@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,84 @@
|
|
|
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.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Official Rollup plugin for `@awacloud/fw` (consumer / role 1).
|
|
8
|
+
*
|
|
9
|
+
* Exposes the same virtual modules as the Vite plugin :
|
|
10
|
+
* - `virtual:@awacloud/fw/preset/<name>` — pre-instantiated runtime for a preset.
|
|
11
|
+
* - `virtual:@awacloud/fw/side-bundle/<name>` — `install(runtime)` helper for a side-bundle.
|
|
12
|
+
*
|
|
13
|
+
* The Vite plugin IS a Rollup plugin under the hood, so this adapter is the
|
|
14
|
+
* same `resolveId` / `load` / `transform` shape, minus Vite-specific niceties
|
|
15
|
+
* (`enforce`). Both delegate to the shared `_shared/core.js`, so the emitted
|
|
16
|
+
* code — direct subpath imports + `registerAllDeep` — is identical.
|
|
17
|
+
*
|
|
18
|
+
* Usage :
|
|
19
|
+
*
|
|
20
|
+
* import fwRollup from '@awacloud/fw/rollup';
|
|
21
|
+
* export default {
|
|
22
|
+
* input: 'src/app.js',
|
|
23
|
+
* output: { dir: 'dist', format: 'es' },
|
|
24
|
+
* plugins: [fwRollup({ preset: 'site-interactive', sanity: 'base' })],
|
|
25
|
+
* };
|
|
26
|
+
*
|
|
27
|
+
* // src/app.js
|
|
28
|
+
* import { runtime } from 'virtual:@awacloud/fw/preset/site-interactive';
|
|
29
|
+
*
|
|
30
|
+
* NOTE — consumer plugin. Using Rollup as a Node build *backend* (role 2,
|
|
31
|
+
* `@rollup/plugin-terser` for lib output) is a separate concern : see
|
|
32
|
+
* `./README.md` and `../nodejs/README.md`.
|
|
33
|
+
*
|
|
34
|
+
* @see ../_shared/core.js
|
|
35
|
+
* @see ../vite/index.js reference adapter (same behaviour)
|
|
36
|
+
*/
|
|
37
|
+
|
|
38
|
+
import { createFwCore } from '../_shared/core.js';
|
|
39
|
+
|
|
40
|
+
// Rollup convention : a leading NUL marks a module id as virtual so no other
|
|
41
|
+
// plugin or the default resolver tries to hit the filesystem for it.
|
|
42
|
+
const RESOLVED_PREFIX = '\0';
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* @typedef {Object} FwRollupOptions
|
|
46
|
+
* @property {string} [preset='site'] Default preset for the bare `virtual:@awacloud/fw/preset` specifier.
|
|
47
|
+
* @property {string[]} [sideBundles=[]] Side-bundles validated up-front.
|
|
48
|
+
* @property {('base'|'community'|'lockdown'|false)} [sanity=false] Prepend the sanity layer to every entry chunk.
|
|
49
|
+
* @property {string} [packageName='@awacloud/fw'] Package specifier used in the emitted imports.
|
|
50
|
+
* @property {string} [configPath] Override `fw.config.json` path.
|
|
51
|
+
*/
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* @param {FwRollupOptions} [options]
|
|
55
|
+
* @returns {import('rollup').Plugin}
|
|
56
|
+
*/
|
|
57
|
+
export default function fwRollup(options = {}) {
|
|
58
|
+
const sanity = options.sanity || false;
|
|
59
|
+
// Shared core : config load + source-tree scan + virtual matcher/emitter.
|
|
60
|
+
const core = createFwCore(options);
|
|
61
|
+
|
|
62
|
+
return {
|
|
63
|
+
name: '@awacloud/fw',
|
|
64
|
+
|
|
65
|
+
resolveId(id) {
|
|
66
|
+
return core.isVirtualId(id) ? RESOLVED_PREFIX + id : null;
|
|
67
|
+
},
|
|
68
|
+
|
|
69
|
+
load(id) {
|
|
70
|
+
if (!id.startsWith(RESOLVED_PREFIX)) return null;
|
|
71
|
+
return core.emit(id.slice(RESOLVED_PREFIX.length));
|
|
72
|
+
},
|
|
73
|
+
|
|
74
|
+
transform(code, id) {
|
|
75
|
+
if (!sanity) return null;
|
|
76
|
+
const info = this.getModuleInfo && this.getModuleInfo(id);
|
|
77
|
+
if (info && info.isEntry) {
|
|
78
|
+
// Extension-less `./sanity/base` / `./sanity/community` subpaths.
|
|
79
|
+
return { code: core.sanityImportLine(sanity) + code, map: null };
|
|
80
|
+
}
|
|
81
|
+
return null;
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# `@awacloud/fw/turbopack`
|
|
2
|
+
|
|
3
|
+
`fwTurbopack()` — Turbopack has no plugin API, so this adapter materializes fw's virtual modules to real files and returns a `turbopack.resolveAlias` map.
|
|
4
|
+
|
|
5
|
+
## Usage
|
|
6
|
+
|
|
7
|
+
Via the Next.js integration (`withFw` wires this adapter in automatically for `next dev --turbopack` / Next ≥16 default — nothing to do on your side):
|
|
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
|
+
Direct usage (any Turbopack-based tool accepting a resolve-alias map):
|
|
20
|
+
|
|
21
|
+
```js
|
|
22
|
+
import { fwTurbopack } from '@awacloud/fw/turbopack';
|
|
23
|
+
const { resolveAlias } = fwTurbopack({ preset: 'site-interactive' });
|
|
24
|
+
// → { 'virtual:@awacloud/fw/preset': './.fw-virtual/preset-default.js', … }
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Options
|
|
28
|
+
|
|
29
|
+
| Option | Type | Default | Role |
|
|
30
|
+
|---|---|---|---|
|
|
31
|
+
| `preset` | `string` | `'site'` | Default preset for the bare `virtual:@awacloud/fw/preset` specifier. |
|
|
32
|
+
| `sideBundles` | `string[]` | `[]` | Side-bundles validated up-front. |
|
|
33
|
+
| `packageName` | `string` | `'@awacloud/fw'` | Package specifier used in the emitted imports. |
|
|
34
|
+
| `configPath` | `string` | bundled | Override `fw.config.json` path. |
|
|
35
|
+
| `outDir` | `string` | `'.fw-virtual'` | Directory (relative to cwd) receiving the materialized modules. |
|
|
36
|
+
|
|
37
|
+
## Notes
|
|
38
|
+
|
|
39
|
+
- **The one adapter here that is not side-effect-free at construction.**
|
|
40
|
+
Reading any property of the returned `resolveAlias` (access, `Object.keys`,
|
|
41
|
+
a `{ ...spread }`) — or calling the returned `materialize()` explicitly —
|
|
42
|
+
lazily runs `rmSync` + `mkdirSync` + `writeFileSync` into `cwd/.fw-virtual`
|
|
43
|
+
by default. Merely calling `fwTurbopack(...)` never touches disk. Import/
|
|
44
|
+
construction gates (tests, config inspection) must pass an absolute
|
|
45
|
+
temporary `outDir` to avoid writing into the repo. See
|
|
46
|
+
[Bundler integration § Side-effecting modules](../../docs/guide/integration-bundlers.md#side-effecting-modules).
|
|
47
|
+
- **Consumed by the Next.js adapter** for `next dev --turbopack` / Next ≥16
|
|
48
|
+
(Turbopack default) — see [`../nextjs/README.md`](../nextjs/README.md).
|
|
49
|
+
- Same shared core as every adapter: `../_shared/core.js` emits code against
|
|
50
|
+
the committed catalog (`_shared/catalog.generated.json`), so the generated
|
|
51
|
+
modules are identical to those produced by the other bundler integrations.
|
|
52
|
+
|
|
53
|
+
## See also
|
|
54
|
+
|
|
55
|
+
- [Integrations overview](../README.md)
|
|
56
|
+
- [Next.js integration](../nextjs/README.md)
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/turbopack/index.d.ts
|
|
6
|
+
// Types for the `@awacloud/fw` Turbopack adapter. Dependency-free (same
|
|
7
|
+
// convention as the other adapters).
|
|
8
|
+
|
|
9
|
+
export interface FwTurbopackOptions {
|
|
10
|
+
/** Default preset for the bare `virtual:@awacloud/fw/preset` specifier. Default: `'site'`. */
|
|
11
|
+
preset?: string;
|
|
12
|
+
/** Side-bundles validated up-front (fail fast on misconfiguration). */
|
|
13
|
+
sideBundles?: string[];
|
|
14
|
+
/** Package specifier used in the emitted imports. Default: `'@awacloud/fw'`. */
|
|
15
|
+
packageName?: string;
|
|
16
|
+
/** Override `fw.config.json` path. */
|
|
17
|
+
configPath?: string;
|
|
18
|
+
/** Directory (relative to cwd) receiving the materialized modules. Default: `'.fw-virtual'`. */
|
|
19
|
+
outDir?: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface FwTurbopackResult {
|
|
23
|
+
/**
|
|
24
|
+
* `virtual:@awacloud/fw/*` specifier → generated-file path (project-root
|
|
25
|
+
* relative). Reading any property of this object (access, `Object.keys`,
|
|
26
|
+
* a `{ ...spread }`) lazily triggers materialization — see `materialize`.
|
|
27
|
+
*/
|
|
28
|
+
resolveAlias: Record<string, string>;
|
|
29
|
+
/** Absolute path of the generated directory (not created until materialization runs). */
|
|
30
|
+
outDir: string;
|
|
31
|
+
/**
|
|
32
|
+
* Rewrite `outDir` from scratch and write every planned module to disk.
|
|
33
|
+
* Idempotent (a second call is a no-op). Called automatically the first
|
|
34
|
+
* time `resolveAlias` is read; exposed so a caller can trigger it
|
|
35
|
+
* explicitly instead.
|
|
36
|
+
*/
|
|
37
|
+
materialize(): void;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* Build the Turbopack alias map for the configured virtual modules. Reads
|
|
42
|
+
* `fw.config.json` + the catalog and computes the map ENTIRELY IN MEMORY —
|
|
43
|
+
* this alone never touches disk. The directory rm+mkdir+write is deferred to
|
|
44
|
+
* `materialize()`, run lazily on first read of `resolveAlias`.
|
|
45
|
+
*/
|
|
46
|
+
export function fwTurbopack(options?: FwTurbopackOptions): FwTurbopackResult;
|
|
47
|
+
export default fwTurbopack;
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/turbopack/index.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview Official Turbopack support for `@awacloud/fw`.
|
|
8
|
+
*
|
|
9
|
+
* Turbopack has no JS plugin API (it does not read Webpack plugins), but the
|
|
10
|
+
* `virtual:@awacloud/fw/*` specifier set is fully **enumerable** from
|
|
11
|
+
* `fw.config.json` (presets + side-bundles). So instead of hooking a
|
|
12
|
+
* resolver, this adapter MATERIALIZES each virtual module into a real file
|
|
13
|
+
* (generated at config-evaluation time) and returns a `resolveAlias` map
|
|
14
|
+
* pointing every virtual specifier at its generated file. The emitted code is
|
|
15
|
+
* the same `_shared/core.js` output as every other adapter — direct subpath
|
|
16
|
+
* imports + `registerAllDeep` — so tree-shaking behaves identically.
|
|
17
|
+
*
|
|
18
|
+
* Consumed by the Next.js integration (`withFw` wires the map into
|
|
19
|
+
* `nextConfig.turbopack.resolveAlias`), and usable directly by any
|
|
20
|
+
* Turbopack-based tool that accepts a resolve-alias map.
|
|
21
|
+
*
|
|
22
|
+
* Usage (direct) :
|
|
23
|
+
*
|
|
24
|
+
* import { fwTurbopack } from '@awacloud/fw/turbopack';
|
|
25
|
+
* const { resolveAlias } = fwTurbopack({ preset: 'site-interactive' });
|
|
26
|
+
* // → { 'virtual:@awacloud/fw/preset': './.fw-virtual/preset-default.js', … }
|
|
27
|
+
*
|
|
28
|
+
* Notes :
|
|
29
|
+
* - The generated directory (default `.fw-virtual/`) is build output —
|
|
30
|
+
* gitignore it. It is fully rewritten, but LAZILY (BL-299) : merely
|
|
31
|
+
* calling `fwTurbopack(...)` only reads `fw.config.json` + the catalog
|
|
32
|
+
* and computes the alias map in memory — it never touches disk. The
|
|
33
|
+
* rm+mkdir+write only happens the FIRST time the returned `resolveAlias`
|
|
34
|
+
* is actually read (property access, `Object.keys`, a `{ ...spread }` —
|
|
35
|
+
* every consumer here, including `../nextjs/index.js`, reads it that way
|
|
36
|
+
* already) or the returned `materialize()` is called explicitly. Either
|
|
37
|
+
* trigger is idempotent : the directory is rewritten from scratch once,
|
|
38
|
+
* on first use, not once per read.
|
|
39
|
+
* - Sanity is NOT handled here (same stance as the Next integration) :
|
|
40
|
+
* place it client-side. See ../nextjs/index.js header.
|
|
41
|
+
*
|
|
42
|
+
* @see ../_shared/core.js
|
|
43
|
+
* @see ../nextjs/index.js wires this into Next ≥ 16 (Turbopack default)
|
|
44
|
+
*/
|
|
45
|
+
|
|
46
|
+
import { mkdirSync, writeFileSync, rmSync } from 'node:fs';
|
|
47
|
+
import { resolve, join } from 'node:path';
|
|
48
|
+
|
|
49
|
+
import {
|
|
50
|
+
createFwCore,
|
|
51
|
+
VIRTUAL_PRESET_PREFIX,
|
|
52
|
+
VIRTUAL_SIDE_PREFIX,
|
|
53
|
+
} from '../_shared/core.js';
|
|
54
|
+
|
|
55
|
+
const HEADER =
|
|
56
|
+
'// GENERATED by @awacloud/fw/turbopack — do not edit (rewritten on every build).\n';
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* @typedef {Object} FwTurbopackOptions
|
|
60
|
+
* @property {string} [preset='site'] Default preset for the bare `virtual:@awacloud/fw/preset` specifier.
|
|
61
|
+
* @property {string[]} [sideBundles=[]] Side-bundles validated up-front.
|
|
62
|
+
* @property {string} [packageName='@awacloud/fw'] Package specifier used in the emitted imports.
|
|
63
|
+
* @property {string} [configPath] Override `fw.config.json` path.
|
|
64
|
+
* @property {string} [outDir='.fw-virtual'] Directory (relative to cwd) receiving the materialized modules.
|
|
65
|
+
*/
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* @typedef {Object} FwTurbopackResult
|
|
69
|
+
* @property {Record<string, string>} resolveAlias `virtual:@awacloud/fw/*` specifier → generated-file path. Reading ANY property of this object (access, `Object.keys`, a `{...}` spread) lazily triggers materialization — see `materialize()`.
|
|
70
|
+
* @property {string} outDir Absolute path of the generated directory (not yet created until materialization runs).
|
|
71
|
+
* @property {() => void} materialize Rewrite `outDir` from scratch and write every planned module to disk. Idempotent (a second call is a no-op). Called automatically the first time `resolveAlias` is read; exposed so a caller can trigger it explicitly instead.
|
|
72
|
+
*/
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Build the Turbopack alias map for the configured virtual modules. Reads
|
|
76
|
+
* `fw.config.json` + the catalog and computes the map ENTIRELY IN MEMORY —
|
|
77
|
+
* this alone never touches disk (BL-299). The directory rm+mkdir+write is
|
|
78
|
+
* deferred to `materialize()`, run lazily on first read of `resolveAlias`
|
|
79
|
+
* (see the `FwTurbopackResult` typedef) so merely constructing the config
|
|
80
|
+
* for inspection can never destroy a pre-existing `outDir`.
|
|
81
|
+
*
|
|
82
|
+
* @param {FwTurbopackOptions} [options]
|
|
83
|
+
* @returns {FwTurbopackResult}
|
|
84
|
+
*/
|
|
85
|
+
export function fwTurbopack(options = {}) {
|
|
86
|
+
const core = createFwCore(options);
|
|
87
|
+
const outDirRel = options.outDir || '.fw-virtual';
|
|
88
|
+
const outDirAbs = resolve(process.cwd(), outDirRel);
|
|
89
|
+
|
|
90
|
+
// Plan every virtual module → generated-file mapping up front. This is
|
|
91
|
+
// PURE : `core.emit` only reads the config/catalog already loaded by
|
|
92
|
+
// `createFwCore` and returns a string — it does not touch disk. Only the
|
|
93
|
+
// `writeFileSync` (and the directory rm+mkdir) below writes anything, and
|
|
94
|
+
// that part is deferred to `materialize()`.
|
|
95
|
+
/** @type {Array<{ file: string, contents: string }>} */
|
|
96
|
+
const plan = [];
|
|
97
|
+
/** @type {Record<string, string>} */
|
|
98
|
+
const target = {};
|
|
99
|
+
/** @param {string} id @param {string} fileBase */
|
|
100
|
+
const planEntry = (id, fileBase) => {
|
|
101
|
+
const contents = core.emit(id);
|
|
102
|
+
if (contents == null) return;
|
|
103
|
+
const file = `${fileBase}.js`;
|
|
104
|
+
plan.push({ file, contents });
|
|
105
|
+
target[id] = `./${outDirRel.replace(/\\/g, '/')}/${file}`;
|
|
106
|
+
};
|
|
107
|
+
|
|
108
|
+
// Bare specifier → the configured default preset.
|
|
109
|
+
planEntry(VIRTUAL_PRESET_PREFIX, 'preset-default');
|
|
110
|
+
for (const name of Object.keys(core.config.presets || {})) {
|
|
111
|
+
planEntry(`${VIRTUAL_PRESET_PREFIX}/${name}`, `preset-${name}`);
|
|
112
|
+
}
|
|
113
|
+
const sideBundles = new Set([
|
|
114
|
+
...Object.keys(core.config.sideBundles || {}),
|
|
115
|
+
...(Array.isArray(options.sideBundles) ? options.sideBundles : []),
|
|
116
|
+
]);
|
|
117
|
+
for (const name of sideBundles) {
|
|
118
|
+
planEntry(`${VIRTUAL_SIDE_PREFIX}/${name}`, `side-bundle-${name}`);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
let materialized = false;
|
|
122
|
+
/**
|
|
123
|
+
* Rewrite `outDirAbs` from scratch and write every planned module — the
|
|
124
|
+
* ONLY place this adapter touches disk. Idempotent: a second call is a
|
|
125
|
+
* no-op, so it is safe to invoke both automatically (via `resolveAlias`
|
|
126
|
+
* access) and explicitly.
|
|
127
|
+
*/
|
|
128
|
+
function materialize() {
|
|
129
|
+
if (materialized) return;
|
|
130
|
+
materialized = true;
|
|
131
|
+
// Dedicated, fully-owned directory: rewrite from scratch on first use
|
|
132
|
+
// so renamed presets never leave stale files behind.
|
|
133
|
+
rmSync(outDirAbs, { recursive: true, force: true });
|
|
134
|
+
mkdirSync(outDirAbs, { recursive: true });
|
|
135
|
+
for (const { file, contents } of plan) {
|
|
136
|
+
writeFileSync(join(outDirAbs, file), HEADER + contents);
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// `resolveAlias` looks like — and for every existing consumer here
|
|
141
|
+
// BEHAVES exactly like — a plain object, but reading any of its
|
|
142
|
+
// properties (direct access, `Object.keys`, a `{ ...resolveAlias }`
|
|
143
|
+
// spread, all of which the `nextjs` adapter already does) lazily runs
|
|
144
|
+
// `materialize()` first. Mere construction of `fwTurbopack(...)` never
|
|
145
|
+
// triggers a get/ownKeys trap, so it stays disk-free.
|
|
146
|
+
const resolveAlias = new Proxy(target, {
|
|
147
|
+
get(obj, prop, receiver) {
|
|
148
|
+
materialize();
|
|
149
|
+
return Reflect.get(obj, prop, receiver);
|
|
150
|
+
},
|
|
151
|
+
ownKeys(obj) {
|
|
152
|
+
materialize();
|
|
153
|
+
return Reflect.ownKeys(obj);
|
|
154
|
+
},
|
|
155
|
+
getOwnPropertyDescriptor(obj, prop) {
|
|
156
|
+
materialize();
|
|
157
|
+
return Reflect.getOwnPropertyDescriptor(obj, prop);
|
|
158
|
+
},
|
|
159
|
+
});
|
|
160
|
+
|
|
161
|
+
return { resolveAlias, outDir: outDirAbs, materialize };
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
export default fwTurbopack;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# `@awacloud/fw` — TypeDoc
|
|
2
|
+
|
|
3
|
+
**Optional** generation of an HTML API reference from the framework types, as a complement to (not a replacement for) the hand-written docs at [`docs/api/`](../../docs/api/).
|
|
4
|
+
|
|
5
|
+
## Source: `dist/types/**` (strategy 1)
|
|
6
|
+
|
|
7
|
+
TypeDoc consumes the declarations already emitted by `bun run types` (JSDoc → tsc), so the generated docs reflect **exactly** the typed surface seen by TS consumers. No re-parsing of JSDoc.
|
|
8
|
+
|
|
9
|
+
## Output: `docs/api-generated/` (separate, generated)
|
|
10
|
+
|
|
11
|
+
The HTML docs are written to **`docs/api-generated/`** — a **distinct** subfolder from `docs/api/` (editorial) to avoid confusion. This folder is:
|
|
12
|
+
|
|
13
|
+
- **generated on demand**, never committed (`.gitignore`);
|
|
14
|
+
- **outside the npm tarball** (`package.json#files` → `!docs/api-generated/**`).
|
|
15
|
+
|
|
16
|
+
## Usage
|
|
17
|
+
|
|
18
|
+
```sh
|
|
19
|
+
bun run setup:typedoc # installs typedoc on demand (not persisted)
|
|
20
|
+
bun run docs:api # bun run types → typedoc --options integrations/typedoc/typedoc.json
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Then open `docs/api-generated/index.html`. To publish (GitHub Pages, etc.), point CI at this folder.
|
|
24
|
+
|
|
25
|
+
## `docs:api` pipeline
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
rm -rf dist/types # purge the outDir (tsc does not delete stale .d.ts files)
|
|
29
|
+
→ bun run types # regenerate dist/types
|
|
30
|
+
→ categorize.js # injects @module + @category (index grouping)
|
|
31
|
+
→ typedoc # generates docs/api-generated/
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
### Index categorization — [`categorize.js`](./categorize.js)
|
|
35
|
+
Without annotation, TypeDoc groups **all** modules under "Other" (it only groups by `@category`). The script derives the category from the **`type`** field of each module (`fw.io.codec` → `io/codec`, fallback: directory), and prepends a `/** @module <path> @category <cat> */` comment in the `dist/types` `.d.ts` files (never `src/`). Result: index grouped by taxonomy (`crypto/hash`, `dom/query`, `io/codec`…), aligned with the source of truth. Idempotent (already-tagged files, e.g. `notifications`, are respected). Only captures `type: 'fw.…'` — not nested `type:` values (`'audio'`, MIME…).
|
|
36
|
+
|
|
37
|
+
> **Purge `dist/types`**: `docs:api` runs `rm -rf dist/types` before `tsc` (which does not delete stale `.d.ts` files) — otherwise old files (vectors `*.kat.d.ts`, build remnants) pollute the index under "Other". The `types` script itself **does not purge** (intentionally manual); for a clean **publication** (the lean tarball ships `dist/types/**`), run `rm -rf dist/types && bun run types` beforehand.
|
|
38
|
+
|
|
39
|
+
## Configuration
|
|
40
|
+
|
|
41
|
+
- [`typedoc.json`](./typedoc.json) — `entryPoints: dist/types` (`entryPointStrategy: "expand"` → one documented module per file), `out: ../../docs/api-generated`, `excludeInternal/Private`. Excludes `*.test.d.ts`, `*.kat.d.ts`, `registry.generated.d.ts`, `typed.d.ts`.
|
|
42
|
+
- [`tsconfig.typedoc.json`](./tsconfig.typedoc.json) — minimal `compilerOptions` (no `include`, to avoid inheriting the `src/**/*.js` from `tsconfig.types.json`).
|
|
43
|
+
|
|
44
|
+
## Known limitation — double module/namespace page
|
|
45
|
+
|
|
46
|
+
Each fw module (`export const x = {…}`) is emitted by `tsc` as `export namespace x`. TypeDoc therefore generates **two pages**: the *module* page (the file, e.g. `io/codec/cbor`) and the *namespace* page (`cbor`, which carries the `name/version/deps/factory` descriptor). **No TypeDoc option merges** a module with its internal namespace (verified: no `inline`/`merge`/`flatten`). Mitigation: the `@module` is named by **path** (`io/codec/cbor`), distinct from the namespace (`cbor`), to remove the "cbor → cbor" confusion. A single page per module would require *unpacking* the namespace in the `.d.ts` files — fragile and tied to the descriptor-vs-useful-API (`CborAPI`) distinction, out of scope here.
|
|
47
|
+
|
|
48
|
+
## Relationship with `docs/api/`
|
|
49
|
+
|
|
50
|
+
- `docs/api/*.md` (hand-written, usage-oriented + Worker Usage + Notes) remains **canonical and editorial**.
|
|
51
|
+
- TypeDoc = **exhaustive generated reference** (complete signatures), useful for completeness/navigation.
|
|
52
|
+
|
|
53
|
+
## Notes
|
|
54
|
+
|
|
55
|
+
- `typedoc` is installed **on demand** (not a committed dependency) — like the other integration tools.
|
|
56
|
+
- Prerequisite: `dist/types` must exist → `docs:api` chains `bun run types` first.
|
|
57
|
+
- Quality reflects the actual state of `@returns` (see [`docs/tools/audit.md`](../../docs/tools/audit.md)): until they are all tightened, some entries will be broad — a useful completeness signal.
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
// packages/front/fw/integrations/typedoc/categorize.js
|
|
6
|
+
/**
|
|
7
|
+
* @fileoverview TypeDoc pre-processing — inject `@category` into the generated
|
|
8
|
+
* `dist/types/**.d.ts` so TypeDoc's index groups modules by the framework
|
|
9
|
+
* taxonomy instead of dumping everything under "Other".
|
|
10
|
+
*
|
|
11
|
+
* Why : TypeDoc groups top-level modules by their `@category`/`@group` JSDoc
|
|
12
|
+
* tag. The fw sources carry the taxonomy in each module's `type` field
|
|
13
|
+
* (`type: 'fw.io.codec'`) but NOT as a file-level `@category` tag, so without
|
|
14
|
+
* this step only the single hand-tagged module (`notifications`) gets a group.
|
|
15
|
+
*
|
|
16
|
+
* What : for every emitted `.d.ts`, derive the category from the matching
|
|
17
|
+
* source module's `type` (`fw.io.codec` → `io/codec`), falling back to the
|
|
18
|
+
* file's directory, and prepend a file-level `/** @category … */` block.
|
|
19
|
+
* Runs in `docs:api` AFTER `bun run types` (fresh, untagged `.d.ts`) and BEFORE
|
|
20
|
+
* `typedoc`. Idempotent : files that already declare `@category`/`@module`
|
|
21
|
+
* (e.g. `notifications`) are left untouched.
|
|
22
|
+
*
|
|
23
|
+
* Operates ONLY on the generated `dist/types/` tree — never edits `src/`.
|
|
24
|
+
* Pure `node:*` APIs → runs under bun or Node.
|
|
25
|
+
*
|
|
26
|
+
* @see ./typedoc.json
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
import { readdirSync, statSync, readFileSync, writeFileSync } from 'node:fs';
|
|
30
|
+
import { resolve, dirname, relative, join } from 'node:path';
|
|
31
|
+
import { fileURLToPath } from 'node:url';
|
|
32
|
+
|
|
33
|
+
const HERE = dirname(fileURLToPath(import.meta.url));
|
|
34
|
+
const PKG_ROOT = resolve(HERE, '..', '..');
|
|
35
|
+
const TYPES_DIR = resolve(PKG_ROOT, 'dist', 'types');
|
|
36
|
+
const SRC_DIR = resolve(PKG_ROOT, 'src');
|
|
37
|
+
|
|
38
|
+
/** Recursively list `*.d.ts` under `dir` (skipping `.test.d.ts`). */
|
|
39
|
+
function listDts(dir) {
|
|
40
|
+
/** @type {string[]} */
|
|
41
|
+
const out = [];
|
|
42
|
+
for (const ent of readdirSync(dir)) {
|
|
43
|
+
const p = join(dir, ent);
|
|
44
|
+
if (statSync(p).isDirectory()) out.push(...listDts(p));
|
|
45
|
+
else if (ent.endsWith('.d.ts') && !ent.endsWith('.test.d.ts') && !ent.endsWith('.kat.d.ts')) out.push(p);
|
|
46
|
+
}
|
|
47
|
+
return out;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Derive a TypeDoc category from the module's `type` field, else from the
|
|
52
|
+
* file's directory under `dist/types/`.
|
|
53
|
+
* @param {string} relPath POSIX path of the `.d.ts` relative to `dist/types`.
|
|
54
|
+
* @param {(string|null)} srcType Value of the source module's `type` field.
|
|
55
|
+
* @returns {string}
|
|
56
|
+
*/
|
|
57
|
+
function categoryFor(relPath, srcType) {
|
|
58
|
+
if (srcType) {
|
|
59
|
+
const c = srcType.replace(/^fw\./, '').replace(/\./g, '/').trim();
|
|
60
|
+
if (c) return c;
|
|
61
|
+
}
|
|
62
|
+
const dir = dirname(relPath).replace(/\\/g, '/');
|
|
63
|
+
return dir === '.' ? 'core' : dir;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Extract the module's taxonomy `type` (`fw.<...>`) from a source file — NOT
|
|
68
|
+
* nested `type:` props (`{ type: 'audio' }`, MIME strings, `type: 'Map'`).
|
|
69
|
+
* @param {string} srcJsPath
|
|
70
|
+
* @returns {(string|null)}
|
|
71
|
+
*/
|
|
72
|
+
function readSrcType(srcJsPath) {
|
|
73
|
+
let src;
|
|
74
|
+
try { src = readFileSync(srcJsPath, 'utf8'); }
|
|
75
|
+
catch { return null; }
|
|
76
|
+
const m = src.match(/(^|[\s,{])type\s*:\s*['"](fw\.[^'"]+)['"]/);
|
|
77
|
+
return m ? m[2] : null;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Make a `.d.ts` carry authoritative module tags : strip ANY existing
|
|
82
|
+
* `@module`/`@category` from its leading comment and (re)insert
|
|
83
|
+
* `@module <path>` + `@category <derived>`. Authoritative on purpose — it
|
|
84
|
+
* overrides whatever the source happens to declare (flat names, wrong
|
|
85
|
+
* categories), so the index grouping is uniform regardless of source JSDoc.
|
|
86
|
+
*
|
|
87
|
+
* `@module` is named by PATH (`io/codec/cbor`) so it stays distinct from the
|
|
88
|
+
* inner namespace (`cbor`). Tags are inserted INTO the existing leading block
|
|
89
|
+
* (preserving its description) when there is one, else a fresh block is
|
|
90
|
+
* prepended.
|
|
91
|
+
*
|
|
92
|
+
* @param {string} content @param {string} modPath @param {string} category
|
|
93
|
+
* @returns {string}
|
|
94
|
+
*/
|
|
95
|
+
function applyModuleTags(content, modPath, category) {
|
|
96
|
+
const bom = content.startsWith('') ? '' : '';
|
|
97
|
+
let body = bom ? content.slice(1) : content;
|
|
98
|
+
// Drop any pre-existing @module/@category JSDoc lines (avoid dupes on rerun).
|
|
99
|
+
body = body.replace(/^[ \t]*\*[ \t]*@(?:module|category)\b[^\n]*\r?\n/gm, '');
|
|
100
|
+
// Prepend a STANDALONE module comment. Kept separate from any existing
|
|
101
|
+
// declaration comment (e.g. a `@typedef`/function doc) so we never hijack
|
|
102
|
+
// that declaration's description as the module summary — TypeDoc still
|
|
103
|
+
// treats an `@module` comment as the module's own doc.
|
|
104
|
+
return `${bom}/**\n * @module ${modPath}\n * @category ${category}\n */\n\n${body}`;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
function main() {
|
|
108
|
+
let tagged = 0;
|
|
109
|
+
for (const dts of listDts(TYPES_DIR)) {
|
|
110
|
+
const content = readFileSync(dts, 'utf8');
|
|
111
|
+
const relPath = relative(TYPES_DIR, dts).replace(/\\/g, '/');
|
|
112
|
+
const srcJs = resolve(SRC_DIR, relPath.replace(/\.d\.ts$/, '.js'));
|
|
113
|
+
const category = categoryFor(relPath, readSrcType(srcJs));
|
|
114
|
+
const modPath = relPath.replace(/\.d\.ts$/, '');
|
|
115
|
+
const next = applyModuleTags(content, modPath, category);
|
|
116
|
+
if (next !== content) { writeFileSync(dts, next, 'utf8'); tagged++; }
|
|
117
|
+
}
|
|
118
|
+
console.log(`[typedoc/categorize] applied authoritative @module/@category to ${tagged} module(s).`);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
main();
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json.schemastore.org/tsconfig",
|
|
3
|
+
"_comment": "Minimal tsconfig for TypeDoc — compilerOptions only, NO `include` (TypeDoc drives the file set via entryPoints = dist/types). Kept separate from tsconfig.types.json to avoid inheriting its `include: src/**/*.js`.",
|
|
4
|
+
"compilerOptions": {
|
|
5
|
+
"target": "ESNext",
|
|
6
|
+
"module": "ESNext",
|
|
7
|
+
"moduleResolution": "bundler",
|
|
8
|
+
"lib": ["ESNext", "DOM"],
|
|
9
|
+
"skipLibCheck": true,
|
|
10
|
+
"types": []
|
|
11
|
+
},
|
|
12
|
+
"include": ["../../dist/types/**/*.d.ts"],
|
|
13
|
+
"exclude": ["../../dist/types/**/*.test.d.ts", "../../dist/types/typed.d.ts"]
|
|
14
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://typedoc.org/schema.json",
|
|
3
|
+
"name": "@awacloud/fw — Référence API (générée)",
|
|
4
|
+
"entryPoints": ["../../dist/types"],
|
|
5
|
+
"entryPointStrategy": "expand",
|
|
6
|
+
"exclude": [
|
|
7
|
+
"**/*.test.d.ts",
|
|
8
|
+
"**/*.kat.d.ts",
|
|
9
|
+
"**/registry.generated.d.ts",
|
|
10
|
+
"**/typed.d.ts"
|
|
11
|
+
],
|
|
12
|
+
"tsconfig": "./tsconfig.typedoc.json",
|
|
13
|
+
"out": "../../docs/api-generated",
|
|
14
|
+
"readme": "none",
|
|
15
|
+
"excludeInternal": true,
|
|
16
|
+
"excludePrivate": true,
|
|
17
|
+
"githubPages": false,
|
|
18
|
+
"hideGenerator": false
|
|
19
|
+
}
|