@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,929 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/src/core/runtime.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Minimal dependency-injection runtime for the framework's module
|
|
8
|
+
* system, with native multi-version support.
|
|
9
|
+
*
|
|
10
|
+
* A **module** is a plain object with these fields:
|
|
11
|
+
* ```js
|
|
12
|
+
* {
|
|
13
|
+
* name : string, // unique identifier
|
|
14
|
+
* version? : string, // semver - defaults to '0.0.0' when absent
|
|
15
|
+
* type? : string, // taxonomy - must match /^(fw|sde|lib)\.[a-z][\w.]*$/ when present
|
|
16
|
+
* dependencies : string[], // names (or 'name@version' specs) of required modules
|
|
17
|
+
* factory : function, // called with resolved dependency instances as args
|
|
18
|
+
* }
|
|
19
|
+
* ```
|
|
20
|
+
*
|
|
21
|
+
* Multiple versions of the same module name can coexist. `resolve('foo')` returns
|
|
22
|
+
* the highest semver version registered ; `resolve('foo', { version: '1.2.3' })`
|
|
23
|
+
* or the canonical spec `resolve('foo@1.2.3')` returns an exact version.
|
|
24
|
+
*
|
|
25
|
+
* The "highest version" pointer is precomputed at register time, so version-less
|
|
26
|
+
* resolves remain O(1).
|
|
27
|
+
*
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* Strict semver core regex (major.minor.patch with optional pre-release/build).
|
|
32
|
+
* @private
|
|
33
|
+
*/
|
|
34
|
+
const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[\w.-]+)?(?:\+[\w.-]+)?$/;
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Type taxonomy regex : `fw.<sub>`, `sd.<sub>`, `sde.<sub>`, `sdc.<sub>`, `lib.<sub>`.
|
|
38
|
+
*
|
|
39
|
+
* - `fw.*` : framework modules (`@awacloud/fw`).
|
|
40
|
+
* - `sd.*` : shared SDE/SDC modules (`@awacloud/sd-common`).
|
|
41
|
+
* - `sde.*` : multi-app desktop specifics (`@awacloud/sde-core`).
|
|
42
|
+
* - `sdc.*` : mono-app container specifics (`@awacloud/sdc-core`).
|
|
43
|
+
* - `lib.*` : standalone libraries (e.g. `lib.video_codec`).
|
|
44
|
+
*
|
|
45
|
+
* @private
|
|
46
|
+
*/
|
|
47
|
+
const TYPE_RE = /^(fw|sd|sde|sdc|lib)\.[a-z][\w.]*$/;
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Default version when a module descriptor omits `version`.
|
|
51
|
+
* @private
|
|
52
|
+
*/
|
|
53
|
+
const DEFAULT_VERSION = '0.0.0';
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Compare two semver strings.
|
|
57
|
+
*
|
|
58
|
+
* Implements the ordering :
|
|
59
|
+
* - numeric major.minor.patch
|
|
60
|
+
* - any pre-release < no pre-release (1.0.0-beta < 1.0.0)
|
|
61
|
+
* - pre-release sorted lexicographically (1.0.0-alpha < 1.0.0-beta)
|
|
62
|
+
*
|
|
63
|
+
* Sufficient for picking the highest version at register time. For range
|
|
64
|
+
* matching (`^`, `~`, `>=`), use the standalone `semver` module.
|
|
65
|
+
*
|
|
66
|
+
* @param {string} a Semver string.
|
|
67
|
+
* @param {string} b Semver string.
|
|
68
|
+
* @returns {number} -1 if a < b, 0 if equal, 1 if a > b.
|
|
69
|
+
* @private
|
|
70
|
+
*/
|
|
71
|
+
function semverCompare(a, b) {
|
|
72
|
+
const [coreA, preA = ''] = a.split('-', 2);
|
|
73
|
+
const [coreB, preB = ''] = b.split('-', 2);
|
|
74
|
+
const partsA = coreA.split('.');
|
|
75
|
+
const partsB = coreB.split('.');
|
|
76
|
+
for (let i = 0; i < 3; i++) {
|
|
77
|
+
const na = +partsA[i] || 0;
|
|
78
|
+
const nb = +partsB[i] || 0;
|
|
79
|
+
if (na !== nb) return na < nb ? -1 : 1;
|
|
80
|
+
}
|
|
81
|
+
// pre-release < release
|
|
82
|
+
if (preA && !preB) return -1;
|
|
83
|
+
if (!preA && preB) return 1;
|
|
84
|
+
if (preA === preB) return 0;
|
|
85
|
+
return preA < preB ? -1 : 1;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Parse a module spec string : `'name'` or `'name@version'`.
|
|
90
|
+
*
|
|
91
|
+
* Splits on the **last** `@` so module names containing `@` (rare) are handled
|
|
92
|
+
* correctly when the version is appended.
|
|
93
|
+
*
|
|
94
|
+
* @param {string} spec Module spec.
|
|
95
|
+
* @returns {{name: string, version: string|undefined}}
|
|
96
|
+
* @private
|
|
97
|
+
*/
|
|
98
|
+
function parseSpec(spec) {
|
|
99
|
+
const at = spec.lastIndexOf('@');
|
|
100
|
+
if (at <= 0) return { name: spec, version: undefined };
|
|
101
|
+
return { name: spec.slice(0, at), version: spec.slice(at + 1) };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* Build the canonical key `name@version`.
|
|
106
|
+
*
|
|
107
|
+
* @param {string} name
|
|
108
|
+
* @param {string} version
|
|
109
|
+
* @returns {string}
|
|
110
|
+
* @private
|
|
111
|
+
*/
|
|
112
|
+
function canonical(name, version) {
|
|
113
|
+
return name + '@' + version;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* A module definition object.
|
|
118
|
+
*
|
|
119
|
+
* @typedef {Object} ModuleDefinition
|
|
120
|
+
* @property {string} name - Unique module identifier.
|
|
121
|
+
* @property {string} [version] - Semver string. Defaults to '0.0.0'.
|
|
122
|
+
* @property {string} [type] - Hierarchical type (e.g. 'fw.io.codec').
|
|
123
|
+
* @property {string[]} dependencies - Ordered list of dependency specs
|
|
124
|
+
* ('name' or 'name@version').
|
|
125
|
+
* @property {ModuleDefinition[]} [deps] - Optional direct JS references to the
|
|
126
|
+
* dependency modules, in the same order
|
|
127
|
+
* as `dependencies`. Bundler-facing only :
|
|
128
|
+
* lets tree-shaking tools trace the graph
|
|
129
|
+
* through static imports. Walked by
|
|
130
|
+
* `registerDeep` / `registerAllDeep`.
|
|
131
|
+
* @property {Function} factory - Factory function invoked with resolved
|
|
132
|
+
* dependency instances as arguments.
|
|
133
|
+
*/
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Public instance type produced by a module's `factory` — i.e. what
|
|
137
|
+
* `runtime.resolve('<name>')` returns for that module. Given a module value
|
|
138
|
+
* `M`, `InstanceOf<typeof M>` is `ReturnType<M['factory']>`. See the typed
|
|
139
|
+
* runtime facade (`@awacloud/fw/typed`) and `docs/guide/typescript.md` for usage.
|
|
140
|
+
*
|
|
141
|
+
* @template {{ factory: (...args: any[]) => any }} M
|
|
142
|
+
* @typedef {ReturnType<M['factory']>} InstanceOf
|
|
143
|
+
*/
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* Per-name registry entry holding all known versions of a module.
|
|
147
|
+
*
|
|
148
|
+
* @typedef {Object} ModuleEntry
|
|
149
|
+
* @property {Map<string, ModuleDefinition>} versions - Map of version → definition.
|
|
150
|
+
* @property {string} latest - Highest semver version present.
|
|
151
|
+
* @property {ModuleDefinition} latestDef - Cached pointer to the latest def.
|
|
152
|
+
*/
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* Options accepted by {@link ModuleRuntime#resolve} and
|
|
156
|
+
* {@link ModuleRuntime#resolveAll}.
|
|
157
|
+
*
|
|
158
|
+
* @typedef {Object} ResolveOptions
|
|
159
|
+
* @property {boolean} [isolation] - When truthy the instance is **not** cached.
|
|
160
|
+
* @property {string} [version] - Explicit version. Ignored if `spec` already
|
|
161
|
+
* contains `@version`.
|
|
162
|
+
* @property {Map} [instances] - Custom instance map (flat, keyed by canonical
|
|
163
|
+
* `name@version`).
|
|
164
|
+
*/
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* Filter passed to {@link ModuleRuntime#list}.
|
|
168
|
+
*
|
|
169
|
+
* @typedef {Object} ListFilter
|
|
170
|
+
* @property {string} [name] - Exact module name.
|
|
171
|
+
* @property {string} [version] - Exact version.
|
|
172
|
+
* @property {string} [type] - Exact type, or prefix when ending with `.`
|
|
173
|
+
* (e.g. `'fw.io.'` matches `'fw.io.codec'`).
|
|
174
|
+
*/
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* One frozen registry row returned by {@link ModuleRuntime#snapshot}.
|
|
178
|
+
*
|
|
179
|
+
* Pure **metadata** — it carries no `factory`, no `deps` reference and no
|
|
180
|
+
* instance. Every field is a primitive or a frozen copy, so the row is inert:
|
|
181
|
+
* holding it grants no way to write back into the registry.
|
|
182
|
+
*
|
|
183
|
+
* @typedef {Object} RegistrySnapshotEntry
|
|
184
|
+
* @property {string} name - Registered module name.
|
|
185
|
+
* @property {string} version - Resolved version ('0.0.0' when the
|
|
186
|
+
* descriptor omitted `version`).
|
|
187
|
+
* @property {string|null} type - Declared taxonomy type, or `null`.
|
|
188
|
+
* @property {ReadonlyArray<string>} dependencies - Frozen copy of the declared
|
|
189
|
+
* dependency specs (never the live array).
|
|
190
|
+
* @property {boolean} latest - `true` when this version is the one a
|
|
191
|
+
* version-less `resolve(name)` would pick.
|
|
192
|
+
* @property {boolean} instantiated - `true` when an instance for this
|
|
193
|
+
* `(name, version)` is already in the
|
|
194
|
+
* default cache. Read-only observation —
|
|
195
|
+
* reading it never instantiates anything.
|
|
196
|
+
*/
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Options accepted by {@link ModuleRuntime#invalidate}.
|
|
200
|
+
*
|
|
201
|
+
* @typedef {Object} InvalidateOptions
|
|
202
|
+
* @property {boolean} [cascade] - When truthy, also invalidate every module
|
|
203
|
+
* that declares the target among its
|
|
204
|
+
* `dependencies`, transitively. Dependents,
|
|
205
|
+
* not dependencies: what a swapped module
|
|
206
|
+
* breaks is the things built on top of it.
|
|
207
|
+
*/
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* Result returned by {@link ModuleRuntime#invalidate}.
|
|
211
|
+
*
|
|
212
|
+
* @typedef {Object} InvalidateResult
|
|
213
|
+
* @property {ReadonlyArray<string>} invalidated - Canonical `name@version` keys
|
|
214
|
+
* whose cached instance was actually dropped. A target that was never
|
|
215
|
+
* instantiated contributes nothing, so an empty array means "nothing was
|
|
216
|
+
* cached", never "nothing matched" — an unknown module throws instead.
|
|
217
|
+
* @property {Object<string, *>} state - Frozen map of canonical key → the value
|
|
218
|
+
* returned by the outgoing instance's `dehydrate()`, for the targets that
|
|
219
|
+
* opted into the convention. Keys absent from it did not implement
|
|
220
|
+
* `dehydrate`. The values themselves are whatever the module returned and
|
|
221
|
+
* are **not** deep-frozen.
|
|
222
|
+
*/
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Result returned by {@link ModuleRuntime#serialize}.
|
|
226
|
+
*
|
|
227
|
+
* @typedef {Object} SerializedGraph
|
|
228
|
+
* @property {string} list - JS array literal of canonical names :
|
|
229
|
+
* `"['hex@1.0.0','uuid@2.0.0']"`.
|
|
230
|
+
* @property {string} content - JS array literal of fully serialised module objects,
|
|
231
|
+
* ready to be evaluated and registered inside a Worker.
|
|
232
|
+
*/
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Lightweight dependency-injection runtime with native multi-version support.
|
|
236
|
+
*
|
|
237
|
+
* Modules are registered once and resolved lazily. `resolve('name')` returns the
|
|
238
|
+
* highest-semver version ; `resolve('name@1.2.3')` or `resolve('name', {version})`
|
|
239
|
+
* returns an exact one. Instances are cached by `(name, version)`.
|
|
240
|
+
*
|
|
241
|
+
* The `context` property is reserved for the Worker bootstrap : `worker-helper.js`
|
|
242
|
+
* assigns the worker framework's public API to it after the worker starts.
|
|
243
|
+
*/
|
|
244
|
+
export class ModuleRuntime {
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* Pinned "never swap" set — module names {@link ModuleRuntime#invalidate}
|
|
248
|
+
* refuses to touch, directly or through a cascade.
|
|
249
|
+
*
|
|
250
|
+
* `signal` is on it because its effect tracking is **per-factory-instance**:
|
|
251
|
+
* dropping its cached instance would leave every already-created signal,
|
|
252
|
+
* derived and effect bound to the previous factory instance while new reads
|
|
253
|
+
* register against the new one, so effects silently stop firing. That is a
|
|
254
|
+
* whole-application breakage with no error to point at, which is exactly the
|
|
255
|
+
* class of failure a hot-reload seam must not be able to cause.
|
|
256
|
+
*
|
|
257
|
+
* The set is **pinned**, not configurable: a per-runtime opt-out would make
|
|
258
|
+
* the guarantee negotiable at the call site, which is where the mistake
|
|
259
|
+
* happens. Widening it is a source change, reviewed like any other.
|
|
260
|
+
*
|
|
261
|
+
* @type {ReadonlyArray<string>}
|
|
262
|
+
*/
|
|
263
|
+
static NEVER_SWAP = Object.freeze(['signal']);
|
|
264
|
+
|
|
265
|
+
constructor() {
|
|
266
|
+
/** @type {Map<string, ModuleEntry>} Registered module entries (one per name). */
|
|
267
|
+
this.modules = new Map();
|
|
268
|
+
|
|
269
|
+
/** @type {Map<string, Map<string, *>>} Instance cache : name → version → instance. */
|
|
270
|
+
this.instances = new Map();
|
|
271
|
+
|
|
272
|
+
/**
|
|
273
|
+
* Reserved for the Worker bootstrap - populated by `worker-helper.js`.
|
|
274
|
+
* @type {Object}
|
|
275
|
+
*/
|
|
276
|
+
this.context = {}; // reserved for worker
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* Register a module definition.
|
|
281
|
+
*
|
|
282
|
+
* Validates `name`, `factory`, `version` (semver, defaults to '0.0.0') and
|
|
283
|
+
* `type` (taxonomy regex, optional). Registering the same `(name, version)`
|
|
284
|
+
* pair overwrites the previous definition. Multiple versions of the same
|
|
285
|
+
* `name` coexist.
|
|
286
|
+
*
|
|
287
|
+
* @param {ModuleDefinition} module
|
|
288
|
+
* @throws {Error} On invalid name, factory, version or type.
|
|
289
|
+
* @returns {this} Chainable.
|
|
290
|
+
*/
|
|
291
|
+
register(module) {
|
|
292
|
+
if (!module || !module.name || !module.factory) {
|
|
293
|
+
throw new Error('Invalid module definition');
|
|
294
|
+
}
|
|
295
|
+
const version = (module.version != null) ? module.version : DEFAULT_VERSION;
|
|
296
|
+
if (!SEMVER_RE.test(version)) {
|
|
297
|
+
throw new Error(`Invalid version "${version}" for module "${module.name}"`);
|
|
298
|
+
}
|
|
299
|
+
if (module.type != null && !TYPE_RE.test(module.type)) {
|
|
300
|
+
throw new Error(`Invalid type "${module.type}" for module "${module.name}"`);
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
let entry = this.modules.get(module.name);
|
|
304
|
+
if (!entry) {
|
|
305
|
+
entry = { versions: new Map(), latest: version, latestDef: module };
|
|
306
|
+
this.modules.set(module.name, entry);
|
|
307
|
+
}
|
|
308
|
+
entry.versions.set(version, module);
|
|
309
|
+
// Recompute latest only when the new version sorts strictly higher.
|
|
310
|
+
if (semverCompare(version, entry.latest) >= 0) {
|
|
311
|
+
entry.latest = version;
|
|
312
|
+
entry.latestDef = module;
|
|
313
|
+
}
|
|
314
|
+
return this;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/**
|
|
318
|
+
* Register an array of module descriptors. Equivalent to calling
|
|
319
|
+
* `register()` for each entry; returns `this` for chaining.
|
|
320
|
+
* @param {ModuleDefinition[]} modules
|
|
321
|
+
* @returns {ModuleRuntime}
|
|
322
|
+
*/
|
|
323
|
+
registerAll(modules) {
|
|
324
|
+
for (const m of modules) this.register(m);
|
|
325
|
+
return this;
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
/**
|
|
329
|
+
* Register a module along with all its transitive `deps` — the optional
|
|
330
|
+
* bundler-friendly companion of `dependencies`.
|
|
331
|
+
*
|
|
332
|
+
* A module may carry a `deps` array of **direct JS references** to its
|
|
333
|
+
* dependency modules (imported statically by the module's source file).
|
|
334
|
+
* `registerDeep` walks that graph depth-first and registers each missing
|
|
335
|
+
* module on the way back up, so dependencies are always registered
|
|
336
|
+
* before their dependents — the correct order for `resolve`.
|
|
337
|
+
*
|
|
338
|
+
* `deps` is purely a build-time / bundler concern : it lets tree-shaking
|
|
339
|
+
* bundlers (Vite / Rollup / Webpack / esbuild) trace the module graph
|
|
340
|
+
* from JS `import` statements while keeping `dependencies` (strings,
|
|
341
|
+
* possibly with `name@version` specs) as the runtime resolution
|
|
342
|
+
* contract. Workers receive only the canonical `dependencies` form via
|
|
343
|
+
* {@link ModuleRuntime#serialize}, so `deps` is not transferred — that
|
|
344
|
+
* is fine, the worker-side closure has already been computed.
|
|
345
|
+
*
|
|
346
|
+
* Idempotent : already-registered modules are skipped. Cycle-safe via
|
|
347
|
+
* a per-call visited set keyed on module name.
|
|
348
|
+
*
|
|
349
|
+
* **Invariant** (validated at build time) :
|
|
350
|
+
* `module.deps.map(d => d.name)` === `module.dependencies.map(s => s.split('@')[0])`
|
|
351
|
+
*
|
|
352
|
+
* @param {ModuleDefinition & {deps?: ModuleDefinition[]}} module
|
|
353
|
+
* @returns {this} Chainable.
|
|
354
|
+
*/
|
|
355
|
+
registerDeep(module) {
|
|
356
|
+
const seen = new Set();
|
|
357
|
+
const visit = (m) => {
|
|
358
|
+
if (!m || typeof m !== 'object' || !m.name || !m.factory) return;
|
|
359
|
+
if (seen.has(m.name)) return;
|
|
360
|
+
seen.add(m.name);
|
|
361
|
+
if (Array.isArray(m.deps)) {
|
|
362
|
+
for (const d of m.deps) visit(d);
|
|
363
|
+
}
|
|
364
|
+
const version = (m.version != null) ? m.version : DEFAULT_VERSION;
|
|
365
|
+
if (!this.has(m.name, version)) this.register(m);
|
|
366
|
+
};
|
|
367
|
+
visit(module);
|
|
368
|
+
return this;
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
/**
|
|
372
|
+
* Equivalent to calling {@link ModuleRuntime#registerDeep} for each entry,
|
|
373
|
+
* sharing a single visited set across the batch so common transitive
|
|
374
|
+
* dependencies are walked only once.
|
|
375
|
+
*
|
|
376
|
+
* @param {Array<ModuleDefinition & {deps?: ModuleDefinition[]}>} modules
|
|
377
|
+
* @returns {this} Chainable.
|
|
378
|
+
*/
|
|
379
|
+
registerAllDeep(modules) {
|
|
380
|
+
for (const m of modules) this.registerDeep(m);
|
|
381
|
+
return this;
|
|
382
|
+
}
|
|
383
|
+
|
|
384
|
+
/**
|
|
385
|
+
* Unregister a module definition. **Does not touch the instance cache** -
|
|
386
|
+
* already-resolved instances held by callers continue to function ; only
|
|
387
|
+
* subsequent `resolve` calls for the removed module(s) will throw.
|
|
388
|
+
*
|
|
389
|
+
* **Spec / version semantics (mirrors `has`) :**
|
|
390
|
+
* - `unregister('foo')` → remove **all** versions of `foo`
|
|
391
|
+
* - `unregister('foo', '1.0.0')` or `unregister('foo@1.0.0')` → remove only that version
|
|
392
|
+
*
|
|
393
|
+
* When the removed version is the current `latest`, the entry's `latest`
|
|
394
|
+
* pointer is recomputed from the remaining versions. When the last version
|
|
395
|
+
* of a name is removed, the entry itself is deleted.
|
|
396
|
+
*
|
|
397
|
+
* @param {string} spec Module name, or `'name@version'`.
|
|
398
|
+
* @param {string} [version] Explicit version (ignored if `spec` already contains `@`).
|
|
399
|
+
* @returns {boolean} `true` if at least one definition was removed.
|
|
400
|
+
*/
|
|
401
|
+
unregister(spec, version) {
|
|
402
|
+
const parsed = parseSpec(spec);
|
|
403
|
+
const name = parsed.name;
|
|
404
|
+
const ver = parsed.version || version;
|
|
405
|
+
|
|
406
|
+
const entry = this.modules.get(name);
|
|
407
|
+
if (!entry) return false;
|
|
408
|
+
|
|
409
|
+
if (ver === undefined) {
|
|
410
|
+
// Remove all versions for this name.
|
|
411
|
+
this.modules.delete(name);
|
|
412
|
+
return true;
|
|
413
|
+
}
|
|
414
|
+
|
|
415
|
+
if (!entry.versions.has(ver)) return false;
|
|
416
|
+
entry.versions.delete(ver);
|
|
417
|
+
|
|
418
|
+
if (entry.versions.size === 0) {
|
|
419
|
+
this.modules.delete(name);
|
|
420
|
+
return true;
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
// Recompute `latest` only when the removed version was the latest.
|
|
424
|
+
if (ver === entry.latest) {
|
|
425
|
+
let bestVer = null;
|
|
426
|
+
let bestDef = null;
|
|
427
|
+
for (const [v, d] of entry.versions) {
|
|
428
|
+
if (bestVer === null || semverCompare(v, bestVer) > 0) {
|
|
429
|
+
bestVer = v;
|
|
430
|
+
bestDef = d;
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
entry.latest = bestVer;
|
|
434
|
+
entry.latestDef = bestDef;
|
|
435
|
+
}
|
|
436
|
+
|
|
437
|
+
return true;
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
/**
|
|
441
|
+
* Check whether a module (or a specific version) is registered.
|
|
442
|
+
*
|
|
443
|
+
* @param {string} name
|
|
444
|
+
* @param {string} [version] When omitted, returns true if any version of `name` exists.
|
|
445
|
+
* @returns {boolean}
|
|
446
|
+
*/
|
|
447
|
+
has(name, version) {
|
|
448
|
+
const entry = this.modules.get(name);
|
|
449
|
+
if (!entry) return false;
|
|
450
|
+
if (version === undefined) return true;
|
|
451
|
+
return entry.versions.has(version);
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
/**
|
|
455
|
+
* Resolve a module by spec.
|
|
456
|
+
*
|
|
457
|
+
* **Spec forms :**
|
|
458
|
+
* - `'foo'` → highest version registered for `foo`
|
|
459
|
+
* - `'foo@1.2.3'` → exact version
|
|
460
|
+
* - `'foo'` + `{ version: '1.2.3' }` → exact version
|
|
461
|
+
*
|
|
462
|
+
* **Caching :**
|
|
463
|
+
* - default : singleton per `(name, version)` in `this.instances`.
|
|
464
|
+
* - `{ isolation: true }` : never cache, always fresh.
|
|
465
|
+
* - `{ instances: customMap }` : flat map keyed by canonical `name@version`.
|
|
466
|
+
*
|
|
467
|
+
* Dependencies are resolved transitively with the same options.
|
|
468
|
+
*
|
|
469
|
+
* @param {string} spec
|
|
470
|
+
* @param {ResolveOptions} [options={}]
|
|
471
|
+
* @throws {Error} When the module (or version) is not registered.
|
|
472
|
+
* @returns {*}
|
|
473
|
+
*/
|
|
474
|
+
resolve(spec, options = {}) {
|
|
475
|
+
const parsed = parseSpec(spec);
|
|
476
|
+
const name = parsed.name;
|
|
477
|
+
const explicit = parsed.version || options.version;
|
|
478
|
+
|
|
479
|
+
const entry = this.modules.get(name);
|
|
480
|
+
if (!entry) throw new Error(`Module not found: ${name}`);
|
|
481
|
+
|
|
482
|
+
let def, version;
|
|
483
|
+
if (explicit !== undefined) {
|
|
484
|
+
def = entry.versions.get(explicit);
|
|
485
|
+
if (!def) throw new Error(`Module not found: ${name}@${explicit}`);
|
|
486
|
+
version = explicit;
|
|
487
|
+
} else {
|
|
488
|
+
def = entry.latestDef;
|
|
489
|
+
version = entry.latest;
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
const isolation = !!options.isolation;
|
|
493
|
+
const customMap = (options.instances instanceof Map) ? options.instances : null;
|
|
494
|
+
|
|
495
|
+
// Cache lookup.
|
|
496
|
+
if (!isolation) {
|
|
497
|
+
if (customMap) {
|
|
498
|
+
const key = canonical(name, version);
|
|
499
|
+
if (customMap.has(key)) return customMap.get(key);
|
|
500
|
+
} else {
|
|
501
|
+
const versionsCache = this.instances.get(name);
|
|
502
|
+
if (versionsCache && versionsCache.has(version)) {
|
|
503
|
+
return versionsCache.get(version);
|
|
504
|
+
}
|
|
505
|
+
}
|
|
506
|
+
}
|
|
507
|
+
|
|
508
|
+
// Resolve dependencies (recursive).
|
|
509
|
+
const deps = (def.dependencies || []).map(d => this.resolve(d, options));
|
|
510
|
+
const instance = def.factory.apply({}, deps);
|
|
511
|
+
|
|
512
|
+
// Cache write.
|
|
513
|
+
if (!isolation) {
|
|
514
|
+
if (customMap) {
|
|
515
|
+
customMap.set(canonical(name, version), instance);
|
|
516
|
+
} else {
|
|
517
|
+
let versionsCache = this.instances.get(name);
|
|
518
|
+
if (!versionsCache) {
|
|
519
|
+
versionsCache = new Map();
|
|
520
|
+
this.instances.set(name, versionsCache);
|
|
521
|
+
}
|
|
522
|
+
versionsCache.set(version, instance);
|
|
523
|
+
}
|
|
524
|
+
}
|
|
525
|
+
return instance;
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
/**
|
|
529
|
+
* Resolve multiple module specs in a single call.
|
|
530
|
+
*
|
|
531
|
+
* Each result key is the original spec string (preserving any `@version`
|
|
532
|
+
* suffix), so `resolveAll(['hex', 'utf8@1.0.0'])` yields
|
|
533
|
+
* `{ hex: <inst>, 'utf8@1.0.0': <inst> }`.
|
|
534
|
+
*
|
|
535
|
+
* @param {string[]} specs
|
|
536
|
+
* @param {ResolveOptions} [options={}]
|
|
537
|
+
* @returns {Object<string, *>}
|
|
538
|
+
*/
|
|
539
|
+
resolveAll(specs, options = {}) {
|
|
540
|
+
const result = {};
|
|
541
|
+
for (const spec of specs) {
|
|
542
|
+
result[spec] = this.resolve(spec, options);
|
|
543
|
+
}
|
|
544
|
+
return result;
|
|
545
|
+
}
|
|
546
|
+
|
|
547
|
+
/**
|
|
548
|
+
* List registered module definitions matching the given filter.
|
|
549
|
+
*
|
|
550
|
+
* Linear scan ; acceptable for the typical module count (≪ 1000).
|
|
551
|
+
*
|
|
552
|
+
* @param {ListFilter} [filter={}]
|
|
553
|
+
* @returns {ModuleDefinition[]}
|
|
554
|
+
*/
|
|
555
|
+
list(filter = {}) {
|
|
556
|
+
const out = [];
|
|
557
|
+
const fName = filter.name;
|
|
558
|
+
const fVer = filter.version;
|
|
559
|
+
const fType = filter.type;
|
|
560
|
+
const typePrefix = (typeof fType === 'string') && fType.endsWith('.');
|
|
561
|
+
|
|
562
|
+
for (const [name, entry] of this.modules) {
|
|
563
|
+
if (fName && fName !== name) continue;
|
|
564
|
+
for (const [version, def] of entry.versions) {
|
|
565
|
+
if (fVer && fVer !== version) continue;
|
|
566
|
+
if (fType) {
|
|
567
|
+
if (!def.type) continue;
|
|
568
|
+
if (typePrefix) {
|
|
569
|
+
if (!def.type.startsWith(fType)) continue;
|
|
570
|
+
} else {
|
|
571
|
+
if (def.type !== fType) continue;
|
|
572
|
+
}
|
|
573
|
+
}
|
|
574
|
+
out.push(def);
|
|
575
|
+
}
|
|
576
|
+
}
|
|
577
|
+
return out;
|
|
578
|
+
}
|
|
579
|
+
|
|
580
|
+
/**
|
|
581
|
+
* Passive, read-only view of the module registry.
|
|
582
|
+
*
|
|
583
|
+
* Companion of {@link ModuleRuntime#list}, which returns the **live**
|
|
584
|
+
* `ModuleDefinition` objects (their `factory`, and a `dependencies` array a
|
|
585
|
+
* caller can splice in place). `snapshot` instead returns frozen metadata
|
|
586
|
+
* rows: enumeration for a devtools registry view without handing out a
|
|
587
|
+
* write channel into registry state, and without the side effect of
|
|
588
|
+
* `resolve()` — which is a full instantiate, not a peek.
|
|
589
|
+
*
|
|
590
|
+
* **Guarantees**
|
|
591
|
+
* - **Instantiates nothing.** No `factory` is invoked and `this.instances`
|
|
592
|
+
* is never written; a call on a registry where nothing has been resolved
|
|
593
|
+
* leaves the instance cache exactly as it was.
|
|
594
|
+
* - **Read-only.** The returned array is frozen, every row is frozen, and
|
|
595
|
+
* each row's `dependencies` is a frozen *copy* — mutating anything the
|
|
596
|
+
* caller receives cannot reach the registry.
|
|
597
|
+
* - **No live handle.** Rows expose no `factory`, no `deps` and no
|
|
598
|
+
* instance, so nothing reachable from a row can be called or patched.
|
|
599
|
+
*
|
|
600
|
+
* The filter is the same one {@link ModuleRuntime#list} accepts, with the
|
|
601
|
+
* same semantics (exact `name` / `version`; exact `type`, or prefix match
|
|
602
|
+
* when `type` ends with `.`).
|
|
603
|
+
*
|
|
604
|
+
* Linear scan over the registry, like `list`.
|
|
605
|
+
*
|
|
606
|
+
* @param {ListFilter} [filter={}]
|
|
607
|
+
* @returns {ReadonlyArray<RegistrySnapshotEntry>} Frozen rows, frozen array.
|
|
608
|
+
*/
|
|
609
|
+
snapshot(filter = {}) {
|
|
610
|
+
const out = [];
|
|
611
|
+
const fName = filter.name;
|
|
612
|
+
const fVer = filter.version;
|
|
613
|
+
const fType = filter.type;
|
|
614
|
+
const typePrefix = (typeof fType === 'string') && fType.endsWith('.');
|
|
615
|
+
|
|
616
|
+
for (const [name, entry] of this.modules) {
|
|
617
|
+
if (fName && fName !== name) continue;
|
|
618
|
+
// Read-only peek at the instance cache: never creates the per-name
|
|
619
|
+
// Map (that is `resolve`'s job), so enumeration stays side-effect free.
|
|
620
|
+
const versionsCache = this.instances.get(name);
|
|
621
|
+
for (const [version, def] of entry.versions) {
|
|
622
|
+
if (fVer && fVer !== version) continue;
|
|
623
|
+
if (fType) {
|
|
624
|
+
if (!def.type) continue;
|
|
625
|
+
if (typePrefix) {
|
|
626
|
+
if (!def.type.startsWith(fType)) continue;
|
|
627
|
+
} else {
|
|
628
|
+
if (def.type !== fType) continue;
|
|
629
|
+
}
|
|
630
|
+
}
|
|
631
|
+
const declared = def.dependencies;
|
|
632
|
+
const deps = Array.isArray(declared) ? declared.slice() : [];
|
|
633
|
+
out.push(Object.freeze({
|
|
634
|
+
name,
|
|
635
|
+
version,
|
|
636
|
+
type: (def.type != null) ? def.type : null,
|
|
637
|
+
dependencies: Object.freeze(deps),
|
|
638
|
+
latest: version === entry.latest,
|
|
639
|
+
instantiated: !!(versionsCache && versionsCache.has(version)),
|
|
640
|
+
}));
|
|
641
|
+
}
|
|
642
|
+
}
|
|
643
|
+
return Object.freeze(out);
|
|
644
|
+
}
|
|
645
|
+
|
|
646
|
+
/**
|
|
647
|
+
* Drop cached instances so the next `resolve` re-runs the factory — the
|
|
648
|
+
* registry-side half of a hot module swap.
|
|
649
|
+
*
|
|
650
|
+
* `register()` is **descriptor-only**: re-registering a module (or
|
|
651
|
+
* `unregister()` then `register()`) swaps the stored definition but never
|
|
652
|
+
* touches {@link ModuleRuntime#instances}, so `resolve()` keeps returning
|
|
653
|
+
* the instance built from the *old* factory. `invalidate` is the missing
|
|
654
|
+
* step: register the new descriptor, invalidate, resolve again.
|
|
655
|
+
*
|
|
656
|
+
* **Spec / version semantics** (mirrors `unregister` / `has`) :
|
|
657
|
+
* - `invalidate('foo')` → every registered version of `foo`
|
|
658
|
+
* - `invalidate('foo@1.0.0')` → only that version
|
|
659
|
+
*
|
|
660
|
+
* **Cascade.** With `{ cascade: true }` the target set grows to every
|
|
661
|
+
* module that declares a target among its `dependencies`, transitively —
|
|
662
|
+
* because a dependent's factory already ran with the *old* dependency
|
|
663
|
+
* instance baked into its closure, and nothing would ever hand it the new
|
|
664
|
+
* one. A version-less dependency spec (`'foo'`) only cascades when the
|
|
665
|
+
* invalidated version is the one `resolve('foo')` would pick, i.e. the
|
|
666
|
+
* entry's `latest`; a pinned spec (`'foo@1.0.0'`) cascades only for that
|
|
667
|
+
* exact version.
|
|
668
|
+
*
|
|
669
|
+
* **Atomic.** The never-swap check and every `dehydrate()` call run *before*
|
|
670
|
+
* the first cache write, so a refused module or a throwing `dehydrate()`
|
|
671
|
+
* leaves the instance cache exactly as it was.
|
|
672
|
+
*
|
|
673
|
+
* **`dehydrate()` / `hydrate()` convention (opt-in).** If an outgoing
|
|
674
|
+
* instance exposes a `dehydrate()` function it is called once and its return
|
|
675
|
+
* value is carried out in the result's `state`, keyed by canonical
|
|
676
|
+
* `name@version`. The runtime does **not** re-inject it: `resolve()` is
|
|
677
|
+
* unchanged and knows nothing about the convention. The caller closes the
|
|
678
|
+
* loop, which keeps the state transfer explicit and inspectable :
|
|
679
|
+
*
|
|
680
|
+
* ```js
|
|
681
|
+
* const { invalidated, state } = runtime.invalidate('todoView', { cascade: true });
|
|
682
|
+
* runtime.register(nextTodoView);
|
|
683
|
+
* for (const key of invalidated) {
|
|
684
|
+
* const instance = runtime.resolve(key);
|
|
685
|
+
* if (key in state && typeof instance.hydrate === 'function') {
|
|
686
|
+
* instance.hydrate(state[key]);
|
|
687
|
+
* }
|
|
688
|
+
* }
|
|
689
|
+
* ```
|
|
690
|
+
*
|
|
691
|
+
* **Scope — read this before relying on it.** Three limits are structural,
|
|
692
|
+
* not gaps to be closed later :
|
|
693
|
+
* - **Handles already handed out are never upgraded.** A caller holding the
|
|
694
|
+
* old instance keeps it; only *subsequent* `resolve` calls see the new
|
|
695
|
+
* one. Hot swap works for modules resolved through the runtime on use.
|
|
696
|
+
* - **Factory-closure state is lost by construction.** Re-running the
|
|
697
|
+
* factory is exactly what clears it. The convention above is the answer,
|
|
698
|
+
* and it is opt-in; state that must survive belongs in a module that is
|
|
699
|
+
* not part of the swap.
|
|
700
|
+
* - **Only the default instance cache is affected.** `{ isolation: true }`
|
|
701
|
+
* instances are never cached and so can never be invalidated, and a
|
|
702
|
+
* caller-supplied `{ instances: map }` cache is the caller's to clear.
|
|
703
|
+
*
|
|
704
|
+
* @param {string} spec Module name, or `'name@version'`.
|
|
705
|
+
* @param {InvalidateOptions} [options={}]
|
|
706
|
+
* @throws {Error} When the module (or version) is not registered, or when a
|
|
707
|
+
* target — directly or through the cascade — is in
|
|
708
|
+
* {@link ModuleRuntime.NEVER_SWAP}.
|
|
709
|
+
* @returns {InvalidateResult} Frozen result.
|
|
710
|
+
*/
|
|
711
|
+
invalidate(spec, options = {}) {
|
|
712
|
+
const parsed = parseSpec(spec);
|
|
713
|
+
const name = parsed.name;
|
|
714
|
+
const explicit = parsed.version;
|
|
715
|
+
|
|
716
|
+
const entry = this.modules.get(name);
|
|
717
|
+
if (!entry) throw new Error(`Module not found: ${name}`);
|
|
718
|
+
if (explicit !== undefined && !entry.versions.has(explicit)) {
|
|
719
|
+
throw new Error(`Module not found: ${name}@${explicit}`);
|
|
720
|
+
}
|
|
721
|
+
|
|
722
|
+
// 1. Target set : name → Set<version>, seeded from the spec then grown
|
|
723
|
+
// to the transitive dependents when `cascade` is set. Fixpoint loop;
|
|
724
|
+
// the registry is small (≪ 1000) so a linear re-scan is fine.
|
|
725
|
+
const targets = new Map();
|
|
726
|
+
targets.set(name, new Set(
|
|
727
|
+
explicit !== undefined ? [explicit] : entry.versions.keys()
|
|
728
|
+
));
|
|
729
|
+
|
|
730
|
+
if (options.cascade) {
|
|
731
|
+
let changed = true;
|
|
732
|
+
while (changed) {
|
|
733
|
+
changed = false;
|
|
734
|
+
for (const [depName, depEntry] of this.modules) {
|
|
735
|
+
for (const [depVersion, def] of depEntry.versions) {
|
|
736
|
+
const known = targets.get(depName);
|
|
737
|
+
if (known && known.has(depVersion)) continue;
|
|
738
|
+
if (!this._dependsOnTarget(def, targets)) continue;
|
|
739
|
+
if (known) known.add(depVersion);
|
|
740
|
+
else targets.set(depName, new Set([depVersion]));
|
|
741
|
+
changed = true;
|
|
742
|
+
}
|
|
743
|
+
}
|
|
744
|
+
}
|
|
745
|
+
}
|
|
746
|
+
|
|
747
|
+
// 2. Refuse before mutating anything : a partially applied invalidation
|
|
748
|
+
// is worse than a refused one.
|
|
749
|
+
for (const targetName of targets.keys()) {
|
|
750
|
+
if (ModuleRuntime.NEVER_SWAP.includes(targetName)) {
|
|
751
|
+
throw new Error(
|
|
752
|
+
`Module "${targetName}" is in the never-swap set and cannot be invalidated`
|
|
753
|
+
);
|
|
754
|
+
}
|
|
755
|
+
}
|
|
756
|
+
|
|
757
|
+
// 3. Collect the outgoing state (opt-in `dehydrate()`), still before any
|
|
758
|
+
// cache write, so a throwing `dehydrate` aborts with the cache intact.
|
|
759
|
+
const pending = [];
|
|
760
|
+
const state = {};
|
|
761
|
+
for (const [targetName, versions] of targets) {
|
|
762
|
+
const versionsCache = this.instances.get(targetName);
|
|
763
|
+
if (!versionsCache) continue;
|
|
764
|
+
for (const version of versions) {
|
|
765
|
+
if (!versionsCache.has(version)) continue;
|
|
766
|
+
const instance = versionsCache.get(version);
|
|
767
|
+
const key = canonical(targetName, version);
|
|
768
|
+
pending.push({ name: targetName, version, key });
|
|
769
|
+
if (instance && typeof instance.dehydrate === 'function') {
|
|
770
|
+
state[key] = instance.dehydrate();
|
|
771
|
+
}
|
|
772
|
+
}
|
|
773
|
+
}
|
|
774
|
+
|
|
775
|
+
// 4. Drop.
|
|
776
|
+
const invalidated = [];
|
|
777
|
+
for (const item of pending) {
|
|
778
|
+
const versionsCache = this.instances.get(item.name);
|
|
779
|
+
versionsCache.delete(item.version);
|
|
780
|
+
if (versionsCache.size === 0) this.instances.delete(item.name);
|
|
781
|
+
invalidated.push(item.key);
|
|
782
|
+
}
|
|
783
|
+
|
|
784
|
+
return Object.freeze({
|
|
785
|
+
invalidated: Object.freeze(invalidated),
|
|
786
|
+
state: Object.freeze(state),
|
|
787
|
+
});
|
|
788
|
+
}
|
|
789
|
+
|
|
790
|
+
/**
|
|
791
|
+
* Whether `def` declares any of the `targets` among its `dependencies`.
|
|
792
|
+
*
|
|
793
|
+
* A version-less dependency spec resolves to the entry's `latest`, so it
|
|
794
|
+
* only counts when that exact version is a target ; a pinned `name@version`
|
|
795
|
+
* spec counts only for its own version.
|
|
796
|
+
*
|
|
797
|
+
* @param {ModuleDefinition} def
|
|
798
|
+
* @param {Map<string, Set<string>>} targets name → invalidated versions.
|
|
799
|
+
* @returns {boolean}
|
|
800
|
+
* @private
|
|
801
|
+
*/
|
|
802
|
+
_dependsOnTarget(def, targets) {
|
|
803
|
+
const declared = def.dependencies;
|
|
804
|
+
if (!Array.isArray(declared)) return false;
|
|
805
|
+
for (const depSpec of declared) {
|
|
806
|
+
const dp = parseSpec(depSpec);
|
|
807
|
+
const versions = targets.get(dp.name);
|
|
808
|
+
if (!versions) continue;
|
|
809
|
+
if (dp.version !== undefined) {
|
|
810
|
+
if (versions.has(dp.version)) return true;
|
|
811
|
+
continue;
|
|
812
|
+
}
|
|
813
|
+
const depEntry = this.modules.get(dp.name);
|
|
814
|
+
if (depEntry && versions.has(depEntry.latest)) return true;
|
|
815
|
+
}
|
|
816
|
+
return false;
|
|
817
|
+
}
|
|
818
|
+
|
|
819
|
+
/**
|
|
820
|
+
* Serialise a dependency sub-graph to a self-contained code string for use
|
|
821
|
+
* inside a Web Worker.
|
|
822
|
+
*
|
|
823
|
+
* Each spec resolves to an exact `(name, version)` def via `parseSpec`
|
|
824
|
+
* (latest if no version). Dependencies of every emitted module are rewritten
|
|
825
|
+
* as canonical `name@version` to guarantee exact resolution worker-side.
|
|
826
|
+
*
|
|
827
|
+
* @param {string[]} specs Entry-point module specs.
|
|
828
|
+
* @returns {SerializedGraph}
|
|
829
|
+
*/
|
|
830
|
+
serialize(specs) {
|
|
831
|
+
const graph = this._buildGraph(specs);
|
|
832
|
+
const canonicalNames = [];
|
|
833
|
+
|
|
834
|
+
const modulesStr = graph.map(node => {
|
|
835
|
+
const { name, version, def } = node;
|
|
836
|
+
const can = canonical(name, version);
|
|
837
|
+
canonicalNames.push(can);
|
|
838
|
+
|
|
839
|
+
const escapedName = name.replace(/'/g, "\\'");
|
|
840
|
+
const escapedVersion = version.replace(/'/g, "\\'");
|
|
841
|
+
const escapedType = def.type ? `,type:'${def.type.replace(/'/g, "\\'")}'` : '';
|
|
842
|
+
|
|
843
|
+
// Rewrite dependencies to canonical name@version to ensure exact
|
|
844
|
+
// resolution inside the worker (which has the same multi-version
|
|
845
|
+
// semantics).
|
|
846
|
+
const escapedDeps = (def.dependencies || []).map(depSpec => {
|
|
847
|
+
const dp = parseSpec(depSpec);
|
|
848
|
+
const depEntry = this.modules.get(dp.name);
|
|
849
|
+
const depVer = dp.version || (depEntry ? depEntry.latest : DEFAULT_VERSION);
|
|
850
|
+
return canonical(dp.name, depVer).replace(/'/g, "\\'");
|
|
851
|
+
});
|
|
852
|
+
const depsStr = escapedDeps.length > 0
|
|
853
|
+
? `['${escapedDeps.join("','")}']`
|
|
854
|
+
: '[]';
|
|
855
|
+
|
|
856
|
+
const factoryStr = def.factory.toString().replace(/^factory/, 'function');
|
|
857
|
+
|
|
858
|
+
return `{name:'${escapedName}',version:'${escapedVersion}'${escapedType},dependencies:${depsStr},factory:${factoryStr}}`;
|
|
859
|
+
}).join(',');
|
|
860
|
+
|
|
861
|
+
const namesStr = canonicalNames.length > 0
|
|
862
|
+
? `'${canonicalNames.map(n => n.replace(/'/g, "\\'")).join("','")}'`
|
|
863
|
+
: '';
|
|
864
|
+
|
|
865
|
+
return { list: `[${namesStr}]`, content: `[${modulesStr}]` };
|
|
866
|
+
}
|
|
867
|
+
|
|
868
|
+
/**
|
|
869
|
+
* Build a topologically ordered list of `(name, version, def)` triples
|
|
870
|
+
* covering the transitive dependency closure of the given specs.
|
|
871
|
+
*
|
|
872
|
+
* Iterative depth-first search with a visited set keyed on canonical
|
|
873
|
+
* `name@version` to deduplicate. Each module's dependencies are visited
|
|
874
|
+
* before the module itself.
|
|
875
|
+
*
|
|
876
|
+
* @param {string[]} specs Entry-point module specs.
|
|
877
|
+
* @returns {Array<{name: string, version: string, def: ModuleDefinition}>}
|
|
878
|
+
* @private
|
|
879
|
+
*/
|
|
880
|
+
_buildGraph(specs) {
|
|
881
|
+
const visited = new Set();
|
|
882
|
+
const result = [];
|
|
883
|
+
|
|
884
|
+
const visit = (spec) => {
|
|
885
|
+
const parsed = parseSpec(spec);
|
|
886
|
+
const entry = this.modules.get(parsed.name);
|
|
887
|
+
if (!entry) throw new Error(`Module not found: ${parsed.name}`);
|
|
888
|
+
const version = parsed.version || entry.latest;
|
|
889
|
+
const def = entry.versions.get(version);
|
|
890
|
+
if (!def) throw new Error(`Module not found: ${parsed.name}@${version}`);
|
|
891
|
+
|
|
892
|
+
const key = canonical(parsed.name, version);
|
|
893
|
+
if (visited.has(key)) return;
|
|
894
|
+
visited.add(key);
|
|
895
|
+
|
|
896
|
+
(def.dependencies || []).forEach(visit);
|
|
897
|
+
result.push({ name: parsed.name, version, def });
|
|
898
|
+
};
|
|
899
|
+
|
|
900
|
+
specs.forEach(visit);
|
|
901
|
+
return result;
|
|
902
|
+
}
|
|
903
|
+
}
|
|
904
|
+
|
|
905
|
+
/**
|
|
906
|
+
* Self-contained source code of the entire runtime (constants +
|
|
907
|
+
* private helpers + `ModuleRuntime` class), ready to be inlined
|
|
908
|
+
* into a Worker without depending on `import`.
|
|
909
|
+
*
|
|
910
|
+
* `worker-helper.js` injects this string at worker startup so that
|
|
911
|
+
* the class (serialised via `.toString()`) can find `SEMVER_RE`,
|
|
912
|
+
* `TYPE_RE`, `DEFAULT_VERSION`, `semverCompare`, `parseSpec`, and
|
|
913
|
+
* `canonical` at execution time.
|
|
914
|
+
*
|
|
915
|
+
* **Order is critical**: helpers and constants must precede the class
|
|
916
|
+
* to satisfy the hoisting rules for `function` declarations and the
|
|
917
|
+
* temporal dead zone of `const`.
|
|
918
|
+
*
|
|
919
|
+
* @type {string}
|
|
920
|
+
*/
|
|
921
|
+
export const runtimeSource = [
|
|
922
|
+
`const SEMVER_RE = ${SEMVER_RE.toString()};`,
|
|
923
|
+
`const TYPE_RE = ${TYPE_RE.toString()};`,
|
|
924
|
+
`const DEFAULT_VERSION = ${JSON.stringify(DEFAULT_VERSION)};`,
|
|
925
|
+
semverCompare.toString(),
|
|
926
|
+
parseSpec.toString(),
|
|
927
|
+
canonical.toString(),
|
|
928
|
+
ModuleRuntime.toString(),
|
|
929
|
+
].join('\n\n');
|