@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,187 @@
|
|
|
1
|
+
# Hot module replacement
|
|
2
|
+
|
|
3
|
+
fw ships **one** hot-reload primitive: `runtime.invalidate()`, which drops
|
|
4
|
+
cached instances so the next `resolve()` re-runs a factory. That is the whole of
|
|
5
|
+
what the framework provides. Everything else a full HMR experience needs — a
|
|
6
|
+
file watcher, a push channel, a client that re-imports changed bytes — is **not
|
|
7
|
+
shipped**; this page says exactly where the line is, because the useful part of
|
|
8
|
+
a hot-reload story is knowing what it will *not* do at 2am.
|
|
9
|
+
|
|
10
|
+
## The problem it solves
|
|
11
|
+
|
|
12
|
+
`runtime.register()` is **descriptor-only**. Re-registering a module (or
|
|
13
|
+
`unregister()` then `register()`) swaps the stored definition but never touches
|
|
14
|
+
the instance cache, so `resolve()` keeps handing back the object built from the
|
|
15
|
+
*old* factory:
|
|
16
|
+
|
|
17
|
+
```js
|
|
18
|
+
runtime.register({ name: 'view', dependencies: [], factory: () => 'old' });
|
|
19
|
+
runtime.resolve('view'); // 'old'
|
|
20
|
+
|
|
21
|
+
runtime.register({ name: 'view', dependencies: [], factory: () => 'new' });
|
|
22
|
+
runtime.resolve('view'); // still 'old' ← here
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
`invalidate()` is the missing step:
|
|
26
|
+
|
|
27
|
+
```js
|
|
28
|
+
runtime.invalidate('view');
|
|
29
|
+
runtime.resolve('view'); // 'new'
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
This is not a redesign of the runtime. It evicts entries from the public
|
|
33
|
+
`runtime.instances` map; the registry, `resolve()`, `list()` and `snapshot()`
|
|
34
|
+
are unchanged.
|
|
35
|
+
|
|
36
|
+
## Scope: leaf modules
|
|
37
|
+
|
|
38
|
+
The supported operation is:
|
|
39
|
+
|
|
40
|
+
> edit a **leaf module** — a view, a template, a presentational component —
|
|
41
|
+
> and swap it without a page reload, with signals held in an **unswapped store
|
|
42
|
+
> module** surviving.
|
|
43
|
+
|
|
44
|
+
Nothing wider. General state-preserving replacement of arbitrary modules is not
|
|
45
|
+
supported, and preserving DOM-local uncontrolled state (a caret position, a
|
|
46
|
+
scroll offset, an unsubmitted `<input>` the swap re-renders) is out of scope.
|
|
47
|
+
|
|
48
|
+
## `runtime.invalidate(spec, options?)`
|
|
49
|
+
|
|
50
|
+
```js
|
|
51
|
+
const { invalidated, state } = runtime.invalidate('todoView', { cascade: true });
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
| | |
|
|
55
|
+
|---|---|
|
|
56
|
+
| `spec` | `'name'` (every registered version) or `'name@version'` (exact) |
|
|
57
|
+
| `options.cascade` | also invalidate every module declaring the target among its `dependencies`, transitively |
|
|
58
|
+
| returns | frozen `{ invalidated, state }` — see [the API page](../api/core/runtime.md#runtimeinvalidatespec-options) |
|
|
59
|
+
|
|
60
|
+
**Cascade goes to dependents, not dependencies.** A dependent's factory already
|
|
61
|
+
ran with the *old* dependency instance captured in its closure, and nothing
|
|
62
|
+
would ever hand it the new one — so it has to be rebuilt too. What the target
|
|
63
|
+
itself depends on is untouched, which is precisely what lets a store module
|
|
64
|
+
survive a view swap.
|
|
65
|
+
|
|
66
|
+
Version precision follows the same rule `resolve()` uses: a version-less
|
|
67
|
+
dependency spec (`'foo'`) cascades only when the invalidated version is the one
|
|
68
|
+
`resolve('foo')` would pick; a pinned spec (`'foo@1.0.0'`) cascades only for
|
|
69
|
+
that exact version.
|
|
70
|
+
|
|
71
|
+
**It is atomic.** The never-swap check and every `dehydrate()` call run before
|
|
72
|
+
the first cache write, so a refused module or a throwing `dehydrate()` leaves
|
|
73
|
+
the cache exactly as it was — a half-applied swap is worse than a rejected one.
|
|
74
|
+
|
|
75
|
+
## The never-swap set
|
|
76
|
+
|
|
77
|
+
`ModuleRuntime.NEVER_SWAP` is a frozen, pinned array of module names
|
|
78
|
+
`invalidate()` refuses to touch, directly or through a cascade. It contains
|
|
79
|
+
**`signal`**.
|
|
80
|
+
|
|
81
|
+
```js
|
|
82
|
+
runtime.invalidate('signal');
|
|
83
|
+
// Error: Module "signal" is in the never-swap set and cannot be invalidated
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
`signal`'s effect tracking is **per-factory-instance**. Dropping its cached
|
|
87
|
+
instance would leave every already-created signal, derived and effect bound to
|
|
88
|
+
the previous factory instance while new reads register against the new one:
|
|
89
|
+
effects stop firing, with no error to point at. That is a whole-application
|
|
90
|
+
breakage of exactly the class a hot-reload seam must not be able to cause.
|
|
91
|
+
|
|
92
|
+
The set is pinned rather than configurable: a per-runtime opt-out would make
|
|
93
|
+
the guarantee negotiable at the call site, which is where the mistake happens.
|
|
94
|
+
Adding a name is a source change, reviewed like any other.
|
|
95
|
+
|
|
96
|
+
## The `dehydrate()` / `hydrate()` convention
|
|
97
|
+
|
|
98
|
+
Opt-in, and **a convention rather than a mechanism**: `resolve()` is unchanged
|
|
99
|
+
and knows nothing about it. `invalidate()` calls `dehydrate()` on each outgoing
|
|
100
|
+
instance that exposes one, and hands the results back keyed by canonical
|
|
101
|
+
`name@version`. The caller closes the loop:
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
const editor = {
|
|
105
|
+
name: 'editor', dependencies: [],
|
|
106
|
+
factory: function () {
|
|
107
|
+
let draft = '';
|
|
108
|
+
return {
|
|
109
|
+
read: () => draft,
|
|
110
|
+
type: (s) => { draft = s; },
|
|
111
|
+
dehydrate: () => ({ draft }), // opt in
|
|
112
|
+
hydrate: (s) => { draft = s.draft; },
|
|
113
|
+
};
|
|
114
|
+
},
|
|
115
|
+
};
|
|
116
|
+
|
|
117
|
+
// …after the new descriptor has been registered:
|
|
118
|
+
const { invalidated, state } = runtime.invalidate('editor', { cascade: true });
|
|
119
|
+
for (const key of invalidated) {
|
|
120
|
+
const instance = runtime.resolve(key);
|
|
121
|
+
if (key in state && typeof instance.hydrate === 'function') {
|
|
122
|
+
instance.hydrate(state[key]);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
Keeping the transfer in the caller's hands is deliberate: the state that
|
|
128
|
+
crosses a swap is visible, inspectable and skippable, instead of being silently
|
|
129
|
+
re-injected by the runtime.
|
|
130
|
+
|
|
131
|
+
## Limits — read these before relying on any of it
|
|
132
|
+
|
|
133
|
+
These are structural properties of the design, not gaps waiting for a later
|
|
134
|
+
wave.
|
|
135
|
+
|
|
136
|
+
1. **Factory-closure state is lost.** Invalidating a module is *exactly* what
|
|
137
|
+
re-runs its factory, and re-running the factory is *exactly* what clears its
|
|
138
|
+
closure. A counter, a cache, a subscription list held in factory scope is
|
|
139
|
+
gone. The `dehydrate()`/`hydrate()` convention above is the answer, and it is
|
|
140
|
+
opt-in — a module that does not implement it loses that state, silently and
|
|
141
|
+
by construction. State that must survive belongs in a module that is **not**
|
|
142
|
+
part of the swap.
|
|
143
|
+
|
|
144
|
+
2. **Handles already handed out are never upgraded.** A caller holding the old
|
|
145
|
+
instance keeps it forever; only *subsequent* `resolve()` calls see the new
|
|
146
|
+
one. Hot swap works for modules that are resolved through the runtime at use
|
|
147
|
+
time, not for ones captured once at startup.
|
|
148
|
+
|
|
149
|
+
3. **Only the default instance cache is affected.** `{ isolation: true }`
|
|
150
|
+
instances are never cached, so they can never be invalidated (each resolve is
|
|
151
|
+
already fresh). A caller-supplied `{ instances: map }` cache is the caller's
|
|
152
|
+
to clear.
|
|
153
|
+
|
|
154
|
+
4. **DOM bindings do not all self-heal.** `reactiveBind`'s `text` / `attr` /
|
|
155
|
+
`show` re-resolve their target node on every effect run and survive a
|
|
156
|
+
re-render; `cls` / `style` / `model` capture the element once at bind time
|
|
157
|
+
and keep writing into the detached old node after a swap. See
|
|
158
|
+
[`reactiveBind`](../api/dom/rendering/reactiveBind.md).
|
|
159
|
+
|
|
160
|
+
## What fw does **not** ship
|
|
161
|
+
|
|
162
|
+
**There is no watcher and no push channel.** Nothing in fw or in the repo's dev
|
|
163
|
+
server detects a file change or tells the browser about it. Driving
|
|
164
|
+
`invalidate()` is the host's job today: a dev tool, a devtools action, a console
|
|
165
|
+
call.
|
|
166
|
+
|
|
167
|
+
The transport primitives all exist and none is wired: `fs.watch` and
|
|
168
|
+
`Bun.serve`'s websocket support on the host side, fw's own
|
|
169
|
+
[`ws`](../api/dom/net/ws.md) / [`sse`](../api/dom/net/sse.md) client modules in
|
|
170
|
+
the page, and cache-busted dynamic `import()` to re-fetch changed bytes — the
|
|
171
|
+
last of which was measured in a real browser realm (both Chromium and Firefox,
|
|
172
|
+
plain and `sanity/base`-hardened, with a control proving the module map really
|
|
173
|
+
did cache) and works. Assembling them into a dev-only, flag-gated push channel
|
|
174
|
+
is **not delivered here** and belongs to the `tools` side of the toolchain.
|
|
175
|
+
|
|
176
|
+
Until then, for a full file-watch → reload loop, use a bundler's own HMR — see
|
|
177
|
+
[Bundler integration](./integration-bundlers.md).
|
|
178
|
+
|
|
179
|
+
## See also
|
|
180
|
+
|
|
181
|
+
- [`ModuleRuntime` API](../api/core/runtime.md) — `invalidate`, `register`,
|
|
182
|
+
`resolve`, `snapshot`
|
|
183
|
+
- [`signal`](../api/io/utils/signal.md) — why it is in the never-swap set
|
|
184
|
+
- [Bundler integration](./integration-bundlers.md) — the supported
|
|
185
|
+
file-watching path today
|
|
186
|
+
- [Module pattern](./module-pattern.md) — where to put state so it survives a
|
|
187
|
+
swap
|
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
# Integration with bundlers
|
|
2
|
+
|
|
3
|
+
`@awacloud/fw` works in two modes — pick the one that matches your project.
|
|
4
|
+
|
|
5
|
+
| Mode | Entry | Build needed | When to pick |
|
|
6
|
+
|---|---|---|---|
|
|
7
|
+
| **Autonomous** | `@awacloud/fw` (default) | No | Static `<script type="module">`, no toolchain. Ship the whole catalogue or a pre-built standalone bundle from `dist/build/`. |
|
|
8
|
+
| **Bundler-integrated** | `@awacloud/fw/vite` (virtual modules) **or** direct subpath imports | Yes (Vite / Webpack / Rollup / esbuild) | You compose the runtime selectively, tree-shake aggressively, ship multiple chunks. |
|
|
9
|
+
|
|
10
|
+
The two modes coexist — choose per-project, not per-package.
|
|
11
|
+
|
|
12
|
+
`main.js` exports the core symbols (`ENV`, `log`, `runtime`, `createWorker`,
|
|
13
|
+
`domReady`) **without** registering any module. The user wires modules
|
|
14
|
+
explicitly. That single rule is what makes both modes work from the same
|
|
15
|
+
entry.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Mode 1 — Autonomous (no build)
|
|
20
|
+
|
|
21
|
+
```html
|
|
22
|
+
<script type="module">
|
|
23
|
+
import fw from 'https://example.cdn/@awacloud/fw';
|
|
24
|
+
import modules from 'https://example.cdn/@awacloud/fw/core/modules.js';
|
|
25
|
+
|
|
26
|
+
fw.runtime.registerAll(modules);
|
|
27
|
+
|
|
28
|
+
fw.domReady.loaded(() => {
|
|
29
|
+
const hex = fw.runtime.resolve('hex');
|
|
30
|
+
console.log(hex.fromBytes(new Uint8Array([72, 105])));
|
|
31
|
+
});
|
|
32
|
+
</script>
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- `core/modules.js` has a single `default export [...]` listing every module.
|
|
36
|
+
No named exports — `import { sanitize } from '@awacloud/fw/core/modules'` is
|
|
37
|
+
**not** supported.
|
|
38
|
+
- `window.console` is replaced by the framework logger when `@awacloud/fw` is
|
|
39
|
+
imported (side-effect of `main.js` → `logger.main`) — in a browser. Under
|
|
40
|
+
bare Node (no `window`), the same import instead operates directly on
|
|
41
|
+
`globalThis.console` and skips the Proxy install, so a Node-side SSR/tooling
|
|
42
|
+
script can import `@awacloud/fw` without throwing.
|
|
43
|
+
- No tree-shaking — `registerAll(modules)` references every binding statically.
|
|
44
|
+
|
|
45
|
+
For zero-config consumers, a pre-built standalone is available at
|
|
46
|
+
`@awacloud/fw/dist/build/<preset>.js` (built by `tools/fw-bundler` (`bundle`)). Two variants exist
|
|
47
|
+
per preset :
|
|
48
|
+
|
|
49
|
+
| Variant | What it does | When |
|
|
50
|
+
|---|---|---|
|
|
51
|
+
| `pure` (default) | ESM only — `export { ENV, log, runtime, ... }`. | Modern apps, ESM consumers. |
|
|
52
|
+
| `classic` (opt-in per preset in `fw.config.json`) | ESM **plus** attaches `globalThis.fw = { ... }` for legacy `<script>` consumers. | Pages that mix module / non-module scripts. |
|
|
53
|
+
|
|
54
|
+
Beyond the curated presets, the synthetic `full` preset bundles **every**
|
|
55
|
+
module under `src/`. It is generated from the source-tree catalog at build
|
|
56
|
+
time — `fw.config.json` does not list it.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## Mode 2 — Vite (recommended)
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
npm i @awacloud/fw
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
```js
|
|
67
|
+
// vite.config.js
|
|
68
|
+
import { defineConfig } from 'vite';
|
|
69
|
+
import fw from '@awacloud/fw/vite';
|
|
70
|
+
|
|
71
|
+
export default defineConfig({
|
|
72
|
+
plugins: [
|
|
73
|
+
fw({
|
|
74
|
+
preset: 'site-interactive',
|
|
75
|
+
sideBundles: ['crypto-basic'],
|
|
76
|
+
sanity: 'base'
|
|
77
|
+
})
|
|
78
|
+
]
|
|
79
|
+
});
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
```js
|
|
83
|
+
// src/main.js
|
|
84
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
85
|
+
const hex = runtime.resolve('hex');
|
|
86
|
+
|
|
87
|
+
async function onLogin() {
|
|
88
|
+
const cryptoBasic = await import('virtual:@awacloud/fw/side-bundle/crypto-basic');
|
|
89
|
+
cryptoBasic.install(runtime);
|
|
90
|
+
const hmac = runtime.resolve('hmac');
|
|
91
|
+
// ...
|
|
92
|
+
}
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
The plugin reads `fw.config.json` (the single source of truth for
|
|
96
|
+
presets and side-bundles) so the bundler output stays in sync with the
|
|
97
|
+
autonomous build.
|
|
98
|
+
|
|
99
|
+
See [`integrations/vite/README.md`](../../integrations/vite/README.md) for the
|
|
100
|
+
full plugin reference.
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Mode 2 — Manual composition (any bundler)
|
|
105
|
+
|
|
106
|
+
A plugin equivalent to the Vite one is planned for Webpack / Rollup /
|
|
107
|
+
esbuild. Until then — and any time you want maximal tree-shaking — compose
|
|
108
|
+
the runtime by hand using **direct subpath imports** :
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
// src/main.js
|
|
112
|
+
import { ModuleRuntime } from '@awacloud/fw/core/runtime';
|
|
113
|
+
import { hex } from '@awacloud/fw/io/codec/hex.js';
|
|
114
|
+
import { b64 } from '@awacloud/fw/io/codec/b64.js';
|
|
115
|
+
import { utf8 } from '@awacloud/fw/io/codec/utf8.js';
|
|
116
|
+
import { url } from '@awacloud/fw/io/codec/url.js';
|
|
117
|
+
import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js';
|
|
118
|
+
|
|
119
|
+
export const runtime = new ModuleRuntime();
|
|
120
|
+
runtime.registerAllDeep([hex, b64, utf8, url, sanitize]);
|
|
121
|
+
// → Rollup/Webpack pull in parser.js, render.js, secPolicy.js automatically
|
|
122
|
+
// because each module's source file statically imports its siblings, and
|
|
123
|
+
// the `deps` array mirrors those imports for `registerDeep` to walk.
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Each subpath maps to `package.json#exports` :
|
|
127
|
+
|
|
128
|
+
| You import | Resolves to |
|
|
129
|
+
|------------------------------------------------|-----------------------------------|
|
|
130
|
+
| `@awacloud/fw/core/runtime` | `src/core/runtime.js` |
|
|
131
|
+
| `@awacloud/fw/io/codec/hex.js` | `src/io/codec/hex.js` |
|
|
132
|
+
| `@awacloud/fw/dom/rendering/sanitize.js` | `src/dom/rendering/sanitize.js` |
|
|
133
|
+
| `@awacloud/fw/crypto/hash/sha256.js` | `src/crypto/hash/sha256.js` |
|
|
134
|
+
| `@awacloud/fw/process/rpc.js` | `src/process/rpc.js` |
|
|
135
|
+
|
|
136
|
+
The `.js` extension is required for the `io/`, `dom/`, `crypto/`, `process/`
|
|
137
|
+
wildcard exports — drop it for the explicit `core/*` entries
|
|
138
|
+
(`@awacloud/fw/core/runtime`, `@awacloud/fw/core/logger`, …).
|
|
139
|
+
|
|
140
|
+
### Side-effecting modules
|
|
141
|
+
|
|
142
|
+
These paths have side effects (do **not** rely on tree-shaking to remove them) :
|
|
143
|
+
|
|
144
|
+
- `@awacloud/fw` (default entry — runs `logger.main` which replaces `window.console`)
|
|
145
|
+
- `@awacloud/fw/core/logger`
|
|
146
|
+
- `@awacloud/fw/dist/build/sanity-*-classic.min.js` (pre-built classic artifacts, self-applying on load)
|
|
147
|
+
- `@awacloud/fw/dist/build/*` (other pre-built standalone bundles)
|
|
148
|
+
|
|
149
|
+
Note: `@awacloud/fw/sanity/base` and `@awacloud/fw/sanity/community` are now **explicit-call ES modules** and are **not** side-effecting — they must be imported and called explicitly. The classic artifacts (`dist/build/sanity-*-classic.min.js`) are the pre-built side-applying variants.
|
|
150
|
+
|
|
151
|
+
`fwTurbopack()` computes its `resolveAlias` in memory; materialization
|
|
152
|
+
(`rmSync`+`mkdirSync`+writes into `outDir`, default `.fw-virtual` under
|
|
153
|
+
`process.cwd()`) happens lazily on first read of `resolveAlias` (property
|
|
154
|
+
access, `Object.keys`, spread) or via `materialize()`; pass an absolute
|
|
155
|
+
`outDir` you own. The other adapters (`vite`, `esbuild`, `rollup`, `webpack`,
|
|
156
|
+
`bun`) only read config.
|
|
157
|
+
|
|
158
|
+
---
|
|
159
|
+
|
|
160
|
+
## How tree-shaking actually works
|
|
161
|
+
|
|
162
|
+
Tree-shaking happens **at the preset / composition level**, not within a
|
|
163
|
+
preset. Once `registerAllDeep([a, b, c])` is reached, Rollup sees a static
|
|
164
|
+
reference to every binding in the array — it cannot drop `c` because
|
|
165
|
+
`runtime.resolve('c')` is never called downstream.
|
|
166
|
+
|
|
167
|
+
Three levels of granularity, from coarsest to finest :
|
|
168
|
+
|
|
169
|
+
| Pattern | What ends up in the bundle |
|
|
170
|
+
|---|---|
|
|
171
|
+
| `virtual:@awacloud/fw/preset/<name>` (Vite plugin) | The modules declared in the preset + their transitives via `deps`. **Tree-shaking is preset-vs-preset** — picking `core` instead of `spa` saves modules ; selecting a subset of `spa` does not. |
|
|
172
|
+
| Manual composition (direct subpath imports + `registerDeep`) | Only the modules you import + their transitives. **Maximal tree-shaking.** Recommended when bundle size matters. |
|
|
173
|
+
| `virtual:@awacloud/fw/preset/full` | Every module under `src/` (~180) + their transitives. Demo / audit / "see everything" — **not for production**. |
|
|
174
|
+
|
|
175
|
+
Inside any single level, the `deps` field on each module declares the direct
|
|
176
|
+
JS references its source file imports. `registerDeep` walks that graph
|
|
177
|
+
depth-first to guarantee dependencies are registered before their dependents
|
|
178
|
+
— it does **not** prune unused modules from the input array.
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## Conditional exports
|
|
183
|
+
|
|
184
|
+
The package declares `browser`, `worker`, `import`, and `default` conditions.
|
|
185
|
+
Bundlers pick the right path automatically :
|
|
186
|
+
|
|
187
|
+
- `"browser"` is preferred by Vite / Webpack / Rollup with the browser target.
|
|
188
|
+
- `"worker"` is matched by bundlers configured to build Web Workers.
|
|
189
|
+
- `"import"` is used by Node ESM.
|
|
190
|
+
- `"default"` is the fallback.
|
|
191
|
+
|
|
192
|
+
DOM-specific paths (`@awacloud/fw/dom/*`) carry a `browser` condition only — Node
|
|
193
|
+
consumers receive an `ERR_PACKAGE_PATH_NOT_EXPORTED` to fail fast.
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Per-integration HMR status
|
|
2
|
+
|
|
3
|
+
**No `@awacloud/fw` integration implements, forwards or performs incremental
|
|
4
|
+
Hot Module Replacement today.** What a page gets when it edits application
|
|
5
|
+
code is the host bundler's own HMR running over fw-produced output — that is
|
|
6
|
+
a real and useful guarantee, but it is the *bundler's*, not fw's. The one
|
|
7
|
+
exception, described below, is the Vite adapter's dev-only config/catalog
|
|
8
|
+
watcher, and even that forces a **full** browser reload rather than patching
|
|
9
|
+
a module in place.
|
|
10
|
+
|
|
11
|
+
For the runtime-level (bundler-independent) HMR question — whether fw's own
|
|
12
|
+
`ModuleRuntime` can re-register and re-render a changed module without a
|
|
13
|
+
bundler in the loop — see [`hmr.md`](./hmr.md); this page covers only what
|
|
14
|
+
each *integration* does with the host bundler's HMR channel.
|
|
15
|
+
|
|
16
|
+
## The count
|
|
17
|
+
|
|
18
|
+
`packages/front/fw/integrations/` has **15** subdirectories once the two
|
|
19
|
+
infrastructure directories are excluded:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
$ ls -d packages/front/fw/integrations/*/ | grep -v '/_'
|
|
23
|
+
astro/ bun/ deno/ esbuild/ eslint/ jest/ nestjs/ nextjs/ nodejs/ rollup/
|
|
24
|
+
turbopack/ typedoc/ vite/ vitest/ webpack/
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
(`_shared/` and `_e2e/` are internal infrastructure, not integrations.)
|
|
28
|
+
[`integrations/README.md`](../../integrations/README.md) previously listed 14
|
|
29
|
+
rows and omitted Turbopack — corrected there alongside this page.
|
|
30
|
+
|
|
31
|
+
## The measurement
|
|
32
|
+
|
|
33
|
+
A grep across `integrations/` (excluding `_e2e/` and `_shared/`, and read as
|
|
34
|
+
**real code lines only** — comments, docstrings and test-mock property names
|
|
35
|
+
excluded) for the token set that would mark an actual HMR hook —
|
|
36
|
+
`handleHotUpdate|hotUpdate|import\.meta\.hot|module\.hot|HotModuleReplacement|
|
|
37
|
+
invalidate|watchChange|onHotUpdate|accept\(` — returns exactly **one** hit:
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
vite/index.js:121: server.moduleGraph.invalidateAll();
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
That line is part of the Vite adapter's dev-only `configureServer` hook (see
|
|
44
|
+
below) — it forces a full reload, not incremental patching, and it is the
|
|
45
|
+
only place in `integrations/` where any of those tokens appears as executable
|
|
46
|
+
code. `integrations/_e2e/run.mjs:198` sets `hmr: false` on a test harness's
|
|
47
|
+
Vite server to *disable* HMR for that harness; it is not an implementation of
|
|
48
|
+
anything.
|
|
49
|
+
|
|
50
|
+
## Per-integration table
|
|
51
|
+
|
|
52
|
+
| Integration | Entry | HMR status today |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| [Vite](../../integrations/vite/README.md) | `vite/index.js:59` `fwVitePlugin` | Host Vite HMR applies to **application** files only — the plugin defines no `handleHotUpdate`, so the `virtual:@awacloud/fw/preset/*` and `…/side-bundle/*` modules are never incrementally patched. The dev-only `configureServer` hook (`vite/index.js:94-128`) watches `fw.config.json` and the committed catalog and, on change, reloads fw's cached config, calls `server.moduleGraph.invalidateAll()`, then sends `{ type: 'full-reload' }` — see "The Vite exception" below. |
|
|
55
|
+
| [Rollup](../../integrations/rollup/README.md) | `rollup/index.js:53` `fwRollup` | None — Rollup has no dev-server/HMR concept; no `watchChange` hook either. |
|
|
56
|
+
| [esbuild](../../integrations/esbuild/README.md) | `esbuild/index.js:102` `fwEsbuild` (plugin) + `esbuild/backend.js` (Node build backend, no dev server) | None. |
|
|
57
|
+
| [Bun](../../integrations/bun/README.md) | `bun/index.js:77` `fwBun` | None — consumer `Bun.build`/`plugin()` adapter, no dev-server hook. |
|
|
58
|
+
| [Webpack](../../integrations/webpack/README.md) | `webpack/index.js:74` `apply(compiler)` | None — no `HotModuleReplacementPlugin` wiring, no invalidation call. |
|
|
59
|
+
| [Astro](../../integrations/astro/README.md) | `astro/index.js:58` `fwAstro` | Inherits the Vite row — `astro:config:setup` re-injects the same Vite plugin, nothing HMR-specific added on top. |
|
|
60
|
+
| [Next.js](../../integrations/nextjs/README.md) | `nextjs/index.js:66` `withFw` | Next's Fast Refresh covers application code; the fw virtual/aliased modules are wired through the Webpack row (or Turbopack row, below) and are not separately hot-patched. |
|
|
61
|
+
| [Turbopack](../../integrations/turbopack/index.js) | `turbopack/index.js:61` `fwTurbopack` | None — Turbopack has no plugin API, so the adapter **materializes** the virtual modules to real files on disk (`.fw-virtual/` by default) at construction time; a config change needs re-materialization, not a hot patch. This is also the one integrations adapter that is **not** side-effect-free at construction (see [Bundler integration § Side-effecting modules](./integration-bundlers.md#side-effecting-modules)) — the other adapters in this table only read config. |
|
|
62
|
+
| [NestJS](../../integrations/nestjs/README.md) | `nestjs/index.js:63` `FwModule.forFeature` | N/A — backend DI wiring, no dev-server/browser HMR concept. |
|
|
63
|
+
| [Vitest](../../integrations/vitest/README.md) | `vitest/vitest.config.js`, `vitest/bun-test-shim.js` | N/A — test runner; its own watch mode re-runs tests, unrelated to module HMR. |
|
|
64
|
+
| [Jest](../../integrations/jest/README.md) | `jest/jest.config.mjs`, `jest/bun-test-shim.js` | N/A — test runner, no watch-mode HMR concept. |
|
|
65
|
+
| [TypeDoc](../../integrations/typedoc/README.md) | `typedoc/typedoc.json`, `typedoc/categorize.js` | N/A — static HTML doc generation, one-shot. |
|
|
66
|
+
| [ESLint](../../integrations/eslint/README.md) | `eslint/no-factory-capture.js` | N/A — lint rule, no runtime/dev-server surface. |
|
|
67
|
+
| [Node.js](../../integrations/nodejs/README.md) | runtime target, not a plugin | N/A — documented compat target; HMR is a bundler/dev-server concern this target doesn't have. |
|
|
68
|
+
| [Deno](../../integrations/deno/README.md) | runtime target, not a plugin | N/A — same as Node.js. |
|
|
69
|
+
|
|
70
|
+
## The Vite exception, precisely
|
|
71
|
+
|
|
72
|
+
Task 04 of this batch closed a real gap: before it, editing `fw.config.json`
|
|
73
|
+
or regenerating the committed module catalog while `vite dev` was running
|
|
74
|
+
required killing and restarting the dev server for the change to take
|
|
75
|
+
effect, because the plugin's internal state was built once at construction
|
|
76
|
+
and never re-read. The fix adds a dev-only `configureServer` hook that
|
|
77
|
+
watches both files and, on a change, re-validates and swaps the cached
|
|
78
|
+
state, invalidates the previously-resolved virtual modules, and sends a
|
|
79
|
+
`full-reload` signal over Vite's HMR channel so the browser refetches the
|
|
80
|
+
new graph. Full details and the exact watched-file set:
|
|
81
|
+
[`integrations/vite/README.md`](../../integrations/vite/README.md#notes).
|
|
82
|
+
|
|
83
|
+
This is **not** incremental HMR: the plugin's own code comment states the
|
|
84
|
+
reason directly — the virtual modules are whole-graph structural output ("an
|
|
85
|
+
entirely different `import` list per preset/side-bundle"), not a value HMR
|
|
86
|
+
can patch in place, so the correct response to a config/catalog change is a
|
|
87
|
+
full reload, not a partial one. It is, however, the one place in
|
|
88
|
+
`integrations/` where fw code calls into Vite's HMR API
|
|
89
|
+
(`moduleGraph.invalidateAll()`, `server.hot.send(...)`) — worth naming
|
|
90
|
+
precisely rather than folding into the flat "no integration touches HMR"
|
|
91
|
+
statement above. `vite build` never calls `configureServer`, so none of this
|
|
92
|
+
affects production output.
|
|
93
|
+
|
|
94
|
+
## See also
|
|
95
|
+
|
|
96
|
+
- [`hmr.md`](./hmr.md) — the native, bundler-independent HMR question (fw's
|
|
97
|
+
own `ModuleRuntime` re-register/re-resolve story).
|
|
98
|
+
- [Bundler integration](./integration-bundlers.md) — modes, tree-shaking,
|
|
99
|
+
side-effecting modules (including Turbopack's construction-time write).
|
|
100
|
+
- [`integrations/README.md`](../../integrations/README.md) — the integration
|
|
101
|
+
catalogue this page's table is a detail view of.
|
|
102
|
+
- [`integrations/vite/README.md`](../../integrations/vite/README.md) — full
|
|
103
|
+
Vite plugin reference, including the config/catalog reload notes.
|