@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,149 @@
|
|
|
1
|
+
# `@awacloud/fw/next`
|
|
2
|
+
|
|
3
|
+
Official Next.js integration. `withFw(nextConfig, fwOptions)` wires the **`@awacloud/fw/webpack`** plugin into the Next build, exposing the virtual modules `virtual:@awacloud/fw/preset/*` / `…/side-bundle/*`.
|
|
4
|
+
|
|
5
|
+
> **Explicit scope**: use fw *inside* a Next app (widget mounted in `useEffect`, SSR data via `render.toHTML`). **Not** a JSX ↔ elm-array bridge.
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
```js
|
|
10
|
+
// next.config.mjs
|
|
11
|
+
import withFw from '@awacloud/fw/next';
|
|
12
|
+
|
|
13
|
+
export default withFw(
|
|
14
|
+
{ /* your Next config */ reactStrictMode: true },
|
|
15
|
+
{ preset: 'site-interactive' },
|
|
16
|
+
);
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
```js
|
|
20
|
+
// client component / island
|
|
21
|
+
'use client';
|
|
22
|
+
import { useEffect, useRef } from 'react';
|
|
23
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
24
|
+
|
|
25
|
+
export function Widget() {
|
|
26
|
+
const ref = useRef(null);
|
|
27
|
+
useEffect(() => {
|
|
28
|
+
const ui = runtime.resolve('uiSession');
|
|
29
|
+
ui.mount(ref.current /* … */);
|
|
30
|
+
}, []);
|
|
31
|
+
return <div ref={ref} />;
|
|
32
|
+
}
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
`withFw` composes with a `webpack(config, options)` already present in your config (it is called after adding the plugin).
|
|
36
|
+
|
|
37
|
+
## Turbopack (default since Next 16)
|
|
38
|
+
|
|
39
|
+
Turbopack cannot run Webpack plugins, so `withFw` supports it differently:
|
|
40
|
+
the virtual modules are **materialized** into `.fw-virtual/` (regenerated at
|
|
41
|
+
every config evaluation — add it to `.gitignore`) and wired through
|
|
42
|
+
`turbopack.resolveAlias` by the `@awacloud/fw/turbopack` adapter. Nothing to do on
|
|
43
|
+
your side — the same `virtual:@awacloud/fw/*` imports work under both engines, and
|
|
44
|
+
`withFw` composes with any `turbopack` config already present.
|
|
45
|
+
|
|
46
|
+
The **manual composition** path ("à la carte" direct subpath imports) of
|
|
47
|
+
course remains available under any engine:
|
|
48
|
+
|
|
49
|
+
```js
|
|
50
|
+
import { createRuntime } from '@awacloud/fw/typed';
|
|
51
|
+
import { hex } from '@awacloud/fw/io/codec/hex.js';
|
|
52
|
+
import { signal } from '@awacloud/fw/io/utils/signal.js';
|
|
53
|
+
|
|
54
|
+
const runtime = createRuntime();
|
|
55
|
+
runtime.registerDeep(hex);
|
|
56
|
+
runtime.registerDeep(signal);
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
## Sanity layer (client-only, recommended: `community`)
|
|
60
|
+
|
|
61
|
+
The sanity layers are browser-only and must never run on the Next server. `withFw`
|
|
62
|
+
therefore forces `sanity: false` on the Webpack plugin. Place the sanity layer
|
|
63
|
+
client-side via a root `'use client'` component (e.g. `app/Sanity.tsx`):
|
|
64
|
+
|
|
65
|
+
```tsx
|
|
66
|
+
// app/Sanity.tsx
|
|
67
|
+
'use client';
|
|
68
|
+
import { applyCommunity } from '@awacloud/fw/sanity/community';
|
|
69
|
+
applyCommunity();
|
|
70
|
+
export default function Sanity() { return null; }
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
```tsx
|
|
74
|
+
// app/layout.tsx (App Router)
|
|
75
|
+
import Sanity from './Sanity';
|
|
76
|
+
export default function RootLayout({ children }) {
|
|
77
|
+
return <html><body><Sanity />{children}</body></html>;
|
|
78
|
+
}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
`community` validates inputs and restricts unsafe patterns without freezing
|
|
82
|
+
prototypes or blocking APIs — **`<Link>` client navigation and `history`
|
|
83
|
+
work normally under `community`**. Use `base` only when you need the full
|
|
84
|
+
strict lockdown (note: `base` blocks `history.pushState` / `replaceState`,
|
|
85
|
+
so Next's `<Link>` client navigation will not work under `base`).
|
|
86
|
+
|
|
87
|
+
## SSR (data, no JSX bridge)
|
|
88
|
+
|
|
89
|
+
`render.toHTML` is **worker-safe / pure data** → usable server-side (Server Component, route handler) to produce the markup, then client-side hydration via `uiSession.hydrate`:
|
|
90
|
+
|
|
91
|
+
```jsx
|
|
92
|
+
// Server Component
|
|
93
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site';
|
|
94
|
+
const html = runtime.resolve('render').toHTML(/* elm array */);
|
|
95
|
+
return <div id="app" dangerouslySetInnerHTML={{ __html: html }} />;
|
|
96
|
+
```
|
|
97
|
+
```js
|
|
98
|
+
// client
|
|
99
|
+
'use client';
|
|
100
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site';
|
|
101
|
+
runtime.resolve('uiSession').hydrate(document.getElementById('app'));
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Recipe — reusable `<FwIsland>` (option B)
|
|
105
|
+
|
|
106
|
+
Minimal React component mounting an fw widget into a `ref` (mounted in `useEffect`, **cleaned up on unmount**). This is a **snippet** (peer React), not delivered code — adapt the `uiSession` call to your widget.
|
|
107
|
+
|
|
108
|
+
```jsx
|
|
109
|
+
'use client';
|
|
110
|
+
import { useEffect, useRef } from 'react';
|
|
111
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
112
|
+
|
|
113
|
+
export function FwIsland({ hydrate = false, render }) {
|
|
114
|
+
const ref = useRef(null);
|
|
115
|
+
useEffect(() => {
|
|
116
|
+
const ui = runtime.resolve('uiSession');
|
|
117
|
+
// hydrate existing SSR markup, OR mount fresh — depends on your uiSession API
|
|
118
|
+
const session = hydrate ? ui.hydrate(ref.current) : render?.(ui, ref.current);
|
|
119
|
+
return () => session?.destroy?.(); // React unmount cleanup
|
|
120
|
+
}, [hydrate, render]);
|
|
121
|
+
return <div ref={ref} />;
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Usage: `<FwIsland render={(ui, el) => ui.mount(el /* view, data */)} />`, or `<FwIsland hydrate />` on a container rendered in SSR (see SSR section). **Assumed boundary**: imperative island — React and `signal`/`uiSession` coexist side by side, **no** JSX↔elm-array bridge.
|
|
126
|
+
|
|
127
|
+
## Client / server boundary
|
|
128
|
+
|
|
129
|
+
| Modules | Where |
|
|
130
|
+
|---|---|
|
|
131
|
+
| `dom`, `uiSession`, `gesture`, sensors… (DOM) | **client only** (`'use client'`) |
|
|
132
|
+
| `render` (data), codecs, `crypto`, `io/*`, `valid`… (worker-safe) | client **and** server |
|
|
133
|
+
|
|
134
|
+
Do not resolve DOM modules in a Server Component.
|
|
135
|
+
|
|
136
|
+
## Options (`fwOptions`)
|
|
137
|
+
|
|
138
|
+
| Option | Type | Default | Role |
|
|
139
|
+
|---|---|---|---|
|
|
140
|
+
| `preset` | `string` | `'site'` | preset of the specifier without suffix |
|
|
141
|
+
| `sideBundles` | `string[]` | `[]` | side-bundles validated at startup |
|
|
142
|
+
| `packageName` | `string` | `'@awacloud/fw'` | specifier used in emitted imports |
|
|
143
|
+
| `configPath` | `string` | bundled | override for `fw.config.json` |
|
|
144
|
+
|
|
145
|
+
## Notes
|
|
146
|
+
|
|
147
|
+
- **Webpack 5** required (Next uses it by default) — the plugin relies on `compiler.webpack.NormalModule` + native scheme hooks.
|
|
148
|
+
- Depends on [`@awacloud/fw/webpack`](../webpack/README.md).
|
|
149
|
+
- Structurally validated by the [e2e harness](https://github.com/awacloud/awa/blob/main/packages/front/fw/integrations/_e2e/README.md) (Next not installed: `withFw` correctly adds the plugin and composes the webpack hook).
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/nextjs/index.d.ts
|
|
6
|
+
// Types for the `@awacloud/fw` Next.js integration. Does NOT depend on `next` — the
|
|
7
|
+
// Next config is typed structurally (same dependency-free convention as the
|
|
8
|
+
// other integrations).
|
|
9
|
+
|
|
10
|
+
export interface FwNextOptions {
|
|
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
|
+
/** Package specifier used in the emitted imports. Default: `'@awacloud/fw'`. */
|
|
16
|
+
packageName?: string;
|
|
17
|
+
/** Override `fw.config.json` path. */
|
|
18
|
+
configPath?: string;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Wrap a Next.js config so the `@awacloud/fw` virtual modules resolve in the Webpack
|
|
23
|
+
* and Turbopack builds. Sanity is NOT injected here (browser-only). Recommended:
|
|
24
|
+
* place `@awacloud/fw/sanity/community` in a root `'use client'` component —
|
|
25
|
+
* `<Link>` / history navigation works under `community`.
|
|
26
|
+
*/
|
|
27
|
+
export default function withFw<T extends Record<string, unknown>>(
|
|
28
|
+
nextConfig?: T,
|
|
29
|
+
fwOptions?: FwNextOptions,
|
|
30
|
+
): T & { webpack: (config: any, options: unknown) => any };
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/nextjs/index.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Official Next.js integration for `@awacloud/fw`.
|
|
8
|
+
*
|
|
9
|
+
* `withFw(nextConfig, fwOptions)` wraps a Next.js config to expose the
|
|
10
|
+
* `virtual:@awacloud/fw/preset/*` / `…/side-bundle/*` modules in the **Webpack**
|
|
11
|
+
* build, by plugging the existing `@awacloud/fw/webpack` plugin into Next's
|
|
12
|
+
* `webpack(config)` hook. It composes with any `webpack` function already on
|
|
13
|
+
* the config.
|
|
14
|
+
*
|
|
15
|
+
* Scope (explicit) :
|
|
16
|
+
* - **Webpack AND Turbopack.** The Webpack build goes through the
|
|
17
|
+
* `@awacloud/fw/webpack` plugin; Turbopack (default since Next 16) cannot run
|
|
18
|
+
* Webpack plugins, so the virtual modules are MATERIALIZED to real files
|
|
19
|
+
* and wired through `turbopack.resolveAlias` (see ../turbopack/index.js).
|
|
20
|
+
* Both paths expose the same `virtual:@awacloud/fw/*` specifiers.
|
|
21
|
+
* - **Sanity is NOT injected here.** The sanity layers are browser-only and
|
|
22
|
+
* must never run on the Next server. Next manages entry points itself (the
|
|
23
|
+
* Webpack plugin's entry-prepend can't reach them). Place the `community`
|
|
24
|
+
* layer client-side — a root `'use client'` component that does
|
|
25
|
+
* `import { applyCommunity } from '@awacloud/fw/sanity/community';
|
|
26
|
+
* applyCommunity();` (a bare side-effect import is inert — `community` is
|
|
27
|
+
* an explicit-call ES module, FINDINGS §c.1). Under `community`, `<Link>`
|
|
28
|
+
* / `history` client navigation works normally. See README for the
|
|
29
|
+
* recommended pattern.
|
|
30
|
+
* - **Not a React bridge.** This lets you USE fw inside a Next app (a widget
|
|
31
|
+
* mounted in `useEffect`, or SSR data via `render.toHTML`) — it does NOT
|
|
32
|
+
* marry fw's elm-array rendering with JSX.
|
|
33
|
+
*
|
|
34
|
+
* Usage :
|
|
35
|
+
*
|
|
36
|
+
* // next.config.mjs
|
|
37
|
+
* import withFw from '@awacloud/fw/next';
|
|
38
|
+
* export default withFw({ /* your next config */ }, { preset: 'site-interactive' });
|
|
39
|
+
*
|
|
40
|
+
* // any client component / island
|
|
41
|
+
* import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
42
|
+
*
|
|
43
|
+
* @see ../webpack/index.js the plugin this wraps
|
|
44
|
+
* @see ./README.md
|
|
45
|
+
*/
|
|
46
|
+
|
|
47
|
+
import { FwWebpackPlugin } from '../webpack/index.js';
|
|
48
|
+
import { fwTurbopack } from '../turbopack/index.js';
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* @typedef {Object} FwNextOptions
|
|
52
|
+
* @property {string} [preset='site'] Default preset for the bare `virtual:@awacloud/fw/preset` specifier.
|
|
53
|
+
* @property {string[]} [sideBundles=[]] Side-bundles validated up-front.
|
|
54
|
+
* @property {string} [packageName='@awacloud/fw'] Package specifier used in the emitted imports.
|
|
55
|
+
* @property {string} [configPath] Override `fw.config.json` path.
|
|
56
|
+
*/
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Wrap a Next.js config so the `@awacloud/fw` virtual modules resolve in the
|
|
60
|
+
* Webpack build. Sanity is intentionally NOT injected here (browser-only,
|
|
61
|
+
* client-side — see file header / README). Recommended: a root
|
|
62
|
+
* `'use client'` component that imports `applyCommunity` from
|
|
63
|
+
* `@awacloud/fw/sanity/community` and calls it (bare side-effect import does
|
|
64
|
+
* nothing — the tier is explicit-call).
|
|
65
|
+
*
|
|
66
|
+
* @param {Record<string, any>} [nextConfig] The user's Next.js config.
|
|
67
|
+
* @param {FwNextOptions} [fwOptions] Options forwarded to the Webpack plugin.
|
|
68
|
+
* @returns {Record<string, any>} The augmented Next.js config.
|
|
69
|
+
*/
|
|
70
|
+
export default function withFw(nextConfig = {}, fwOptions = {}) {
|
|
71
|
+
// Turbopack path (default engine since Next 16) : materialize the virtual
|
|
72
|
+
// modules into `.fw-virtual/` and alias the specifiers to those files.
|
|
73
|
+
// Composes with any `turbopack` config already present.
|
|
74
|
+
const { resolveAlias } = fwTurbopack(fwOptions);
|
|
75
|
+
|
|
76
|
+
return {
|
|
77
|
+
...nextConfig,
|
|
78
|
+
turbopack: {
|
|
79
|
+
...(nextConfig.turbopack || {}),
|
|
80
|
+
resolveAlias: {
|
|
81
|
+
...((nextConfig.turbopack || {}).resolveAlias || {}),
|
|
82
|
+
...resolveAlias,
|
|
83
|
+
},
|
|
84
|
+
},
|
|
85
|
+
webpack(config, options) {
|
|
86
|
+
config.plugins = config.plugins || [];
|
|
87
|
+
// `sanity: false` — Next owns entry points; the community sanity
|
|
88
|
+
// layer is placed client-side by the app (see README), not via the
|
|
89
|
+
// build. `<Link>` / history navigation works under community.
|
|
90
|
+
config.plugins.push(new FwWebpackPlugin({ ...fwOptions, sanity: false }));
|
|
91
|
+
// Compose with a pre-existing `webpack` hook on the user's config.
|
|
92
|
+
if (typeof nextConfig.webpack === 'function') {
|
|
93
|
+
return nextConfig.webpack(config, options);
|
|
94
|
+
}
|
|
95
|
+
return config;
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# `@awacloud/fw` — Node.js
|
|
2
|
+
|
|
3
|
+
**Runtime target** (not a plugin): the canonical "`@awacloud/fw` under Node" page. `@awacloud/fw` targets bun **and** Node; this page consolidates what works, the single bun-specific point (resolved), and provides a drop-in Node-native `package.json`. Operational details + task table: [`../../docs/dev/runtime.md`](../../docs/dev/runtime.md).
|
|
4
|
+
|
|
5
|
+
## Quick summary
|
|
6
|
+
|
|
7
|
+
| Surface | Node? |
|
|
8
|
+
|---|---|
|
|
9
|
+
| `@awacloud/fw` as a **dependency** (ESM, subpaths, worker-safe modules, `render.toHTML` SSR data) | ✅ native |
|
|
10
|
+
| **Tooling** (`fw-bundler`'s `modlib/scan-modules`, `bundle/lib/config`, `fw-codegen`'s `registry`, `audit`, `rendering/aot`, `rendering/precompilation`) | ✅ `node:*` only |
|
|
11
|
+
| **Bundle build** (`dist/build/*`) | ✅ via **esbuild**/rollup backend (`--backend`) — replaces the single bun-specific piece (`Bun.build`/`Bun.gzipSync`) |
|
|
12
|
+
| **Tests** | ✅ via **Vitest** (or Jest) — shim `bun:test`, suite intact |
|
|
13
|
+
| **Types / lint / TypeDoc** | ✅ `tsc` / `eslint` / `typedoc` (all Node) |
|
|
14
|
+
| `dom/*` + `sanity` modules | ⛔ **browser-only** — do not resolve server-side (boundary shared with Deno/Nest) |
|
|
15
|
+
|
|
16
|
+
**All integrations** (`vite`, `esbuild`, `rollup`, `bun`, `webpack`, `astro`, `next`, `nest`, `vitest`, `jest`, `typedoc`) are `node:`-only code at load time → usable under Node where relevant (the **Bun** bridge targets the bun runtime, but its file remains importable under Node).
|
|
17
|
+
|
|
18
|
+
## The single bun-specific point — resolved
|
|
19
|
+
|
|
20
|
+
The builder drove `Bun.build`/`Bun.gzipSync`. It is now behind a **backend selector** (`tools/fw-bundler/src/bundle/lib/bundler.js`): `bun` (default), **`esbuild`** (recommended for Node), `rollup`. To produce `dist/build/*` under **pure Node**:
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
bun run setup:e2e # installs esbuild (on demand)
|
|
24
|
+
node ../../../tools/fw-bundler/src/bundle/index.js --backend esbuild
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
> **Node invocation**: target `index.js` explicitly (`node tools/<…>/index.js`, or for the mutualized tools `node ../../../tools/<fw-bundler|fw-codegen>/src/<…>/index.js`), not the directory — the `isMainModule` guard does not activate on `node <directory>`.
|
|
28
|
+
|
|
29
|
+
## Developing 100% under Node — intentional substitution
|
|
30
|
+
|
|
31
|
+
The default `package.json` is **bun**-oriented (and intentionally *lean*: heavy Node tools are installed on demand). For a Node-only setup, [`package.node.example.json`](./package.node.example.json) provides a **drop-in** profile: Node-native `scripts` (Vitest, `tsc`, `eslint`, `--backend esbuild` builds, tools via `index.js`) + Node toolchain in `devDependencies`.
|
|
32
|
+
|
|
33
|
+
```sh
|
|
34
|
+
# use it as inspiration, or merge its scripts/devDependencies into package.json, then:
|
|
35
|
+
npm install
|
|
36
|
+
npm test # vitest
|
|
37
|
+
npm run prebuild # node …/fw-bundler/src/bundle/index.js --backend esbuild
|
|
38
|
+
npm run types # tsc
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## See also
|
|
42
|
+
|
|
43
|
+
- [`docs/dev/runtime.md`](../../docs/dev/runtime.md) — full bun vs Node table, lean install policy.
|
|
44
|
+
- [esbuild backend](../esbuild/README.md) · [rollup backend](../rollup/README.md) — produce `dist/build/*` under Node.
|
|
45
|
+
- [Vitest](../vitest/README.md) · [Jest](../jest/README.md) — run the suite under Node.
|
|
46
|
+
- [Deno](../deno/README.md) — the other runtime target (same browser/server boundary).
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"_comment": "EXAMPLE — deliberate bun → Node substitution. Copy these `scripts` + `devDependencies` into fw's package.json (or take them as a model) to develop 100% under Node, without bun. `types:registry*`/`types:audit`/`prebuild*`/`build:standalone` are wired through Node's own module resolution (`import('@awacloud/tool-fw-{bundler,codegen}/<entry>').then(m => m.runCli(...))`), same as the bun-default profile's resolved node form — this profile's own devDependencies make that resolve locally, so no relative path is needed. `build:parseresult`/`build:aot` still target `index.js` explicitly (the isMainModule guard does not fire on `node <dir>`). Builds via the esbuild backend (Node). NB: this profile commits the Node toolchain as devDependencies, unlike the lean bun default.",
|
|
3
|
+
"scripts": {
|
|
4
|
+
"test": "vitest run -c integrations/vitest/vitest.config.js",
|
|
5
|
+
"test:watch": "vitest -c integrations/vitest/vitest.config.js",
|
|
6
|
+
"lint": "eslint . --max-warnings 0",
|
|
7
|
+
"types": "tsc -p tsconfig.types.json",
|
|
8
|
+
"types:registry": "node --input-type=module -e \"import('@awacloud/tool-fw-codegen/registry').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" --",
|
|
9
|
+
"types:registry:check": "node --input-type=module -e \"import('@awacloud/tool-fw-codegen/registry').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" -- --check",
|
|
10
|
+
"types:audit": "node --input-type=module -e \"import('@awacloud/tool-fw-codegen/audit').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" --",
|
|
11
|
+
"prebuild": "node --input-type=module -e \"import('@awacloud/tool-fw-bundler/bundle').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" -- --backend esbuild",
|
|
12
|
+
"prebuild:rollup": "node --input-type=module -e \"import('@awacloud/tool-fw-bundler/bundle').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" -- --backend rollup",
|
|
13
|
+
"build:standalone": "node --input-type=module -e \"import('@awacloud/tool-fw-bundler/standalone').then(m => m.runCli(process.argv.slice(1))).then(c => process.exit(c))\" --",
|
|
14
|
+
"build:parseresult": "node tools/rendering/precompilation/index.js",
|
|
15
|
+
"build:aot": "node tools/rendering/aot/index.js",
|
|
16
|
+
"docs:api": "rm -rf dist/types && npm run types && node integrations/typedoc/categorize.js && typedoc --options integrations/typedoc/typedoc.json"
|
|
17
|
+
},
|
|
18
|
+
"devDependencies": {
|
|
19
|
+
"@eslint/js": "^9.0.0",
|
|
20
|
+
"@happy-dom/global-registrator": "^20.6.0",
|
|
21
|
+
"@rollup/plugin-terser": "^0.4.4",
|
|
22
|
+
"esbuild": "^0.28.0",
|
|
23
|
+
"eslint": "^9.0.0",
|
|
24
|
+
"globals": "^15.0.0",
|
|
25
|
+
"happy-dom": "^20.6.0",
|
|
26
|
+
"rollup": "^4.61.1",
|
|
27
|
+
"typescript": "^5.9.3",
|
|
28
|
+
"typescript-eslint": "^8.0.0",
|
|
29
|
+
"vitest": "^3.0.0"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# `@awacloud/fw/rollup`
|
|
2
|
+
|
|
3
|
+
Official Rollup plugin — **consumer role** (role 1). The Vite plugin *is* a Rollup plugin under the hood; this adapter mirrors its `resolveId`/`load`/`transform` shape, without the Vite extras.
|
|
4
|
+
|
|
5
|
+
> **Role 2** (Rollup as a Node build backend) is delivered in [`backend.js`](./backend.js) — see the section below.
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
```js
|
|
10
|
+
// rollup.config.js
|
|
11
|
+
import fwRollup from '@awacloud/fw/rollup';
|
|
12
|
+
|
|
13
|
+
export default {
|
|
14
|
+
input: 'src/app.js',
|
|
15
|
+
output: { dir: 'dist', format: 'es' },
|
|
16
|
+
plugins: [fwRollup({ preset: 'site-interactive', sanity: 'base' })],
|
|
17
|
+
};
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
// src/app.js
|
|
22
|
+
import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
23
|
+
|
|
24
|
+
const cryptoBasic = await import('virtual:@awacloud/fw/side-bundle/crypto-basic');
|
|
25
|
+
cryptoBasic.install(runtime);
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
## Virtual modules
|
|
29
|
+
|
|
30
|
+
| Specifier | Content |
|
|
31
|
+
|---|---|
|
|
32
|
+
| `virtual:@awacloud/fw/preset` | pre-instantiated runtime for the default preset (`options.preset`) |
|
|
33
|
+
| `virtual:@awacloud/fw/preset/<name>` | same for preset `<name>` |
|
|
34
|
+
| `virtual:@awacloud/fw/side-bundle/<name>` | `export function install(runtime)` + `modules` |
|
|
35
|
+
|
|
36
|
+
Emitted code **identical** to other bundlers (shared core `../_shared/core.js`).
|
|
37
|
+
|
|
38
|
+
## Options
|
|
39
|
+
|
|
40
|
+
| Option | Type | Default | Role |
|
|
41
|
+
|---|---|---|---|
|
|
42
|
+
| `preset` | `string` | `'site'` | preset of the specifier without suffix |
|
|
43
|
+
| `sideBundles` | `string[]` | `[]` | side-bundles validated at startup |
|
|
44
|
+
| `sanity` | `'base' \| 'community' \| 'lockdown' \| false` | `false` | prefixes the sanity layer on each entry chunk |
|
|
45
|
+
| `packageName` | `string` | `'@awacloud/fw'` | specifier used in emitted imports |
|
|
46
|
+
| `configPath` | `string` | bundled | override for `fw.config.json` |
|
|
47
|
+
|
|
48
|
+
## Node build backend (role 2) — [`backend.js`](./backend.js)
|
|
49
|
+
|
|
50
|
+
**Alternative** Node backend to the bun builder (parallel to esbuild), to produce `dist/build/*` without bun. Rollup + `@rollup/plugin-terser` (minification) + `@rollup/plugin-node-resolve`. Same contract (`buildOne`/`buildClassical`), hash `node:crypto`, gzip `node:zlib`.
|
|
51
|
+
|
|
52
|
+
> **Heavier than esbuild** — esbuild remains the recommended Node backend. This one is for pipelines already Rollup-centered.
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
bun run setup:e2e # installs rollup + plugins (terser, node-resolve)
|
|
56
|
+
bun run prebuild:rollup # bun, rollup backend
|
|
57
|
+
node ../../../tools/fw-bundler/src/bundle/index.js --backend rollup # build under pure Node
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Validated: full build under pure Node (8 presets + 8 side-bundles + sanity, `pure`+`classic`). Sizes comparable (terser gzip slightly better, e.g. full ≈ 184 KB gz vs 198 KB esbuild). Selected via `--backend rollup` / `FW_BUILD_BACKEND=rollup` — never auto-selected (bun/esbuild only in auto mode).
|
|
61
|
+
|
|
62
|
+
## Notes (consumer plugin)
|
|
63
|
+
|
|
64
|
+
- **Sanity**: injected via the `transform` hook on `isEntry` modules. `'base'`/`'community'`: bare side-effect import. `'lockdown'`: `import { lockdown } from '…'; lockdown();` (explicit-call module, not an IIFE). Browser-only — do not enable for a Node/Worker target.
|
|
65
|
+
- **Resolution**: the emitted `@awacloud/fw/*` imports are resolved by Rollup via the app's resolver (typically `@rollup/plugin-node-resolve`).
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/rollup/backend.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Rollup **build backend** for `@awacloud/fw` (Rollup role 2).
|
|
8
|
+
*
|
|
9
|
+
* Alternative Node replacement for the bun-specific builder
|
|
10
|
+
* (`tools/fw-bundler/src/bundle/lib/bundler.js`), parallel to the esbuild backend.
|
|
11
|
+
* Heavier than esbuild (Rollup + `@rollup/plugin-terser` for minification),
|
|
12
|
+
* so esbuild stays the recommended Node backend ; this exists for pipelines
|
|
13
|
+
* that are already Rollup-centric or want Rollup's output.
|
|
14
|
+
*
|
|
15
|
+
* Same contract as the other backends :
|
|
16
|
+
* buildOne(opts) → { outputs, outFile, bytes, hashSha256, gzBytes }
|
|
17
|
+
* buildClassical(opts) → idem (IIFE, sanity.min.js)
|
|
18
|
+
*
|
|
19
|
+
* Hash via `node:crypto`, gzip size via `node:zlib`. Peers installed on demand
|
|
20
|
+
* (`bun run setup:e2e` → rollup, @rollup/plugin-node-resolve, @rollup/plugin-terser).
|
|
21
|
+
*
|
|
22
|
+
* Selected by the bundler selector when the backend is `rollup`
|
|
23
|
+
* (`--backend rollup` / `FW_BUILD_BACKEND=rollup`). Never auto-selected.
|
|
24
|
+
*
|
|
25
|
+
* @see ./README.md
|
|
26
|
+
* @see ../esbuild/backend.js the recommended (lighter) Node backend
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
import { readFileSync, existsSync } from 'node:fs';
|
|
30
|
+
import { createHash } from 'node:crypto';
|
|
31
|
+
import { gzipSync } from 'node:zlib';
|
|
32
|
+
import { resolve, dirname, basename } from 'node:path';
|
|
33
|
+
|
|
34
|
+
/** Best-effort dynamic import — returns the chosen named/default export or null. */
|
|
35
|
+
async function tryPlugin(spec, pick) {
|
|
36
|
+
try {
|
|
37
|
+
const m = await import(spec);
|
|
38
|
+
return pick(m);
|
|
39
|
+
} catch {
|
|
40
|
+
return null;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Build a single entry with Rollup. Same signature/return as the bun backend.
|
|
46
|
+
* @returns {Promise<{ outputs: string[], outFile: string, bytes: number, hashSha256: string, gzBytes: number }>}
|
|
47
|
+
*/
|
|
48
|
+
export async function buildOne({
|
|
49
|
+
entry,
|
|
50
|
+
outdir,
|
|
51
|
+
outFileName,
|
|
52
|
+
minify = true,
|
|
53
|
+
sourcemap = 'external',
|
|
54
|
+
format = 'esm',
|
|
55
|
+
target = 'browser',
|
|
56
|
+
external,
|
|
57
|
+
}) {
|
|
58
|
+
const { rollup } = await import('rollup');
|
|
59
|
+
|
|
60
|
+
const plugins = [];
|
|
61
|
+
const nodeResolve = await tryPlugin('@rollup/plugin-node-resolve', (m) => m.nodeResolve ?? m.default);
|
|
62
|
+
if (nodeResolve) {
|
|
63
|
+
plugins.push(nodeResolve({
|
|
64
|
+
browser: target === 'browser',
|
|
65
|
+
exportConditions: target === 'browser' ? ['browser', 'import', 'default'] : ['import', 'default'],
|
|
66
|
+
}));
|
|
67
|
+
}
|
|
68
|
+
if (minify) {
|
|
69
|
+
const terser = await tryPlugin('@rollup/plugin-terser', (m) => m.default ?? m);
|
|
70
|
+
if (!terser) {
|
|
71
|
+
throw new Error('rollup backend: minify requested but @rollup/plugin-terser is not installed (run `bun run setup:e2e`).');
|
|
72
|
+
}
|
|
73
|
+
plugins.push(terser());
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
const base = outFileName
|
|
77
|
+
? outFileName.replace(/\.js$/, '')
|
|
78
|
+
: `${basename(dirname(entry))}${minify ? '.min' : ''}`;
|
|
79
|
+
const outFile = resolve(outdir, `${base}.js`);
|
|
80
|
+
const rollupFormat = format === 'iife' ? 'iife' : 'es';
|
|
81
|
+
|
|
82
|
+
let bundle;
|
|
83
|
+
try {
|
|
84
|
+
bundle = await rollup({
|
|
85
|
+
input: entry,
|
|
86
|
+
plugins,
|
|
87
|
+
external: external && external.length ? [...external] : [],
|
|
88
|
+
onwarn: () => { /* browser bundle : import.meta / this-undefined warnings are expected */ },
|
|
89
|
+
});
|
|
90
|
+
await bundle.write({
|
|
91
|
+
file: outFile,
|
|
92
|
+
format: rollupFormat,
|
|
93
|
+
sourcemap: sourcemap !== 'none',
|
|
94
|
+
inlineDynamicImports: true,
|
|
95
|
+
...(rollupFormat === 'iife' ? { name: 'fwBundle' } : {}),
|
|
96
|
+
});
|
|
97
|
+
} catch (e) {
|
|
98
|
+
throw new Error(`rollup build failed for ${entry}: ${e.message}`, { cause: e });
|
|
99
|
+
} finally {
|
|
100
|
+
if (bundle) await bundle.close();
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
const buf = readFileSync(outFile);
|
|
104
|
+
const outputs = [outFile];
|
|
105
|
+
const mapFile = `${outFile}.map`;
|
|
106
|
+
if (existsSync(mapFile)) outputs.push(mapFile);
|
|
107
|
+
|
|
108
|
+
return {
|
|
109
|
+
outputs,
|
|
110
|
+
outFile,
|
|
111
|
+
bytes: buf.byteLength,
|
|
112
|
+
hashSha256: createHash('sha256').update(buf).digest('hex'),
|
|
113
|
+
gzBytes: gzipSync(buf).byteLength,
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* Build a classical (IIFE) script — used for `sanity.min.js`. sanity/base.js
|
|
119
|
+
* has no exports, so the IIFE needs no `output.name`.
|
|
120
|
+
* @returns {Promise<{ outputs: string[], outFile: string, bytes: number, hashSha256: string, gzBytes: number }>}
|
|
121
|
+
*/
|
|
122
|
+
export async function buildClassical({ entry, outdir, outFileName, minify = true }) {
|
|
123
|
+
return buildOne({
|
|
124
|
+
entry,
|
|
125
|
+
outdir,
|
|
126
|
+
outFileName,
|
|
127
|
+
minify,
|
|
128
|
+
sourcemap: 'none',
|
|
129
|
+
format: 'iife',
|
|
130
|
+
target: 'browser',
|
|
131
|
+
});
|
|
132
|
+
}
|
|
@@ -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/rollup/index.d.ts
|
|
6
|
+
// Types for the `@awacloud/fw` Rollup plugin. Does NOT depend on the `rollup`
|
|
7
|
+
// package — typed against a minimal structural plugin shape (same convention
|
|
8
|
+
// as vite/index.d.ts and esbuild/index.d.ts).
|
|
9
|
+
|
|
10
|
+
export interface FwRollupOptions {
|
|
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 chunk. 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
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Minimal structural shape of a Rollup plugin (no dependency on `rollup`). */
|
|
24
|
+
export interface FwRollupPlugin {
|
|
25
|
+
name: string;
|
|
26
|
+
resolveId(id: string): string | null;
|
|
27
|
+
load(id: string): string | null;
|
|
28
|
+
transform(code: string, id: string): { code: string; map: null } | null;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Create the `@awacloud/fw` Rollup consumer plugin. */
|
|
32
|
+
export default function fwRollup(options?: FwRollupOptions): FwRollupPlugin;
|