@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,115 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: fixedPoint
|
|
3
|
+
category: io/math
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# fixedPoint
|
|
11
|
+
|
|
12
|
+
> Fixed-point ↔ float conversions for binary format I/O (SFNT, TIFF, DSP).
|
|
13
|
+
|
|
14
|
+
**Module** `fixedPoint` | **Source** `packages/front/fw/src/io/math/fixed-point.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Conversions between fixed-point representations (Fixed16.16, F2Dot14, FUnit) and JS floats. Covers SFNT / OpenType formats (matrices, axis coords, design units), TIFF and audio/DSP variants. Includes a generic parameterizable helper (arbitrary intBits + fracBits).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const fp = runtime.resolve('fixedPoint');
|
|
22
|
+
// Returns: { fixed16ToFloat, floatToFixed16, ufixed16ToFloat, floatToUfixed16,
|
|
23
|
+
// f2dot14ToFloat, floatToF2dot14, funitToPx, fixedToFloat, floatToFixed }
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## API
|
|
27
|
+
|
|
28
|
+
| Method | Signature | Returns |
|
|
29
|
+
|--------|-----------|---------|
|
|
30
|
+
| `fixed16ToFloat` | `(raw: number) => number` | Float from signed Fixed16.16 |
|
|
31
|
+
| `floatToFixed16` | `(value: number, opts?) => number` | Signed Fixed16.16 (bit-pattern uint32) |
|
|
32
|
+
| `ufixed16ToFloat` | `(raw: number) => number` | Float from unsigned UFix16.16 |
|
|
33
|
+
| `floatToUfixed16` | `(value: number, opts?) => number` | UFix16.16 (bit-pattern uint32) |
|
|
34
|
+
| `f2dot14ToFloat` | `(raw: number) => number` | Float from signed F2Dot14 (16 bits) |
|
|
35
|
+
| `floatToF2dot14` | `(value: number, opts?) => number` | F2Dot14 (bit-pattern uint16, 0x0000–0xFFFF) |
|
|
36
|
+
| `funitToPx` | `(unitsPerEm: number, fontSize: number, funit: number) => number` | Design units → pixels |
|
|
37
|
+
| `fixedToFloat` | `(raw, intBits, fracBits, signed?) => number` | Generic: raw → float |
|
|
38
|
+
| `floatToFixed` | `(value, intBits, fracBits, signed?, opts?) => number` | Generic: float → bit-pattern |
|
|
39
|
+
|
|
40
|
+
### Option `opts`
|
|
41
|
+
|
|
42
|
+
The `floatTo*` functions accept an optional `{ strict: boolean }` object:
|
|
43
|
+
|
|
44
|
+
- `strict: false` (default) — out-of-range values are clamped; NaN/Infinity return `0` or the max value.
|
|
45
|
+
- `strict: true` — throws `RangeError` on NaN, Infinity, or range overflow.
|
|
46
|
+
|
|
47
|
+
### Supported formats
|
|
48
|
+
|
|
49
|
+
| Type | Total bits | Integer bits | Fraction bits | Range |
|
|
50
|
+
|------|-----------:|-------------:|--------------:|-------|
|
|
51
|
+
| Signed Fixed16.16 | 32 | 16 | 16 | -32768 to 32767.99998… |
|
|
52
|
+
| Unsigned UFix16.16 | 32 | 16 | 16 | 0 to 65535.99998… |
|
|
53
|
+
| Signed F2Dot14 | 16 | 2 | 14 | -2 to 1.99993… |
|
|
54
|
+
| FUnit | variable | — | — | integer × (1 / unitsPerEm) |
|
|
55
|
+
|
|
56
|
+
## Examples
|
|
57
|
+
|
|
58
|
+
### SFNT / OpenType — matrices and axis coords
|
|
59
|
+
|
|
60
|
+
```js
|
|
61
|
+
const fp = runtime.resolve('fixedPoint');
|
|
62
|
+
|
|
63
|
+
// Read a Fixed16.16 matrix from a DataView
|
|
64
|
+
const m00 = fp.fixed16ToFloat(view.getUint32(offset, false)); // → e.g. 1.0
|
|
65
|
+
|
|
66
|
+
// Axis coordinate F2Dot14 (avar / gvar)
|
|
67
|
+
const coord = fp.f2dot14ToFloat(view.getUint16(offset, false)); // → -1.0 … 1.99993…
|
|
68
|
+
|
|
69
|
+
// Design-unit → pixels (layout)
|
|
70
|
+
const px = fp.funitToPx(2048, 16, 1024); // → 8.0
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### Generic Fixed8.8 (unsigned)
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
const fp = runtime.resolve('fixedPoint');
|
|
77
|
+
|
|
78
|
+
const value = fp.fixedToFloat(0x0180, 8, 8, false); // → 1.5
|
|
79
|
+
const raw = fp.floatToFixed(1.5, 8, 8, false); // → 0x0180
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Strict conversion (throws on overflow)
|
|
83
|
+
|
|
84
|
+
```js
|
|
85
|
+
const fp = runtime.resolve('fixedPoint');
|
|
86
|
+
|
|
87
|
+
fp.floatToFixed16(100000); // → 0x7FFFFFFF (clamp)
|
|
88
|
+
fp.floatToFixed16(100000, { strict: true }); // throws RangeError
|
|
89
|
+
fp.floatToFixed16(NaN); // → 0
|
|
90
|
+
fp.floatToFixed16(NaN, { strict: true }); // throws RangeError
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## Worker Usage
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
const worker = fw.createWorker(
|
|
97
|
+
function ({ libs, args }) {
|
|
98
|
+
const result = libs.fixedPoint.fixed16ToFloat(args.raw);
|
|
99
|
+
self.postMessage(result);
|
|
100
|
+
},
|
|
101
|
+
{ dependencies: ['fixedPoint'], args: { raw: 0x00018000 } } // → 1.5
|
|
102
|
+
);
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## Notes
|
|
106
|
+
|
|
107
|
+
- **float64 precision**: Fixed16.16 (32 bits) fits comfortably within `Number.MAX_SAFE_INTEGER`; no `BigInt` needed in v1.
|
|
108
|
+
- **F2Dot14 boundary**: `floatToF2dot14(2.0)` → `0x7FFF` (max representable), `floatToF2dot14(-2.0)` → `0x8000` (min).
|
|
109
|
+
- **Unsigned representation**: `floatTo*` methods always return an unsigned bit-pattern (positive JS integer), even for signed formats — conforming to the DataView/ArrayBuffer standard.
|
|
110
|
+
- **No npm dependencies**: pure JS implementation, worker-safe.
|
|
111
|
+
|
|
112
|
+
## See also
|
|
113
|
+
|
|
114
|
+
- [linalg](./linalg.md) — transformation matrices (uses Fixed16.16 in SFNT)
|
|
115
|
+
- [geom](./geom.md) — 2D geometry (FUnit coordinates for typographic layouts)
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: geom
|
|
3
|
+
category: io/math
|
|
4
|
+
dependencies: [linalg]
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# geom
|
|
11
|
+
|
|
12
|
+
> 2D geometry — Point, Rect, Circle, Line, Polygon, hit-testing, intersections.
|
|
13
|
+
|
|
14
|
+
**Module** `geom` | **Source** `packages/front/fw/src/io/math/geom.js` | **Deps** `linalg` | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
2D geometric primitives with hit-testing, intersections, polygon simplification (Ramer-Douglas-Peucker) and transform via `linalg.mat3`. No 3D geometry, polygon clipping, or Voronoi.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const geom = runtime.resolve('geom');
|
|
22
|
+
// Returns: { Point, Rect, Circle, Line, Polygon, hitTest, transform }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
### Point
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `create` | `(x, y) => {x, y}` | Point |
|
|
32
|
+
| `distance` | `(a, b) => number` | Euclidean distance |
|
|
33
|
+
| `midpoint` | `(a, b) => Point` | Midpoint |
|
|
34
|
+
| `equals` | `(a, b, eps?) => boolean` | Comparison with epsilon |
|
|
35
|
+
|
|
36
|
+
### Rect (left/top inclusive, right/bottom exclusive)
|
|
37
|
+
|
|
38
|
+
| Method | Signature | Returns |
|
|
39
|
+
|--------|-----------|---------|
|
|
40
|
+
| `create` | `(x, y, w, h) => Rect` | Rectangle |
|
|
41
|
+
| `contains` | `(rect, point) => boolean` | Hit-test |
|
|
42
|
+
| `intersects` | `(a, b) => boolean` | Overlap |
|
|
43
|
+
| `intersection` | `(a, b) => Rect \| null` | Overlap area |
|
|
44
|
+
| `union` | `(a, b) => Rect` | Bounding union |
|
|
45
|
+
| `area` | `(rect) => number` | w×h |
|
|
46
|
+
| `center` | `(rect) => Point` | Center |
|
|
47
|
+
| `normalize` | `(rect) => Rect` | Ensures w,h ≥ 0 |
|
|
48
|
+
|
|
49
|
+
### Circle
|
|
50
|
+
|
|
51
|
+
| Method | Signature | Returns |
|
|
52
|
+
|--------|-----------|---------|
|
|
53
|
+
| `create` | `(cx, cy, r) => Circle` | Circle |
|
|
54
|
+
| `contains` | `(circle, point) => boolean` | Point inside the circle |
|
|
55
|
+
| `intersectsCircle` | `(a, b) => boolean` | Two circles |
|
|
56
|
+
| `intersectsRect` | `(circle, rect) => boolean` | Circle/rectangle |
|
|
57
|
+
|
|
58
|
+
### Line (segment)
|
|
59
|
+
|
|
60
|
+
| Method | Signature | Returns |
|
|
61
|
+
|--------|-----------|---------|
|
|
62
|
+
| `create` | `(x1, y1, x2, y2) => Line` | Segment |
|
|
63
|
+
| `length` | `(line) => number` | Length |
|
|
64
|
+
| `intersects` | `(a, b) => boolean` | Intersecting |
|
|
65
|
+
| `intersection` | `(a, b) => Point \| null` | Intersection point |
|
|
66
|
+
| `distanceToPoint` | `(line, point) => number` | Minimum distance |
|
|
67
|
+
| `closestPoint` | `(line, point) => Point` | Closest point on the segment |
|
|
68
|
+
|
|
69
|
+
### Polygon
|
|
70
|
+
|
|
71
|
+
| Method | Signature | Returns |
|
|
72
|
+
|--------|-----------|---------|
|
|
73
|
+
| `create` | `(points: Point[]) => Polygon` | Polygon |
|
|
74
|
+
| `area` | `(poly) => number` | Signed area (> 0 = CCW) |
|
|
75
|
+
| `isCcw` | `(poly) => boolean` | Counter-clockwise orientation |
|
|
76
|
+
| `contains` | `(poly, point) => boolean` | Ray-casting |
|
|
77
|
+
| `bbox` | `(poly) => Rect` | Bounding box |
|
|
78
|
+
| `simplify` | `(poly, tolerance) => Polygon` | Ramer-Douglas-Peucker |
|
|
79
|
+
|
|
80
|
+
### Global helpers
|
|
81
|
+
|
|
82
|
+
| Method | Description |
|
|
83
|
+
|--------|-------------|
|
|
84
|
+
| `hitTest(shape, point)` | Dispatches to Rect / Circle / Polygon |
|
|
85
|
+
| `transform(point, mat3)` | Applies `linalg.mat3.transform` |
|
|
86
|
+
|
|
87
|
+
## Examples
|
|
88
|
+
|
|
89
|
+
### Generic hit-test
|
|
90
|
+
|
|
91
|
+
```js
|
|
92
|
+
const geom = runtime.resolve('geom');
|
|
93
|
+
|
|
94
|
+
const rect = geom.Rect.create(0, 0, 100, 50);
|
|
95
|
+
const circle = geom.Circle.create(50, 25, 30);
|
|
96
|
+
|
|
97
|
+
geom.hitTest(rect, { x: 10, y: 10 }); // true
|
|
98
|
+
geom.hitTest(circle, { x: 50, y: 25 }); // true
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Rectangle intersection
|
|
102
|
+
|
|
103
|
+
```js
|
|
104
|
+
const a = geom.Rect.create(0, 0, 10, 10);
|
|
105
|
+
const b = geom.Rect.create(5, 5, 10, 10);
|
|
106
|
+
|
|
107
|
+
if (geom.Rect.intersects(a, b)) {
|
|
108
|
+
const overlap = geom.Rect.intersection(a, b);
|
|
109
|
+
// { x: 5, y: 5, w: 5, h: 5 }
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
### Simplify a GPS polygon
|
|
114
|
+
|
|
115
|
+
```js
|
|
116
|
+
const path = geom.Polygon.create(gpsPoints);
|
|
117
|
+
const simplified = geom.Polygon.simplify(path, 0.001); // tolerance in degrees
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
## Worker Usage
|
|
121
|
+
|
|
122
|
+
```js
|
|
123
|
+
const worker = fw.createWorker(
|
|
124
|
+
function ({ libs, args }) {
|
|
125
|
+
const geom = libs.geom;
|
|
126
|
+
const rect = geom.Rect.create(args.x, args.y, args.w, args.h);
|
|
127
|
+
const hits = args.points.filter(p => geom.Rect.contains(rect, geom.Point.create(p[0], p[1])));
|
|
128
|
+
self.postMessage(hits);
|
|
129
|
+
},
|
|
130
|
+
{ dependencies: ['geom'], args: { x: 0, y: 0, w: 100, h: 100, points: [[10, 10], [200, 200]] } }
|
|
131
|
+
);
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
## Notes
|
|
135
|
+
|
|
136
|
+
- **Border convention**: `Rect.contains` — left/top inclusive, right/bottom exclusive (`x < rect.x + rect.w`).
|
|
137
|
+
- **Non-closed polygon**: the last point is auto-closed back to the first for `area` and `contains`.
|
|
138
|
+
- `Polygon.area` returns a signed value — positive = CCW, negative = CW. Use `Math.abs` for the geometric area.
|
|
139
|
+
- `hitTest` dispatches by duck-typing: presence of `w`/`h` → Rect, `cx`/`r` → Circle, `points` → Polygon.
|
|
140
|
+
|
|
141
|
+
## See also
|
|
142
|
+
|
|
143
|
+
- [linalg](./linalg.md) — linear algebra (matrix transforms)
|
|
144
|
+
- [interp](./interp.md) — spatial interpolation (Bézier, barycentric)
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: interp
|
|
3
|
+
category: io/math
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# interp
|
|
11
|
+
|
|
12
|
+
> Spatial interpolation — linear, bicubic, Bézier, Catmull-Rom, barycentric.
|
|
13
|
+
|
|
14
|
+
**Module** `interp` | **Source** `packages/front/fw/src/io/math/interp.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Non-temporal interpolation for 2D fields (textures, heightmaps), path splines, pose blending. Distinct from [`easing`](../calc/easing.md) (temporal animations). All functions are pure — no mutation except `vec` which takes an `out`.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const interp = runtime.resolve('interp');
|
|
22
|
+
// Returns: { linear, smoothstep, smootherstep, cubicHermite, catmullRom, bezier2, bezier3, bilinear, bicubic, vec, barycentric, sample, sample2D }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `linear` | `(a, b, t) => number` | `a + t*(b-a)` |
|
|
30
|
+
| `smoothstep` | `(edge0, edge1, x) => number` | GLSL standard, clamped |
|
|
31
|
+
| `smootherstep` | `(edge0, edge1, x) => number` | 6t⁵ - 15t⁴ + 10t³ |
|
|
32
|
+
| `cubicHermite` | `(p0, p1, m0, m1, t) => number` | Hermite cubic |
|
|
33
|
+
| `catmullRom` | `(p0, p1, p2, p3, t, alpha?) => number` | Centripetal by default (α=0.5) |
|
|
34
|
+
| `bezier2` | `(p0, p1, p2, t) => number` | Quadratic Bézier |
|
|
35
|
+
| `bezier3` | `(p0, p1, p2, p3, t) => number` | Cubic Bézier |
|
|
36
|
+
| `bilinear` | `(q11, q21, q12, q22, x, y) => number` | 2D bilinear interpolation |
|
|
37
|
+
| `bicubic` | `(samples4x4, x, y) => number` | 4×4 Catmull-Rom |
|
|
38
|
+
| `vec` | `(out, a, b, t) => out` | Vector lerp (n-dimensional) |
|
|
39
|
+
| `barycentric` | `(p, a, b, c) => {u, v, w}` | Barycentric coordinates |
|
|
40
|
+
| `sample` | `(samples, t) => number` | Lerp over indexed 1D array |
|
|
41
|
+
| `sample2D` | `(samples, w, h, x, y) => number` | Bilinear over 2D grid |
|
|
42
|
+
|
|
43
|
+
## Examples
|
|
44
|
+
|
|
45
|
+
### Path spline (Catmull-Rom)
|
|
46
|
+
|
|
47
|
+
```js
|
|
48
|
+
const interp = runtime.resolve('interp');
|
|
49
|
+
|
|
50
|
+
const controlPoints = [0, 1, 4, 2, 5]; // y values
|
|
51
|
+
const t = 0.5; // position within segment p1..p2
|
|
52
|
+
|
|
53
|
+
const y = interp.catmullRom(
|
|
54
|
+
controlPoints[0], controlPoints[1],
|
|
55
|
+
controlPoints[2], controlPoints[3],
|
|
56
|
+
t
|
|
57
|
+
);
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Bézier UI (S-curve)
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
// Cubic Bézier for ease-in-out animation
|
|
64
|
+
function easeInOut(t) {
|
|
65
|
+
return interp.bezier3(0, 0.25, 0.75, 1, t);
|
|
66
|
+
}
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Bilinear heightmap
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
// 3x3 height grid
|
|
73
|
+
const grid = [1, 2, 1, 3, 5, 3, 1, 2, 1];
|
|
74
|
+
const height = interp.sample2D(grid, 3, 3, 0.5, 0.5); // centre = 5
|
|
75
|
+
|
|
76
|
+
// 4x4 grid for bicubic (smoother)
|
|
77
|
+
const height2 = interp.bicubic(grid4x4, 0.5, 0.5);
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Pose blending (barycentric)
|
|
81
|
+
|
|
82
|
+
```js
|
|
83
|
+
const { u, v, w } = interp.barycentric(cursor, vertA, vertB, vertC);
|
|
84
|
+
const blended = {
|
|
85
|
+
x: u * poseA.x + v * poseB.x + w * poseC.x,
|
|
86
|
+
y: u * poseA.y + v * poseB.y + w * poseC.y,
|
|
87
|
+
};
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Worker Usage
|
|
91
|
+
|
|
92
|
+
```js
|
|
93
|
+
const worker = fw.createWorker(
|
|
94
|
+
function ({ libs, args }) {
|
|
95
|
+
const interp = libs.interp;
|
|
96
|
+
// Interpolate a grid of values in a worker
|
|
97
|
+
const result = interp.bilinear(args.grid, args.x, args.y);
|
|
98
|
+
self.postMessage(result);
|
|
99
|
+
},
|
|
100
|
+
{ dependencies: ['interp'], args: { grid: [[0, 1], [1, 2]], x: 0.5, y: 0.5 } }
|
|
101
|
+
);
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Notes
|
|
105
|
+
|
|
106
|
+
- `t` is free — extrapolation outside `[0, 1]` is allowed for `linear`, `bezier*`, `catmullRom`. `smoothstep`/`smootherstep` clamp.
|
|
107
|
+
- Catmull-Rom α=0.5 (centripetal) recommended for visual splines — avoids loops on close points. α=0 (uniform), α=1 (chordal).
|
|
108
|
+
- `bicubic` more expensive than `bilinear` — prefer `bilinear` for real-time sampling, `bicubic` for image upscaling.
|
|
109
|
+
- **Distinct from `easing`** (io/calc): `easing` is for animations (time), `interp` is for space (positions, fields).
|
|
110
|
+
|
|
111
|
+
## See also
|
|
112
|
+
|
|
113
|
+
- [easing](../calc/easing.md) — temporal interpolation for animations
|
|
114
|
+
- [geom](./geom.md) — 2D geometry (Bézier paths in geom)
|
|
115
|
+
- [linalg](./linalg.md) — linear algebra for transforms
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: linalg
|
|
3
|
+
category: io/math
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# linalg
|
|
11
|
+
|
|
12
|
+
> 2D/3D/4D linear algebra — vectors + column-major matrices, gl-matrix style.
|
|
13
|
+
|
|
14
|
+
**Module** `linalg` | **Source** `packages/front/fw/src/io/math/linalg.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Linear algebra primitives for graphics, physics, and geometric computation. [gl-matrix](https://github.com/toji/gl-matrix) style: `Float32Array`, functions with out-parameter for zero allocation in hot paths. Column-major matrices (compatible with WebGL/OpenGL).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const linalg = runtime.resolve('linalg');
|
|
22
|
+
// Returns: { vec2, vec3, vec4, mat3, mat4 }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
### Vectors (`vec2`, `vec3`, `vec4`)
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `create` | `(arr?) => Float32Array` | Vector (zeros or initial values) |
|
|
32
|
+
| `add` | `(out, a, b) => out` | `a + b` |
|
|
33
|
+
| `sub` | `(out, a, b) => out` | `a - b` |
|
|
34
|
+
| `mul` | `(out, a, b) => out` | Component-wise |
|
|
35
|
+
| `scale` | `(out, v, s) => out` | `v * s` |
|
|
36
|
+
| `dot` | `(a, b) => number` | Dot product |
|
|
37
|
+
| `cross` | `(out, a, b) => out` | Cross product (vec3 only) |
|
|
38
|
+
| `length` | `(v) => number` | Norm |
|
|
39
|
+
| `normalize` | `(out, v) => out` | Unit vector |
|
|
40
|
+
| `distance` | `(a, b) => number` | Euclidean distance |
|
|
41
|
+
| `lerp` | `(out, a, b, t) => out` | Linear interpolation |
|
|
42
|
+
| `equals` | `(a, b, eps?) => boolean` | Comparison with epsilon |
|
|
43
|
+
|
|
44
|
+
### Matrices (`mat3`, `mat4`)
|
|
45
|
+
|
|
46
|
+
| Method | Signature | Returns |
|
|
47
|
+
|--------|-----------|---------|
|
|
48
|
+
| `create` | `() => Float32Array` | Identity matrix |
|
|
49
|
+
| `identity` | `(out) => out` | Resets to identity |
|
|
50
|
+
| `multiply` | `(out, a, b) => out` | `a * b` |
|
|
51
|
+
| `translate` | `(out, m, v) => out` | Translation |
|
|
52
|
+
| `rotate` | `(out, m, rad, axis?) => out` | Rotation (axis = vec3 for mat4) |
|
|
53
|
+
| `scale` | `(out, m, v) => out` | Scale |
|
|
54
|
+
| `invert` | `(out, m) => boolean` | Inverse; `false` if singular |
|
|
55
|
+
| `transpose` | `(out, m) => out` | Transpose |
|
|
56
|
+
| `transform` | `(out, m, v) => out` | Applies the matrix to the vector |
|
|
57
|
+
|
|
58
|
+
**Additional mat4 methods**:
|
|
59
|
+
|
|
60
|
+
| Method | Description |
|
|
61
|
+
|--------|-------------|
|
|
62
|
+
| `perspective(out, fovY, aspect, near, far)` | Perspective matrix |
|
|
63
|
+
| `ortho(out, l, r, b, t, near, far)` | Orthographic projection |
|
|
64
|
+
| `lookAt(out, eye, center, up)` | View matrix |
|
|
65
|
+
| `transform4(out, m, vec4)` | Transforms without perspective divide |
|
|
66
|
+
|
|
67
|
+
## Examples
|
|
68
|
+
|
|
69
|
+
### Basic 3D pipeline
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
const linalg = runtime.resolve('linalg');
|
|
73
|
+
const { vec3, mat4 } = linalg;
|
|
74
|
+
|
|
75
|
+
// Matrices
|
|
76
|
+
const model = mat4.create();
|
|
77
|
+
mat4.translate(model, model, [0, 0, -5]);
|
|
78
|
+
mat4.rotate(model, model, Math.PI / 4, [0, 1, 0]);
|
|
79
|
+
|
|
80
|
+
const view = mat4.create();
|
|
81
|
+
mat4.lookAt(view, [0, 2, 5], [0, 0, 0], [0, 1, 0]);
|
|
82
|
+
|
|
83
|
+
const proj = mat4.create();
|
|
84
|
+
mat4.perspective(proj, Math.PI / 3, 16 / 9, 0.1, 1000);
|
|
85
|
+
|
|
86
|
+
// MVP
|
|
87
|
+
const mvp = mat4.create();
|
|
88
|
+
mat4.multiply(mvp, proj, view);
|
|
89
|
+
mat4.multiply(mvp, mvp, model);
|
|
90
|
+
|
|
91
|
+
// Transform a point
|
|
92
|
+
const point = vec3.create([1, 0, 0]);
|
|
93
|
+
const result = vec3.create();
|
|
94
|
+
mat4.transform(result, mvp, point);
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Vectors
|
|
98
|
+
|
|
99
|
+
```js
|
|
100
|
+
const { vec3 } = linalg;
|
|
101
|
+
|
|
102
|
+
const a = vec3.create([3, 4, 0]);
|
|
103
|
+
const b = vec3.create([1, 0, 0]);
|
|
104
|
+
|
|
105
|
+
console.log(vec3.length(a)); // 5
|
|
106
|
+
console.log(vec3.dot(a, b)); // 3
|
|
107
|
+
const n = vec3.create();
|
|
108
|
+
vec3.normalize(n, a); // [0.6, 0.8, 0]
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## Worker Usage
|
|
112
|
+
|
|
113
|
+
```js
|
|
114
|
+
const worker = fw.createWorker(
|
|
115
|
+
function ({ libs, args }) {
|
|
116
|
+
const { mat4, vec3 } = libs.linalg;
|
|
117
|
+
const m = mat4.create();
|
|
118
|
+
mat4.rotate(m, m, args.angle, args.axis);
|
|
119
|
+
const out = vec3.create();
|
|
120
|
+
mat4.transform(out, m, args.point);
|
|
121
|
+
return Array.from(out);
|
|
122
|
+
},
|
|
123
|
+
{ dependencies: ['linalg'], args: { angle: Math.PI / 2, axis: [0, 1, 0], point: [1, 0, 0] } }
|
|
124
|
+
);
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
## Notes
|
|
128
|
+
|
|
129
|
+
- Aliasing safe: `add(a, a, b)` is valid — operations read inputs before writing.
|
|
130
|
+
- Column-major: the 4th column of mat4 contains the translation (`m[12]`, `m[13]`, `m[14]`). Pass directly to `gl.uniformMatrix4fv(loc, false, mat4)`.
|
|
131
|
+
- No quaternions — for chained rotations without gimbal lock, see the separate `linalg-quat` plan.
|
|
132
|
+
- `Float32Array` precision: for high-precision computation, use `Float64Array` + adapted functions.
|
|
133
|
+
|
|
134
|
+
## See also
|
|
135
|
+
|
|
136
|
+
- [geom](./geom.md) — 2D geometry (Rect, Circle, hit-test)
|
|
137
|
+
- [interp](./interp.md) — spatial interpolation (Bézier, bicubic)
|
|
138
|
+
- [stats](./stats.md) — descriptive statistics
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: stats
|
|
3
|
+
category: io/math
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# stats
|
|
11
|
+
|
|
12
|
+
> Descriptive statistics — mean, median, quantile, variance, histogram, normalize.
|
|
13
|
+
|
|
14
|
+
**Module** `stats` | **Source** `packages/front/fw/src/io/math/stats.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Basic statistical computations on arrays of numbers. Single-pass where possible (mean, sum); sorting required for median, quantile, iqr. All functions throw on empty arrays or arrays with NaN.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const stats = runtime.resolve('stats');
|
|
22
|
+
// Returns: { mean, median, mode, geomean, harmean, variance, stddev, range, iqr, mad, min, max, sum, product, quantile, percentile, histogram, zscore, normalize, standardize }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `mean` | `(arr: number[]) => number` | Arithmetic mean |
|
|
30
|
+
| `median` | `(arr) => number` | Median value |
|
|
31
|
+
| `mode` | `(arr) => number` | Most frequent value |
|
|
32
|
+
| `geomean` | `(arr) => number` | Geometric mean |
|
|
33
|
+
| `harmean` | `(arr) => number` | Harmonic mean |
|
|
34
|
+
| `variance` | `(arr, sample?) => number` | Population or sample variance |
|
|
35
|
+
| `stddev` | `(arr, sample?) => number` | Standard deviation |
|
|
36
|
+
| `range` | `(arr) => number` | max - min |
|
|
37
|
+
| `iqr` | `(arr) => number` | Q3 - Q1 |
|
|
38
|
+
| `mad` | `(arr) => number` | Median absolute deviation |
|
|
39
|
+
| `min` / `max` | `(arr) => number` | Extreme values |
|
|
40
|
+
| `sum` / `product` | `(arr) => number` | Sum / product |
|
|
41
|
+
| `quantile` | `(arr, q: [0,1]) => number` | Type 7 quantile (R standard) |
|
|
42
|
+
| `percentile` | `(arr, p: [0,100]) => number` | Alias `quantile(arr, p/100)` |
|
|
43
|
+
| `histogram` | `(arr, bins: number \| edges[]) => {edges, counts}` | Distribution by bins |
|
|
44
|
+
| `zscore` | `(value, arr) => number` | Z-score |
|
|
45
|
+
| `normalize` | `(arr, {min?, max?}) => number[]` | Remap to [min, max] |
|
|
46
|
+
| `standardize` | `(arr) => number[]` | (x - mean) / stddev |
|
|
47
|
+
|
|
48
|
+
## Examples
|
|
49
|
+
|
|
50
|
+
### Basic statistics
|
|
51
|
+
|
|
52
|
+
```js
|
|
53
|
+
const stats = runtime.resolve('stats');
|
|
54
|
+
|
|
55
|
+
const data = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
|
|
56
|
+
|
|
57
|
+
console.log(stats.mean(data)); // 5.5
|
|
58
|
+
console.log(stats.median(data)); // 5.5
|
|
59
|
+
console.log(stats.variance(data)); // 8.25 (population)
|
|
60
|
+
console.log(stats.stddev(data, true)); // ~3.03 (sample)
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### Quantiles and distribution
|
|
64
|
+
|
|
65
|
+
```js
|
|
66
|
+
const scores = [45, 52, 61, 71, 75, 80, 85, 90, 95, 100];
|
|
67
|
+
|
|
68
|
+
const q1 = stats.quantile(scores, 0.25);
|
|
69
|
+
const q3 = stats.quantile(scores, 0.75);
|
|
70
|
+
console.log(`IQR: ${stats.iqr(scores)}`);
|
|
71
|
+
|
|
72
|
+
const { edges, counts } = stats.histogram(scores, 5);
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### Normalization
|
|
76
|
+
|
|
77
|
+
```js
|
|
78
|
+
const normalized = stats.normalize([0, 5, 10], { min: 0, max: 1 });
|
|
79
|
+
// [0, 0.5, 1]
|
|
80
|
+
|
|
81
|
+
const standardized = stats.standardize(data);
|
|
82
|
+
// mean ≈ 0, stddev ≈ 1
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## Worker Usage
|
|
86
|
+
|
|
87
|
+
```js
|
|
88
|
+
const worker = fw.createWorker(
|
|
89
|
+
function ({ libs, args }) {
|
|
90
|
+
return {
|
|
91
|
+
mean: libs.stats.mean(args.data),
|
|
92
|
+
stddev: libs.stats.stddev(args.data),
|
|
93
|
+
};
|
|
94
|
+
},
|
|
95
|
+
{ dependencies: ['stats'], args: { data: [1, 2, 3, 4, 5] } }
|
|
96
|
+
);
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
## Notes
|
|
100
|
+
|
|
101
|
+
- `quantile` Type 7 (R default method, Excel `PERCENTILE`) — linear interpolation between sorted values.
|
|
102
|
+
- `mean([])` and any call on an empty array throws `'stats: empty array'` — no silent `NaN` return.
|
|
103
|
+
- `variance(arr, true)` divides by `n-1` (sample); `false` (default) divides by `n` (population).
|
|
104
|
+
- `histogram` with a bin count: evenly distributed bins over `[min, max]`. With explicit edges: bins between successive edges.
|
|
105
|
+
|
|
106
|
+
## See also
|
|
107
|
+
|
|
108
|
+
- [interp](./interp.md) — spatial interpolation
|
|
109
|
+
- [linalg](./linalg.md) — linear algebra
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# IO / Structures
|
|
2
|
+
|
|
3
|
+
Low-level data structures. All worker-safe, no DOM dependencies.
|
|
4
|
+
|
|
5
|
+
| Module | Returns | Deps | Description |
|
|
6
|
+
|--------|----------|------|-------------|
|
|
7
|
+
| [lruCache](./lruCache.md) | `{create}` | none | Bounded LRU cache O(1) |
|
|
8
|
+
| [heap](./heap.md) | `{create}` | none | Binary heap (priority queue) O(log n) |
|
|
9
|
+
| [ringBuffer](./ringBuffer.md) | `{create}` | none | FIFO ring buffer O(1), circular overwrite |
|
|
10
|
+
| [trie](./trie.md) | `{create}` | none | Prefix tree (autocompletion, prefix search) |
|
|
11
|
+
| [btree](./btree.md) | `{create}` | none | m-way B-tree (ordered map, range queries) |
|
|
12
|
+
| [treeWalker](./tree-walker.md) | `{createWalker, walk, findFirst, findAll, replaceNode, wrapNode, flattenNode, cloneNode}` | none | Generic visitor for linked trees (entering/leaving events) |
|
|
13
|
+
|
|
14
|
+
## Common pattern
|
|
15
|
+
|
|
16
|
+
```js
|
|
17
|
+
const lruCache = runtime.resolve('lruCache');
|
|
18
|
+
const cache = lruCache.create({ maxSize: 128 });
|
|
19
|
+
|
|
20
|
+
const heap = runtime.resolve('heap');
|
|
21
|
+
const h = heap.create({ comparator: (a, b) => a - b });
|
|
22
|
+
|
|
23
|
+
const ringBuffer = runtime.resolve('ringBuffer');
|
|
24
|
+
const rb = ringBuffer.create({ capacity: 256 });
|
|
25
|
+
|
|
26
|
+
const trie = runtime.resolve('trie');
|
|
27
|
+
const t = trie.create();
|
|
28
|
+
|
|
29
|
+
const btree = runtime.resolve('btree');
|
|
30
|
+
const b = btree.create({ order: 5 });
|
|
31
|
+
```
|