@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,858 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview Lightweight reactive signals.
|
|
7
|
+
*
|
|
8
|
+
* A `signal` is a mutable cell of value that notifies subscribers whenever
|
|
9
|
+
* its value changes. A `derived` signal recomputes from one or more source
|
|
10
|
+
* signals automatically. An `effect` runs a side-effect whenever any signal
|
|
11
|
+
* read inside it changes (auto-tracking). A `resource` wraps an async
|
|
12
|
+
* fetcher into a signal carrying `{status, value, error}`.
|
|
13
|
+
* `computed` is an auto-tracked, memoized, lazy read-only derived signal.
|
|
14
|
+
* `scheduleNotify` / `flushSync` provide opt-in async coalescing.
|
|
15
|
+
*
|
|
16
|
+
* Design goals :
|
|
17
|
+
* - **Tiny** : ~350 lines, dependencies-explicit by default ; auto-tracking
|
|
18
|
+
* only inside `effect` / `computed` (never inside `derived` to keep that
|
|
19
|
+
* primitive predictable).
|
|
20
|
+
* - **Sync notifications** : `set()` fires subscribers synchronously by
|
|
21
|
+
* default. Opt-in async coalescing via `scheduleNotify(mode)`.
|
|
22
|
+
* - **No memory leaks** : every subscription returns an unsubscribe.
|
|
23
|
+
* - **No DOM coupling** : usable in workers ; `raf` mode degrades to
|
|
24
|
+
* microtask when `requestAnimationFrame` is absent.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* const sig = runtime.resolve('signal');
|
|
28
|
+
* const count = sig.create(0);
|
|
29
|
+
* const double = sig.derived([count], (n) => n * 2);
|
|
30
|
+
* const triple = sig.computed(() => count.get() * 3);
|
|
31
|
+
*
|
|
32
|
+
* const stop = sig.effect(() => console.log('count =', count.get()));
|
|
33
|
+
* count.set(3); // logs: count = 3
|
|
34
|
+
* stop(); // detaches the effect
|
|
35
|
+
*
|
|
36
|
+
* const users = sig.resource(() => fetch('/api/users').then(r => r.json()));
|
|
37
|
+
* users.subscribe(s => console.log(s.status, s.value));
|
|
38
|
+
*
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* A writable reactive cell holding a value of type `T`.
|
|
43
|
+
* @template T
|
|
44
|
+
* @typedef {object} Signal
|
|
45
|
+
* @property {() => T} get Read the value, registering as a dependency of any active effect.
|
|
46
|
+
* @property {() => T} peek Read the value without registering a dependency.
|
|
47
|
+
* @property {(next: T) => void} set Replace the value and notify subscribers (unless equal per `eq`).
|
|
48
|
+
* @property {(fn: (current: T) => T) => void} update Set the value from a function of the current value.
|
|
49
|
+
* @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
|
|
50
|
+
* @property {number} size Current subscriber count.
|
|
51
|
+
* @property {boolean} _isSignal Internal marker.
|
|
52
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
53
|
+
* @property {string} _graphId Internal dependency-graph node id (`s<n>`).
|
|
54
|
+
*/
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* A read-only reactive cell of type `T` (e.g. from `resource`).
|
|
58
|
+
* @template T
|
|
59
|
+
* @typedef {object} ReadonlySignal
|
|
60
|
+
* @property {() => T} get Read the value, registering as a dependency of any active effect.
|
|
61
|
+
* @property {() => T} peek Read the value without registering a dependency.
|
|
62
|
+
* @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
|
|
63
|
+
* @property {number} size Current subscriber count.
|
|
64
|
+
* @property {boolean} _isSignal Internal marker.
|
|
65
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
66
|
+
*/
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* A read-only reactive cell of type `T` returned by `derived`, additionally
|
|
70
|
+
* disposable to detach its dependency subscriptions.
|
|
71
|
+
* @template T
|
|
72
|
+
* @typedef {object} DisposableReadonlySignal
|
|
73
|
+
* @property {() => T} get Read the value, registering as a dependency of any active effect.
|
|
74
|
+
* @property {() => T} peek Read the value without registering a dependency.
|
|
75
|
+
* @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
|
|
76
|
+
* @property {() => void} dispose Detach all dependency subscriptions (idempotent). After
|
|
77
|
+
* `dispose()`, `get()`/`peek()` keep returning the last computed value and a dep write
|
|
78
|
+
* never recomputes it again.
|
|
79
|
+
* @property {number} size Current subscriber count.
|
|
80
|
+
* @property {boolean} _isSignal Internal marker.
|
|
81
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
82
|
+
*/
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* State carried by a `resource` / `derivedAsync` signal.
|
|
86
|
+
* @template T
|
|
87
|
+
* @typedef {object} ResourceState
|
|
88
|
+
* @property {'idle'|'pending'|'resolved'|'rejected'} status Current fetch status.
|
|
89
|
+
* @property {T|null} value Last resolved value (preserved while pending/rejected).
|
|
90
|
+
* @property {Error|null} error Error from the latest rejected fetch, else null.
|
|
91
|
+
*/
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Read-only resource signal returned by `resource`.
|
|
95
|
+
* @template T
|
|
96
|
+
* @typedef {object} ResourceSignal
|
|
97
|
+
* @property {() => ResourceState<T>} get Read the resource state, registering as a dependency.
|
|
98
|
+
* @property {() => ResourceState<T>} peek Read the resource state without registering.
|
|
99
|
+
* @property {(fn: (state: ResourceState<T>) => void) => (() => void)} subscribe Subscribe to state changes.
|
|
100
|
+
* @property {() => void} refresh Trigger a new fetch (re-using this signal).
|
|
101
|
+
* @property {number} size Current subscriber count.
|
|
102
|
+
* @property {boolean} _isSignal Internal marker.
|
|
103
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
104
|
+
*/
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Read-only async-derived resource signal returned by `derivedAsync`.
|
|
108
|
+
* @template T
|
|
109
|
+
* @typedef {object} DerivedAsyncSignal
|
|
110
|
+
* @property {() => ResourceState<T>} get Read the resource state, registering as a dependency.
|
|
111
|
+
* @property {() => ResourceState<T>} peek Read the resource state without registering.
|
|
112
|
+
* @property {(fn: (state: ResourceState<T>) => void) => (() => void)} subscribe Subscribe to state changes.
|
|
113
|
+
* @property {() => void} refresh Trigger a new fetch.
|
|
114
|
+
* @property {() => void} dispose Detach all dependency subscriptions (idempotent).
|
|
115
|
+
* @property {number} size Current subscriber count.
|
|
116
|
+
* @property {boolean} _isSignal Internal marker.
|
|
117
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
118
|
+
*/
|
|
119
|
+
|
|
120
|
+
/**
|
|
121
|
+
* A read-only auto-tracked memoized derived signal returned by `computed`.
|
|
122
|
+
* @template T
|
|
123
|
+
* @typedef {object} ComputedSignal
|
|
124
|
+
* @property {() => T} get Read the computed value, registering as a dependency of any active effect.
|
|
125
|
+
* @property {() => T} peek Read the computed value without registering a dependency.
|
|
126
|
+
* @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
|
|
127
|
+
* @property {() => void} dispose Detach all tracked-source subscriptions (idempotent). After
|
|
128
|
+
* `dispose()`, `get()`/`peek()` keep returning the last computed value and a source write
|
|
129
|
+
* never recomputes it again.
|
|
130
|
+
* @property {number} size Current subscriber count.
|
|
131
|
+
* @property {boolean} _isSignal Internal marker.
|
|
132
|
+
* @property {Set<Function>} _subs Internal subscriber set.
|
|
133
|
+
* @property {string} _graphId Internal dependency-graph node id (`c<n>`).
|
|
134
|
+
*/
|
|
135
|
+
|
|
136
|
+
/**
|
|
137
|
+
* A signal node of the snapshot returned by `inspectGraph()`.
|
|
138
|
+
* @typedef {object} GraphSignalNode
|
|
139
|
+
* @property {string} id Stable per-factory node id — `s<n>` (`create`) or `c<n>` (`computed`).
|
|
140
|
+
* @property {'signal'|'computed'} kind Which primitive minted the node.
|
|
141
|
+
*/
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* An effect node of the snapshot returned by `inspectGraph()`.
|
|
145
|
+
* @typedef {object} GraphEffectNode
|
|
146
|
+
* @property {string} id Stable per-factory effect id (`e<n>`).
|
|
147
|
+
* @property {number} deps Number of signals this effect currently depends on.
|
|
148
|
+
*/
|
|
149
|
+
|
|
150
|
+
/**
|
|
151
|
+
* A directed dependency edge: the effect re-runs when the signal changes.
|
|
152
|
+
* @typedef {object} GraphEdge
|
|
153
|
+
* @property {string} effect Effect node id.
|
|
154
|
+
* @property {string} signal Signal node id.
|
|
155
|
+
*/
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* Frozen, defensively-copied view of one factory instance's dependency graph.
|
|
159
|
+
* @typedef {object} SignalGraphSnapshot
|
|
160
|
+
* @property {ReadonlyArray<GraphSignalNode>} signals Signals at least one live effect depends on.
|
|
161
|
+
* @property {ReadonlyArray<GraphEffectNode>} effects Live (non-stopped) effects.
|
|
162
|
+
* @property {ReadonlyArray<GraphEdge>} edges Effect → signal dependency edges.
|
|
163
|
+
*/
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* Public shape returned by `signal.factory()` — the reactivity core.
|
|
167
|
+
* @typedef {object} SignalAPI
|
|
168
|
+
* @property {<T>(initial: T, opts?: { eq?: (a: T, b: T) => boolean }) => Signal<T>} create Create a writable signal.
|
|
169
|
+
* @property {<T>(deps: Array<Signal<any>|ReadonlySignal<any>>, fn: (...values: any[]) => T, opts?: { eq?: (a: T, b: T) => boolean }) => DisposableReadonlySignal<T>} derived Create a read-only signal derived from explicit deps.
|
|
170
|
+
* @property {(fn: () => void) => void} batch Batch multiple `set()` calls so subscribers fire once at the end.
|
|
171
|
+
* @property {<T>(fn: () => T) => T} untrack Read signals without registering in the active effect.
|
|
172
|
+
* @property {(fn: () => void) => (() => void)} effect Run `fn`, auto-tracking reads; returns a `stop()`.
|
|
173
|
+
* @property {<T>(fetcher: () => Promise<T>, opts?: { autoStart?: boolean, eq?: (a: ResourceState<T>, b: ResourceState<T>) => boolean }) => ResourceSignal<T>} resource Wrap an async fetcher into a resource signal.
|
|
174
|
+
* @property {<T>(deps: Array<Signal<any>|ReadonlySignal<any>>, fn: (...values: any[]) => T | Promise<T>, opts?: { autoStart?: boolean }) => DerivedAsyncSignal<T>} derivedAsync Async-derived resource signal.
|
|
175
|
+
* @property {<T>(fn: () => T, opts?: { eq?: (a: T, b: T) => boolean }) => ComputedSignal<T>} computed Auto-tracked memoized read-only derived signal.
|
|
176
|
+
* @property {(mode: 'sync'|'microtask'|'raf') => (() => void)} scheduleNotify Enable opt-in async coalescing; returns a disposer restoring the previous mode.
|
|
177
|
+
* @property {() => void} flushSync Force immediate flush of any pending coalesced notifications.
|
|
178
|
+
* @property {() => SignalGraphSnapshot} inspectGraph Read-only snapshot of this instance's dependency graph.
|
|
179
|
+
*/
|
|
180
|
+
|
|
181
|
+
export const signal = {
|
|
182
|
+
name: 'signal',
|
|
183
|
+
version: '1.2.0',
|
|
184
|
+
type: 'fw.io.utils',
|
|
185
|
+
dependencies: [],
|
|
186
|
+
|
|
187
|
+
/** @returns {SignalAPI} */
|
|
188
|
+
factory() {
|
|
189
|
+
|
|
190
|
+
// ── Batch state (per-factory closure) ───────────────────────────────
|
|
191
|
+
let _batchDepth = 0;
|
|
192
|
+
let _batchPending = null; // Map<signal, latestValue>
|
|
193
|
+
|
|
194
|
+
// ── Auto-tracking state (per-factory closure) ───────────────────────
|
|
195
|
+
// When an effect runs, the currently-active tracker collects every
|
|
196
|
+
// signal whose `get()` is called. `derived` is intentionally NOT
|
|
197
|
+
// auto-tracking - its deps are explicit (predictable, no surprise
|
|
198
|
+
// re-runs).
|
|
199
|
+
let _currentTracker = null; // Set<signal> | null
|
|
200
|
+
|
|
201
|
+
// ── Async coalescing state (per-factory closure) ─────────────────────
|
|
202
|
+
// Default mode is 'sync' (no coalescing). When changed via
|
|
203
|
+
// `scheduleNotify(mode)`, set() records pending signals instead of
|
|
204
|
+
// firing immediately. A single flush is scheduled per tick.
|
|
205
|
+
let _notifyMode = 'sync'; // 'sync' | 'microtask' | 'raf'
|
|
206
|
+
let _coalescePending = null; // Map<signal, latestValue> | null
|
|
207
|
+
let _flushScheduled = false; // guard: only one scheduled flush per tick
|
|
208
|
+
|
|
209
|
+
// ── Dependency-graph state (per-factory closure) ────────────────────
|
|
210
|
+
// Node identity is minted at creation (`_graphId`, a plain string) and
|
|
211
|
+
// the graph itself is kept ONLY on the live effects, as sets of those
|
|
212
|
+
// strings — never as references to signal objects. That is deliberate:
|
|
213
|
+
// an effect already retains its deps' subscriber sets, and holding the
|
|
214
|
+
// signal objects too would extend their lifetime for the sake of
|
|
215
|
+
// introspection. Stopped effects are removed, so this state is bounded
|
|
216
|
+
// by the same lifecycle contract `effect()` already has.
|
|
217
|
+
let _nodeSeq = 0; // shared by create() and computed()
|
|
218
|
+
let _effectSeq = 0;
|
|
219
|
+
const _liveEffects = new Set(); // Set<{ id: string, deps: Set<string> }>
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* Drain the coalesce-pending map: notify each signal's subscribers
|
|
223
|
+
* exactly once with its latest value. Called by the scheduled flush
|
|
224
|
+
* or imperatively via `flushSync()`.
|
|
225
|
+
*/
|
|
226
|
+
function drainCoalesced() {
|
|
227
|
+
_flushScheduled = false;
|
|
228
|
+
const queue = _coalescePending;
|
|
229
|
+
_coalescePending = null;
|
|
230
|
+
if (!queue) return;
|
|
231
|
+
for (const [sig, v] of queue) {
|
|
232
|
+
for (const sub of [...sig._subs]) {
|
|
233
|
+
try { sub(v); } catch { /* subscriber error never breaks others */ }
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/**
|
|
239
|
+
* Schedule a single async drain according to the current `_notifyMode`.
|
|
240
|
+
* 'raf' falls back to microtask when `requestAnimationFrame` is absent
|
|
241
|
+
* (e.g. workers).
|
|
242
|
+
*/
|
|
243
|
+
function scheduleFlush() {
|
|
244
|
+
if (_notifyMode === 'raf' && typeof requestAnimationFrame === 'function') {
|
|
245
|
+
requestAnimationFrame(drainCoalesced);
|
|
246
|
+
} else {
|
|
247
|
+
Promise.resolve().then(drainCoalesced);
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
/**
|
|
252
|
+
* Create a writable signal.
|
|
253
|
+
*
|
|
254
|
+
* @template T
|
|
255
|
+
* @param {T} initial - Initial value.
|
|
256
|
+
* @param {Object} [opts]
|
|
257
|
+
* @param {(a:T,b:T)=>boolean} [opts.eq=Object.is]
|
|
258
|
+
* @returns {object} signal
|
|
259
|
+
*/
|
|
260
|
+
function create(initial, opts) {
|
|
261
|
+
let value = initial;
|
|
262
|
+
const eq = (opts && typeof opts.eq === 'function') ? opts.eq : Object.is;
|
|
263
|
+
const subs = new Set();
|
|
264
|
+
|
|
265
|
+
const api = {
|
|
266
|
+
get() {
|
|
267
|
+
// Auto-tracking : if an effect is currently running, register
|
|
268
|
+
// this signal as one of its dependencies.
|
|
269
|
+
if (_currentTracker !== null) _currentTracker.add(api);
|
|
270
|
+
return value;
|
|
271
|
+
},
|
|
272
|
+
/** Read without registering a subscription in an active effect. */
|
|
273
|
+
peek() { return value; },
|
|
274
|
+
set(next) {
|
|
275
|
+
if (eq(value, next)) return;
|
|
276
|
+
value = next;
|
|
277
|
+
if (_batchDepth > 0) {
|
|
278
|
+
_batchPending.set(api, value);
|
|
279
|
+
return;
|
|
280
|
+
}
|
|
281
|
+
// Opt-in async coalescing: record pending; schedule one flush.
|
|
282
|
+
if (_notifyMode !== 'sync') {
|
|
283
|
+
if (_coalescePending === null) _coalescePending = new Map();
|
|
284
|
+
_coalescePending.set(api, value);
|
|
285
|
+
if (!_flushScheduled) {
|
|
286
|
+
_flushScheduled = true;
|
|
287
|
+
scheduleFlush();
|
|
288
|
+
}
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
for (const fn of [...subs]) {
|
|
292
|
+
try { fn(value); }
|
|
293
|
+
catch { /* subscriber error never breaks others */ }
|
|
294
|
+
}
|
|
295
|
+
},
|
|
296
|
+
update(fn) { api.set(fn(value)); },
|
|
297
|
+
subscribe(fn) {
|
|
298
|
+
if (typeof fn !== 'function') return () => {};
|
|
299
|
+
subs.add(fn);
|
|
300
|
+
return () => subs.delete(fn);
|
|
301
|
+
},
|
|
302
|
+
get size() { return subs.size; },
|
|
303
|
+
_isSignal: true,
|
|
304
|
+
_subs: subs,
|
|
305
|
+
_graphId: 's' + (++_nodeSeq),
|
|
306
|
+
};
|
|
307
|
+
return api;
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/**
|
|
311
|
+
* Create a read-only signal derived from explicit deps. Recomputes
|
|
312
|
+
* whenever any dep changes ; subscribers fire when the result differs
|
|
313
|
+
* (per `opts.eq`).
|
|
314
|
+
*
|
|
315
|
+
* The returned signal exposes `dispose()` to detach the dep
|
|
316
|
+
* subscriptions it holds internally (mirrors `derivedAsync`) — call it
|
|
317
|
+
* when the derived signal is discarded (e.g. component unmount,
|
|
318
|
+
* list-row churn) to avoid it recomputing forever on every dep write.
|
|
319
|
+
* After `dispose()`, `get()`/`peek()` keep returning the last computed
|
|
320
|
+
* value and never resubscribe.
|
|
321
|
+
*/
|
|
322
|
+
function derived(deps, fn, opts) {
|
|
323
|
+
if (!Array.isArray(deps) || deps.some(d => !d || !d._isSignal))
|
|
324
|
+
throw new Error('signal.derived: deps must be an array of signals');
|
|
325
|
+
if (typeof fn !== 'function')
|
|
326
|
+
throw new Error('signal.derived: fn must be a function');
|
|
327
|
+
|
|
328
|
+
const compute = () => fn(...deps.map(d => d.peek()));
|
|
329
|
+
const inner = create(compute(), opts);
|
|
330
|
+
|
|
331
|
+
let _disposed = false;
|
|
332
|
+
const _unsubs = deps.map(d => d.subscribe(() => {
|
|
333
|
+
if (_disposed) return;
|
|
334
|
+
inner.set(compute());
|
|
335
|
+
}));
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* Detach all dep subscriptions so the derived signal can be
|
|
339
|
+
* garbage-collected. Idempotent.
|
|
340
|
+
*/
|
|
341
|
+
function dispose() {
|
|
342
|
+
if (_disposed) return;
|
|
343
|
+
_disposed = true;
|
|
344
|
+
for (const off of _unsubs) {
|
|
345
|
+
try { off(); } catch { /* swallow */ }
|
|
346
|
+
}
|
|
347
|
+
_unsubs.length = 0;
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
return {
|
|
351
|
+
get: inner.get,
|
|
352
|
+
peek: inner.peek,
|
|
353
|
+
subscribe: inner.subscribe,
|
|
354
|
+
dispose,
|
|
355
|
+
get size() { return inner.size; },
|
|
356
|
+
_isSignal: true,
|
|
357
|
+
_subs: inner._subs,
|
|
358
|
+
};
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
/**
|
|
362
|
+
* Batch multiple `set()` calls so subscribers fire **once** at the end.
|
|
363
|
+
*/
|
|
364
|
+
function batch(fn) {
|
|
365
|
+
if (typeof fn !== 'function') return;
|
|
366
|
+
if (_batchDepth === 0) _batchPending = new Map();
|
|
367
|
+
_batchDepth++;
|
|
368
|
+
try { fn(); }
|
|
369
|
+
finally {
|
|
370
|
+
_batchDepth--;
|
|
371
|
+
if (_batchDepth === 0) {
|
|
372
|
+
const queue = _batchPending;
|
|
373
|
+
_batchPending = null;
|
|
374
|
+
for (const [sig, v] of queue) {
|
|
375
|
+
for (const sub of [...sig._subs]) {
|
|
376
|
+
try { sub(v); } catch { /* swallow */ }
|
|
377
|
+
}
|
|
378
|
+
}
|
|
379
|
+
}
|
|
380
|
+
}
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
/**
|
|
384
|
+
* Read a signal **without** registering as a dependency in the
|
|
385
|
+
* currently-active effect. The wrapper temporarily nulls the tracker,
|
|
386
|
+
* runs `fn`, then restores it.
|
|
387
|
+
*
|
|
388
|
+
* @template T
|
|
389
|
+
* @param {() => T} fn
|
|
390
|
+
* @returns {T}
|
|
391
|
+
*/
|
|
392
|
+
function untrack(fn) {
|
|
393
|
+
const prev = _currentTracker;
|
|
394
|
+
_currentTracker = null;
|
|
395
|
+
try { return fn(); }
|
|
396
|
+
finally { _currentTracker = prev; }
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
/**
|
|
400
|
+
* Run `fn` once, tracking every signal it reads. Re-run `fn` whenever
|
|
401
|
+
* any of those signals change. Returns a `stop()` function that
|
|
402
|
+
* unsubscribes from all tracked signals.
|
|
403
|
+
*
|
|
404
|
+
* Dependencies are **re-collected** on each run, so conditional reads
|
|
405
|
+
* work correctly :
|
|
406
|
+
*
|
|
407
|
+
* effect(() => {
|
|
408
|
+
* if (showName.get()) console.log(name.get());
|
|
409
|
+
* // ↑ `name` is only tracked while `showName` is true.
|
|
410
|
+
* });
|
|
411
|
+
*
|
|
412
|
+
* Reads done inside `untrack(...)` do NOT register.
|
|
413
|
+
*
|
|
414
|
+
* Errors thrown by `fn` are caught and printed via `console.error`
|
|
415
|
+
* so a faulty effect cannot break unrelated effects.
|
|
416
|
+
*
|
|
417
|
+
* **Recursion contract.** Subscriptions to freshly-collected deps are
|
|
418
|
+
* wired only AFTER `fn` returns, so a synchronous `signal.set(...)`
|
|
419
|
+
* inside `fn` that targets a tracked signal does NOT re-enter the
|
|
420
|
+
* effect immediately ; the value change is visible to the next read
|
|
421
|
+
* via `get()`. Indirect recursion (a microtask scheduled by `fn` that
|
|
422
|
+
* later mutates a tracked dep) is supported and re-runs the effect.
|
|
423
|
+
* If a write must mutate a tracked signal without scheduling a
|
|
424
|
+
* re-run, wrap it in `untrack(() => sig.set(v))`. There is no
|
|
425
|
+
* runtime recursion guard ; consumers are responsible for avoiding
|
|
426
|
+
* unbounded loops between effects and the signals they mutate.
|
|
427
|
+
*
|
|
428
|
+
* @param {() => void} fn
|
|
429
|
+
* @returns {() => void} stop
|
|
430
|
+
*/
|
|
431
|
+
function effect(fn) {
|
|
432
|
+
if (typeof fn !== 'function')
|
|
433
|
+
throw new Error('signal.effect: fn must be a function');
|
|
434
|
+
|
|
435
|
+
const unsubscribers = new Set();
|
|
436
|
+
let stopped = false;
|
|
437
|
+
// Graph record for this effect: id + the ids of its current deps.
|
|
438
|
+
// Registered up front so an effect is visible while its first run
|
|
439
|
+
// is still in flight; removed by `stop()`.
|
|
440
|
+
const record = { id: 'e' + (++_effectSeq), deps: new Set() };
|
|
441
|
+
_liveEffects.add(record);
|
|
442
|
+
|
|
443
|
+
function detach() {
|
|
444
|
+
for (const off of unsubscribers) {
|
|
445
|
+
try { off(); } catch { /* swallow */ }
|
|
446
|
+
}
|
|
447
|
+
unsubscribers.clear();
|
|
448
|
+
}
|
|
449
|
+
|
|
450
|
+
function run() {
|
|
451
|
+
if (stopped) return;
|
|
452
|
+
detach();
|
|
453
|
+
const deps = new Set();
|
|
454
|
+
const prev = _currentTracker;
|
|
455
|
+
_currentTracker = deps;
|
|
456
|
+
try { fn(); }
|
|
457
|
+
catch (e) {
|
|
458
|
+
try { console.error('signal.effect: handler threw', e); }
|
|
459
|
+
catch { /* swallow */ }
|
|
460
|
+
}
|
|
461
|
+
finally { _currentTracker = prev; }
|
|
462
|
+
// Subscribe to each dep ; on any change, re-run. The graph
|
|
463
|
+
// record is rebuilt from the same freshly-collected set, so
|
|
464
|
+
// conditional reads are reflected edge-for-edge.
|
|
465
|
+
record.deps.clear();
|
|
466
|
+
for (const sig of deps) {
|
|
467
|
+
record.deps.add(sig._graphId);
|
|
468
|
+
const off = sig.subscribe(run);
|
|
469
|
+
unsubscribers.add(off);
|
|
470
|
+
}
|
|
471
|
+
}
|
|
472
|
+
|
|
473
|
+
run();
|
|
474
|
+
|
|
475
|
+
return function stop() {
|
|
476
|
+
stopped = true;
|
|
477
|
+
detach();
|
|
478
|
+
record.deps.clear();
|
|
479
|
+
_liveEffects.delete(record);
|
|
480
|
+
};
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
/**
|
|
484
|
+
* Wrap an async `fetcher` into a read-only signal carrying
|
|
485
|
+
* `{ status: 'idle' | 'pending' | 'resolved' | 'rejected',
|
|
486
|
+
* value: T | null, error: Error | null }`.
|
|
487
|
+
*
|
|
488
|
+
* Starts in `'idle'`, calls `refresh()` to fetch. The returned signal
|
|
489
|
+
* also exposes `refresh()` which triggers a new fetch (re-using the
|
|
490
|
+
* same signal, so subscribers see the transition `pending → resolved`).
|
|
491
|
+
*
|
|
492
|
+
* Use case : SSR `<initialData>`, list refresh button, polling.
|
|
493
|
+
*
|
|
494
|
+
* @template T
|
|
495
|
+
* @param {() => Promise<T>} fetcher
|
|
496
|
+
* @param {Object} [opts]
|
|
497
|
+
* @param {boolean} [opts.autoStart=true] - Trigger the first fetch
|
|
498
|
+
* immediately on creation.
|
|
499
|
+
* @param {(prev:any, next:any)=>boolean} [opts.eq] - Equality on the
|
|
500
|
+
* wrapped state (default : reference compare on `value`).
|
|
501
|
+
* @returns {object} `{ get, peek, subscribe, refresh, _isSignal }`
|
|
502
|
+
*/
|
|
503
|
+
function resource(fetcher, opts) {
|
|
504
|
+
if (typeof fetcher !== 'function')
|
|
505
|
+
throw new Error('signal.resource: fetcher must be a function');
|
|
506
|
+
|
|
507
|
+
const autoStart = !(opts && opts.autoStart === false);
|
|
508
|
+
// Custom eq : compare on { status, value, error } shape - a
|
|
509
|
+
// setState that produces the same triple is a no-op.
|
|
510
|
+
const eq = (opts && typeof opts.eq === 'function')
|
|
511
|
+
? opts.eq
|
|
512
|
+
: (a, b) => a.status === b.status && a.value === b.value && a.error === b.error;
|
|
513
|
+
|
|
514
|
+
const inner = create(
|
|
515
|
+
{ status: 'idle', value: null, error: null },
|
|
516
|
+
{ eq }
|
|
517
|
+
);
|
|
518
|
+
|
|
519
|
+
// Token to invalidate in-flight fetches when `refresh()` is called
|
|
520
|
+
// again before the previous one resolves.
|
|
521
|
+
let _token = 0;
|
|
522
|
+
|
|
523
|
+
function refresh() {
|
|
524
|
+
const token = ++_token;
|
|
525
|
+
inner.set({
|
|
526
|
+
status: 'pending',
|
|
527
|
+
value: inner.peek().value, // preserve last value during loading
|
|
528
|
+
error: null,
|
|
529
|
+
});
|
|
530
|
+
Promise.resolve()
|
|
531
|
+
.then(() => fetcher())
|
|
532
|
+
.then(
|
|
533
|
+
(v) => {
|
|
534
|
+
if (token !== _token) return; // superseded
|
|
535
|
+
inner.set({ status: 'resolved', value: v, error: null });
|
|
536
|
+
},
|
|
537
|
+
(err) => {
|
|
538
|
+
if (token !== _token) return;
|
|
539
|
+
inner.set({
|
|
540
|
+
status: 'rejected',
|
|
541
|
+
value: inner.peek().value,
|
|
542
|
+
error: err instanceof Error ? err : new Error(String(err)),
|
|
543
|
+
});
|
|
544
|
+
}
|
|
545
|
+
);
|
|
546
|
+
}
|
|
547
|
+
|
|
548
|
+
if (autoStart) refresh();
|
|
549
|
+
|
|
550
|
+
return {
|
|
551
|
+
get: inner.get,
|
|
552
|
+
peek: inner.peek,
|
|
553
|
+
subscribe: inner.subscribe,
|
|
554
|
+
refresh,
|
|
555
|
+
get size() { return inner.size; },
|
|
556
|
+
_isSignal: true,
|
|
557
|
+
_subs: inner._subs,
|
|
558
|
+
};
|
|
559
|
+
}
|
|
560
|
+
|
|
561
|
+
/**
|
|
562
|
+
* Async-derived resource - like `derived` but the compute function
|
|
563
|
+
* may return a Promise. Returns a resource-shaped signal carrying
|
|
564
|
+
* `{ status, value, error }`. Re-runs `fn(...deps)` whenever any dep
|
|
565
|
+
* changes, with the same stale-token guard as `resource`.
|
|
566
|
+
*
|
|
567
|
+
* Use case : a list `query` signal + a `page` signal → a derived
|
|
568
|
+
* resource that fetches the matching page.
|
|
569
|
+
*
|
|
570
|
+
* const query = signal.create('foo');
|
|
571
|
+
* const page = signal.create(1);
|
|
572
|
+
* const data = signal.derivedAsync([query, page], (q, p) =>
|
|
573
|
+
* fetch(`/api/search?q=${q}&p=${p}`).then(r => r.json())
|
|
574
|
+
* );
|
|
575
|
+
* data.subscribe(s => console.log(s.status, s.value));
|
|
576
|
+
*
|
|
577
|
+
* @template T
|
|
578
|
+
* @param {Array} deps - Source signals (explicit, like `derived`).
|
|
579
|
+
* @param {(...values:any[]) => T | Promise<T>} fn
|
|
580
|
+
* @param {Object} [opts]
|
|
581
|
+
* @param {boolean} [opts.autoStart=true]
|
|
582
|
+
* @returns {object} resource-shaped read-only signal with `refresh()`.
|
|
583
|
+
*/
|
|
584
|
+
function derivedAsync(deps, fn, opts) {
|
|
585
|
+
if (!Array.isArray(deps) || deps.some(d => !d || !d._isSignal))
|
|
586
|
+
throw new Error('signal.derivedAsync: deps must be an array of signals');
|
|
587
|
+
if (typeof fn !== 'function')
|
|
588
|
+
throw new Error('signal.derivedAsync: fn must be a function');
|
|
589
|
+
|
|
590
|
+
const r = resource(
|
|
591
|
+
() => Promise.resolve().then(() => fn(...deps.map(d => d.peek()))),
|
|
592
|
+
opts,
|
|
593
|
+
);
|
|
594
|
+
|
|
595
|
+
// Track every dep subscription so we can release them on dispose,
|
|
596
|
+
// avoiding the leak when the resource is discarded by the caller
|
|
597
|
+
// (e.g. component unmount, list-row churn).
|
|
598
|
+
const _unsubs = [];
|
|
599
|
+
let _disposed = false;
|
|
600
|
+
|
|
601
|
+
for (const d of deps) {
|
|
602
|
+
const off = d.subscribe(() => {
|
|
603
|
+
if (_disposed) return;
|
|
604
|
+
r.refresh();
|
|
605
|
+
});
|
|
606
|
+
_unsubs.push(off);
|
|
607
|
+
}
|
|
608
|
+
|
|
609
|
+
/**
|
|
610
|
+
* Detach all dep subscriptions so the resource can be garbage-
|
|
611
|
+
* collected. Subsequent `refresh()` calls become no-ops via the
|
|
612
|
+
* `_disposed` guard. Idempotent.
|
|
613
|
+
*/
|
|
614
|
+
function dispose() {
|
|
615
|
+
if (_disposed) return;
|
|
616
|
+
_disposed = true;
|
|
617
|
+
for (const off of _unsubs) {
|
|
618
|
+
try { off(); } catch { /* swallow */ }
|
|
619
|
+
}
|
|
620
|
+
_unsubs.length = 0;
|
|
621
|
+
}
|
|
622
|
+
|
|
623
|
+
return {
|
|
624
|
+
get: r.get,
|
|
625
|
+
peek: r.peek,
|
|
626
|
+
subscribe: r.subscribe,
|
|
627
|
+
refresh: r.refresh,
|
|
628
|
+
dispose,
|
|
629
|
+
get size() { return r.size; },
|
|
630
|
+
_isSignal: true,
|
|
631
|
+
_subs: r._subs,
|
|
632
|
+
};
|
|
633
|
+
}
|
|
634
|
+
|
|
635
|
+
/**
|
|
636
|
+
* Auto-tracked, memoized, read-only derived signal.
|
|
637
|
+
*
|
|
638
|
+
* Dependencies are collected automatically (like `effect`) on each run —
|
|
639
|
+
* no explicit deps array (contrast `derived`, which keeps explicit deps).
|
|
640
|
+
* Lazy: recomputes on read after any tracked source changed.
|
|
641
|
+
* Reading a `computed` inside an `effect` or another `computed` registers
|
|
642
|
+
* it as a dependency (composable). `untrack(fn)` suppresses tracking
|
|
643
|
+
* inside the compute function.
|
|
644
|
+
*
|
|
645
|
+
* @template T
|
|
646
|
+
* @param {() => T} fn
|
|
647
|
+
* @param {{ eq?: (a: T, b: T) => boolean }} [opts]
|
|
648
|
+
* @returns {ComputedSignal<T>}
|
|
649
|
+
*/
|
|
650
|
+
function computed(fn, opts) {
|
|
651
|
+
if (typeof fn !== 'function')
|
|
652
|
+
throw new Error('signal.computed: fn must be a function');
|
|
653
|
+
|
|
654
|
+
const eq = (opts && typeof opts.eq === 'function') ? opts.eq : Object.is;
|
|
655
|
+
/** Subscribers of this computed signal (effects / other computeds). */
|
|
656
|
+
const subs = new Set();
|
|
657
|
+
|
|
658
|
+
let _dirty = true; // always recompute on the first read
|
|
659
|
+
let _value; // last memoized value (undefined before first run)
|
|
660
|
+
let _unsubs = []; // unsubscribers for currently-tracked deps
|
|
661
|
+
let _disposed = false;
|
|
662
|
+
|
|
663
|
+
/** Release all dep subscriptions; called before each recompute. */
|
|
664
|
+
function detachDeps() {
|
|
665
|
+
for (const off of _unsubs) {
|
|
666
|
+
try { off(); } catch { /* swallow */ }
|
|
667
|
+
}
|
|
668
|
+
_unsubs = [];
|
|
669
|
+
}
|
|
670
|
+
|
|
671
|
+
/**
|
|
672
|
+
* Called by any tracked dep when it changes.
|
|
673
|
+
* Eagerly recomputes so subscribers receive the fresh value, and
|
|
674
|
+
* re-collects deps (supporting conditional reads).
|
|
675
|
+
*/
|
|
676
|
+
function onDepChanged() {
|
|
677
|
+
if (_disposed) return;
|
|
678
|
+
if (!_dirty) _dirty = true; // guard: avoid re-entry below
|
|
679
|
+
detachDeps();
|
|
680
|
+
|
|
681
|
+
// Re-collect deps.
|
|
682
|
+
const deps = new Set();
|
|
683
|
+
const prevTracker = _currentTracker;
|
|
684
|
+
_currentTracker = deps;
|
|
685
|
+
let next;
|
|
686
|
+
try { next = fn(); }
|
|
687
|
+
finally { _currentTracker = prevTracker; }
|
|
688
|
+
|
|
689
|
+
const prevVal = _value;
|
|
690
|
+
_value = next;
|
|
691
|
+
_dirty = false;
|
|
692
|
+
|
|
693
|
+
// Re-subscribe with fresh dep set.
|
|
694
|
+
for (const sig of deps) {
|
|
695
|
+
_unsubs.push(sig.subscribe(onDepChanged));
|
|
696
|
+
}
|
|
697
|
+
|
|
698
|
+
// Propagate to this computed's subscribers only if value changed.
|
|
699
|
+
if (!eq(prevVal, next)) {
|
|
700
|
+
for (const sub of [...subs]) {
|
|
701
|
+
try { sub(next); } catch { /* swallow */ }
|
|
702
|
+
}
|
|
703
|
+
}
|
|
704
|
+
}
|
|
705
|
+
|
|
706
|
+
/**
|
|
707
|
+
* Perform the initial (lazy) computation: collect deps, compute value,
|
|
708
|
+
* subscribe to each dep with `onDepChanged`.
|
|
709
|
+
* Must be called only when `_dirty === true`.
|
|
710
|
+
*/
|
|
711
|
+
function initialCompute() {
|
|
712
|
+
detachDeps();
|
|
713
|
+
const deps = new Set();
|
|
714
|
+
const prevTracker = _currentTracker;
|
|
715
|
+
_currentTracker = deps;
|
|
716
|
+
try { _value = fn(); }
|
|
717
|
+
finally { _currentTracker = prevTracker; }
|
|
718
|
+
_dirty = false;
|
|
719
|
+
for (const sig of deps) {
|
|
720
|
+
_unsubs.push(sig.subscribe(onDepChanged));
|
|
721
|
+
}
|
|
722
|
+
}
|
|
723
|
+
|
|
724
|
+
const api = {
|
|
725
|
+
get() {
|
|
726
|
+
// Register this computed as a dep of any active outer tracker.
|
|
727
|
+
if (_currentTracker !== null) _currentTracker.add(api);
|
|
728
|
+
// Post-dispose: never recompute, keep returning the last value.
|
|
729
|
+
if (_dirty && !_disposed) initialCompute();
|
|
730
|
+
return _value;
|
|
731
|
+
},
|
|
732
|
+
peek() {
|
|
733
|
+
// Compute without registering in any outer tracker.
|
|
734
|
+
if (_dirty && !_disposed) {
|
|
735
|
+
const prevTracker = _currentTracker;
|
|
736
|
+
_currentTracker = null;
|
|
737
|
+
initialCompute();
|
|
738
|
+
_currentTracker = prevTracker;
|
|
739
|
+
}
|
|
740
|
+
return _value;
|
|
741
|
+
},
|
|
742
|
+
subscribe(cb) {
|
|
743
|
+
if (typeof cb !== 'function') return () => {};
|
|
744
|
+
subs.add(cb);
|
|
745
|
+
return () => subs.delete(cb);
|
|
746
|
+
},
|
|
747
|
+
/**
|
|
748
|
+
* Detach all tracked-source subscriptions so this computed can
|
|
749
|
+
* be garbage-collected instead of recomputing forever on every
|
|
750
|
+
* source write. Idempotent. After `dispose()`, `get()`/`peek()`
|
|
751
|
+
* keep returning the last computed value and never resubscribe.
|
|
752
|
+
*/
|
|
753
|
+
dispose() {
|
|
754
|
+
if (_disposed) return;
|
|
755
|
+
_disposed = true;
|
|
756
|
+
detachDeps();
|
|
757
|
+
},
|
|
758
|
+
get size() { return subs.size; },
|
|
759
|
+
_isSignal: true,
|
|
760
|
+
_subs: subs,
|
|
761
|
+
_graphId: 'c' + (++_nodeSeq),
|
|
762
|
+
};
|
|
763
|
+
|
|
764
|
+
return Object.freeze(api);
|
|
765
|
+
}
|
|
766
|
+
|
|
767
|
+
/**
|
|
768
|
+
* Enable opt-in async coalescing for subsequent notifications.
|
|
769
|
+
* `'microtask'` → flush via `Promise.resolve().then(…)`;
|
|
770
|
+
* `'raf'` → `requestAnimationFrame` (falls back to microtask when rAF
|
|
771
|
+
* is absent, e.g. workers);
|
|
772
|
+
* `'sync'` → restore default synchronous notifications.
|
|
773
|
+
*
|
|
774
|
+
* Returns a disposer that restores the previous mode.
|
|
775
|
+
*
|
|
776
|
+
* @param {'sync'|'microtask'|'raf'} mode
|
|
777
|
+
* @returns {() => void}
|
|
778
|
+
*/
|
|
779
|
+
function scheduleNotify(mode) {
|
|
780
|
+
const prev = _notifyMode;
|
|
781
|
+
_notifyMode = mode;
|
|
782
|
+
// If switching back to sync, flush anything pending immediately.
|
|
783
|
+
if (mode === 'sync' && _coalescePending !== null) {
|
|
784
|
+
drainCoalesced();
|
|
785
|
+
}
|
|
786
|
+
return function disposer() {
|
|
787
|
+
_notifyMode = prev;
|
|
788
|
+
// If restoring sync, flush pending notifications immediately.
|
|
789
|
+
if (prev === 'sync' && _coalescePending !== null) {
|
|
790
|
+
drainCoalesced();
|
|
791
|
+
}
|
|
792
|
+
};
|
|
793
|
+
}
|
|
794
|
+
|
|
795
|
+
/**
|
|
796
|
+
* Force an immediate flush of any pending coalesced notifications.
|
|
797
|
+
* No-op when coalescing is not active or there is nothing pending.
|
|
798
|
+
*/
|
|
799
|
+
function flushSync() {
|
|
800
|
+
drainCoalesced();
|
|
801
|
+
}
|
|
802
|
+
|
|
803
|
+
/**
|
|
804
|
+
* Read-only snapshot of **this factory instance's** effect dependency
|
|
805
|
+
* graph: the live effects, the signals they currently depend on, and
|
|
806
|
+
* the edges between them.
|
|
807
|
+
*
|
|
808
|
+
* Reading the graph is **not** a reactive read. The snapshot is built
|
|
809
|
+
* from the private tracking records only — no signal value is read
|
|
810
|
+
* through `get()` — and the whole build additionally runs inside
|
|
811
|
+
* `untrack`, so calling this from within an active `effect` or
|
|
812
|
+
* `computed` can never register a dependency. An accessor that reported
|
|
813
|
+
* the graph by walking it through the normal read path would change the
|
|
814
|
+
* graph it reports; this one does not.
|
|
815
|
+
*
|
|
816
|
+
* The returned object, its arrays and every node/edge are frozen copies:
|
|
817
|
+
* mutating them throws and never reaches the real tracking state.
|
|
818
|
+
*
|
|
819
|
+
* Scope, stated rather than implied: the graph is the **effect**
|
|
820
|
+
* dependency graph. A signal appears once at least one live effect
|
|
821
|
+
* depends on it, and disappears when the last one drops it or stops.
|
|
822
|
+
* Signals nobody observes, and the internal deps of a `computed` (which
|
|
823
|
+
* has no `stop()` handle, so registering it would outlive its usefulness
|
|
824
|
+
* and retain state), are deliberately not nodes; a `computed` read by an
|
|
825
|
+
* effect does appear, as a node of kind `'computed'`.
|
|
826
|
+
*
|
|
827
|
+
* @returns {SignalGraphSnapshot} Frozen snapshot; never a live handle.
|
|
828
|
+
*/
|
|
829
|
+
function inspectGraph() {
|
|
830
|
+
return untrack(() => {
|
|
831
|
+
const signals = [];
|
|
832
|
+
const effects = [];
|
|
833
|
+
const edges = [];
|
|
834
|
+
const seen = new Set();
|
|
835
|
+
for (const rec of _liveEffects) {
|
|
836
|
+
effects.push(Object.freeze({ id: rec.id, deps: rec.deps.size }));
|
|
837
|
+
for (const sid of rec.deps) {
|
|
838
|
+
if (!seen.has(sid)) {
|
|
839
|
+
seen.add(sid);
|
|
840
|
+
signals.push(Object.freeze({
|
|
841
|
+
id: sid,
|
|
842
|
+
kind: sid[0] === 'c' ? 'computed' : 'signal',
|
|
843
|
+
}));
|
|
844
|
+
}
|
|
845
|
+
edges.push(Object.freeze({ effect: rec.id, signal: sid }));
|
|
846
|
+
}
|
|
847
|
+
}
|
|
848
|
+
return Object.freeze({
|
|
849
|
+
signals: Object.freeze(signals),
|
|
850
|
+
effects: Object.freeze(effects),
|
|
851
|
+
edges: Object.freeze(edges),
|
|
852
|
+
});
|
|
853
|
+
});
|
|
854
|
+
}
|
|
855
|
+
|
|
856
|
+
return { create, derived, batch, untrack, effect, resource, derivedAsync, computed, scheduleNotify, flushSync, inspectGraph };
|
|
857
|
+
},
|
|
858
|
+
};
|