@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,215 @@
|
|
|
1
|
+
# `tools/fw-bundler` (`bundle`) — Prebuild
|
|
2
|
+
|
|
3
|
+
> Mutualized: the implementation no longer lives
|
|
4
|
+
> under `packages/front/fw/tools/build/bundler/` — it was ported
|
|
5
|
+
> logic-verbatim to the repo-level `tools/fw-bundler` package
|
|
6
|
+
> (`tools/fw-bundler/src/bundle/`), consumed here as a devDependency
|
|
7
|
+
> (`@awacloud/tool-fw-bundler`) and invoked via its `fw-bundler bundle` bin.
|
|
8
|
+
|
|
9
|
+
## Purpose
|
|
10
|
+
|
|
11
|
+
Zero-dependency prebuild orchestrator based on `Bun.build`. Produces minified/unminified ESM bundles for the presets and side-bundles declared in **`fw.config.json`**, as well as `sanity.min.js`.
|
|
12
|
+
|
|
13
|
+
## CLI usage
|
|
14
|
+
|
|
15
|
+
```sh
|
|
16
|
+
bun run prebuild # everything (presets + side-bundles + sanity)
|
|
17
|
+
bun run prebuild:presets # all presets (no side-bundles)
|
|
18
|
+
bun run prebuild:side-bundles # all side-bundles
|
|
19
|
+
bun run prebuild:minimal # a specific preset
|
|
20
|
+
bun run prebuild:core
|
|
21
|
+
bun run prebuild:site
|
|
22
|
+
bun run prebuild:site-interactive
|
|
23
|
+
bun run prebuild:spa
|
|
24
|
+
bun run prebuild:pwa
|
|
25
|
+
bun run prebuild:sanity # only sanity.min.js
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Direct form:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
fw-bundler bundle [target] [flags] # from the package root
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
`target` can be:
|
|
35
|
+
- A preset name (`minimal`, `core`, `site`, …)
|
|
36
|
+
- A side-bundle name (`crypto-basic`, `realtime`, …)
|
|
37
|
+
- `presets` — all presets only
|
|
38
|
+
- `side-bundles` — all side-bundles only
|
|
39
|
+
- `all` (default) — everything
|
|
40
|
+
|
|
41
|
+
### Flags
|
|
42
|
+
|
|
43
|
+
| Flag | Effect |
|
|
44
|
+
| ------------------- | ------ |
|
|
45
|
+
| `--dev` | `ENV.DEV = true` and preserves `/* dev_only */` blocks. |
|
|
46
|
+
| `--no-log` | `ENV.LOG = false` — no main logger. |
|
|
47
|
+
| `--no-sanity-log` | Patches `sanity/base.js` with `LOG_ATTEMPTS = false` (silent in production). |
|
|
48
|
+
| `--sanity-only` | Builds only `dist/build/sanity.min.js`. |
|
|
49
|
+
| `--no-sanity` | Does not emit `sanity.min.js`. |
|
|
50
|
+
| `--config <path>` | Overrides the path to `fw.config.json`. |
|
|
51
|
+
| `--classic` | Forces emission of the `classic` variant on **all** targets in the run (union with the config's `variants`). |
|
|
52
|
+
| `--endpoint <name>` | Name of the global property attached by the `classic` variant (overrides config; default `fw`). |
|
|
53
|
+
| `--backend <name>` | Build backend: `bun` (default under bun), `esbuild` or `rollup` (Node-capable). Auto-selected if omitted. |
|
|
54
|
+
|
|
55
|
+
## Build backends (bun by default, or Node)
|
|
56
|
+
|
|
57
|
+
The builder drives `Bun.build`/`Bun.gzipSync` via a **selector** (`lib/bundler.js`) with a single contract. Three backends:
|
|
58
|
+
|
|
59
|
+
| Backend | Runtime | Selection |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| `bun` | bun | default under bun |
|
|
62
|
+
| `esbuild` | Node (recommended) | `--backend esbuild` / `FW_BUILD_BACKEND` / auto if bun absent |
|
|
63
|
+
| `rollup` | Node (alternative, + terser) | `--backend rollup` |
|
|
64
|
+
|
|
65
|
+
To produce `dist/build/*` **under pure Node** (without bun):
|
|
66
|
+
|
|
67
|
+
```sh
|
|
68
|
+
bun run setup:e2e # installs esbuild (and rollup/terser) on demand
|
|
69
|
+
bun run prebuild:node # = node ../../../tools/fw-bundler/src/bundle/index.js --backend esbuild
|
|
70
|
+
# rollup alternative:
|
|
71
|
+
node ../../../tools/fw-bundler/src/bundle/index.js --backend rollup
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
> Under Node, target `index.js` explicitly (`node .../bundle/index.js`), not the directory — otherwise the `isMainModule` guard does not execute `main()`. Under bun, the declared `fw-bundler bundle` bin is enough. Details: [`../dev/runtime.md`](../dev/runtime.md), backends [esbuild](../../integrations/esbuild/README.md) / [rollup](../../integrations/rollup/README.md).
|
|
75
|
+
|
|
76
|
+
## Configuration
|
|
77
|
+
|
|
78
|
+
The configuration lives in **`fw.config.json`**. Single source of truth, consumed by the self-contained build **and** by the Vite plugin — no risk of drift.
|
|
79
|
+
|
|
80
|
+
Shape:
|
|
81
|
+
|
|
82
|
+
```json
|
|
83
|
+
{
|
|
84
|
+
"defaults": {
|
|
85
|
+
"variants": ["pure"]
|
|
86
|
+
},
|
|
87
|
+
"presets": {
|
|
88
|
+
"minimal": {
|
|
89
|
+
"description": "...",
|
|
90
|
+
"modules": []
|
|
91
|
+
},
|
|
92
|
+
"core": {
|
|
93
|
+
"description": "...",
|
|
94
|
+
"modules": ["errors", "eventBus", "..."]
|
|
95
|
+
},
|
|
96
|
+
"site": {
|
|
97
|
+
"extends": "core",
|
|
98
|
+
"modules": ["dom", "events", "..."],
|
|
99
|
+
"variants": ["pure", "classic"]
|
|
100
|
+
}
|
|
101
|
+
},
|
|
102
|
+
"sideBundles": {
|
|
103
|
+
"realtime": {
|
|
104
|
+
"description": "...",
|
|
105
|
+
"modules": ["ws", "sse", "webrtc"]
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
**Cascading** via the `extends` field (cycle-detected). The preset inherits the parent's `modules` and merges them (deduplication + stable order).
|
|
112
|
+
|
|
113
|
+
**Variants**: `pure` or `classic`. By default, only `pure` is emitted. For a preset/side-bundle to also emit the `classic` variant, explicitly declare `"variants": ["pure", "classic"]` on the relevant entry — or globally via `defaults.variants`.
|
|
114
|
+
|
|
115
|
+
**Endpoint**: the `classic` variant attaches the framework to `globalThis.<endpoint>` (default `fw`). Configurable at three levels, from highest to lowest priority:
|
|
116
|
+
|
|
117
|
+
1. CLI `--endpoint <name>` (global run override);
|
|
118
|
+
2. `endpoint` per entry (`presets.<name>.endpoint` / `sideBundles.<name>.endpoint`);
|
|
119
|
+
3. `defaults.endpoint`.
|
|
120
|
+
|
|
121
|
+
The name must be a valid JS identifier (dot-access in generated code). Example config:
|
|
122
|
+
|
|
123
|
+
```json
|
|
124
|
+
{
|
|
125
|
+
"defaults": { "variants": ["pure"], "endpoint": "fw" },
|
|
126
|
+
"presets": {
|
|
127
|
+
"site": { "extends": "core", "modules": ["dom"], "variants": ["pure", "classic"], "endpoint": "awa" }
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
## pure vs classic variants
|
|
133
|
+
|
|
134
|
+
| Variant | Effect |
|
|
135
|
+
|---|---|
|
|
136
|
+
| **pure** (default) | `export default fw;` — no side effects. The app imports the bundle as ESM. |
|
|
137
|
+
| **classic** | Additionally: `if (!globalThis.<endpoint>) globalThis.<endpoint> = fw;` — useful for `<script type="module" src="...">` when you want to access the framework from non-module code. `<endpoint>` = `fw` by default, configurable (see above). |
|
|
138
|
+
|
|
139
|
+
Side-bundles follow the same logic: `pure` exports `default _mods` (the descriptor array) + `install(runtime)` + `modules`; `classic` self-installs onto `globalThis.<endpoint>.runtime` via `registerAllDeep` (same endpoint as the preset loaded upstream).
|
|
140
|
+
|
|
141
|
+
## Outputs
|
|
142
|
+
|
|
143
|
+
Everything is written to `dist/build/`. Naming convention:
|
|
144
|
+
|
|
145
|
+
| Variant | Preset | Side-bundle |
|
|
146
|
+
|-----------|------------------------------------------------|----------------------------------------------------------|
|
|
147
|
+
| `pure` | `fw.<preset>.pure.min.js` (+ `.pure.js`) | `fw.pack.<name>.pure.min.js` (+ `.pure.js`) |
|
|
148
|
+
| `classic` | `fw.<preset>.min.js` (+ `.js`) | `fw.pack.<name>.min.js` (+ `.js`) |
|
|
149
|
+
|
|
150
|
+
Each bundle has a paired `.meta.json` with: description, modules listed, env, bytes (min/gz), sha256, builtAt.
|
|
151
|
+
|
|
152
|
+
## Architecture
|
|
153
|
+
|
|
154
|
+
```
|
|
155
|
+
fw.config.json # source of truth — pure data (package root)
|
|
156
|
+
tools/fw-bundler/src/bundle/ # repo-level, mutualized — @awacloud/tool-fw-bundler
|
|
157
|
+
├── index.js # CLI orchestrator (dispatched via the `fw-bundler bundle` bin)
|
|
158
|
+
└── lib/
|
|
159
|
+
├── config.js # load fw.config.json + cascade extends + validate
|
|
160
|
+
├── entry-gen.js # generates the entry from scratch (preset + side-bundle)
|
|
161
|
+
├── validate-deps.js # invariants: deps↔dependencies, modules.js consistency, dep-string lookup
|
|
162
|
+
├── strip-dev.js # mirrors src/ with dev_only blocks removed
|
|
163
|
+
└── bundler.js # wrapper over Bun.build
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
`fw.config.json` lives at the **package root** (alongside `package.json`, like `tsconfig.types.json`) — it is cross-cutting editorial data, consumed by the bundler **and** the Vite plugin, not owned by a single tool.
|
|
167
|
+
|
|
168
|
+
The shared scanner `tools/fw-bundler/src/modlib/scan-modules.js` is the source of truth for module discovery: all tools (bundler, validate-deps, standalone) consume it, never `src/core/modules.js` directly (the latter serves the self-contained mode).
|
|
169
|
+
|
|
170
|
+
## Pipeline
|
|
171
|
+
|
|
172
|
+
1. **Load** `fw.config.json` + scan `src/` (single walk).
|
|
173
|
+
2. **Validate**: source-tree invariants (3 checks from `validate-deps.js`) + preset/side-bundle references.
|
|
174
|
+
3. **Strip-dev** (production only): mirror `src/` → `dist/_tmp/_src/` with `/* dev_only */` blocks removed.
|
|
175
|
+
4. **Sanity**: emits `sanity.min.js`.
|
|
176
|
+
5. **Assets**: copies `brotli_dict.bin` and other binary assets.
|
|
177
|
+
6. **Presets**: for each preset × variant, generates the entry from scratch and bundles.
|
|
178
|
+
7. **Side-bundles**: same.
|
|
179
|
+
|
|
180
|
+
## Customising
|
|
181
|
+
|
|
182
|
+
### Adding a module to a preset
|
|
183
|
+
|
|
184
|
+
Edit `fw.config.json`, add the name to the preset's `modules` array. The name must exist in `src/` (a module-shaped `export const X = { name, factory, ... }`). If the reference is invalid, the build fails at the `loadConfig` phase:
|
|
185
|
+
|
|
186
|
+
```
|
|
187
|
+
[config] preset "site" references unknown modules: foo, bar
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### Creating a preset
|
|
191
|
+
|
|
192
|
+
Add an entry in `fw.config.json#presets`, optionally with `extends: "<parent>"`. Add a `prebuild:<name>` script in `package.json` (optional — `fw-bundler bundle <name>` already works).
|
|
193
|
+
|
|
194
|
+
### Adding a side-bundle
|
|
195
|
+
|
|
196
|
+
Add an entry in `fw.config.json#sideBundles`: `{ "description": "...", "modules": [...] }`. Variants inherit from `defaults.variants` unless explicitly overridden.
|
|
197
|
+
|
|
198
|
+
### Editorial pruning
|
|
199
|
+
|
|
200
|
+
With the `deps` field (cf. [`docs/guide/module-pattern.md`](../guide/module-pattern.md)) and `registerAllDeep`, presets no longer need to list the transitive closure: only the top-level conceptual modules are needed. The bundler pulls in deps via each module's JS imports. You can freely shorten existing lists.
|
|
201
|
+
|
|
202
|
+
## Technical constraints
|
|
203
|
+
|
|
204
|
+
- Zero npm dependencies — only `Bun.build`, `Bun.gzipSync`, `node:fs`, `node:path`, `node:crypto`.
|
|
205
|
+
- Browser target (`target: 'browser'`, `format: 'esm'`).
|
|
206
|
+
- External source maps (`.map`) for preset and pack bundles.
|
|
207
|
+
- `sanity.min.js` is a classic script (no module syntax).
|
|
208
|
+
|
|
209
|
+
## See also
|
|
210
|
+
|
|
211
|
+
- [`standalone.md`](./standalone.md) — self-contained ESM bundle for an individual fw module.
|
|
212
|
+
- [`precompilation.md`](./precompilation.md) — HTML → `ParseResult` JSON precompilation.
|
|
213
|
+
- [`aot.md`](./aot.md) — AOT HTML → imperative JS factory compilation.
|
|
214
|
+
- [`../guide/integration-bundlers.md`](../guide/integration-bundlers.md) — self-contained vs Vite/Webpack.
|
|
215
|
+
- [`../../integrations/vite/README.md`](../../integrations/vite/README.md) — Vite plugin.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# `tools/fw-codegen` (`registry`) — Type registry generator
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Generates **`types/registry.generated.d.ts`**: the `module name → instance type` map that feeds the typed facade `@awacloud/fw/typed` (`asTyped`, `createRuntime`) and allows `resolve('hex')` to return a narrow type rather than `unknown`.
|
|
6
|
+
|
|
7
|
+
Each entry is of the form:
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
'hex': ReturnType<typeof import('../dist/types/io/codec/hex')['hex']['factory']>;
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
— no value import, no named `import type`: the instance type derives directly from the `.d.ts` declaration emitted by `tsc`. The quality of an entry = the quality of the factory's corresponding `@returns` (cf. [`audit.md`](./audit.md)).
|
|
14
|
+
|
|
15
|
+
## CLI usage
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
fw-codegen registry # writes the registry
|
|
19
|
+
fw-codegen registry --check # CI: exit ≠ 0 if the registry is stale
|
|
20
|
+
# or via npm scripts
|
|
21
|
+
bun run types:registry
|
|
22
|
+
bun run types:registry:check
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
| Flag | Description |
|
|
26
|
+
| ------------ | ----------- |
|
|
27
|
+
| `--check` | Does not rewrite; compares and fails if the content differs (CI guard). |
|
|
28
|
+
|
|
29
|
+
> **Order**: run **after** `bun run types` — the registry references declarations emitted in `dist/types/`. Both are chained in `prepack` (`types` → `types:registry` → `prebuild`).
|
|
30
|
+
|
|
31
|
+
## Example
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
[codegen-types] wrote types\registry.generated.d.ts (169 modules).
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Consumption (cf. [TypeScript — Tier 2](../guide/typescript.md)):
|
|
38
|
+
|
|
39
|
+
```ts
|
|
40
|
+
import { createRuntime } from '@awacloud/fw/typed';
|
|
41
|
+
import { hex } from '@awacloud/fw/io/codec/hex.js';
|
|
42
|
+
|
|
43
|
+
const rt = createRuntime([hex]);
|
|
44
|
+
const codec = rt.resolve('hex'); // HexAPI — narrow, without <T>
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## How it works
|
|
48
|
+
|
|
49
|
+
1. `scanAll` (via `tools/fw-bundler/src/modlib/scan-modules.js`) enumerates the modules under `src/`.
|
|
50
|
+
2. For each module (sorted by name), computes the relative path from `types/` to the emitted declaration `dist/types/<path>.d.ts` and emits a `ReturnType<typeof import(...)['<binding>']['factory']>` entry.
|
|
51
|
+
3. Writes `types/registry.generated.d.ts` (or, in `--check` mode, compares against the existing file).
|
|
52
|
+
|
|
53
|
+
The mapping is **stable with respect to internal typedef names**: it depends only on the module path and its exported binding, not on the name of the return `@typedef`. Renaming an internal typedef does not stale the registry; adding / removing / moving a module does.
|
|
54
|
+
|
|
55
|
+
## Narrowing caveat
|
|
56
|
+
|
|
57
|
+
`resolve` is typed against the **full catalogue**, not against the actually registered subset (the `name` field is `string` in the `.d.ts`, not a literal). `createRuntime([hex]).resolve('sha256')` type-checks as `Sha256API` but throws `Module not found` at runtime. Details in [TypeScript — Narrowing caveat](../guide/typescript.md).
|
|
58
|
+
|
|
59
|
+
## See also
|
|
60
|
+
|
|
61
|
+
- [`audit.md`](./audit.md) — verify `@returns` precision before relying on the registry.
|
|
62
|
+
- [TypeScript](../guide/typescript.md) — `asTyped`, `createRuntime`, `InstanceOf`, and the narrowing caveat.
|
|
63
|
+
- [`../../integrations/vite/README.md`](../../integrations/vite/README.md) — the transparent Vite-side variant (`vite-env`).
|
|
64
|
+
- [`../README.md`](../README.md) — general fw doc index.
|
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
---
|
|
2
|
+
tool: jsx
|
|
3
|
+
category: tools/rendering
|
|
4
|
+
status: complete
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# `tools/rendering/jsx/` — JSX → ParseResult precompiler
|
|
8
|
+
|
|
9
|
+
> Compile `.jsx` template files to `ParseResult` JSON at build time, zero runtime overhead.
|
|
10
|
+
|
|
11
|
+
**Tool** `tools/rendering/jsx/` | **Source** `packages/front/fw/tools/rendering/jsx/index.js` | **Worker-safe** N/A (offline build tool)
|
|
12
|
+
|
|
13
|
+
## Purpose
|
|
14
|
+
|
|
15
|
+
The JSX precompiler lowers `.jsx` template files to the same `ParseResult` that
|
|
16
|
+
`parser.fromHTML()` produces at runtime, then emits the result as JSON (and
|
|
17
|
+
optionally as an ESM module). The **runtime is untouched** — JSX is purely an
|
|
18
|
+
input syntax lowered offline, exactly like the AOT and precompilation tools.
|
|
19
|
+
|
|
20
|
+
This is the **blessed path**: JSX for ergonomics, ParseResult for compatibility.
|
|
21
|
+
The existing `render` / `template` / hydration pipeline consumes the output
|
|
22
|
+
unchanged.
|
|
23
|
+
|
|
24
|
+
## CLI usage
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
bun run tools/rendering/jsx/ <input> [options]
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
| Argument / flag | Description |
|
|
31
|
+
| ------------------ | ------------------------------------------------------------------------ |
|
|
32
|
+
| `<input>` | A `.jsx` file OR a directory (walked recursively). |
|
|
33
|
+
| `--out <dir>` | Output directory. Default: next to each input file. |
|
|
34
|
+
| `--ext <ext>` | Output extension. Default: `.parseresult.json`. |
|
|
35
|
+
| `--glob <pat>` | Glob filter for directory walks. Default: `**/*.jsx`. |
|
|
36
|
+
| `--minify` | Emit compact JSON (no indentation). |
|
|
37
|
+
| `--verify` | Re-parse via `template.fromParseResult` and deep-compare. |
|
|
38
|
+
| `--esm` | Also emit a sibling `.js` file: `export default {...}`. |
|
|
39
|
+
| `--help, -h` | Print this help. |
|
|
40
|
+
|
|
41
|
+
Examples:
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
# Compile a single file
|
|
45
|
+
bun run tools/rendering/jsx/ src/components/card.jsx --out dist/tpl --minify
|
|
46
|
+
|
|
47
|
+
# Compile a directory, emit ESM siblings, verify in CI
|
|
48
|
+
bun run tools/rendering/jsx/ src/components --out dist/tpl --esm --verify
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Programmatic API
|
|
52
|
+
|
|
53
|
+
`compileJsx(source, opts?) → ParseResult` is **self-contained**: it
|
|
54
|
+
instantiates its own `secPolicy` + `parser` internally (matching how the CLI
|
|
55
|
+
obtains its parser), so no pre-built parser is required. Pass nothing for the
|
|
56
|
+
common case; the `opts` bag is the same CLI options object (`minify`,
|
|
57
|
+
`verify`, `esm`) and additionally accepts `opts.parser` to reuse an existing
|
|
58
|
+
parser instance.
|
|
59
|
+
|
|
60
|
+
```js
|
|
61
|
+
import { compileJsx, jsxToHTML } from './tools/rendering/jsx/index.js';
|
|
62
|
+
|
|
63
|
+
// Compile JSX source to ParseResult — no parser to build.
|
|
64
|
+
const result = compileJsx('<div id="card">{title}</div>');
|
|
65
|
+
// → { template: [{ id: 'card', tag: 'div', text: '', map: [...] }] }
|
|
66
|
+
|
|
67
|
+
// Reuse a parser instance across many compiles (optional):
|
|
68
|
+
import { parser } from './src/dom/rendering/parser.js';
|
|
69
|
+
import { secPolicy } from './src/dom/rendering/secPolicy.js';
|
|
70
|
+
const p = parser.factory(secPolicy.factory());
|
|
71
|
+
const r2 = compileJsx('<div id="card">{title}</div>', { parser: p });
|
|
72
|
+
|
|
73
|
+
// Low-level: JSX → HTML string (for inspection / testing)
|
|
74
|
+
const html = jsxToHTML('<div id="r" class={cls}></div>');
|
|
75
|
+
// → '<div id="r" class="#{cls}"></div>'
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Mapping rules
|
|
79
|
+
|
|
80
|
+
The table below shows how each JSX construct maps to the framework's
|
|
81
|
+
`#{}` / `${}` HTML template notation and the resulting `ParseResult` shape.
|
|
82
|
+
The output is **byte-for-equivalent** (deep-equal) to what `parser.fromHTML()`
|
|
83
|
+
returns for the corresponding `#{}/${} ` template.
|
|
84
|
+
|
|
85
|
+
| JSX source | HTML equivalent | ParseResult effect |
|
|
86
|
+
|---|---|---|
|
|
87
|
+
| `<div>static text</div>` | `<div>static text</div>` | `elm.text = "static text"` |
|
|
88
|
+
| `<div>{name}</div>` | `<div>#{name}</div>` | `elm.text = "", elm.map = [{name:"name",prop:"text"}]` |
|
|
89
|
+
| `<div class={cls}>` | `<div class="#{cls}">` | `elm.data.class = "", elm.map = [{…data:true}]` |
|
|
90
|
+
| `<div class="a {cls} b">` | `<div class="a #{cls} b">` | `elm.data.class = "a ", elm.map = [{…append:true}]` |
|
|
91
|
+
| `<Slot name="content"/>` | `${content}` | `elm.content = "content"` |
|
|
92
|
+
| `<Each name="items"><li>…</li></Each>` | `<!-- $items --><li>…</li><!-- items$ -->` | `elm.content = "items"`, `result.iterates.items = […]` |
|
|
93
|
+
|
|
94
|
+
### The `{name}`-is-a-binding rule
|
|
95
|
+
|
|
96
|
+
Inside JSX template files `{…}` must contain **only a plain identifier**
|
|
97
|
+
(e.g. `{myVar}`), not an arbitrary JavaScript expression. This constraint is
|
|
98
|
+
what keeps the output compatible with the no-vdom / AOT / hydration pipeline:
|
|
99
|
+
the compiler never needs to evaluate JavaScript; it only needs to record a
|
|
100
|
+
binding name that `render.js` resolves at runtime against the data object.
|
|
101
|
+
|
|
102
|
+
Attempting to write `{a + b}` or `{obj.prop}` will throw at compile time with
|
|
103
|
+
a clear error message.
|
|
104
|
+
|
|
105
|
+
### Slot syntax: `<Slot name="…"/>`
|
|
106
|
+
|
|
107
|
+
A self-closing `<Slot name="content"/>` element lowers to `${content}` in the
|
|
108
|
+
HTML notation, producing `elm.content = "content"` in the `ParseResult`.
|
|
109
|
+
The slot is then filled by `render.toHTML(result, data, { slots: { content: '…' } })`
|
|
110
|
+
or by `template.elm(ctx, elm)` at runtime.
|
|
111
|
+
|
|
112
|
+
### Iteration: `<Each name="…">…</Each>`
|
|
113
|
+
|
|
114
|
+
An `<Each name="items">` block lowers to the `<!-- $items -->…<!-- items$ -->`
|
|
115
|
+
comment-delimiter notation the parser recognises. The elements inside become
|
|
116
|
+
`result.iterates.items`. At runtime, `render.toHTML(result, data, { iterates: { items: rows } })`
|
|
117
|
+
renders each row against the sub-template.
|
|
118
|
+
|
|
119
|
+
## Consumer toolchain (editor support)
|
|
120
|
+
|
|
121
|
+
The precompiler requires no fw-specific build plugin. Standard
|
|
122
|
+
`jsxImportSource` / `jsxFactory` config (esbuild / tsc) is used **for the
|
|
123
|
+
editor and type-checker only** — the compiled output never reaches a browser.
|
|
124
|
+
|
|
125
|
+
### `tsconfig.json` snippet
|
|
126
|
+
|
|
127
|
+
```json
|
|
128
|
+
{
|
|
129
|
+
"compilerOptions": {
|
|
130
|
+
"jsx": "react",
|
|
131
|
+
"jsxFactory": "h",
|
|
132
|
+
"jsxFragmentFactory": "Fragment",
|
|
133
|
+
"jsxImportSource": "@awacloud/fw/tools/rendering/jsx/types"
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### esbuild snippet
|
|
139
|
+
|
|
140
|
+
```js
|
|
141
|
+
esbuild.build({
|
|
142
|
+
jsx: 'transform',
|
|
143
|
+
jsxFactory: 'h',
|
|
144
|
+
jsxFragment: 'Fragment',
|
|
145
|
+
});
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### JSX type stub (`types/jsx.d.ts`)
|
|
149
|
+
|
|
150
|
+
Place a `jsx.d.ts` next to your templates for `<Slot>` / `<Each>` autocomplete:
|
|
151
|
+
|
|
152
|
+
```ts
|
|
153
|
+
// @awacloud/fw JSX intrinsic elements stub
|
|
154
|
+
declare namespace JSX {
|
|
155
|
+
interface IntrinsicElements {
|
|
156
|
+
[tag: string]: Record<string, unknown>;
|
|
157
|
+
Slot: { name: string };
|
|
158
|
+
Each: { name: string; children?: unknown };
|
|
159
|
+
}
|
|
160
|
+
}
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
No fw-specific build plugin is required; the precompiler is invoked as a
|
|
164
|
+
pre-build step, before esbuild / tsc.
|
|
165
|
+
|
|
166
|
+
## Runtime integration
|
|
167
|
+
|
|
168
|
+
```js
|
|
169
|
+
import { template } from '@awacloud/fw/dom/rendering/template.js';
|
|
170
|
+
import { secPolicy } from '@awacloud/fw/dom/rendering/secPolicy.js';
|
|
171
|
+
import precompiled from './card.jsx.parseresult.json' assert { type: 'json' };
|
|
172
|
+
|
|
173
|
+
const tpl = template.factory(secPolicy.factory());
|
|
174
|
+
const pr = tpl.fromParseResult(precompiled);
|
|
175
|
+
// pr has the same shape as parser.fromHTML(html) — pass to cmd.elms, render.toHTML, etc.
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
With `--esm` (portable, no JSON import assertions needed):
|
|
179
|
+
|
|
180
|
+
```js
|
|
181
|
+
import precompiled from './card.jsx.parseresult.js';
|
|
182
|
+
const pr = tpl.fromParseResult(precompiled);
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
## Security policy parity
|
|
186
|
+
|
|
187
|
+
The JSX precompiler enforces the same `secPolicy` rules as `parser.fromHTML()`:
|
|
188
|
+
|
|
189
|
+
- `<script>`, `<object>`, `<embed>`, `<iframe>` tags are silently dropped.
|
|
190
|
+
- `on*` event-handler attributes (e.g. `onclick={handler}`) are silently dropped.
|
|
191
|
+
- URL-bearing attributes (`href`, `src`, …) carrying `javascript:` / `vbscript:`
|
|
192
|
+
values are stored as-is at parse time and rejected by `render.js` / `template.js`
|
|
193
|
+
at render time — identical behaviour to the HTML parse path.
|
|
194
|
+
|
|
195
|
+
## Tests
|
|
196
|
+
|
|
197
|
+
```sh
|
|
198
|
+
bun test packages/front/fw/tools/rendering/jsx/
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
Covers: all mapping rules (deep-equal to `parser.fromHTML()`), secPolicy
|
|
202
|
+
parity, `--verify` round-trip, fixtures, `--esm`, directory walk, error cases,
|
|
203
|
+
and SSR `render.toHTML()` integration.
|
|
204
|
+
|
|
205
|
+
## Non-goals
|
|
206
|
+
|
|
207
|
+
### Runtime `parser.fromJSX()` — not shipped
|
|
208
|
+
|
|
209
|
+
Rationale: a runtime JSX parser would require shipping a JSX tokenizer to the
|
|
210
|
+
browser, breaking the zero-runtime-deps constraint. The precompiler produces
|
|
211
|
+
the same `ParseResult` offline; use `template.fromParseResult()` to load it.
|
|
212
|
+
Substitute: run `bun run tools/rendering/jsx/` as a pre-build step.
|
|
213
|
+
|
|
214
|
+
### Arbitrary `{expr}` expressions — not supported
|
|
215
|
+
|
|
216
|
+
Rationale: arbitrary JS expressions (`{a + b}`, `{obj.prop}`) would require
|
|
217
|
+
a full JS evaluator at compile time and a corresponding vdom at runtime,
|
|
218
|
+
undermining the no-vdom / AOT / hydration invariants. Only plain identifier
|
|
219
|
+
bindings (`{myVar}`) are accepted — they map directly to the `#{}` template
|
|
220
|
+
notation. Substitute: compute derived values in your data layer before passing
|
|
221
|
+
to `render` / `template`.
|
|
222
|
+
|
|
223
|
+
### Virtual DOM — not included
|
|
224
|
+
|
|
225
|
+
Rationale: the framework's rendering model is `ParseResult` → flat elm-array →
|
|
226
|
+
`render.js` data-binding → `template.js` DOM patching. A vdom layer would
|
|
227
|
+
duplicate this mechanism and introduce reconciliation overhead. The JSX
|
|
228
|
+
precompiler is a one-way lowering, not a vdom implementation. Substitute: use
|
|
229
|
+
the existing `render` + `template` + `uiSession` modules for reactive updates.
|
|
230
|
+
|
|
231
|
+
## See also
|
|
232
|
+
|
|
233
|
+
- [`aot.md`](./aot.md) — compiles templates to imperative factory JS for maximum startup performance.
|
|
234
|
+
- [`precompilation.md`](./precompilation.md) — compiles `.html` templates (with `#{}/${} ` notation) to `ParseResult` JSON.
|
|
235
|
+
- [`../api/dom/rendering/parser.md`](../api/dom/rendering/parser.md) — `ParseResult` shape and `parser.fromHTML()` reference.
|
|
236
|
+
- [`../api/dom/rendering/render.md`](../api/dom/rendering/render.md) — `render.toHTML()` SSR and `render.elms()` binding reference.
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# `tools/rendering/precompilation/` — `ParseResult` precompilation
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Walks one or more `.html` template files, runs them through `parser.fromHTML()` at build time, and emits the resulting `ParseResult` as JSON. The runtime can then load the precompiled artefact directly and pass it to `template.fromParseResult(json)`, saving the per-template parsing cost at first paint.
|
|
6
|
+
|
|
7
|
+
## CLI usage
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
bun tools/rendering/precompilation/ <input> [options]
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
| Argument / flag | Description |
|
|
14
|
+
| ------------------ | ------------------------------------------------------------------ |
|
|
15
|
+
| `<input>` | A `.html` file OR a directory (recursive walk). |
|
|
16
|
+
| `--out <dir>` | Output directory. Default: alongside each input file. |
|
|
17
|
+
| `--ext <ext>` | Output extension. Default `.parseresult.json`. |
|
|
18
|
+
| `--glob <pattern>` | Glob filter when `<input>` is a directory. Default `**/*.html`. |
|
|
19
|
+
| `--minify` | Strips whitespace from the emitted JSON. |
|
|
20
|
+
| `--verify` | Re-instantiates via `template.fromParseResult` and deep-compares. |
|
|
21
|
+
| `--esm` | Also emits a sibling `.js` file: `export default {...}`. |
|
|
22
|
+
|
|
23
|
+
Via the npm script:
|
|
24
|
+
|
|
25
|
+
```sh
|
|
26
|
+
bun run build:parseresult my-templates/ --out dist/parseresult --minify --esm
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Example
|
|
30
|
+
|
|
31
|
+
Input — `nav.html`:
|
|
32
|
+
|
|
33
|
+
```html
|
|
34
|
+
<nav class="main"><h1>#{title}</h1></nav>
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
Output — `nav.html.parseresult.json`:
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{"template":[...],"iterates":{...}}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
With `--esm`, sibling `nav.html.parseresult.js`:
|
|
44
|
+
|
|
45
|
+
```js
|
|
46
|
+
// auto-generated by tools/rendering/precompilation/ — do not edit
|
|
47
|
+
export default {"template":[...],"iterates":{...}};
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Runtime integration
|
|
51
|
+
|
|
52
|
+
```js
|
|
53
|
+
import { template } from '@awacloud/fw/dom/rendering/template.js';
|
|
54
|
+
import precompiled from './nav.html.parseresult.json' assert { type: 'json' };
|
|
55
|
+
|
|
56
|
+
const tpl = template.factory(secPolicy.factory());
|
|
57
|
+
const pr = tpl.fromParseResult(precompiled);
|
|
58
|
+
// pr has the same shape as parser.fromHTML(html) — pass to cmd.elms, etc.
|
|
59
|
+
tpl.elms('main', pr.template);
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Browser support for JSON import assertions varies. The portable alternative is `--esm`, which emits a sibling `.js`:
|
|
63
|
+
|
|
64
|
+
```js
|
|
65
|
+
import precompiled from './nav.html.parseresult.js';
|
|
66
|
+
const pr = tpl.fromParseResult(precompiled);
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## Notes / limitations
|
|
70
|
+
|
|
71
|
+
- The tool fails fast with a clear diagnostic if `parser.fromHTML()` produces a value that is not JSON-serialisable (functions, class instances, DOM nodes, Maps, Sets). To date, all output is pure data.
|
|
72
|
+
- `--verify` is recommended in CI: it confirms that the JSON written to disk is structurally identical to a fresh parse of the HTML source.
|
|
73
|
+
- No runtime `default` value on `map` entries (always empty fallback) — for that need, use `template.fromParseResult` with runtime data.
|
|
74
|
+
|
|
75
|
+
## Tests
|
|
76
|
+
|
|
77
|
+
```sh
|
|
78
|
+
bun test tools/rendering/precompilation/index.test.js
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Covers parsing, CLI options, directory walk, `--minify`, `--verify`, `--esm`, and errors.
|
|
82
|
+
|
|
83
|
+
## See also
|
|
84
|
+
|
|
85
|
+
- [`aot.md`](./aot.md) — for maximum performance, compiles to an imperative JS factory (loses runtime flexibility).
|
|
86
|
+
- [`standalone.md`](./standalone.md) — self-contained ESM bundle for a single fw module.
|
|
87
|
+
- [`bundler.md`](./bundler.md) — main prebuild orchestrator.
|
|
88
|
+
- [`../README.md`](../README.md) — general fw doc index.
|