@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,342 @@
|
|
|
1
|
+
# Workflow — Creating a module
|
|
2
|
+
|
|
3
|
+
> Operational plan for adding a module to the framework. Aimed primarily at an LLM (Claude Sonnet 4.6+) or a developer running the procedure for the first time.
|
|
4
|
+
|
|
5
|
+
This page is an **execution plan**, not a course. For each phase, it points to the reference guides to load.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Prerequisites: guides to read before starting
|
|
10
|
+
|
|
11
|
+
| Guide | Purpose |
|
|
12
|
+
|-------|-----------|
|
|
13
|
+
| [`module-pattern.md`](./module-pattern.md) | `{ name, dependencies, deps, factory }` structure, purity rules, worker serialisation |
|
|
14
|
+
| [`security.md`](./security.md) | APIs blocked by `sanity/base.js` — **never** use in a factory |
|
|
15
|
+
| [`test-format.md`](./test-format.md) | `*.test.js` file convention (bun) |
|
|
16
|
+
| [`doc-format.md`](./doc-format.md) | `docs/api/*.md` page convention + README cascade |
|
|
17
|
+
|
|
18
|
+
Load these 4 files into context before phase 1.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Phase 0 — Discovery / scoping
|
|
23
|
+
|
|
24
|
+
**Goal**: avoid duplicates, identify reusable dependencies.
|
|
25
|
+
|
|
26
|
+
### 0.1 — Verify no existing module already covers the need
|
|
27
|
+
|
|
28
|
+
Read the exhaustive table in [`docs/README.md`](../README.md). Also read the `README.md` of the target category (e.g. [`docs/api/io/codec/README.md`](../api/io/codec/README.md)) for its precise context.
|
|
29
|
+
|
|
30
|
+
For modules with fuzzy scope, `grep` the code and docs:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
grep -ri "<keyword>" docs/api/
|
|
34
|
+
grep -ri "<keyword>" src/core/
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### 0.2 — Identify reusable dependencies
|
|
38
|
+
|
|
39
|
+
Before writing `crypto.getRandomValues`, custom `JSON.parse`, etc., **check**:
|
|
40
|
+
|
|
41
|
+
| Need | Existing module |
|
|
42
|
+
|--------|--------------------------------------------------------------------------------|
|
|
43
|
+
| String ↔ bytes | [`utf8`](../api/io/codec/utf8.md) |
|
|
44
|
+
| Hex / Base64 / Base32 / Base58 | [`hex`](../api/io/codec/hex.md), [`b64`](../api/io/codec/b64.md), [`base32`](../api/io/codec/base32.md), [`base58`](../api/io/codec/base58.md) |
|
|
45
|
+
| CSPRNG / DRBG | `random` (source: `src/crypto/utils/random.js`) |
|
|
46
|
+
| UUID v1 / v4 | [`uuid`](../api/crypto/utils/uuid.md) |
|
|
47
|
+
| CRC32 / Adler32 | [`crc32`](../api/io/calc/crc32.md), [`adler32`](../api/io/calc/adler32.md) |
|
|
48
|
+
| Async queue | [`queue`](../api/io/utils/queue.md) |
|
|
49
|
+
| Type / schema validation | [`valid`](../api/io/utils/valid.md) |
|
|
50
|
+
| Binary serialisation | [`buffer`](../api/io/codec/buffer.md), [`cbor`](../api/io/codec/cbor.md), [`msgpack`](../api/io/codec/msgpack.md) |
|
|
51
|
+
|
|
52
|
+
Any functionality available in the framework **must** be declared as a dependency rather than re-implemented.
|
|
53
|
+
|
|
54
|
+
### 0.3 — Choose the location
|
|
55
|
+
|
|
56
|
+
Follow the existing tree:
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
src/core/
|
|
60
|
+
├── io/
|
|
61
|
+
│ ├── codec/ ← parsing/serialisation
|
|
62
|
+
│ ├── compress/ ← compression
|
|
63
|
+
│ ├── calc/ ← checksums, math
|
|
64
|
+
│ └── utils/ ← neutral utilities
|
|
65
|
+
├── dom/
|
|
66
|
+
│ ├── rendering/ ← parser, render, template, uiSession
|
|
67
|
+
│ ├── query/ ← dom, events, media
|
|
68
|
+
│ ├── display/ ← animate, fullscreen
|
|
69
|
+
│ ├── fs/ ← indexedDB, storage, download
|
|
70
|
+
│ ├── net/ ← ajax, ws
|
|
71
|
+
│ └── utils/ ← entropyCollector, ua, clipboard
|
|
72
|
+
├── crypto/ ← cryptographic primitives
|
|
73
|
+
└── io/process/ ← message, rpc
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
If the module doesn't fit anywhere: ask the question before creating a new folder.
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## Phase 1 — Source implementation
|
|
81
|
+
|
|
82
|
+
**Target**: `packages/front/fw/<path>/<name>.js`
|
|
83
|
+
|
|
84
|
+
### 1.1 — Mandatory skeleton
|
|
85
|
+
|
|
86
|
+
```js
|
|
87
|
+
import { dep1 } from '../<category>/<dep1>.js';
|
|
88
|
+
import { dep2 } from '../<category>/<dep2>.js';
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* @description
|
|
92
|
+
* <Long description: scope, implemented RFC, alternatives, out of scope.>
|
|
93
|
+
*
|
|
94
|
+
* @example
|
|
95
|
+
* const <name> = registry.resolve('<name>');
|
|
96
|
+
* <name>.method1(...);
|
|
97
|
+
*/
|
|
98
|
+
// NB: do NOT write `@module` / `@category` by hand. The generated API reference
|
|
99
|
+
// (TypeDoc) derives them automatically from the `type` field / path
|
|
100
|
+
// via `integrations/typedoc/categorize.js` — any value written here would
|
|
101
|
+
// be ignored/overwritten. Similarly, type the `factory()` return with a named
|
|
102
|
+
// `@typedef` (e.g. `@typedef {object} <Name>API`) rather than an inline object.
|
|
103
|
+
export const <name> = {
|
|
104
|
+
name: '<name>',
|
|
105
|
+
version: '1.0.0',
|
|
106
|
+
type: 'fw.<category>', // taxonomy (optional but recommended)
|
|
107
|
+
dependencies: ['dep1', 'dep2'], // names (string) — runtime contract
|
|
108
|
+
deps: [dep1, dep2], // direct JS refs — bundler mirror
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* @param {Object} dep1 ...
|
|
112
|
+
* @returns {Object}
|
|
113
|
+
*/
|
|
114
|
+
factory(dep1, dep2) {
|
|
115
|
+
// private state, private helpers (prefixed _xxx or in closure)
|
|
116
|
+
|
|
117
|
+
function publicMethod(...) { ... }
|
|
118
|
+
|
|
119
|
+
return { publicMethod, ... };
|
|
120
|
+
}
|
|
121
|
+
};
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
**`deps` ↔ `dependencies` invariant**: both arrays must list the
|
|
125
|
+
same modules in the **same order**. Validation is performed at build
|
|
126
|
+
time by `tools/fw-bundler` (`bundle`) — a mismatch is a fatal error.
|
|
127
|
+
|
|
128
|
+
### 1.2 — Absolute rules (security.md reminder)
|
|
129
|
+
|
|
130
|
+
Inside the `factory`:
|
|
131
|
+
|
|
132
|
+
- ❌ `Math.random` → use `random.bytes()` (dependency)
|
|
133
|
+
- ❌ `crypto.randomUUID` → use `uuid.v4()` (dependency)
|
|
134
|
+
- ❌ `eval`, `new Function(...)`, dynamic `import()`
|
|
135
|
+
- ❌ `document.*`, `window.*`, `history.*`
|
|
136
|
+
- ❌ `performance.now`, `performance.mark` (timing-channel)
|
|
137
|
+
- ❌ `innerHTML` (redirected to `innerText` by sanity)
|
|
138
|
+
- ❌ Closures over main-thread values (not serialisable)
|
|
139
|
+
- ❌ Side-effects at instantiation (no `fetch`, listeners, console at factory top-level)
|
|
140
|
+
|
|
141
|
+
If the module is a **DOM module** (not worker-safe), `document`/`window` are OK but must be declared explicitly (`worker-safe: false`).
|
|
142
|
+
|
|
143
|
+
### 1.3 — Registration in the catalogue
|
|
144
|
+
|
|
145
|
+
`src/core/modules.js` is the self-contained catalogue — `import` at the top, `default
|
|
146
|
+
export [...]` at the bottom. **No named exports.** Add:
|
|
147
|
+
|
|
148
|
+
1. An `import` in the appropriate section (grouped by subtree):
|
|
149
|
+
```js
|
|
150
|
+
// <section>
|
|
151
|
+
import { <name> } from '../<path>/<name>.js';
|
|
152
|
+
```
|
|
153
|
+
2. A reference in the `export default [...]` array, near modules of the same family (order is free as long as the array remains topologically consistent — `registerAll` iterates without sorting).
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## Phase 2 — Tests
|
|
158
|
+
|
|
159
|
+
**Target**: `packages/front/fw/<path>/<name>.test.js`
|
|
160
|
+
|
|
161
|
+
### 2.1 — Follow [`test-format.md`](./test-format.md)
|
|
162
|
+
|
|
163
|
+
Mandatory sections:
|
|
164
|
+
|
|
165
|
+
1. Metadata test (`name`, `dependencies`, `factory`)
|
|
166
|
+
2. Factory API test (all public members present and typed)
|
|
167
|
+
3. `describe` per public method
|
|
168
|
+
4. Error tests / edge cases
|
|
169
|
+
5. Round-trip if applicable
|
|
170
|
+
6. Official RFC vectors if a standard is implemented
|
|
171
|
+
|
|
172
|
+
### 2.2 — Manual dependency wiring
|
|
173
|
+
|
|
174
|
+
```js
|
|
175
|
+
import { myModule } from './myModule.js';
|
|
176
|
+
import { utf8 } from './utf8.js';
|
|
177
|
+
|
|
178
|
+
// Minimal stub for deps outside the test's scope if needed
|
|
179
|
+
const inst = myModule.factory(utf8.factory(), /* other deps */);
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
### 2.3 — Run
|
|
183
|
+
|
|
184
|
+
```bash
|
|
185
|
+
bun test packages/front/fw/<path>/<name>.test.js
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
**No test must fail.** Iterate until 100% pass.
|
|
189
|
+
|
|
190
|
+
Then run the full directory to verify no regression:
|
|
191
|
+
|
|
192
|
+
```bash
|
|
193
|
+
bun test packages/front/fw/<path>/
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
## Phase 3 — Documentation
|
|
199
|
+
|
|
200
|
+
**Target**: `docs/api/<path>/<name>.md`
|
|
201
|
+
|
|
202
|
+
### 3.1 — Follow [`doc-format.md`](./doc-format.md)
|
|
203
|
+
|
|
204
|
+
Canonical skeleton with:
|
|
205
|
+
- Frontmatter (`module`, `category`, `dependencies`, `returns`, `worker-safe`, `status: complete`)
|
|
206
|
+
- H1 + tagline ≤ 15 words
|
|
207
|
+
- Bold metadata line
|
|
208
|
+
- Resolve section
|
|
209
|
+
- API table
|
|
210
|
+
- Sub-sections per complex method
|
|
211
|
+
- End-to-end runnable examples
|
|
212
|
+
- Worker Usage (if worker-safe)
|
|
213
|
+
- Notes (≥ 2 bullets)
|
|
214
|
+
- See also (≥ 1 link)
|
|
215
|
+
|
|
216
|
+
### 3.2 — Verify internal links
|
|
217
|
+
|
|
218
|
+
All links must be **relative** and functional. No absolute URLs to the repo.
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## Phase 4 — README cascade
|
|
223
|
+
|
|
224
|
+
**Every** module creation impacts a README chain. Update **in order**:
|
|
225
|
+
|
|
226
|
+
### 4.1 — Leaf category README
|
|
227
|
+
|
|
228
|
+
E.g. `docs/api/io/codec/README.md`. Add a row to the module table:
|
|
229
|
+
|
|
230
|
+
```markdown
|
|
231
|
+
| [<name>](./<name>.md) | `{method1, ...}` | `dep1` | Short description |
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
If the category has multiple families (like codec: bytes↔string / value↔bytes / text / HTTP), place the module in the correct family of the introduction paragraph.
|
|
235
|
+
|
|
236
|
+
### 4.2 — Section README
|
|
237
|
+
|
|
238
|
+
E.g. `docs/api/io/README.md`. Verify the module list for the category includes the new name.
|
|
239
|
+
|
|
240
|
+
### 4.3 — Root API README
|
|
241
|
+
|
|
242
|
+
E.g. `docs/api/README.md`. Verify the row for the target category includes the new module.
|
|
243
|
+
|
|
244
|
+
### 4.4 — Root docs README
|
|
245
|
+
|
|
246
|
+
`docs/README.md`. Add a row to the **exhaustive table** of all modules:
|
|
247
|
+
|
|
248
|
+
```markdown
|
|
249
|
+
| `<name>` | <category> | <quick description> |
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Maintain consistent ordering (grouped by category as in the existing file).
|
|
253
|
+
|
|
254
|
+
---
|
|
255
|
+
|
|
256
|
+
## Phase 5 — Final verification
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
# 1. All tests in the directory pass
|
|
260
|
+
bun test packages/front/fw/<path>/
|
|
261
|
+
|
|
262
|
+
# 2. No regression beyond
|
|
263
|
+
bun test src/core/
|
|
264
|
+
|
|
265
|
+
# 3. Visual inspection
|
|
266
|
+
# - Module page reads coherently
|
|
267
|
+
# - Internal links functional
|
|
268
|
+
# - All READMEs updated
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
### Delivery checklist
|
|
272
|
+
|
|
273
|
+
- [ ] `packages/front/fw/<path>/<name>.js` — module created, conventions respected
|
|
274
|
+
- [ ] `dependencies` AND `deps` fields consistent (same order, same names)
|
|
275
|
+
- [ ] `src/core/modules.js` — `import` added + entry in the `default export` array
|
|
276
|
+
- [ ] `packages/front/fw/<path>/<name>.test.js` — tests created and 100% pass
|
|
277
|
+
- [ ] `bun test packages/front/fw/<path>/` — no regression
|
|
278
|
+
- [ ] `docs/api/<path>/<name>.md` — page created following doc-format
|
|
279
|
+
- [ ] `docs/api/<path>/README.md` — entry added
|
|
280
|
+
- [ ] `docs/api/<section>/README.md` — section up to date
|
|
281
|
+
- [ ] `docs/api/README.md` — API index up to date
|
|
282
|
+
- [ ] `docs/README.md` — root table up to date
|
|
283
|
+
- [ ] No broken internal links
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## Pattern for extending an existing module
|
|
288
|
+
|
|
289
|
+
When the goal is to **extend** an existing module (add methods, not create a new one):
|
|
290
|
+
|
|
291
|
+
1. **Fully preserve the existing API** — search for consumers with:
|
|
292
|
+
```bash
|
|
293
|
+
grep -r "<name>\.<methodLegacy>" source/
|
|
294
|
+
```
|
|
295
|
+
No existing signature or name must change.
|
|
296
|
+
2. Add new methods after the existing ones in the source file.
|
|
297
|
+
3. Run existing tests first — they must all pass without modification.
|
|
298
|
+
4. Add a `describe('<new surface>')` section in the test.
|
|
299
|
+
5. Extend the docs: new `## API` or new sub-section, without breaking the organisation.
|
|
300
|
+
6. README cascade unchanged (same module, same name).
|
|
301
|
+
|
|
302
|
+
Example: extending `valid` with schema validation — the legacy API (`is`, `isNumber`, …) is fully preserved, and `validate` / `test` / `compile` are added.
|
|
303
|
+
|
|
304
|
+
---
|
|
305
|
+
|
|
306
|
+
## Pattern for adding a dependency to an existing module
|
|
307
|
+
|
|
308
|
+
When a module gains a dependency (e.g. `mime` adding `random` for CSPRNG):
|
|
309
|
+
|
|
310
|
+
1. Add the corresponding `import` at the top of the source file.
|
|
311
|
+
2. Update `dependencies: [...]` **and** `deps: [...]` in the source — same order.
|
|
312
|
+
3. Update the `factory(dep1, dep2, ...)` signature in order.
|
|
313
|
+
4. **All test sites** manually instantiating the factory must be updated.
|
|
314
|
+
5. Doc frontmatter: `dependencies: [dep1, dep2, ...]`.
|
|
315
|
+
6. Bold metadata line in the doc: `**Deps** \`dep1\`, \`dep2\``.
|
|
316
|
+
7. Table in the category README: `Deps` column.
|
|
317
|
+
8. Verify the new dependency introduces no cycle (`runtime._buildGraph`).
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## Frequent anti-patterns
|
|
322
|
+
|
|
323
|
+
| Anti-pattern | Good practice |
|
|
324
|
+
|--------------|----------------|
|
|
325
|
+
| Re-implement UTF-8/hex/base64 inline | Declare `utf8`/`hex`/`b64` as deps |
|
|
326
|
+
| `console.log` at factory top-level | Side-effect forbidden — `logger` if needed |
|
|
327
|
+
| Stub `crypto` in a production test | Stub only the strict minimum, keep `crypto.getRandomValues` |
|
|
328
|
+
| Put docs in `source/` or a README in `docs/` | Strict separation: code in `source/`, docs in `docs/` |
|
|
329
|
+
| Skip the README cascade | Discoverability broken — the root table must always reflect the state |
|
|
330
|
+
| `test.skip` or `test.only` committed | Tests either green or deleted |
|
|
331
|
+
| Frontmatter `status: complete` on a page without Resolve / API / Example | `status: stub` until actually complete |
|
|
332
|
+
| Dependency on a DOM module from a worker-safe module | Breaks serialisation — refactor or mark `worker-safe: false` |
|
|
333
|
+
|
|
334
|
+
---
|
|
335
|
+
|
|
336
|
+
## See also
|
|
337
|
+
|
|
338
|
+
- [Module pattern](./module-pattern.md)
|
|
339
|
+
- [Security (sanity)](./security.md)
|
|
340
|
+
- [Test format](./test-format.md)
|
|
341
|
+
- [Documentation format](./doc-format.md)
|
|
342
|
+
- [Workers](./workers.md)
|
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
# Module Pattern
|
|
2
|
+
|
|
3
|
+
The fundamental pattern of the framework: each module is a descriptor object with a pure factory.
|
|
4
|
+
|
|
5
|
+
## Structure
|
|
6
|
+
|
|
7
|
+
```js
|
|
8
|
+
import { hex } from '../io/codec/hex.js';
|
|
9
|
+
import { b64 } from '../io/codec/b64.js';
|
|
10
|
+
|
|
11
|
+
export const myModule = {
|
|
12
|
+
name: 'myModule', // unique identifier (string)
|
|
13
|
+
version: '1.0.0', // semver (optional — default '0.0.0')
|
|
14
|
+
type: 'fw.io.codec', // taxonomy (optional): fw.<sub> | sd.<sub> | sde.<sub> | sdc.<sub> | lib.<sub>
|
|
15
|
+
dependencies: ['hex', 'b64@1.0.0'], // specs ('name' = latest, 'name@version' = exact)
|
|
16
|
+
deps: [hex, b64], // direct JS refs — bundler mirror of `dependencies`
|
|
17
|
+
|
|
18
|
+
factory(hex, b64) { // args = resolved dependencies in order
|
|
19
|
+
// private state — isolated, never shared between instances
|
|
20
|
+
const state = {};
|
|
21
|
+
|
|
22
|
+
return {
|
|
23
|
+
method() { /* ... */ }
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
};
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### The `dependencies` / `deps` tandem
|
|
30
|
+
|
|
31
|
+
| Field | Role | Format |
|
|
32
|
+
|---|---|---|
|
|
33
|
+
| `dependencies` | **Runtime resolution contract.** Specifies the names (and versions) resolved by `runtime.resolve` and serialised towards workers. | `string[]` — `'name'` or `'name@version'`. |
|
|
34
|
+
| `deps` | **Bundler mirror.** Direct JS references to the dependency modules, statically imported at the top of the source file. Allows Rollup / Webpack / Vite / esbuild to trace the graph via `import` and tree-shake correctly. | `ModuleDefinition[]` — no strings. |
|
|
35
|
+
|
|
36
|
+
**Invariant** (validated at build time):
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
module.deps.map(d => d.name) === module.dependencies.map(s => s.split('@')[0])
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Both **must** list the same modules in the same order. `dependencies` carries
|
|
43
|
+
version constraints; `deps` carries JS references. Workers only receive
|
|
44
|
+
`dependencies` (the runtime serialisation), not `deps` — the import graph
|
|
45
|
+
has no meaning inside a Worker, which has no module loader.
|
|
46
|
+
|
|
47
|
+
**Absolute rules:**
|
|
48
|
+
1. `factory` is a **pure** function — no access to `window`, `document`, global variables
|
|
49
|
+
2. No side-effects when calling the factory (no `fetch`, `console.log`, listeners)
|
|
50
|
+
3. **Serialisable** code — `factory.toString()` must produce valid JS (no closures over main-thread values)
|
|
51
|
+
4. Dependencies **declared explicitly** in `dependencies[]` — no direct `import`
|
|
52
|
+
|
|
53
|
+
### `version` and `type` fields
|
|
54
|
+
|
|
55
|
+
| Field | Format | Validation at `register` |
|
|
56
|
+
|---|---|---|
|
|
57
|
+
| `version` | semver `MAJOR.MINOR.PATCH[-pre][+build]` | strict regex; default `'0.0.0'` if absent |
|
|
58
|
+
| `type` | `^(fw\|sde\|lib)\.[a-z][\w.]*$` | strict regex; tolerated absent |
|
|
59
|
+
|
|
60
|
+
`runtime.register()` **throws** on invalid version or type. Validation is backwards-compatible: a legacy module without `version`/`type` continues to work.
|
|
61
|
+
|
|
62
|
+
### Coexisting multi-version
|
|
63
|
+
|
|
64
|
+
Several `version` values of the same `name` can coexist in the same runtime:
|
|
65
|
+
|
|
66
|
+
```js
|
|
67
|
+
runtime.register({ name: 'codec', version: '1.0.0', dependencies: [], factory: () => v1 });
|
|
68
|
+
runtime.register({ name: 'codec', version: '2.0.0', dependencies: [], factory: () => v2 });
|
|
69
|
+
|
|
70
|
+
runtime.resolve('codec'); // → v2 (latest)
|
|
71
|
+
runtime.resolve('codec@1.0.0'); // → v1 (exact)
|
|
72
|
+
runtime.has('codec', '2.0.0'); // → true
|
|
73
|
+
runtime.list({ name: 'codec' }); // → [def@1.0.0, def@2.0.0]
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Enables **progressive migration**: two versions of a module can be used by different consumers during a transition.
|
|
77
|
+
|
|
78
|
+
## Return shapes
|
|
79
|
+
|
|
80
|
+
Factories return different shapes depending on the module:
|
|
81
|
+
|
|
82
|
+
### 1. API object (most common)
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
// hex, b64, utf8, dom, events, ...
|
|
86
|
+
const hex = runtime.resolve('hex');
|
|
87
|
+
hex.fromBytes(bytes); // direct method
|
|
88
|
+
hex.toBytes(str);
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### 2. Constructor
|
|
92
|
+
|
|
93
|
+
```js
|
|
94
|
+
// crc32, adler32, queue
|
|
95
|
+
const CRC32 = runtime.resolve('crc32');
|
|
96
|
+
const checksum = new CRC32();
|
|
97
|
+
checksum.append(data);
|
|
98
|
+
checksum.get(); // → number
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### 3. Value generator
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
// uuid
|
|
105
|
+
const uuid = runtime.resolve('uuid');
|
|
106
|
+
uuid.v1(); // string UUID v1 (time-based)
|
|
107
|
+
uuid.v1(true); // raw Uint8Array[16]
|
|
108
|
+
uuid.v4(); // string UUID v4 (random)
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### 4. Complex namespaced object
|
|
112
|
+
|
|
113
|
+
```js
|
|
114
|
+
// processMessage
|
|
115
|
+
const pm = runtime.resolve('processMessage');
|
|
116
|
+
pm.sync(); // in-memory channel
|
|
117
|
+
pm.worker(); // proxy inside a Worker
|
|
118
|
+
pm.workerCommand(ref); // commands to a Worker
|
|
119
|
+
pm.workerFramework(runtime, modules, args); // standard bootstrap
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Singleton vs isolation
|
|
123
|
+
|
|
124
|
+
By default, `runtime.resolve` returns the **same instance** on every call:
|
|
125
|
+
|
|
126
|
+
```js
|
|
127
|
+
const a = runtime.resolve('hex');
|
|
128
|
+
const b = runtime.resolve('hex');
|
|
129
|
+
a === b; // true — singleton
|
|
130
|
+
|
|
131
|
+
// Fresh instance (not cached)
|
|
132
|
+
const c = runtime.resolve('hex', { isolation: true });
|
|
133
|
+
const d = runtime.resolve('hex', { isolation: true });
|
|
134
|
+
c === d; // false
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### Custom instance map
|
|
138
|
+
|
|
139
|
+
For isolated groups of instances sharing the same registry:
|
|
140
|
+
|
|
141
|
+
```js
|
|
142
|
+
const instancesA = new Map();
|
|
143
|
+
const instancesB = new Map();
|
|
144
|
+
|
|
145
|
+
const hexA = runtime.resolve('hex', { instances: instancesA });
|
|
146
|
+
const hexB = runtime.resolve('hex', { instances: instancesB });
|
|
147
|
+
hexA === hexB; // false — separate instances
|
|
148
|
+
|
|
149
|
+
// Typical use: inline vs worker side by side
|
|
150
|
+
const libs = runtime.resolveAll(['hex', 'uuid'], { instances: new Map() });
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## Module naming
|
|
154
|
+
|
|
155
|
+
Current format (short):
|
|
156
|
+
```
|
|
157
|
+
'hex', 'b64', 'utf8', 'uuid', 'template', 'uiSession', ...
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
Recommended format for new modules:
|
|
161
|
+
```
|
|
162
|
+
'io_codec_hex', 'dom_rendering_template', ...
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
## Dynamic registration
|
|
166
|
+
|
|
167
|
+
```js
|
|
168
|
+
const myModule = {
|
|
169
|
+
name: 'dynModule',
|
|
170
|
+
version: '1.0.0',
|
|
171
|
+
dependencies: [],
|
|
172
|
+
deps: [],
|
|
173
|
+
factory() {
|
|
174
|
+
return (x) => x * 2;
|
|
175
|
+
}
|
|
176
|
+
};
|
|
177
|
+
|
|
178
|
+
fw.runtime.register(myModule);
|
|
179
|
+
const double = fw.runtime.resolve('dynModule');
|
|
180
|
+
double(21); // 42
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
### Transitive registration via `deps`
|
|
184
|
+
|
|
185
|
+
`registerDeep(module)` registers `module` **and** recursively all its `deps`
|
|
186
|
+
(depth-first, idempotent, cycle-safe). `registerAllDeep([...])`
|
|
187
|
+
applies the same logic to an array and shares the "seen" set across entries.
|
|
188
|
+
|
|
189
|
+
```js
|
|
190
|
+
import { ModuleRuntime } from '@awacloud/fw/core/runtime';
|
|
191
|
+
import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js';
|
|
192
|
+
|
|
193
|
+
const runtime = new ModuleRuntime();
|
|
194
|
+
runtime.registerDeep(sanitize);
|
|
195
|
+
// → sanitize + parser + render + secPolicy + their transitives registered
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
Typical use:
|
|
199
|
+
|
|
200
|
+
| Method | When |
|
|
201
|
+
|---|---|
|
|
202
|
+
| `register(module)` | Single module, dependencies already registered. |
|
|
203
|
+
| `registerAll([modules])` | Pre-sorted array (e.g. `core/modules.js` listing everything in canonical order). |
|
|
204
|
+
| `registerDeep(module)` | Manual composition — let the runtime find transitives via `deps`. |
|
|
205
|
+
| `registerAllDeep([modules])` | Same for a subset (e.g. a Vite preset). |
|
|
206
|
+
|
|
207
|
+
## Discovery — `runtime.list()`
|
|
208
|
+
|
|
209
|
+
```js
|
|
210
|
+
// All modules in a category
|
|
211
|
+
fw.runtime.list({ type: 'fw.io.codec' }); // exact
|
|
212
|
+
fw.runtime.list({ type: 'fw.' }); // prefix (trailing `.`)
|
|
213
|
+
|
|
214
|
+
// All versions of a module
|
|
215
|
+
fw.runtime.list({ name: 'hex' });
|
|
216
|
+
|
|
217
|
+
// Combinations
|
|
218
|
+
fw.runtime.list({ type: 'sde.', version: '1.0.0' });
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
> **`list()` hands out live definitions, not a read-only view.** The
|
|
222
|
+
> `ModuleDefinition` objects it returns are the registered ones themselves —
|
|
223
|
+
> live `factory`, live `dependencies` array — so a caller can splice
|
|
224
|
+
> `dependencies` in place or replace `factory`. Reserve `list()` for trusted
|
|
225
|
+
> internal code that genuinely needs that write channel (e.g. registration
|
|
226
|
+
> bookkeeping). Anything read-only — devtools, an inspector panel, a status
|
|
227
|
+
> view — should use [`runtime.snapshot()`](../api/core/runtime.md#runtimesnapshotfilter)
|
|
228
|
+
> instead: same filter shape, but frozen metadata rows with no live handles
|
|
229
|
+
> and no instantiation.
|
|
230
|
+
|
|
231
|
+
## Golden rules
|
|
232
|
+
|
|
233
|
+
| Rule | Why |
|
|
234
|
+
|-------|----------|
|
|
235
|
+
| No `import` **inside the factory body** | Not serialisable for workers (top-of-file imports are normal and feed `deps`) |
|
|
236
|
+
| No `document`/`window` in the factory | Not available in workers |
|
|
237
|
+
| No global state | Violates isolation, bugs in workers |
|
|
238
|
+
| Declare all deps in `dependencies[]` AND `deps[]` | Runtime resolution + bundler tree-shaking |
|
|
239
|
+
| Idempotent factory | Testable, cleanly re-instantiable |
|
|
240
|
+
|
|
241
|
+
## See also
|
|
242
|
+
|
|
243
|
+
- [ModuleRuntime API](../api/core/runtime.md)
|
|
244
|
+
- [Web Workers](./workers.md)
|