@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,499 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: runtime
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: class
|
|
6
|
+
worker-safe: partial
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# ModuleRuntime
|
|
11
|
+
|
|
12
|
+
> Framework DI engine: registry, lazy resolution, singleton cache, **native multi-version**, worker serialisation.
|
|
13
|
+
|
|
14
|
+
**Module** `runtime` | **Source** `packages/front/fw/src/core/runtime.js` | **Deps** none | **Worker-safe** partial (class injected into workers via `runtimeSource`)
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
// Not resolved via runtime — directly accessible from the fw object:
|
|
20
|
+
import fw from './fw/main.js';
|
|
21
|
+
const { runtime } = fw;
|
|
22
|
+
|
|
23
|
+
// Or manual instantiation:
|
|
24
|
+
import { ModuleRuntime } from './fw/src/core/runtime.js';
|
|
25
|
+
const rt = new ModuleRuntime();
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Key concepts
|
|
29
|
+
|
|
30
|
+
### Module spec
|
|
31
|
+
|
|
32
|
+
A **spec** is either:
|
|
33
|
+
- `'foo'` — resolves to the **highest registered version** of `foo`
|
|
34
|
+
- `'foo@1.2.3'` — resolves to the **exact version** (canonical name)
|
|
35
|
+
|
|
36
|
+
A module's `dependencies` can mix both forms:
|
|
37
|
+
```js
|
|
38
|
+
dependencies: ['hex', 'utf8@1.0.0', 'lz4']
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Multi-version
|
|
42
|
+
|
|
43
|
+
Multiple versions of the same `name` can coexist:
|
|
44
|
+
```js
|
|
45
|
+
runtime.register({ name: 'foo', version: '1.0.0', dependencies: [], factory: () => 'v1' });
|
|
46
|
+
runtime.register({ name: 'foo', version: '2.0.0', dependencies: [], factory: () => 'v2' });
|
|
47
|
+
|
|
48
|
+
runtime.resolve('foo'); // → 'v2' (latest)
|
|
49
|
+
runtime.resolve('foo@1.0.0'); // → 'v1'
|
|
50
|
+
runtime.resolve('foo', { version: '1.0.0' }); // → 'v1'
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The "latest" selection is precomputed at register time: `resolve('foo')` remains **O(1)**.
|
|
54
|
+
|
|
55
|
+
### Validation at register
|
|
56
|
+
|
|
57
|
+
| Field | Validation | If absent |
|
|
58
|
+
|---|---|---|
|
|
59
|
+
| `name` | required (truthy) | throw `Invalid module definition` |
|
|
60
|
+
| `factory` | required (truthy) | throw `Invalid module definition` |
|
|
61
|
+
| `version` | semver regex `MAJOR.MINOR.PATCH[-pre][+build]` | default `'0.0.0'` |
|
|
62
|
+
| `type` | regex `^(fw\|sd\|sde\|sdc\|lib)\.[a-z][\w.]*$` | accepted absent |
|
|
63
|
+
| `dependencies` | list of specs | default `[]` |
|
|
64
|
+
|
|
65
|
+
## API
|
|
66
|
+
|
|
67
|
+
### `runtime.register(module)`
|
|
68
|
+
|
|
69
|
+
Registers a module. Chainable. A re-registered `(name, version)` pair overwrites the previous. Multiple `version` values of the same `name` coexist.
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
runtime.register(myModule);
|
|
73
|
+
|
|
74
|
+
// Chaining
|
|
75
|
+
runtime.register(modA).register(modB);
|
|
76
|
+
|
|
77
|
+
// Multi-version
|
|
78
|
+
runtime
|
|
79
|
+
.register({ name: 'codec', version: '1.0.0', dependencies: [], factory: () => v1 })
|
|
80
|
+
.register({ name: 'codec', version: '2.0.0', dependencies: [], factory: () => v2 });
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
| Param | Type | Description |
|
|
84
|
+
|-------|------|-------------|
|
|
85
|
+
| `module` | `ModuleDefinition` | Object `{ name, version?, type?, dependencies, factory }` |
|
|
86
|
+
|
|
87
|
+
**Throws:**
|
|
88
|
+
- `Invalid module definition` — `name` or `factory` missing
|
|
89
|
+
- `Invalid version "<v>" for module "<name>"` — `version` does not match semver
|
|
90
|
+
- `Invalid type "<t>" for module "<name>"` — `type` does not match the taxonomy
|
|
91
|
+
|
|
92
|
+
Returns: `this` (chainable).
|
|
93
|
+
|
|
94
|
+
> **Re-registration is descriptor-only.** Overwriting a `(name, version)` pair
|
|
95
|
+
> swaps the stored definition; it does **not** touch the `instances` cache. A
|
|
96
|
+
> module already resolved under that pair keeps returning the **old** instance,
|
|
97
|
+
> and so does every later `resolve()` — `unregister()` followed by `register()`
|
|
98
|
+
> behaves the same way. Bumping `version` self-invalidates the module (the cache
|
|
99
|
+
> is keyed `name` → `version` → instance) but does **not** refresh dependents
|
|
100
|
+
> that already hold a resolved handle: handles once handed out are never
|
|
101
|
+
> upgraded. Build hot-invalidation on top of the public `instances` map and
|
|
102
|
+
> `list()`'s dependency data; `{ isolation: true }` instances are never cached.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
### `runtime.registerAll(modules)`
|
|
107
|
+
|
|
108
|
+
Registers an array of definitions in a single operation. Equivalent to calling `register()` for each entry. Chainable.
|
|
109
|
+
|
|
110
|
+
```js
|
|
111
|
+
import netModules from '/dist/build/fw.pack.realtime.pure.min.js';
|
|
112
|
+
runtime.registerAll(netModules);
|
|
113
|
+
|
|
114
|
+
// Chaining
|
|
115
|
+
runtime
|
|
116
|
+
.registerAll(coreModules)
|
|
117
|
+
.registerAll(extraModules)
|
|
118
|
+
.register(customMod);
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
| Param | Type | Description |
|
|
122
|
+
|-------|------|-------------|
|
|
123
|
+
| `modules` | `ModuleDefinition[]` | Array of definitions to register in order |
|
|
124
|
+
|
|
125
|
+
Returns: `this` (chainable).
|
|
126
|
+
|
|
127
|
+
**Typical use**: consuming the **module packs** produced by the prebuild in pure mode (`fw.pack.<group>.pure.min.js` exports `default [m1, m2, …]`). See [docs/tools/bundler.md](../../tools/bundler.md).
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
### `runtime.registerDeep(module)`
|
|
132
|
+
|
|
133
|
+
Registers `module` **along with all its transitive dependencies** declared via its `deps` field (direct JS references). Works depth-first and registers each missing module on the return path, guaranteeing the dependencies-before-dependants order expected by `resolve`. Chainable.
|
|
134
|
+
|
|
135
|
+
```js
|
|
136
|
+
import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js';
|
|
137
|
+
runtime.registerDeep(sanitize);
|
|
138
|
+
// → registers sanitize + parser + render + secPolicy + ...
|
|
139
|
+
const s = runtime.resolve('sanitize');
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
| Param | Type | Description |
|
|
143
|
+
|-------|------|-------------|
|
|
144
|
+
| `module` | `ModuleDefinition & { deps?: ModuleDefinition[] }` | Module whose `deps` field (JS references) will be traversed |
|
|
145
|
+
|
|
146
|
+
**Behaviour:**
|
|
147
|
+
- Idempotent — a module `(name, version)` already registered is skipped.
|
|
148
|
+
- Cycle-safe via a `Set` of visited nodes shared per call (key: `module.name`).
|
|
149
|
+
- `deps` is **only** the bundler-friendly counterpart of `dependencies` (strings). Resolution is still driven by `dependencies`; `deps` simply allows Rollup/Vite/esbuild to trace the graph via JS `import` statements.
|
|
150
|
+
- **Invariant** (validated at build): `module.deps.map(d => d.name)` = `module.dependencies.map(s => s.split('@')[0])`.
|
|
151
|
+
- `serialize` does **not** embed `deps` (only `dependencies`) — the worker-side closure is still computed from the canonical form.
|
|
152
|
+
|
|
153
|
+
Returns: `this` (chainable).
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
### `runtime.registerAllDeep(modules)`
|
|
158
|
+
|
|
159
|
+
Equivalent to `registerDeep` applied to each entry of the array. Shares a visited `Set` to avoid re-traversing common dependencies. Chainable.
|
|
160
|
+
|
|
161
|
+
```js
|
|
162
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
163
|
+
runtime.registerAllDeep(modules);
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
| Param | Type | Description |
|
|
167
|
+
|-------|------|-------------|
|
|
168
|
+
| `modules` | `Array<ModuleDefinition & { deps?: ModuleDefinition[] }>` | Array of modules to register deeply |
|
|
169
|
+
|
|
170
|
+
Returns: `this` (chainable).
|
|
171
|
+
|
|
172
|
+
**Tree-shaking note**: `registerAllDeep([a, b, c])` still references all bindings `a`/`b`/`c` at the call site. A bundler therefore cannot eliminate any of them. For a minimal graph, import a single module by its subpath and call `registerDeep(module)` — the transitive closure then comes **via the module's own JS imports**.
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
### `runtime.resolve(spec, options?)`
|
|
177
|
+
|
|
178
|
+
Resolves a module by **spec** (`'name'` or `'name@version'`). Recursively instantiates dependencies. Singleton cache by default, per `(name, version)`.
|
|
179
|
+
|
|
180
|
+
```js
|
|
181
|
+
const hex = runtime.resolve('hex'); // latest
|
|
182
|
+
const v1 = runtime.resolve('hex@1.0.0'); // exact
|
|
183
|
+
const v2 = runtime.resolve('hex', { version: '2.0.0' });
|
|
184
|
+
|
|
185
|
+
// Without cache
|
|
186
|
+
const fresh = runtime.resolve('hex', { isolation: true });
|
|
187
|
+
|
|
188
|
+
// Custom shared cache (canonical keys `name@version`)
|
|
189
|
+
const map = new Map();
|
|
190
|
+
const a = runtime.resolve('hex', { instances: map });
|
|
191
|
+
const b = runtime.resolve('hex', { instances: map }); // same instance
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
| Param | Type | Description |
|
|
195
|
+
|-------|------|-------------|
|
|
196
|
+
| `spec` | `string` | `'name'` (latest) or `'name@version'` (exact) |
|
|
197
|
+
| `options.version` | `string` | Explicit version — ignored if `spec` already contains `@version` |
|
|
198
|
+
| `options.isolation` | `boolean` | If `true`, creates a new instance without caching it |
|
|
199
|
+
| `options.instances` | `Map` | Custom instance map (canonical keys `name@version`) |
|
|
200
|
+
|
|
201
|
+
Returns: module instance.
|
|
202
|
+
**Throws:** `Module not found: <name>` or `Module not found: <name>@<version>`.
|
|
203
|
+
|
|
204
|
+
---
|
|
205
|
+
|
|
206
|
+
### `runtime.resolveAll(specs, options?)`
|
|
207
|
+
|
|
208
|
+
Resolves multiple modules in one operation. The **result keys** are the **original specs** (preserving any `@version` suffix).
|
|
209
|
+
|
|
210
|
+
```js
|
|
211
|
+
const { hex, utf8 } = runtime.resolveAll(['hex', 'utf8']);
|
|
212
|
+
|
|
213
|
+
// Mix latest + exact
|
|
214
|
+
const r = runtime.resolveAll(['hex', 'utf8@1.0.0']);
|
|
215
|
+
r['hex']; // latest
|
|
216
|
+
r['utf8@1.0.0']; // exact
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
Returns: `Object<string, instance>`.
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
### `runtime.unregister(spec, version?)`
|
|
224
|
+
|
|
225
|
+
Removes a module definition. **Does not touch the instance cache**: references already obtained via `resolve` continue to work; only subsequent resolutions fail.
|
|
226
|
+
|
|
227
|
+
```js
|
|
228
|
+
runtime.unregister('foo'); // removes ALL versions of 'foo'
|
|
229
|
+
runtime.unregister('foo', '1.0.0'); // removes only '1.0.0'
|
|
230
|
+
runtime.unregister('foo@1.0.0'); // same (canonical notation)
|
|
231
|
+
```
|
|
232
|
+
|
|
233
|
+
| Param | Type | Description |
|
|
234
|
+
|---|---|---|
|
|
235
|
+
| `spec` | `string` | Module name or `'name@version'` |
|
|
236
|
+
| `version` | `string` | Explicit version (ignored if `spec` already contains `@`) |
|
|
237
|
+
|
|
238
|
+
Returns: `boolean` — `true` if at least one definition was removed.
|
|
239
|
+
|
|
240
|
+
**Effects:**
|
|
241
|
+
- If the removed version was the `latest`, the pointer is recomputed over the remaining versions.
|
|
242
|
+
- If the last version of a name is removed, the registry entry is deleted.
|
|
243
|
+
- The `instances` cache is **unchanged**: already-resolved instances survive on the caller side. A subsequent `register` of the same `(name, version)` will hit the same cached instance (unless `isolation: true`).
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
### `runtime.has(name, version?)`
|
|
248
|
+
|
|
249
|
+
Checks whether a module (or a specific version) is registered.
|
|
250
|
+
|
|
251
|
+
```js
|
|
252
|
+
runtime.has('hex'); // true
|
|
253
|
+
runtime.has('hex', '1.0.0'); // true
|
|
254
|
+
runtime.has('hex', '9.9.9'); // false
|
|
255
|
+
runtime.has('foobar'); // false
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
Returns: `boolean`.
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
262
|
+
### `runtime.list(filter?)`
|
|
263
|
+
|
|
264
|
+
Discovery — returns module definitions matching the filter.
|
|
265
|
+
|
|
266
|
+
```js
|
|
267
|
+
runtime.list(); // all (all versions)
|
|
268
|
+
runtime.list({ name: 'hex' }); // all versions of 'hex'
|
|
269
|
+
runtime.list({ version: '1.0.0' }); // all '1.0.0' versions
|
|
270
|
+
runtime.list({ type: 'fw.io.codec' }); // exact type
|
|
271
|
+
runtime.list({ type: 'fw.' }); // PREFIX (trailing `.`) — all fw.*
|
|
272
|
+
runtime.list({ name: 'hex', version: '2.0.0' }); // combined
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
| Filter | Type | Description |
|
|
276
|
+
|---|---|---|
|
|
277
|
+
| `name` | `string` | Exact match |
|
|
278
|
+
| `version` | `string` | Exact match |
|
|
279
|
+
| `type` | `string` | Exact match, **or prefix if trailing `.`** |
|
|
280
|
+
|
|
281
|
+
Returns: `ModuleDefinition[]`. Linear — performant up to several hundred modules.
|
|
282
|
+
|
|
283
|
+
> **`list()` hands out live definitions.** The returned objects are the
|
|
284
|
+
> registered `ModuleDefinition`s themselves — including the live `factory` and
|
|
285
|
+
> the live `dependencies` array, which a caller can splice in place. Use it for
|
|
286
|
+
> discovery inside trusted code; for a **read-only** view (devtools, an
|
|
287
|
+
> inspector panel, anything that only needs to *look*), use
|
|
288
|
+
> [`snapshot()`](#runtimesnapshotfilter) below.
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
### `runtime.snapshot(filter?)`
|
|
293
|
+
|
|
294
|
+
Passive, **read-only** view of the registry: frozen metadata rows, no live
|
|
295
|
+
handles, **no instantiation**.
|
|
296
|
+
|
|
297
|
+
```js
|
|
298
|
+
runtime.snapshot();
|
|
299
|
+
// → [
|
|
300
|
+
// { name: 'hex', version: '1.0.0', type: 'fw.io.codec',
|
|
301
|
+
// dependencies: [], latest: false, instantiated: true },
|
|
302
|
+
// { name: 'hex', version: '2.0.0', type: 'fw.io.codec',
|
|
303
|
+
// dependencies: [], latest: true, instantiated: false },
|
|
304
|
+
// { name: 'utf8', version: '0.0.0', type: null,
|
|
305
|
+
// dependencies: ['hex'], latest: true, instantiated: false },
|
|
306
|
+
// ]
|
|
307
|
+
|
|
308
|
+
runtime.snapshot({ name: 'hex' }); // all versions of 'hex'
|
|
309
|
+
runtime.snapshot({ type: 'fw.io.' }); // PREFIX (trailing `.`)
|
|
310
|
+
runtime.snapshot({ name: 'hex', version: '2.0.0' });
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
| Field | Type | Description |
|
|
314
|
+
|---|---|---|
|
|
315
|
+
| `name` | `string` | Registered module name |
|
|
316
|
+
| `version` | `string` | Resolved version — `'0.0.0'` when the descriptor omitted `version` |
|
|
317
|
+
| `type` | `string \| null` | Declared taxonomy type, `null` when undeclared |
|
|
318
|
+
| `dependencies` | `readonly string[]` | Frozen **copy** of the declared dependency specs |
|
|
319
|
+
| `latest` | `boolean` | `true` for the version a version-less `resolve(name)` would pick |
|
|
320
|
+
| `instantiated` | `boolean` | `true` when an instance for this `(name, version)` is already in the default cache |
|
|
321
|
+
|
|
322
|
+
`filter` is the same object `list()` accepts, with the same semantics (exact
|
|
323
|
+
`name` / `version`; exact `type`, or prefix match when `type` ends with `.`).
|
|
324
|
+
|
|
325
|
+
Returns: `ReadonlyArray<RegistrySnapshotEntry>` — the array is frozen, every row
|
|
326
|
+
is frozen, and every row's `dependencies` is a frozen copy. Linear scan, like
|
|
327
|
+
`list()`.
|
|
328
|
+
|
|
329
|
+
**Guarantees**
|
|
330
|
+
|
|
331
|
+
- **It does not instantiate.** No `factory` is invoked and the `instances` cache
|
|
332
|
+
is never written — not even the per-name sub-`Map`. Calling it on a registry
|
|
333
|
+
where nothing has been resolved leaves the cache byte-identical. This is the
|
|
334
|
+
difference from `resolve()`, which is a *full instantiate*, not a peek.
|
|
335
|
+
- **It is read-only.** Nothing the caller receives can write back into registry
|
|
336
|
+
state: the array cannot be extended, a row cannot be re-keyed, and
|
|
337
|
+
`dependencies` is a copy, so splicing it does not touch the registered
|
|
338
|
+
definition. (In strict mode — i.e. any ES module — such an attempt throws.)
|
|
339
|
+
- **It leaks no live handle.** Rows carry the six metadata fields above and
|
|
340
|
+
nothing else: no `factory`, no `deps`, no instance. `instantiated` is an
|
|
341
|
+
observation of the cache, never a way to reach what is in it.
|
|
342
|
+
- **Lockdown-compatible, measured, zero carve-out** — see
|
|
343
|
+
`packages/front/fw/tests/registry-accessor-lockdown.integration.test.js`:
|
|
344
|
+
enumeration, filtering, freezing and the "instantiates nothing" property all
|
|
345
|
+
hold after `sanity/lockdown()`, on a runtime built before the freeze and on
|
|
346
|
+
one constructed after it.
|
|
347
|
+
|
|
348
|
+
---
|
|
349
|
+
|
|
350
|
+
### `runtime.invalidate(spec, options?)`
|
|
351
|
+
|
|
352
|
+
Drops cached instances so the next `resolve()` re-runs the factory — the
|
|
353
|
+
registry-side half of a hot module swap. Full guide:
|
|
354
|
+
[`docs/guide/hmr.md`](../../guide/hmr.md).
|
|
355
|
+
|
|
356
|
+
```js
|
|
357
|
+
runtime.register(nextTodoView); // descriptor-only: cache untouched
|
|
358
|
+
const { invalidated, state } = runtime.invalidate('todoView', { cascade: true });
|
|
359
|
+
runtime.resolve('todoView'); // built from the NEW factory
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
| Parameter | Type | Description |
|
|
363
|
+
|---|---|---|
|
|
364
|
+
| `spec` | `string` | `'name'` (every registered version) or `'name@version'` (exact) |
|
|
365
|
+
| `options.cascade` | `boolean` | Also invalidate every module declaring the target among its `dependencies`, transitively |
|
|
366
|
+
|
|
367
|
+
Returns: `InvalidateResult` — frozen `{ invalidated, state }`.
|
|
368
|
+
|
|
369
|
+
| Field | Type | Description |
|
|
370
|
+
|---|---|---|
|
|
371
|
+
| `invalidated` | `readonly string[]` | Canonical `name@version` keys whose cached instance was actually dropped |
|
|
372
|
+
| `state` | `Object<string, *>` | Frozen map of canonical key → value returned by the outgoing instance's opt-in `dehydrate()` |
|
|
373
|
+
|
|
374
|
+
Throws `Module not found: <name>` (or `<name>@<version>`) for an unregistered
|
|
375
|
+
target, and refuses any target — direct or cascaded — in
|
|
376
|
+
`ModuleRuntime.NEVER_SWAP`.
|
|
377
|
+
|
|
378
|
+
**Semantics**
|
|
379
|
+
|
|
380
|
+
- **Dependents, not dependencies.** A cascade walks *upward*: the modules whose
|
|
381
|
+
factories already ran with the outgoing instance baked into their closure. A
|
|
382
|
+
version-less dependency spec (`'foo'`) only cascades when the invalidated
|
|
383
|
+
version is the entry's `latest`; a pinned spec cascades only for its own
|
|
384
|
+
version.
|
|
385
|
+
- **Atomic.** The never-swap check and every `dehydrate()` call run before the
|
|
386
|
+
first cache write, so a refusal or a throwing `dehydrate()` leaves the cache
|
|
387
|
+
exactly as it was.
|
|
388
|
+
- **The registry is not touched.** `invalidate` evicts instances; `unregister`
|
|
389
|
+
removes definitions. They are independent.
|
|
390
|
+
- **`ModuleRuntime.NEVER_SWAP`** is a frozen, pinned array of module names — it
|
|
391
|
+
contains `signal`, whose effect tracking is per-factory-instance, so swapping
|
|
392
|
+
it would silently detach every existing effect. Not configurable per runtime.
|
|
393
|
+
|
|
394
|
+
**Limits** (structural, documented rather than deferred)
|
|
395
|
+
|
|
396
|
+
- Handles already handed out are **never** upgraded — only subsequent `resolve`
|
|
397
|
+
calls see the new instance.
|
|
398
|
+
- Factory-closure state is **lost**: re-running the factory is exactly what
|
|
399
|
+
clears it. The opt-in `dehydrate()` / `hydrate()` convention is the answer.
|
|
400
|
+
- Only the default cache is affected: `{ isolation: true }` instances are never
|
|
401
|
+
cached, and a caller-supplied `{ instances: map }` is the caller's to clear.
|
|
402
|
+
|
|
403
|
+
---
|
|
404
|
+
|
|
405
|
+
### `runtime.serialize(specs)`
|
|
406
|
+
|
|
407
|
+
Serialises the transitive dependency graph as a JS string for injection into a Worker.
|
|
408
|
+
|
|
409
|
+
```js
|
|
410
|
+
const { list, content } = runtime.serialize(['uuid']);
|
|
411
|
+
// list → "['hex@1.0.0','uuid@1.0.0']" (topological canonical names)
|
|
412
|
+
// content → "[{name:'hex',version:'1.0.0',type:'fw.io.codec',dependencies:[],factory:function(){...}},...]"
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
Returns: `{ list: string, content: string }`.
|
|
416
|
+
|
|
417
|
+
**Notes:**
|
|
418
|
+
- `specs` can be bare (`'foo'` → latest) or `'foo@1.0.0'`.
|
|
419
|
+
- **Each serialised module's dependencies are rewritten to canonical form** (`'hex'` → `'hex@1.0.0'`) to guarantee exact resolution on the worker side.
|
|
420
|
+
- `version` and `type` are preserved in the bundle.
|
|
421
|
+
- Used internally by `createWorker`. The `toString()` of factories is embedded; shorthand methods are converted to `function` keyword for eval compatibility.
|
|
422
|
+
|
|
423
|
+
---
|
|
424
|
+
|
|
425
|
+
### `runtime._buildGraph(specs)` *(internal)*
|
|
426
|
+
|
|
427
|
+
Depth-first topological sort over the transitive closure. Returns `[{name, version, def}]` — dependencies before dependants. Deduplicates by canonical `name@version`.
|
|
428
|
+
|
|
429
|
+
## Internal properties
|
|
430
|
+
|
|
431
|
+
| Property | Type | Description |
|
|
432
|
+
|-----------|------|-------------|
|
|
433
|
+
| `modules` | `Map<string, ModuleEntry>` | Registry by name — `ModuleEntry = {versions, latest, latestDef}` |
|
|
434
|
+
| `instances` | `Map<string, Map<string, *>>` | Singleton cache per `(name, version)` |
|
|
435
|
+
| `context` | `Object` | Reserved for worker bootstrap (populated by `worker-helper.js`) |
|
|
436
|
+
|
|
437
|
+
## Typedef: ModuleDefinition
|
|
438
|
+
|
|
439
|
+
```js
|
|
440
|
+
{
|
|
441
|
+
name: string, // unique identifier
|
|
442
|
+
version?: string, // semver — default '0.0.0'
|
|
443
|
+
type?: string, // taxonomy 'fw.<sub>' | 'sd.<sub>' | 'sde.<sub>' | 'sdc.<sub>' | 'lib.<sub>' — regex ^(fw|sd|sde|sdc|lib)\.[a-z][\w.]*$
|
|
444
|
+
dependencies: string[], // specs ('name' or 'name@version') — runtime contract
|
|
445
|
+
deps?: ModuleDefinition[], // direct JS refs — bundler-friendly, traversed by registerDeep
|
|
446
|
+
factory: Function // factory(...deps) => instance
|
|
447
|
+
}
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
> **`deps` vs `dependencies`** — `dependencies` is the **runtime contract** (strings, support `@version`, embedded in `serialize`). `deps` is a **bundler-friendly counterpart**: an array of direct JS references (from static imports) that `registerDeep`/`registerAllDeep` traverse. Build-time invariant: `deps.map(d => d.name)` corresponds to `dependencies.map(s => s.split('@')[0])`. Not transferred to workers.
|
|
451
|
+
|
|
452
|
+
## Examples
|
|
453
|
+
|
|
454
|
+
### Register and resolve a module
|
|
455
|
+
|
|
456
|
+
```js
|
|
457
|
+
import { ModuleRuntime } from './fw/src/core/runtime.js';
|
|
458
|
+
|
|
459
|
+
const rt = new ModuleRuntime();
|
|
460
|
+
rt.register({ name: 'greet', dependencies: [], factory: () => ({ hello: (name) => `Hello ${name}` }) });
|
|
461
|
+
const greet = rt.resolve('greet');
|
|
462
|
+
greet.hello('world'); // 'Hello world'
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
### Multi-version
|
|
466
|
+
|
|
467
|
+
```js
|
|
468
|
+
rt.register({ name: 'codec', version: '1.0.0', dependencies: [], factory: () => 'v1' });
|
|
469
|
+
rt.register({ name: 'codec', version: '2.0.0', dependencies: [], factory: () => 'v2' });
|
|
470
|
+
|
|
471
|
+
rt.resolve('codec'); // → 'v2' (latest)
|
|
472
|
+
rt.resolve('codec@1.0.0'); // → 'v1'
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
## Notes
|
|
476
|
+
|
|
477
|
+
- The "latest" selection is precomputed at `register` — `resolve('foo')` remains O(1) regardless of the number of versions.
|
|
478
|
+
- `unregister` does not touch the `instances` cache: already-obtained references continue to work.
|
|
479
|
+
- `list()` returns **live** definitions (mutable `dependencies`, callable `factory`); `snapshot()` returns frozen metadata copies and instantiates nothing — pick `snapshot()` for any read-only consumer.
|
|
480
|
+
- `serialize` emits dependencies in canonical `name@version` form to guarantee exact worker-side resolution.
|
|
481
|
+
- `runtimeSource` exports the private helpers + the class, enabling their injection into a Worker without `import`.
|
|
482
|
+
|
|
483
|
+
## Backwards compatibility
|
|
484
|
+
|
|
485
|
+
| Legacy case | Behaviour |
|
|
486
|
+
|---|---|
|
|
487
|
+
| Module without `version` or `type` | OK — default version `'0.0.0'`, no type validation |
|
|
488
|
+
| `resolve('foo')` after legacy register | returns the single version (`'0.0.0'`) |
|
|
489
|
+
| Mix of legacy + versioned | explicit version wins (`'1.0.0'` > `'0.0.0'`) |
|
|
490
|
+
| `serialize(['foo'])` legacy | OK — emits `'foo@0.0.0'` |
|
|
491
|
+
| `dependencies: ['hex']` legacy | OK — resolves latest |
|
|
492
|
+
|
|
493
|
+
No existing fw module is broken by the evolution.
|
|
494
|
+
|
|
495
|
+
## See also
|
|
496
|
+
|
|
497
|
+
- [Module pattern](../../guide/module-pattern.md)
|
|
498
|
+
- [Web Workers](../../guide/workers.md)
|
|
499
|
+
- [worker-helper](./worker-helper.md)
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: worker-helper
|
|
3
|
+
category: core
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: function
|
|
6
|
+
worker-safe: false
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# createWorker
|
|
11
|
+
|
|
12
|
+
> Spawns a framework-aware Web Worker from an inline function. Required modules are serialised automatically.
|
|
13
|
+
|
|
14
|
+
**Module** `worker-helper` | **Source** `packages/front/fw/src/core/worker-helper.js` | **Deps** none | **Worker-safe** no
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
// Not resolved via runtime — directly accessible from the fw object:
|
|
20
|
+
import fw from './fw/main.js';
|
|
21
|
+
const createWorker = fw.createWorker;
|
|
22
|
+
// Usage: fw.createWorker(workerFn, options?)
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|---------|-----------|---------|
|
|
29
|
+
| `createWorker` | `(workerFn: Function, options?: WorkerOptions) => Worker` | `Worker` with patched `terminate()` |
|
|
30
|
+
|
|
31
|
+
### `createWorker` options
|
|
32
|
+
|
|
33
|
+
| Param | Type | Default | Description |
|
|
34
|
+
|-------|------|--------|-------------|
|
|
35
|
+
| `workerFn` | `Function` | **required** | Function executed in the worker. Receives `runtime.context`. Must be self-contained. |
|
|
36
|
+
| `options.dependencies` | `string[]` | `[]` | Modules to serialise and register in the worker |
|
|
37
|
+
| `options.workerFw` | `Function` | DEFAULT_WORKER_FRAMEWORK | Worker bootstrap: `(runtime, modules, args) => context` |
|
|
38
|
+
| `options.args` | `any[]` | `[]` | JSON-serialisable arguments passed to `workerFw` |
|
|
39
|
+
| `options.terminate` | `Function` | no-op | Cleanup callback before native `Worker.terminate()` |
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### Minimal
|
|
44
|
+
|
|
45
|
+
```js
|
|
46
|
+
const worker = fw.createWorker(
|
|
47
|
+
function({ libs }) {
|
|
48
|
+
console.log(libs.hex.fromBytes(new Uint8Array([255, 0, 1])));
|
|
49
|
+
},
|
|
50
|
+
{ dependencies: ['hex'] }
|
|
51
|
+
);
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### With arguments
|
|
55
|
+
|
|
56
|
+
```js
|
|
57
|
+
const worker = fw.createWorker(
|
|
58
|
+
function({ libs, args }) {
|
|
59
|
+
const [url, maxRetries] = args;
|
|
60
|
+
// processing...
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
dependencies: ['hex', 'b64'],
|
|
64
|
+
args: ['https://api.example.com', 3]
|
|
65
|
+
}
|
|
66
|
+
);
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Listening to messages
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
const worker = fw.createWorker(
|
|
73
|
+
function({ process }) {
|
|
74
|
+
// Send a message to the main thread
|
|
75
|
+
process.postMessage({ type: 'result', value: 42 });
|
|
76
|
+
},
|
|
77
|
+
{ dependencies: ['processMessage'], workerFw: processMessage.workerFramework }
|
|
78
|
+
);
|
|
79
|
+
|
|
80
|
+
worker.onmessage = function(event) {
|
|
81
|
+
console.log('received:', event.data); // { type: 'result', value: 42 }
|
|
82
|
+
};
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### Inline (same API, no worker)
|
|
86
|
+
|
|
87
|
+
```js
|
|
88
|
+
// Identical execution without worker — useful for debugging
|
|
89
|
+
const libs = fw.runtime.resolveAll(['hex', 'b64'], { instances: new Map() });
|
|
90
|
+
myWorkerFn({ libs, process: {}, args: ['arg1'] });
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Initialisation sequence inside the worker
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
1. Logger bootstrap (if ENV.LOG)
|
|
97
|
+
2. runtimeSource (constants + private helpers + ModuleRuntime class)
|
|
98
|
+
3. new ModuleRuntime()
|
|
99
|
+
4. Registration of ALL modules in the graph (entry + transitive dependencies)
|
|
100
|
+
5. workerFw(runtime, dependenciesUserSpecs, args) → runtime.context
|
|
101
|
+
6. workerFn(runtime.context)
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
> **Note (since semver introduction)**: the injected code includes
|
|
105
|
+
> `runtimeSource` which combines the `ModuleRuntime` class AND its private helpers
|
|
106
|
+
> (`semverCompare`, `parseSpec`, `canonical`, `SEMVER_RE`, …). Without this grouping,
|
|
107
|
+
> `ModuleRuntime.toString()` alone is insufficient — the class would reference
|
|
108
|
+
> symbols absent from the worker context → `ReferenceError`.
|
|
109
|
+
|
|
110
|
+
## Default `workerFw`
|
|
111
|
+
|
|
112
|
+
```js
|
|
113
|
+
function DEFAULT_WORKER_FRAMEWORK(runtime, modules, args) {
|
|
114
|
+
const libs = runtime.resolveAll(modules);
|
|
115
|
+
const process = {};
|
|
116
|
+
return { libs, process, args };
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
`workerFn` therefore receives `{ libs, process, args }` unless `workerFw` is customised.
|
|
121
|
+
|
|
122
|
+
### `libs` keys — keyed by user specs, not canonical
|
|
123
|
+
|
|
124
|
+
The keys of `libs` correspond **textually** to the strings passed in
|
|
125
|
+
`options.dependencies`. No automatic canonicalisation (no `@version` suffix added):
|
|
126
|
+
|
|
127
|
+
```js
|
|
128
|
+
fw.createWorker(({ libs }) => {
|
|
129
|
+
libs.hex.fromBytes(...); // ✓ keyed on 'hex'
|
|
130
|
+
libs['utf8@1.0.0'].decode(...); // ✓ keyed on 'utf8@1.0.0'
|
|
131
|
+
}, {
|
|
132
|
+
dependencies: ['hex', 'utf8@1.0.0']
|
|
133
|
+
});
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
Behaviour aligned with main thread:
|
|
137
|
+
`runtime.resolveAll(['hex'])` → `{ hex: <hex> }`.
|
|
138
|
+
|
|
139
|
+
**Transitive dependencies** are registered in the worker's runtime
|
|
140
|
+
(and thus resolvable via `runtime.resolve(...)`) but are **not exposed**
|
|
141
|
+
in `libs` by default. To access them, either declare them explicitly in
|
|
142
|
+
`dependencies`, or use a custom `workerFw`.
|
|
143
|
+
|
|
144
|
+
## Framework messages (`__fw: true`)
|
|
145
|
+
|
|
146
|
+
Internal messages (logs, commands) are intercepted by `worker-helper.js`
|
|
147
|
+
via `event.stopImmediatePropagation()` and **never** bubble up to user
|
|
148
|
+
`onmessage` handlers. When `ENV.LOG=true`, messages `{ __fw: true,
|
|
149
|
+
__type: 'log', msg }` are also pushed to the main-thread log (`log.__push(msg)`).
|
|
150
|
+
|
|
151
|
+
## Cleanup
|
|
152
|
+
|
|
153
|
+
```js
|
|
154
|
+
const worker = fw.createWorker(fn, {
|
|
155
|
+
terminate: () => console.log('worker terminated')
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
worker.terminate(); // → cleanup() → URL.revokeObjectURL + callback + native terminate
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
`worker.terminate()` is **idempotent** — subsequent calls are no-ops
|
|
162
|
+
(URL not re-revoked, callback not re-invoked, listener not re-removed).
|
|
163
|
+
|
|
164
|
+
If `new Worker(...)` fails (constructor throws), the Blob URL is
|
|
165
|
+
revoked before rethrowing — no leak.
|
|
166
|
+
|
|
167
|
+
## Notes
|
|
168
|
+
|
|
169
|
+
- `workerFn` and `workerFw` are converted to string via `.toString()` — they must not capture variables from the main scope (closures), reference `document`/`window`, or use ES module imports.
|
|
170
|
+
- Transitive dependencies are registered in the worker runtime but are not exposed in `libs` by default — declare them explicitly in `dependencies` to access them.
|
|
171
|
+
- `worker.terminate()` is idempotent — subsequent calls are no-ops (URL not re-revoked, callback not re-invoked).
|
|
172
|
+
- If `new Worker(blobUrl)` fails, the Blob URL is revoked before rethrowing — no leak.
|
|
173
|
+
|
|
174
|
+
## See also
|
|
175
|
+
|
|
176
|
+
- [Workers guide](../../guide/workers.md)
|
|
177
|
+
- [processMessage](../process/message.md)
|
|
178
|
+
- [processRPC](../process/rpc.md)
|
|
179
|
+
- [ModuleRuntime.serialize](./runtime.md)
|
|
180
|
+
- [`src/core/worker-helper.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/core/worker-helper.test.js) — unit tests (code generation, sandbox round-trip, idempotent terminate, `__fw` messages).
|