@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,32 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/esbuild/index.d.ts
|
|
6
|
+
// Types for the `@awacloud/fw` esbuild plugin. Intentionally does NOT depend on the
|
|
7
|
+
// `esbuild` package — we type against a minimal structural plugin shape so the
|
|
8
|
+
// integration stays dependency-free (same convention as vite/index.d.ts).
|
|
9
|
+
|
|
10
|
+
export interface FwEsbuildOptions {
|
|
11
|
+
/** Default preset for the bare `virtual:@awacloud/fw/preset` specifier. Default: `'site'`. */
|
|
12
|
+
preset?: string;
|
|
13
|
+
/** Side-bundles validated up-front (fail fast on misconfiguration). */
|
|
14
|
+
sideBundles?: string[];
|
|
15
|
+
/** Prepend the sanity layer to every entry point. Default: `false`. */
|
|
16
|
+
sanity?: 'base' | 'community' | 'lockdown' | false;
|
|
17
|
+
/** Package specifier used in the emitted imports. Default: `'@awacloud/fw'`. */
|
|
18
|
+
packageName?: string;
|
|
19
|
+
/** Override `fw.config.json` path. */
|
|
20
|
+
configPath?: string;
|
|
21
|
+
/** Dir from which the emitted `@awacloud/fw/*` imports resolve. Default: build cwd. */
|
|
22
|
+
resolveDir?: string;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Minimal structural shape of an esbuild plugin (no dependency on `esbuild`). */
|
|
26
|
+
export interface FwEsbuildPlugin {
|
|
27
|
+
name: string;
|
|
28
|
+
setup(build: unknown): void;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Create the `@awacloud/fw` esbuild consumer plugin. */
|
|
32
|
+
export default function fwEsbuild(options?: FwEsbuildOptions): FwEsbuildPlugin;
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/esbuild/index.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Official esbuild plugin for `@awacloud/fw` (consumer / role 1).
|
|
8
|
+
*
|
|
9
|
+
* Exposes the same virtual modules as the Vite plugin :
|
|
10
|
+
* - `virtual:@awacloud/fw/preset/<name>` — pre-instantiated runtime for a preset.
|
|
11
|
+
* - `virtual:@awacloud/fw/side-bundle/<name>` — `install(runtime)` helper for a side-bundle.
|
|
12
|
+
*
|
|
13
|
+
* The generated code is identical to every other bundler adapter (shared
|
|
14
|
+
* `_shared/core.js`) : direct subpath imports (`@awacloud/fw/io/codec/hex.js`) +
|
|
15
|
+
* `registerAllDeep`. esbuild follows those imports and closes the transitive
|
|
16
|
+
* `deps` graph, tree-shaking what the app doesn't use.
|
|
17
|
+
*
|
|
18
|
+
* Virtual modules use esbuild's native `onResolve` / `onLoad` in a dedicated
|
|
19
|
+
* namespace — the simplest of all the bundler ports.
|
|
20
|
+
*
|
|
21
|
+
* Usage :
|
|
22
|
+
*
|
|
23
|
+
* import * as esbuild from 'esbuild';
|
|
24
|
+
* import fwEsbuild from '@awacloud/fw/esbuild';
|
|
25
|
+
*
|
|
26
|
+
* await esbuild.build({
|
|
27
|
+
* entryPoints: ['src/app.js'],
|
|
28
|
+
* bundle: true,
|
|
29
|
+
* format: 'esm',
|
|
30
|
+
* outfile: 'dist/app.js',
|
|
31
|
+
* plugins: [fwEsbuild({ preset: 'site-interactive', sanity: 'base' })],
|
|
32
|
+
* });
|
|
33
|
+
*
|
|
34
|
+
* // src/app.js
|
|
35
|
+
* import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
36
|
+
*
|
|
37
|
+
* NOTE — this is the *consumer* plugin. Using esbuild as the Node build
|
|
38
|
+
* *backend* that replaces `Bun.build` for producing `dist/build/*` is a
|
|
39
|
+
* separate concern : see `./backend.js` (role 2) and `../nodejs/README.md`.
|
|
40
|
+
*
|
|
41
|
+
* @see ../_shared/core.js
|
|
42
|
+
* @see ../vite/index.js reference adapter (same behaviour)
|
|
43
|
+
*/
|
|
44
|
+
|
|
45
|
+
import { readFileSync } from 'node:fs';
|
|
46
|
+
import { resolve, extname } from 'node:path';
|
|
47
|
+
|
|
48
|
+
import { createFwCore } from '../_shared/core.js';
|
|
49
|
+
|
|
50
|
+
const NAMESPACE = 'awa-fw';
|
|
51
|
+
// Matches both the bare preset specifier and the suffixed preset/side-bundle ones.
|
|
52
|
+
const FILTER = /^virtual:@awacloud\/fw\/(preset|side-bundle)(\/.*)?$/;
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Map a file extension to the esbuild loader used when we re-emit an entry
|
|
56
|
+
* with the sanity import prepended.
|
|
57
|
+
* @param {string} file
|
|
58
|
+
* @returns {('js'|'jsx'|'ts'|'tsx')}
|
|
59
|
+
*/
|
|
60
|
+
function loaderFor(file) {
|
|
61
|
+
switch (extname(file)) {
|
|
62
|
+
case '.ts': return 'ts';
|
|
63
|
+
case '.tsx': return 'tsx';
|
|
64
|
+
case '.jsx': return 'jsx';
|
|
65
|
+
default: return 'js';
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Normalise esbuild's `entryPoints` (string[] | {in,out}[] | Record<out,in>)
|
|
71
|
+
* to a Set of absolute input paths, resolved against the build's working dir.
|
|
72
|
+
* @param {unknown} entryPoints
|
|
73
|
+
* @param {string} cwd
|
|
74
|
+
* @returns {Set<string>}
|
|
75
|
+
*/
|
|
76
|
+
function entryAbsPaths(entryPoints, cwd) {
|
|
77
|
+
/** @type {string[]} */
|
|
78
|
+
const ins = [];
|
|
79
|
+
if (Array.isArray(entryPoints)) {
|
|
80
|
+
for (const e of entryPoints) {
|
|
81
|
+
if (typeof e === 'string') ins.push(e);
|
|
82
|
+
else if (e && typeof e === 'object' && typeof e.in === 'string') ins.push(e.in);
|
|
83
|
+
}
|
|
84
|
+
} else if (entryPoints && typeof entryPoints === 'object') {
|
|
85
|
+
for (const v of Object.values(entryPoints)) {
|
|
86
|
+
if (typeof v === 'string') ins.push(v);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
return new Set(ins.map((p) => resolve(cwd, p)));
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* @typedef {Object} FwEsbuildOptions
|
|
94
|
+
* @property {string} [preset='site'] Default preset for the bare `virtual:@awacloud/fw/preset` specifier.
|
|
95
|
+
* @property {string[]} [sideBundles=[]] Side-bundles validated up-front.
|
|
96
|
+
* @property {('base'|'community'|'lockdown'|false)} [sanity=false] Prepend the sanity layer to every entry point.
|
|
97
|
+
* @property {string} [packageName='@awacloud/fw'] Package specifier used in the emitted imports.
|
|
98
|
+
* @property {string} [configPath] Override `fw.config.json` path.
|
|
99
|
+
* @property {string} [resolveDir] Dir from which the emitted `@awacloud/fw/*` imports resolve (default: build cwd / process.cwd()).
|
|
100
|
+
*/
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* @param {FwEsbuildOptions} [options]
|
|
104
|
+
* @returns {{ name: string, setup: (build: any) => void }} esbuild plugin
|
|
105
|
+
*/
|
|
106
|
+
export default function fwEsbuild(options = {}) {
|
|
107
|
+
const sanity = options.sanity || false;
|
|
108
|
+
// Shared core : config load + source-tree scan + virtual matcher/emitter.
|
|
109
|
+
const core = createFwCore(options);
|
|
110
|
+
|
|
111
|
+
return {
|
|
112
|
+
name: '@awacloud/fw',
|
|
113
|
+
setup(build) {
|
|
114
|
+
const cwd = (build.initialOptions && build.initialOptions.absWorkingDir) || process.cwd();
|
|
115
|
+
const resolveDir = options.resolveDir || cwd;
|
|
116
|
+
|
|
117
|
+
// 1. Virtual modules : claim the specifier, then emit its source.
|
|
118
|
+
build.onResolve({ filter: FILTER }, (args) => ({ path: args.path, namespace: NAMESPACE }));
|
|
119
|
+
|
|
120
|
+
build.onLoad({ filter: /.*/, namespace: NAMESPACE }, (args) => {
|
|
121
|
+
const contents = core.emit(args.path);
|
|
122
|
+
if (contents == null) return null;
|
|
123
|
+
// resolveDir lets esbuild resolve the emitted bare `@awacloud/fw/*`
|
|
124
|
+
// imports via the consumer project's node_modules.
|
|
125
|
+
return { contents, loader: 'js', resolveDir };
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
// 2. Sanity layer : esbuild has no `isEntry` transform hook, so we
|
|
129
|
+
// re-emit each declared entry with the side-effect import prepended.
|
|
130
|
+
// (Mirrors the Vite plugin's entry-only injection.)
|
|
131
|
+
if (sanity) {
|
|
132
|
+
const entries = entryAbsPaths(build.initialOptions && build.initialOptions.entryPoints, cwd);
|
|
133
|
+
if (entries.size) {
|
|
134
|
+
build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, (args) => {
|
|
135
|
+
if (!entries.has(args.path)) return null;
|
|
136
|
+
const original = readFileSync(args.path, 'utf8');
|
|
137
|
+
return {
|
|
138
|
+
contents: core.sanityImportLine(sanity) + original,
|
|
139
|
+
loader: loaderFor(args.path),
|
|
140
|
+
resolveDir: resolve(args.path, '..'),
|
|
141
|
+
};
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
},
|
|
146
|
+
};
|
|
147
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# `@awacloud/fw` — ESLint
|
|
2
|
+
|
|
3
|
+
ESLint guards that **encode framework invariants**. Consumed by the `eslint.config.js` at the root of the package (no `@awacloud/fw/<x>` export — this is internal dev tooling).
|
|
4
|
+
|
|
5
|
+
## Contents
|
|
6
|
+
|
|
7
|
+
- [`no-factory-capture.js`](./no-factory-capture.js) — custom rule `fw/no-factory-capture`. Forbids a module `factory()` from capturing a module-scope binding (scope analysis: `v.defs.length === 0` excludes ambient globals). **Invariant**: factories must be self-contained (`factory.toString()` is serialized to Workers) — a capture would break Worker execution.
|
|
8
|
+
|
|
9
|
+
## Other guards live in `eslint.config.js` (root)
|
|
10
|
+
|
|
11
|
+
The root `eslint.config.js` **derives** its rules from the source of truth (the sanity layer) rather than hard-coding them:
|
|
12
|
+
|
|
13
|
+
- `no-restricted-globals` / `no-restricted-properties` — generated from the `BLOCKED_*` entries in `src/sanity/base.js`.
|
|
14
|
+
- `no-restricted-syntax` — anti-assignment guard for frozen prototypes, built by introspection (`Object.getOwnPropertyNames(<Ctor>.prototype)`) for the 9 frozen built-ins.
|
|
15
|
+
- Layers by scope: `src/**` (sanity + `fw/no-factory-capture`), `tools|integrations/**` (Node/Bun globals), tests/playground/`.d.ts` (relaxed guards).
|
|
16
|
+
|
|
17
|
+
Gate: `bun run lint` = `eslint . --max-warnings 0`.
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```js
|
|
22
|
+
// eslint.config.js (package root)
|
|
23
|
+
import fw from './integrations/eslint/no-factory-capture.js';
|
|
24
|
+
// … fw.rules['no-factory-capture'] wired into the src/** layer
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
See the root `eslint.config.js` for the full wiring (sanity derivation → rules).
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/eslint/no-factory-capture.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Custom ESLint rule — `fw/no-factory-capture`.
|
|
8
|
+
*
|
|
9
|
+
* Flags, at edit time, any identifier referenced inside a module's `factory()`
|
|
10
|
+
* that resolves to a **module-scope binding** (a top-level `import` / `const` /
|
|
11
|
+
* `class` / `function`) rather than to a factory parameter or an ambient global.
|
|
12
|
+
*
|
|
13
|
+
* Why : `runtime.serialize()` ships `factory.toString()` into a Worker and the
|
|
14
|
+
* `standalone` tool inlines the factory — both execute the factory source in a
|
|
15
|
+
* clean scope with no access to the module's outer bindings. A captured
|
|
16
|
+
* module-scope binding therefore breaks worker bootstrap / standalone builds.
|
|
17
|
+
* This is the same invariant the `standalone` closure-capture detector enforces
|
|
18
|
+
* at build time, lifted to edit time with proper scope analysis (more accurate
|
|
19
|
+
* than the build-time regex).
|
|
20
|
+
*
|
|
21
|
+
* Mechanism (no allow-list needed) : a reference is a capture iff its resolved
|
|
22
|
+
* variable (a) has at least one definition node (`defs.length > 0` — excludes
|
|
23
|
+
* ambient globals declared via `languageOptions.globals`, which have none) and
|
|
24
|
+
* (b) is declared in a scope strictly ABOVE the factory function. Factory
|
|
25
|
+
* parameters live in the function scope itself and are thus never flagged;
|
|
26
|
+
* factory-local declarations live in descendant scopes and are never flagged.
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
/** @type {import('eslint').Rule.RuleModule} */
|
|
30
|
+
const rule = {
|
|
31
|
+
meta: {
|
|
32
|
+
type: 'problem',
|
|
33
|
+
docs: {
|
|
34
|
+
description:
|
|
35
|
+
'Disallow factory closures from capturing module-scope bindings (worker-serialization safety).',
|
|
36
|
+
},
|
|
37
|
+
schema: [],
|
|
38
|
+
messages: {
|
|
39
|
+
capture:
|
|
40
|
+
'Factory captures module-scope `{{name}}` — not serializable to a Worker ' +
|
|
41
|
+
'(runtime.serialize / standalone). Define it inside the factory, or pass it as a dependency.',
|
|
42
|
+
},
|
|
43
|
+
},
|
|
44
|
+
|
|
45
|
+
create(context) {
|
|
46
|
+
const sourceCode = context.sourceCode;
|
|
47
|
+
|
|
48
|
+
function checkFactory(fnNode) {
|
|
49
|
+
const fnScope = sourceCode.getScope(fnNode);
|
|
50
|
+
|
|
51
|
+
// Scopes strictly above the factory function — capturing from any of
|
|
52
|
+
// these is what breaks serialization.
|
|
53
|
+
const ancestors = new Set();
|
|
54
|
+
for (let s = fnScope.upper; s; s = s.upper) ancestors.add(s);
|
|
55
|
+
|
|
56
|
+
const seen = new Set();
|
|
57
|
+
const visit = (scope) => {
|
|
58
|
+
for (const ref of scope.references) {
|
|
59
|
+
const v = ref.resolved;
|
|
60
|
+
if (!v || v.defs.length === 0) continue; // ambient/global → fine
|
|
61
|
+
if (!ancestors.has(v.scope)) continue; // factory-local → fine
|
|
62
|
+
const key = v.name + '@' + ref.identifier.range[0];
|
|
63
|
+
if (seen.has(key)) continue;
|
|
64
|
+
seen.add(key);
|
|
65
|
+
context.report({
|
|
66
|
+
node: ref.identifier,
|
|
67
|
+
messageId: 'capture',
|
|
68
|
+
data: { name: v.name },
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
scope.childScopes.forEach(visit);
|
|
72
|
+
};
|
|
73
|
+
visit(fnScope);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
return {
|
|
77
|
+
'Property[key.name="factory"]'(node) {
|
|
78
|
+
const fn = node.value;
|
|
79
|
+
if (!fn || (fn.type !== 'FunctionExpression' && fn.type !== 'ArrowFunctionExpression')) {
|
|
80
|
+
return;
|
|
81
|
+
}
|
|
82
|
+
// Only treat it as a module descriptor factory when the sibling
|
|
83
|
+
// shape is present (avoids flagging unrelated `factory` keys).
|
|
84
|
+
const obj = node.parent;
|
|
85
|
+
const isDescriptor =
|
|
86
|
+
obj &&
|
|
87
|
+
obj.type === 'ObjectExpression' &&
|
|
88
|
+
obj.properties.some(
|
|
89
|
+
(p) => p.key && (p.key.name === 'dependencies' || p.key.name === 'name'),
|
|
90
|
+
);
|
|
91
|
+
if (isDescriptor) checkFactory(fn);
|
|
92
|
+
},
|
|
93
|
+
};
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
|
|
97
|
+
export default {
|
|
98
|
+
rules: { 'no-factory-capture': rule },
|
|
99
|
+
};
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# `@awacloud/fw/jest`
|
|
2
|
+
|
|
3
|
+
Run the test suite **under Jest / Node**, without touching the tests. An alternative to [Vitest](../vitest/README.md) for teams already invested in Jest.
|
|
4
|
+
|
|
5
|
+
> **Vitest remains the recommended Node runner** (ESM-first, trivial config). Jest works but its ESM support is more involved — see Notes.
|
|
6
|
+
|
|
7
|
+
## Mechanism
|
|
8
|
+
|
|
9
|
+
Same principle as Vitest: a **shim** remaps `bun:test` → `@jest/globals`.
|
|
10
|
+
|
|
11
|
+
1. [`bun-test-shim.js`](./bun-test-shim.js): re-exports `describe/test/expect/before*/after*` from `@jest/globals`, and **bridges `test.if(cond)`** (bun API absent from Jest) → `cond ? test : test.skip`. The **`done` callback is natively supported** by Jest (nothing to bridge).
|
|
12
|
+
2. [`jest.config.mjs`](https://github.com/awacloud/awa/blob/main/packages/front/fw/integrations/jest/jest.config.mjs): `moduleNameMapper` `^bun:test$` → shim, `transform: {}` (native ESM), `testEnvironment: 'node'`.
|
|
13
|
+
|
|
14
|
+
## DOM — `environment: 'node'` is enough
|
|
15
|
+
|
|
16
|
+
As under bun/Vitest, DOM tests register happy-dom themselves (`GlobalRegistrator.register()` at the top of the file). No need for `jest-environment-jsdom` or `projects`: Node + these self-registrations reproduce the environment.
|
|
17
|
+
|
|
18
|
+
## Usage
|
|
19
|
+
|
|
20
|
+
```sh
|
|
21
|
+
bun run setup:jest # installs jest + @jest/globals on demand (not persisted)
|
|
22
|
+
bun run test:jest # node --experimental-vm-modules node_modules/jest/bin/jest.js -c integrations/jest/jest.config.mjs
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
The **`--experimental-vm-modules`** flag is passed via `node` (cross-platform, no env variable). The DOM comes from `@happy-dom/global-registrator` (committed devDependency).
|
|
26
|
+
|
|
27
|
+
## For a consumer project
|
|
28
|
+
|
|
29
|
+
```js
|
|
30
|
+
// jest.config.mjs
|
|
31
|
+
import { createRequire } from 'node:module';
|
|
32
|
+
const shim = createRequire(import.meta.url).resolve('@awacloud/fw/jest/shim');
|
|
33
|
+
export default {
|
|
34
|
+
moduleNameMapper: { '^bun:test$': shim },
|
|
35
|
+
transform: {},
|
|
36
|
+
testEnvironment: 'node',
|
|
37
|
+
};
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Notes
|
|
41
|
+
|
|
42
|
+
- **ESM under Jest = the real hard part**: `transform: {}` + `--experimental-vm-modules`. `import.meta.url` (used by the runtime/crypto tests for `tests/_vectors`) works under vm-modules but remains a point of attention. If a full run fails, **prefer Vitest**.
|
|
43
|
+
- `*.kat.js` (data files) excluded from `testMatch`, but loaded via import by the `.test.js` files.
|
|
44
|
+
- Jest is **not** a committed devDependency; installed on demand (`bun add --no-save`).
|
|
45
|
+
- bun↔jest matcher parity is very high (bun:test mirrors Jest) — validate on a full run.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/jest/bun-test-shim.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Drop-in replacement for the `bun:test` module under Jest.
|
|
8
|
+
*
|
|
9
|
+
* The suite imports only `describe, test, expect, beforeEach, afterEach,
|
|
10
|
+
* beforeAll, afterAll` from `bun:test` — all present in `@jest/globals`.
|
|
11
|
+
* Aliasing `bun:test` → this shim (via `moduleNameMapper`) lets the suite run
|
|
12
|
+
* under Jest WITHOUT touching a test file.
|
|
13
|
+
*
|
|
14
|
+
* API gaps vs bun:test :
|
|
15
|
+
* - `done` callback : Jest supports it natively → no adaptation needed
|
|
16
|
+
* (unlike Vitest 4, which removed it).
|
|
17
|
+
* - `test.if(cond)` : a bun-only conditional modifier. Jest has no `runIf`,
|
|
18
|
+
* so we bridge `test.if(cond)` → `cond ? test : test.skip`.
|
|
19
|
+
*
|
|
20
|
+
* @see ./jest.config.mjs wires the `moduleNameMapper` alias
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
import {
|
|
24
|
+
describe,
|
|
25
|
+
test as _jestTest,
|
|
26
|
+
expect,
|
|
27
|
+
beforeEach,
|
|
28
|
+
afterEach,
|
|
29
|
+
beforeAll,
|
|
30
|
+
afterAll,
|
|
31
|
+
} from '@jest/globals';
|
|
32
|
+
|
|
33
|
+
// Bridge `test.if(cond)` (bun) → conditional skip (Jest). Everything else
|
|
34
|
+
// (`each`, `skip`, `only`, `concurrent`, `failing`, direct call with `done`)
|
|
35
|
+
// passes straight through to Jest's native `test`.
|
|
36
|
+
const test = new Proxy(_jestTest, {
|
|
37
|
+
get(target, prop, receiver) {
|
|
38
|
+
if (prop === 'if') return (cond) => (cond ? target : target.skip);
|
|
39
|
+
return Reflect.get(target, prop, receiver);
|
|
40
|
+
},
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
export { describe, test, expect, beforeEach, afterEach, beforeAll, afterAll };
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# `@awacloud/fw/nest`
|
|
2
|
+
|
|
3
|
+
Official NestJS integration — **backend / Node**. Exposes the **environment-agnostic modules** of `@awacloud/fw` (crypto, codecs, compression, math, process, valid, eventBus…) as **Nest providers**.
|
|
4
|
+
|
|
5
|
+
> **Marginal need, assumed.** `@awacloud/fw` is a *front* framework. The server-side interest: sharing **the same** hand-written crypto/codec between browser client and Nest server (identical hash/signature/encoding on both sides), or reusing fw primitives in shared libs (e.g. `office`). **DOM is out of scope** (guard at bootstrap).
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
Pass **imported module objects** (tree-shakable), not names:
|
|
10
|
+
|
|
11
|
+
```ts
|
|
12
|
+
import { Module, Inject, Injectable } from '@nestjs/common';
|
|
13
|
+
import { FwModule } from '@awacloud/fw/nest';
|
|
14
|
+
import { sha256 } from '@awacloud/fw/crypto/hash/sha256.js';
|
|
15
|
+
import { cbor } from '@awacloud/fw/io/codec/cbor.js';
|
|
16
|
+
import { bitArray } from '@awacloud/fw/crypto/utils/bitArray.js';
|
|
17
|
+
|
|
18
|
+
@Module({
|
|
19
|
+
// Only top-level modules become injectable Nest providers —
|
|
20
|
+
// `bitArray` is listed explicitly because we inject it below.
|
|
21
|
+
imports: [FwModule.forFeature([sha256, cbor, bitArray])],
|
|
22
|
+
})
|
|
23
|
+
export class AppModule {}
|
|
24
|
+
|
|
25
|
+
@Injectable()
|
|
26
|
+
export class SignService {
|
|
27
|
+
constructor(
|
|
28
|
+
@Inject('sha256') private readonly sha256: any,
|
|
29
|
+
@Inject('cbor') private readonly cbor: any,
|
|
30
|
+
@Inject('bitArray') private readonly bitArray: any,
|
|
31
|
+
) {}
|
|
32
|
+
digest(payload: unknown) {
|
|
33
|
+
const bytes = this.cbor.encode(payload); // Uint8Array
|
|
34
|
+
// `sha256.hash` expects a UTF-8 string OR a bitArray (32-bit words),
|
|
35
|
+
// NOT raw bytes → convert via bitArray.
|
|
36
|
+
return this.sha256.hash(this.bitArray.ui8_to_ba(bytes));
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
> ⚠️ **Crypto input shape**: `sha256.hash` interprets a `Uint8Array` as a *bitArray* (not as raw bytes). Passing `cbor.encode(...)` directly would produce a wrong hash — hence the `bitArray.ui8_to_ba(...)` bridge (and the `bitArray` injection). See the runnable example [`playground/integrations/nest`](https://github.com/awacloud/awa/tree/main/packages/front/fw/playground/integrations/nest).
|
|
42
|
+
|
|
43
|
+
- **Token** = the module `name` (`@Inject('sha256')`).
|
|
44
|
+
- **Transitive dependencies** are registered automatically (the `deps` field) — only pass top-level modules (here `sha256`/`cbor`/`bitArray`).
|
|
45
|
+
- `exports` is populated → other Nest modules can inject these tokens.
|
|
46
|
+
|
|
47
|
+
## DOM guard (out of scope)
|
|
48
|
+
|
|
49
|
+
Any `fw.dom.*` module (browser-only: freezes `window`/`document`) is **rejected at bootstrap**:
|
|
50
|
+
|
|
51
|
+
```ts
|
|
52
|
+
FwModule.forFeature([dom]); // ❌ throws: "dom" is browser-only (type "fw.dom.query")
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Override possible but **not recommended**: `FwModule.forFeature([...], { allowDom: true })`.
|
|
56
|
+
|
|
57
|
+
## Options
|
|
58
|
+
|
|
59
|
+
| Option | Type | Default | Role |
|
|
60
|
+
|---|---|---|---|
|
|
61
|
+
| `global` | `boolean` | `false` | marks the Nest module as global |
|
|
62
|
+
| `allowDom` | `boolean` | `false` | allows `fw.dom.*` modules (not recommended server-side) |
|
|
63
|
+
|
|
64
|
+
## Notes
|
|
65
|
+
|
|
66
|
+
- **Peer `@nestjs/common`**: consumer dependency only; this integration **does not import** Nest (the `DynamicModule` is a structural shape) → zero hard dependency.
|
|
67
|
+
- Typing: `@Inject('name')` returns `any` at the Nest level; at the usage site, cast to the module's API type (see `@awacloud/fw/typed` `InstanceOf`).
|
|
68
|
+
- This is a Nest-idiomatic wrapper over the fw runtime; without Nest, `createRuntime` (`@awacloud/fw/typed`) already suffices on the server side.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/nestjs/index.d.ts
|
|
6
|
+
// Types for the `@awacloud/fw` NestJS integration. Does NOT depend on
|
|
7
|
+
// `@nestjs/common` — the dynamic module is typed structurally.
|
|
8
|
+
|
|
9
|
+
/** Minimal shape of an imported fw module object. */
|
|
10
|
+
export interface FwModuleObject {
|
|
11
|
+
name: string;
|
|
12
|
+
type?: string;
|
|
13
|
+
factory: (...args: any[]) => any;
|
|
14
|
+
deps?: unknown[];
|
|
15
|
+
[k: string]: unknown;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export interface FwForFeatureOptions {
|
|
19
|
+
/** Mark the produced Nest module as global. Default: `false`. */
|
|
20
|
+
global?: boolean;
|
|
21
|
+
/** Allow `fw.dom.*` (browser-only) modules server-side. Default: `false`. */
|
|
22
|
+
allowDom?: boolean;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** Structural Nest `DynamicModule` (no dependency on `@nestjs/common`). */
|
|
26
|
+
export interface FwDynamicModule {
|
|
27
|
+
module: typeof FwModule;
|
|
28
|
+
providers: Array<{ provide: string; useValue: unknown }>;
|
|
29
|
+
exports: string[];
|
|
30
|
+
global?: boolean;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export class FwModule {
|
|
34
|
+
/** Expose the resolved fw modules as Nest providers (token = module name). */
|
|
35
|
+
static forFeature(modules: FwModuleObject[], options?: FwForFeatureOptions): FwDynamicModule;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export default FwModule;
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/nestjs/index.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Official NestJS integration for `@awacloud/fw` (backend / Node).
|
|
8
|
+
*
|
|
9
|
+
* `@awacloud/fw` is a FRONT framework ; the useful intersection with a Nest server
|
|
10
|
+
* is its **environment-agnostic / worker-safe** modules — `crypto/*`,
|
|
11
|
+
* `io/codec/*`, `io/compress/*`, `io/math`, `process/*`, `valid`, `eventBus`,
|
|
12
|
+
* … — NOT the DOM. `FwModule.forFeature([...])` bridges those into Nest's DI
|
|
13
|
+
* container : it builds an `@awacloud/fw` runtime, resolves each requested module,
|
|
14
|
+
* and exposes the resolved instance as a Nest provider (token = module name).
|
|
15
|
+
*
|
|
16
|
+
* Typical use : share the SAME hand-written crypto/codec between the browser
|
|
17
|
+
* client and the Nest server (identical hashing/signing/encoding on both
|
|
18
|
+
* sides), or reuse fw primitives in `office`-style shared libraries.
|
|
19
|
+
*
|
|
20
|
+
* **DOM is out of scope.** A guard rejects any `fw.dom.*` module at bootstrap
|
|
21
|
+
* (browser-only : freezes `window`/`document`). Override only if you know what
|
|
22
|
+
* you're doing (`{ allowDom: true }`).
|
|
23
|
+
*
|
|
24
|
+
* Pass imported module OBJECTS (tree-shakable), not names :
|
|
25
|
+
*
|
|
26
|
+
* import { Module } from '@nestjs/common';
|
|
27
|
+
* import { FwModule } from '@awacloud/fw/nest';
|
|
28
|
+
* import { sha256 } from '@awacloud/fw/crypto/hash/sha256.js';
|
|
29
|
+
* import { cbor } from '@awacloud/fw/io/codec/cbor.js';
|
|
30
|
+
*
|
|
31
|
+
* @Module({ imports: [FwModule.forFeature([sha256, cbor])] })
|
|
32
|
+
* export class AppModule {}
|
|
33
|
+
*
|
|
34
|
+
* // inject by module name
|
|
35
|
+
* constructor(@Inject('sha256') private readonly sha256: any) {}
|
|
36
|
+
*
|
|
37
|
+
* @see ./README.md
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
import { ModuleRuntime } from '@awacloud/fw/core/runtime';
|
|
41
|
+
|
|
42
|
+
/** Browser-only module type prefix — rejected server-side by default. */
|
|
43
|
+
const DOM_TYPE_RE = /^fw\.dom\./;
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* @typedef {Object} FwModuleObject A framework module descriptor.
|
|
47
|
+
* @property {string} name
|
|
48
|
+
* @property {string} [type]
|
|
49
|
+
* @property {Function} factory
|
|
50
|
+
* @property {any[]} [deps]
|
|
51
|
+
*
|
|
52
|
+
* @typedef {Object} FwForFeatureOptions
|
|
53
|
+
* @property {boolean} [global=false] Mark the produced Nest module as global.
|
|
54
|
+
* @property {boolean} [allowDom=false] Allow `fw.dom.*` modules (NOT recommended server-side).
|
|
55
|
+
*/
|
|
56
|
+
|
|
57
|
+
export class FwModule {
|
|
58
|
+
/**
|
|
59
|
+
* Build a Nest dynamic module exposing the resolved `@awacloud/fw` modules as
|
|
60
|
+
* providers (token = each module's `name`). Transitive dependencies are
|
|
61
|
+
* registered automatically via each module's `deps` field.
|
|
62
|
+
*
|
|
63
|
+
* @param {FwModuleObject[]} modules Imported fw module objects.
|
|
64
|
+
* @param {FwForFeatureOptions} [options]
|
|
65
|
+
* @returns {{ module: typeof FwModule, providers: any[], exports: string[], global?: boolean }}
|
|
66
|
+
*/
|
|
67
|
+
static forFeature(modules, options = {}) {
|
|
68
|
+
if (!Array.isArray(modules) || modules.length === 0) {
|
|
69
|
+
throw new Error('[FwModule] forFeature() requires a non-empty array of fw module objects.');
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
const allowDom = options.allowDom === true;
|
|
73
|
+
for (const m of modules) {
|
|
74
|
+
if (!m || typeof m.name !== 'string' || typeof m.factory !== 'function') {
|
|
75
|
+
throw new Error('[FwModule] forFeature() expects imported fw module OBJECTS (e.g. `import { sha256 } from "@awacloud/fw/crypto/hash/sha256.js"`), not names.');
|
|
76
|
+
}
|
|
77
|
+
if (!allowDom && typeof m.type === 'string' && DOM_TYPE_RE.test(m.type)) {
|
|
78
|
+
throw new Error(
|
|
79
|
+
`[FwModule] "${m.name}" is browser-only (type "${m.type}") and cannot run on a Nest server. ` +
|
|
80
|
+
`Use a worker-safe module, or pass { allowDom: true } to override (not recommended).`
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
const runtime = new ModuleRuntime();
|
|
86
|
+
runtime.registerAllDeep(modules); // registers requested modules + transitive deps
|
|
87
|
+
|
|
88
|
+
const providers = modules.map((m) => ({ provide: m.name, useValue: runtime.resolve(m.name) }));
|
|
89
|
+
|
|
90
|
+
return {
|
|
91
|
+
module: FwModule,
|
|
92
|
+
providers,
|
|
93
|
+
exports: providers.map((p) => p.provide),
|
|
94
|
+
...(options.global ? { global: true } : {}),
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
export default FwModule;
|