@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,298 @@
|
|
|
1
|
+
---
|
|
2
|
+
category: guide
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Tutorial: a todo app in under 100 lines
|
|
6
|
+
|
|
7
|
+
> Goal: show how to combine `parser`, `template`, `uiSession`, `ui.list`,
|
|
8
|
+
> `signal` and `form` to build a functional app without a third-party framework,
|
|
9
|
+
> without JSX, without a virtual DOM. Full code at the end, < 100 lines excluding HTML.
|
|
10
|
+
>
|
|
11
|
+
> Prerequisites: having read [getting-started](./getting-started.md) (runtime init,
|
|
12
|
+
> resolving a module). Basic DOM knowledge.
|
|
13
|
+
|
|
14
|
+
## What we are building
|
|
15
|
+
|
|
16
|
+
A todo app with:
|
|
17
|
+
- input + item add (form binding)
|
|
18
|
+
- live list filterable by status (signal + derived)
|
|
19
|
+
- toggle done per item
|
|
20
|
+
- item deletion
|
|
21
|
+
- live counter "N remaining"
|
|
22
|
+
- persistence via the `storage` module (backend `localStorage`, JSON managed)
|
|
23
|
+
|
|
24
|
+
Runtime demo: the HTML input fits in 25 lines, the JS in fewer than 60.
|
|
25
|
+
|
|
26
|
+
## Step 1 — The HTML shell
|
|
27
|
+
|
|
28
|
+
```html
|
|
29
|
+
<!doctype html>
|
|
30
|
+
<html lang="en">
|
|
31
|
+
<head>
|
|
32
|
+
<meta charset="utf-8">
|
|
33
|
+
<meta name="viewport" content="width=device-width,initial-scale=1">
|
|
34
|
+
<title>Todo</title>
|
|
35
|
+
<script src="./fw/dist/build/sanity-base-classic.min.js"></script> <!-- fw security lock, must be first -->
|
|
36
|
+
<!-- default tier is lockdown(); no classic artifact is built for it today
|
|
37
|
+
(prebuild:sanity emits base + community only), so call lockdown() from a
|
|
38
|
+
module script — see docs/guide/security.md § Recommended default -->
|
|
39
|
+
<script type="module" src="./app.js"></script>
|
|
40
|
+
</head>
|
|
41
|
+
<body>
|
|
42
|
+
<main id="app"></main>
|
|
43
|
+
</body>
|
|
44
|
+
</html>
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Sanity is loaded first — it neutralises `eval`, `Function`, `innerHTML`,
|
|
48
|
+
`history.pushState`, `Math.random`, `crypto.randomUUID`, etc. The rest of
|
|
49
|
+
the app works with fw's secure APIs only (hence the `uuid` module
|
|
50
|
+
below, instead of `crypto.randomUUID`).
|
|
51
|
+
|
|
52
|
+
## Step 2 — The templates
|
|
53
|
+
|
|
54
|
+
```js
|
|
55
|
+
// Inline for the demo; in practice load them from an HTML file.
|
|
56
|
+
const SHELL = `
|
|
57
|
+
<section id="root" class="todo">
|
|
58
|
+
<h1>Todos</h1>
|
|
59
|
+
<form id="add">
|
|
60
|
+
<input id="newText" placeholder="Add..." autocomplete="off">
|
|
61
|
+
<button id="submit">+</button>
|
|
62
|
+
</form>
|
|
63
|
+
<nav id="filter">
|
|
64
|
+
<button id="all">All</button>
|
|
65
|
+
<button id="active">Active</button>
|
|
66
|
+
<button id="done">Done</button>
|
|
67
|
+
</nav>
|
|
68
|
+
<ul id="items">\${rows}</ul>
|
|
69
|
+
<footer id="count">#{remaining} remaining</footer>
|
|
70
|
+
</section>
|
|
71
|
+
`;
|
|
72
|
+
|
|
73
|
+
const ROW = `
|
|
74
|
+
<li id="row" data-fw-row-id="#{id}">
|
|
75
|
+
<input id="check" type="checkbox" checked="#{done}">
|
|
76
|
+
<span id="text">#{text}</span>
|
|
77
|
+
<button id="del" data-act="del">×</button>
|
|
78
|
+
</li>
|
|
79
|
+
`;
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
Notation reminder:
|
|
83
|
+
- `#{var}`: substituted value (text or attribute).
|
|
84
|
+
- `${slot}`: placeholder for items.
|
|
85
|
+
- `id="..."`: logical identifier referenced from JS (`sess.get`/`sess.on(blockId, id, …)`).
|
|
86
|
+
|
|
87
|
+
> **Logical `id` ≠ DOM `id`**: at render time, the engine replaces each logical
|
|
88
|
+
> `id="..."` with a **unique generated** identifier (rows of a keyed list cannot
|
|
89
|
+
> share the same `id`). A **delegated** handler therefore cannot filter on
|
|
90
|
+
> `[id$="del"]` — the rendered `id` no longer equals "del". Mark the button
|
|
91
|
+
> with a stable **`data-*`** attribute (`data-act="del"`), which is preserved
|
|
92
|
+
> as-is (like `data-fw-row-id`). To target an element *by its logical id*, use
|
|
93
|
+
> the session instead (`sess.on('app', 'del', …)`), but that is not applicable
|
|
94
|
+
> to dynamic rows — hence the delegation.
|
|
95
|
+
|
|
96
|
+
> **Conditional attribute**: `checked="#{done}"` behaves as a boolean — the attribute
|
|
97
|
+
> is **set** when `done` is true, **omitted** when it is `false`/`null`/`undefined`
|
|
98
|
+
> (cf. `applyAttributes`). This is what makes the checkbox reflect the `done`
|
|
99
|
+
> state on each (re)render of the row — including after a `list.sync` that
|
|
100
|
+
> recreates the row.
|
|
101
|
+
|
|
102
|
+
## Step 3 — Runtime bootstrap
|
|
103
|
+
|
|
104
|
+
```js
|
|
105
|
+
import { runtime } from '@awacloud/fw';
|
|
106
|
+
import modules from '@awacloud/fw/core/modules';
|
|
107
|
+
|
|
108
|
+
// After the refactor: no module is pre-registered by main.js.
|
|
109
|
+
// The user must register the full set (or a subset) before the
|
|
110
|
+
// first `runtime.resolve(...)`. `registerAll` accepts the default export
|
|
111
|
+
// of `core/modules.js` (an array of descriptors `{ name, deps, factory }`).
|
|
112
|
+
runtime.registerAll(modules);
|
|
113
|
+
|
|
114
|
+
const tpl = runtime.resolve('template');
|
|
115
|
+
const ui = runtime.resolve('uiSession');
|
|
116
|
+
const signal = runtime.resolve('signal');
|
|
117
|
+
const form = runtime.resolve('form');
|
|
118
|
+
const dom = runtime.resolve('dom');
|
|
119
|
+
const uuid = runtime.resolve('uuid'); // v4 ids (crypto.randomUUID is neutralised by sanity)
|
|
120
|
+
const store = runtime.resolve('storage').local; // localStorage + JSON; null if unavailable
|
|
121
|
+
|
|
122
|
+
const ctx = 'todo';
|
|
123
|
+
tpl.init(ctx, { to: document.getElementById('app'), main: true });
|
|
124
|
+
const sess = ui(ctx);
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
`tpl.init` registers the render context on the `<main>`; `ui(ctx)` creates
|
|
128
|
+
a session, a high-level facade manipulated for the rest.
|
|
129
|
+
|
|
130
|
+
## Step 4 — Reactive state
|
|
131
|
+
|
|
132
|
+
```js
|
|
133
|
+
const items = signal.create(store?.get('todos') || []);
|
|
134
|
+
const filter = signal.create('all'); // 'all' | 'active' | 'done'
|
|
135
|
+
const visible = signal.derived([items, filter], (xs, f) =>
|
|
136
|
+
f === 'all' ? xs : xs.filter(x => f === 'done' ? x.done : !x.done)
|
|
137
|
+
);
|
|
138
|
+
const remaining = signal.derived([items], xs => xs.filter(x => !x.done).length);
|
|
139
|
+
|
|
140
|
+
// Automatic persistence (JSON serialisation managed by the storage module).
|
|
141
|
+
signal.effect(() => store?.set('todos', items.get()));
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
Four signals suffice:
|
|
145
|
+
- `items`: source of truth (array of `{id, text, done}` objects).
|
|
146
|
+
- `filter`: active filter.
|
|
147
|
+
- `visible`: derived — always synchronised with `items`+`filter`.
|
|
148
|
+
- `remaining`: derived counter.
|
|
149
|
+
|
|
150
|
+
The `effect` persists on every `items` change, without manual setup.
|
|
151
|
+
|
|
152
|
+
> **Why `storage` instead of raw `localStorage`?** `localStorage` is not
|
|
153
|
+
> blocked by sanity — using it directly would work. But the
|
|
154
|
+
> [`storage`](../api/dom/fs/storage.md) module (`src/dom/fs/storage.js`) is the
|
|
155
|
+
> idiomatic option: `storage.local.get/set` serialises/deserialises JSON for
|
|
156
|
+
> us, and `storage.local` returns `null` when the backend is unavailable
|
|
157
|
+
> (private browsing, sandboxed iframe) — hence the `?.` above.
|
|
158
|
+
|
|
159
|
+
## Step 5 — Rendering
|
|
160
|
+
|
|
161
|
+
```js
|
|
162
|
+
const shellTpl = sess.parse(SHELL);
|
|
163
|
+
const rowTpl = sess.parse(ROW);
|
|
164
|
+
|
|
165
|
+
sess.add([{ id: 'app', block: shellTpl, data: { remaining: remaining.get() } }]);
|
|
166
|
+
|
|
167
|
+
// Keyed list — incremental diff, unchanged items keep their DOM.
|
|
168
|
+
const list = sess.list('app', 'rows', {
|
|
169
|
+
keyFn: x => x.id,
|
|
170
|
+
block: rowTpl,
|
|
171
|
+
eqFn: 'shallow',
|
|
172
|
+
});
|
|
173
|
+
|
|
174
|
+
// Bind derived → list (re-sync on every change).
|
|
175
|
+
signal.effect(() => list.sync(visible.get()));
|
|
176
|
+
signal.effect(() => sess.text('app', 'count', `${remaining.get()} remaining`));
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
`sess.list` creates a keyed controller: `keyFn` extracts the key, `eqFn: 'shallow'`
|
|
180
|
+
detects content changes without recreating DOM. The `effect` re-synchronises
|
|
181
|
+
automatically on every `visible` change.
|
|
182
|
+
|
|
183
|
+
## Step 6 — Interactions
|
|
184
|
+
|
|
185
|
+
```js
|
|
186
|
+
// Form: field bind + submit
|
|
187
|
+
const newItem = form.create({
|
|
188
|
+
fields: { text: { type: 'string', required: true } },
|
|
189
|
+
onSubmit: ({ text }) => {
|
|
190
|
+
items.set([...items.get(), { id: uuid.v4(), text, done: false }]);
|
|
191
|
+
newItem.reset();
|
|
192
|
+
},
|
|
193
|
+
});
|
|
194
|
+
newItem.attach('text', sess.get('app', 'newText'));
|
|
195
|
+
sess.on('app', 'add', 'submit', (e) => { e.preventDefault(); newItem.submit(); });
|
|
196
|
+
|
|
197
|
+
// Filter
|
|
198
|
+
for (const f of ['all', 'active', 'done']) {
|
|
199
|
+
sess.on('app', f, 'click', () => filter.set(f));
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
// Toggle done + delete (event delegation, a single listener for the whole list)
|
|
203
|
+
sess.on('app', 'items', 'change', (e) => {
|
|
204
|
+
const row = e.target.closest('[data-fw-row-id]');
|
|
205
|
+
if (!row) return;
|
|
206
|
+
const id = row.dataset.fwRowId;
|
|
207
|
+
items.set(items.get().map(x => x.id === id ? { ...x, done: e.target.checked } : x));
|
|
208
|
+
});
|
|
209
|
+
|
|
210
|
+
sess.on('app', 'items', 'click', (e) => {
|
|
211
|
+
if (!e.target.closest('[data-act="del"]')) return; // data-* survives render, logical id does not
|
|
212
|
+
const row = e.target.closest('[data-fw-row-id]');
|
|
213
|
+
if (!row) return;
|
|
214
|
+
items.set(items.get().filter(x => x.id !== row.dataset.fwRowId));
|
|
215
|
+
});
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
Note: we could have used `list.on(key, 'click', fn)` but `events.delegate`
|
|
219
|
+
via `sess.on(blockId, slotName, ...)` is more economical for long lists
|
|
220
|
+
(a single handler).
|
|
221
|
+
|
|
222
|
+
> **Why `uuid.v4()`?** `crypto.randomUUID` is one of the APIs
|
|
223
|
+
> neutralised by sanity (cf. step 1) — calling it would throw an exception at
|
|
224
|
+
> runtime. The `uuid` module (`src/crypto/utils/uuid.js`) generates RFC 4122 v4
|
|
225
|
+
> UUIDs via `crypto.getRandomValues`, which is not blocked.
|
|
226
|
+
|
|
227
|
+
## Full code (54 lines)
|
|
228
|
+
|
|
229
|
+
```js
|
|
230
|
+
import { runtime } from '@awacloud/fw';
|
|
231
|
+
import modules from '@awacloud/fw/core/modules';
|
|
232
|
+
|
|
233
|
+
runtime.registerAll(modules);
|
|
234
|
+
|
|
235
|
+
const tpl = runtime.resolve('template');
|
|
236
|
+
const ui = runtime.resolve('uiSession');
|
|
237
|
+
const sig = runtime.resolve('signal');
|
|
238
|
+
const frm = runtime.resolve('form');
|
|
239
|
+
const uuid = runtime.resolve('uuid');
|
|
240
|
+
const store = runtime.resolve('storage').local;
|
|
241
|
+
|
|
242
|
+
const SHELL = `<section id="root"><h1>Todos</h1><form id="add"><input id="newText"><button id="submit">+</button></form><nav id="filter"><button id="all">All</button><button id="active">Active</button><button id="done">Done</button></nav><ul id="items">\${rows}</ul><footer id="count">#{remaining}</footer></section>`;
|
|
243
|
+
const ROW = `<li id="row" data-fw-row-id="#{id}"><input id="check" type="checkbox" checked="#{done}"><span id="text">#{text}</span><button id="del" data-act="del">×</button></li>`;
|
|
244
|
+
|
|
245
|
+
const ctx = 'todo';
|
|
246
|
+
tpl.init(ctx, { to: document.getElementById('app'), main: true });
|
|
247
|
+
const s = ui(ctx);
|
|
248
|
+
|
|
249
|
+
const items = sig.create(store?.get('todos') || []);
|
|
250
|
+
const filter = sig.create('all');
|
|
251
|
+
const visible = sig.derived([items, filter], (xs, f) =>
|
|
252
|
+
f === 'all' ? xs : xs.filter(x => f === 'done' ? x.done : !x.done));
|
|
253
|
+
const rem = sig.derived([items], xs => xs.filter(x => !x.done).length);
|
|
254
|
+
sig.effect(() => store?.set('todos', items.get()));
|
|
255
|
+
|
|
256
|
+
s.add([{ id: 'app', block: s.parse(SHELL), data: { remaining: 0 } }]);
|
|
257
|
+
const list = s.list('app', 'rows', { keyFn: x => x.id, block: s.parse(ROW), eqFn: 'shallow' });
|
|
258
|
+
sig.effect(() => list.sync(visible.get()));
|
|
259
|
+
sig.effect(() => s.text('app', 'count', rem.get() + ' remaining'));
|
|
260
|
+
|
|
261
|
+
const newItem = frm.create({
|
|
262
|
+
fields: { text: { type: 'string', required: true } },
|
|
263
|
+
onSubmit: ({ text }) => {
|
|
264
|
+
items.set([...items.get(), { id: uuid.v4(), text, done: false }]);
|
|
265
|
+
newItem.reset();
|
|
266
|
+
},
|
|
267
|
+
});
|
|
268
|
+
newItem.attach('text', s.get('app', 'newText'));
|
|
269
|
+
s.on('app', 'add', 'submit', (e) => { e.preventDefault(); newItem.submit(); });
|
|
270
|
+
|
|
271
|
+
for (const f of ['all', 'active', 'done']) s.on('app', f, 'click', () => filter.set(f));
|
|
272
|
+
|
|
273
|
+
s.on('app', 'items', 'change', (e) => {
|
|
274
|
+
const row = e.target.closest('[data-fw-row-id]');
|
|
275
|
+
if (!row) return;
|
|
276
|
+
items.set(items.get().map(x => x.id === row.dataset.fwRowId ? { ...x, done: e.target.checked } : x));
|
|
277
|
+
});
|
|
278
|
+
s.on('app', 'items', 'click', (e) => {
|
|
279
|
+
if (!e.target.closest('[data-act="del"]')) return;
|
|
280
|
+
const row = e.target.closest('[data-fw-row-id]');
|
|
281
|
+
if (!row) return;
|
|
282
|
+
items.set(items.get().filter(x => x.id !== row.dataset.fwRowId));
|
|
283
|
+
});
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
## What we did NOT write
|
|
287
|
+
|
|
288
|
+
- no class component, no hook, no virtual DOM
|
|
289
|
+
- no mandatory bundler (the module loads as native ESM)
|
|
290
|
+
- no framework directives (`v-if`, `*ngFor`, …) — the `#{var}` notation
|
|
291
|
+
lives in standard HTML templates
|
|
292
|
+
- no unnecessary re-renders: `list.sync` with `eqFn: 'shallow'` only touches
|
|
293
|
+
DOM nodes of changed items
|
|
294
|
+
|
|
295
|
+
## Going further
|
|
296
|
+
|
|
297
|
+
See [index by use case](./by-use-case.md) to navigate the docs based on
|
|
298
|
+
what you want to do next: SSR, modals, routes, accessibility, etc.
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
# TypeScript support
|
|
2
|
+
|
|
3
|
+
`@awacloud/fw` ships TypeScript declarations generated from JSDoc by `tsc` into
|
|
4
|
+
`dist/types/`. There is no separate `@types/` package and no `.d.ts` colocated
|
|
5
|
+
with the JavaScript sources — `package.json#exports[*].types` points to
|
|
6
|
+
`./dist/types/...` for every entry. Types are resolved automatically by any
|
|
7
|
+
TypeScript-aware tooling.
|
|
8
|
+
|
|
9
|
+
## What you get out of the box
|
|
10
|
+
|
|
11
|
+
| Path | Typed surface |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `@awacloud/fw` | `{ ENV, log, runtime, createWorker, domReady }` (named + default exports). |
|
|
14
|
+
| `@awacloud/fw/core/runtime` | `ModuleRuntime`, `ModuleDefinition`, `InstanceOf<M>`, `ResolveOptions`, `ListFilter`, `SerializedGraph`. |
|
|
15
|
+
| `@awacloud/fw/core/worker-helper` | `WorkerOptions`, `WorkerRuntimeFn`, `createWorkerRuntime`. |
|
|
16
|
+
| `@awacloud/fw/core/logger` | `LoggerAPI`, `LogEntry`, `LogSubscriber`. |
|
|
17
|
+
| `@awacloud/fw/core/readyState` | `ReadyStateAPI`. |
|
|
18
|
+
| `@awacloud/fw/core/modules` | Default export typed as `ModuleDefinition[]` (the catalogue). No named exports. |
|
|
19
|
+
| `@awacloud/fw/config` | `fw.config.json` — pure data (presets + side-bundles). Import as JSON. |
|
|
20
|
+
| `@awacloud/fw/typed` | `asTyped(runtime)` + `createRuntime(modules?)` → `TypedModuleRuntime` (name-narrowed `resolve`), `InstanceOf<M>`, `ModuleInstanceMap`, `ModuleName`. |
|
|
21
|
+
| `@awacloud/fw/vite` | `FwPluginOptions`, default export plugin factory. |
|
|
22
|
+
|
|
23
|
+
## Recommended `tsconfig.json`
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"compilerOptions": {
|
|
28
|
+
"target": "ES2022",
|
|
29
|
+
"module": "ESNext",
|
|
30
|
+
"moduleResolution": "bundler",
|
|
31
|
+
"strict": true,
|
|
32
|
+
"skipLibCheck": true,
|
|
33
|
+
"lib": ["ES2022", "DOM"]
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
`moduleResolution: "bundler"` is required for the conditional-exports map of `@awacloud/fw` to resolve correctly. With `"node16"` you must enable `--experimental-conditional-exports` flags on Node and stay within paths that don't depend on the `"browser"` condition.
|
|
39
|
+
|
|
40
|
+
## Typed module resolution
|
|
41
|
+
|
|
42
|
+
There are three ways to type a `resolve` call, from zero-setup to fully automatic. They all bottom out in the **factory return type** captured in each emitted `dist/types/<path>/<mod>.d.ts` — so improving a module's JSDoc improves every tier at once.
|
|
43
|
+
|
|
44
|
+
### Tier 1 — generic parameter (zero setup)
|
|
45
|
+
|
|
46
|
+
`runtime.resolve<T>(spec)` is generic — pass the expected instance type :
|
|
47
|
+
|
|
48
|
+
```ts
|
|
49
|
+
import fw from '@awacloud/fw';
|
|
50
|
+
|
|
51
|
+
interface HexCodec {
|
|
52
|
+
fromBytes(b: Uint8Array): string;
|
|
53
|
+
toBytes(s: string): Uint8Array;
|
|
54
|
+
test(s: string): boolean;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const hex = fw.runtime.resolve<HexCodec>('hex');
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Tier 1bis — derive the type instead of restating it
|
|
61
|
+
|
|
62
|
+
The instance type already lives in the emitted declaration. Pull it out with
|
|
63
|
+
`InstanceOf` (exported from both `@awacloud/fw/core/runtime` and `@awacloud/fw/typed`)
|
|
64
|
+
rather than hand-writing the interface :
|
|
65
|
+
|
|
66
|
+
```ts
|
|
67
|
+
import type { InstanceOf } from '@awacloud/fw/typed';
|
|
68
|
+
import { hex } from '@awacloud/fw/io/codec/hex.js';
|
|
69
|
+
|
|
70
|
+
type HexCodec = InstanceOf<typeof hex>; // = ReturnType<typeof hex.factory>
|
|
71
|
+
const codec = fw.runtime.resolve<HexCodec>('hex');
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Tier 2 — automatic narrowing via `@awacloud/fw/typed`
|
|
75
|
+
|
|
76
|
+
`asTyped(runtime)` re-types an existing runtime so `resolve(name)` and
|
|
77
|
+
`resolveAll([...names])` narrow **by module name** — no type parameter, no
|
|
78
|
+
import of the module value :
|
|
79
|
+
|
|
80
|
+
```ts
|
|
81
|
+
import fw from '@awacloud/fw';
|
|
82
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
83
|
+
import { asTyped } from '@awacloud/fw/typed';
|
|
84
|
+
|
|
85
|
+
fw.runtime.registerAll(modules);
|
|
86
|
+
const rt = asTyped(fw.runtime);
|
|
87
|
+
|
|
88
|
+
const hex = rt.resolve('hex'); // HexCodec — inferred
|
|
89
|
+
const { sha256, hmac } = rt.resolveAll(['sha256', 'hmac']); // both typed
|
|
90
|
+
rt.resolve('hex@1.0.0'); // unknown — version specs fall back
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
`asTyped` is an identity function at runtime (zero cost) — it only changes the
|
|
94
|
+
static view, and pulls **nothing** into your bundle (the name→type map is all
|
|
95
|
+
`import type` / `typeof import(...)`, fully erased before bundling). The map is
|
|
96
|
+
generated into `types/registry.generated.d.ts` by `bun run types:registry`,
|
|
97
|
+
which must run after `bun run types` (it references the emitted `dist/types/`
|
|
98
|
+
declarations). Both are wired into `prepack`.
|
|
99
|
+
|
|
100
|
+
> The narrowing is only as precise as the underlying factory return types.
|
|
101
|
+
> A module whose factory infers `any` will resolve to `any` here — which is
|
|
102
|
+
> why Tier 2 is worth enabling **after** the JSDoc pass below, not before.
|
|
103
|
+
|
|
104
|
+
For a **standalone composition** (no `@awacloud/fw` bundle, no Vite — just a runtime
|
|
105
|
+
built à la carte in a TS project), `createRuntime` is the one-liner counterpart.
|
|
106
|
+
It news up a `ModuleRuntime`, deep-registers the modules you pass (transitive
|
|
107
|
+
`deps` included), and returns it already typed :
|
|
108
|
+
|
|
109
|
+
```ts
|
|
110
|
+
import { createRuntime } from '@awacloud/fw/typed';
|
|
111
|
+
import { hex } from '@awacloud/fw/io/codec/hex.js';
|
|
112
|
+
import { sanitize } from '@awacloud/fw/dom/rendering/sanitize.js';
|
|
113
|
+
|
|
114
|
+
const rt = createRuntime([hex, sanitize]); // tree-shakable, deep-registered
|
|
115
|
+
const codec = rt.resolve('hex'); // HexAPI — inferred
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
This mirrors the autonomous `tools/fw-bundler` (`standalone`) output (a single self-contained
|
|
119
|
+
module) but at the type level, for bundler-driven TS projects.
|
|
120
|
+
|
|
121
|
+
> **Narrowing caveat (both `asTyped` and `createRuntime`)** — `resolve` is typed
|
|
122
|
+
> against the *full* catalog, not the subset you registered. Module `name` is
|
|
123
|
+
> `string` in the emitted declarations (not a literal), so the registered set
|
|
124
|
+
> can't be tracked at the type level. `createRuntime([hex]).resolve('sha256')`
|
|
125
|
+
> type-checks as `Sha256API` but throws `Module not found` at runtime. Only
|
|
126
|
+
> `resolve(name)` for modules you actually injected.
|
|
127
|
+
|
|
128
|
+
### Tier 2bis — transparent narrowing with the Vite plugin
|
|
129
|
+
|
|
130
|
+
If you build through `@awacloud/fw/vite`, you don't even call `asTyped`. Add the
|
|
131
|
+
ambient reference once (in any `.ts` of your project, typically a
|
|
132
|
+
`vite-env.d.ts`) :
|
|
133
|
+
|
|
134
|
+
```ts
|
|
135
|
+
/// <reference types="@awacloud/fw/vite-env" />
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
Then the `runtime` exported by a preset virtual module is already a
|
|
139
|
+
`TypedModuleRuntime` :
|
|
140
|
+
|
|
141
|
+
```ts
|
|
142
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
143
|
+
|
|
144
|
+
const hex = runtime.resolve('hex'); // narrowed — no asTyped, no <T>
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
This is a fresh ambient module declaration (no overload merging), so it is
|
|
148
|
+
robust — unlike a global augmentation of `ModuleRuntime.resolve`, which would
|
|
149
|
+
be defeated by overload ordering and is intentionally **not** shipped.
|
|
150
|
+
|
|
151
|
+
### Improving the underlying type (all tiers)
|
|
152
|
+
|
|
153
|
+
Module-specific narrowing is driven by JSDoc on the factory's return type :
|
|
154
|
+
when a module's source declares `@returns {HexCodec}` (with a matching
|
|
155
|
+
`@typedef`), that type flows into `dist/types/io/codec/hex.d.ts` and from there
|
|
156
|
+
into every tier above. Until a module's JSDoc is tightened, its entry degrades
|
|
157
|
+
gracefully to the inferred (often looser) shape.
|
|
158
|
+
|
|
159
|
+
After changing any module's factory signature, regenerate the registry :
|
|
160
|
+
|
|
161
|
+
```sh
|
|
162
|
+
bun run types # tsc → dist/types/**.d.ts
|
|
163
|
+
bun run types:registry # → types/registry.generated.d.ts
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
`bun run types:registry:check` fails if the registry is stale (use in CI).
|
|
167
|
+
|
|
168
|
+
## Writing a module in TypeScript
|
|
169
|
+
|
|
170
|
+
You can author modules in TypeScript provided the compiled JavaScript output preserves the factory shape for worker serialisation:
|
|
171
|
+
|
|
172
|
+
```ts
|
|
173
|
+
import type { ModuleDefinition } from '@awacloud/fw/core/runtime';
|
|
174
|
+
|
|
175
|
+
interface MyCodec {
|
|
176
|
+
encode(s: string): Uint8Array;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
export const myCodec: ModuleDefinition<readonly [], MyCodec> = {
|
|
180
|
+
name: 'myCodec',
|
|
181
|
+
version: '1.0.0',
|
|
182
|
+
type: 'lib.io.codec',
|
|
183
|
+
dependencies: [],
|
|
184
|
+
factory: function () {
|
|
185
|
+
return {
|
|
186
|
+
encode(s: string) { return new TextEncoder().encode(s); }
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
};
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
### ⚠️ Worker-serialisation pitfall
|
|
193
|
+
|
|
194
|
+
`runtime.serialize()` calls `factory.toString()` and ships the source string to a Worker. The Worker has no module loader — it executes the stringified factory in a clean scope. So **the compiled factory must remain self-contained** :
|
|
195
|
+
|
|
196
|
+
- ❌ Do not use `async` / `await` in the factory body (or anywhere reachable from it) — TypeScript injects an `__awaiter` helper at file scope that the Worker won't see.
|
|
197
|
+
- ❌ Do not use decorators — they inject `__decorate` helpers.
|
|
198
|
+
- ❌ Do not use TypeScript `import helpers` (`importHelpers: true`) or `tslib` runtime helpers.
|
|
199
|
+
- ✅ Compile with `target: "ES2022"` (or higher), `useDefineForClassFields: false`, `importHelpers: false`.
|
|
200
|
+
- ✅ Verify with `console.log(myModule.factory.toString())` that the output is plain JavaScript with no `__awaiter`, `__decorate`, `tslib_*` references.
|
|
201
|
+
|
|
202
|
+
The runtime itself (`runtime.js`) and its serialised companion `runtimeSource`
|
|
203
|
+
stay in plain JavaScript precisely for this reason. Its `.d.ts` lives in
|
|
204
|
+
`dist/types/core/runtime.d.ts`, generated from JSDoc.
|
|
205
|
+
|
|
206
|
+
## Per-module narrow types
|
|
207
|
+
|
|
208
|
+
Today `dist/types/core/modules.d.ts` types every catalogue entry as the
|
|
209
|
+
generic `ModuleDefinition` (functional but loose). Tighter types are added
|
|
210
|
+
module-by-module by improving the JSDoc on each module's factory return
|
|
211
|
+
type — `tsc` then emits a precise declaration into `dist/types/<path>/<name>.d.ts`.
|
|
212
|
+
No companion `.d.ts` files live in `src/`.
|
|
213
|
+
|
|
214
|
+
Until a module's JSDoc is tightened, fall back to the generic resolver type
|
|
215
|
+
parameter (`resolve<HexCodec>('hex')`).
|