@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,128 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: date
|
|
3
|
+
category: io/time
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# date
|
|
11
|
+
|
|
12
|
+
> Date + Intl helpers — strict ISO parsing, locale-aware formatting, calendar arithmetic.
|
|
13
|
+
|
|
14
|
+
**Module** `date` | **Source** `packages/front/fw/src/io/time/date.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
No embedded timezone database — delegated to native `Intl` (modern browsers, Node 16+, Bun).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const date = runtime.resolve('date');
|
|
22
|
+
// Returns: { format, formatRelative, parse, parseISO, diff, add, sub, startOf, endOf, getOffset, zones, isValid }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `isValid` | `(d: Date) => boolean` | `true` if date is valid (non-NaN) |
|
|
30
|
+
| `format` | `(d: Date, options?) => string` | Intl.DateTimeFormat.format |
|
|
31
|
+
| `formatRelative` | `(from: Date, to?: Date, options?) => string` | "3 min ago" via Intl.RelativeTimeFormat |
|
|
32
|
+
| `parseISO` | `(str: string) => Date \| null` | Strict ISO 8601 (timezone required) |
|
|
33
|
+
| `parse` | `(str: string, fmt?: string) => Date \| null` | Custom format (tokens YYYY MM DD HH mm ss SSS) |
|
|
34
|
+
| `add` | `(d: Date, n: number, unit: string) => Date` | New Date (immutable) |
|
|
35
|
+
| `sub` | `(d: Date, n: number, unit: string) => Date` | Alias for `add(d, -n, unit)` |
|
|
36
|
+
| `diff` | `(a: Date, b: Date, unit: string) => number` | `a - b` in `unit` (floor) |
|
|
37
|
+
| `startOf` | `(d: Date, unit: string) => Date` | Start of the period |
|
|
38
|
+
| `endOf` | `(d: Date, unit: string) => Date` | End of the period (23:59:59.999) |
|
|
39
|
+
| `getOffset` | `(d: Date, timeZone: string) => number` | Minutes from UTC |
|
|
40
|
+
| `zones` | `() => string[]` | List of IANA timezones (Intl.supportedValuesOf) |
|
|
41
|
+
|
|
42
|
+
### Valid units (`add`, `sub`, `diff`, `startOf`, `endOf`)
|
|
43
|
+
|
|
44
|
+
`'years'` | `'months'` | `'weeks'` | `'days'` | `'hours'` | `'minutes'` | `'seconds'` | `'ms'`
|
|
45
|
+
|
|
46
|
+
### Options `format`
|
|
47
|
+
|
|
48
|
+
All `Intl.DateTimeFormat` options + `locale` (default `'en-US'`).
|
|
49
|
+
|
|
50
|
+
### Options `parse` — supported tokens
|
|
51
|
+
|
|
52
|
+
| Token | Meaning | Example |
|
|
53
|
+
|-------|---------|---------|
|
|
54
|
+
| `YYYY` | 4-digit year | `2024` |
|
|
55
|
+
| `MM` | 2-digit month | `01` |
|
|
56
|
+
| `DD` | 2-digit day | `15` |
|
|
57
|
+
| `HH` | 2-digit hour (24h) | `14` |
|
|
58
|
+
| `mm` | 2-digit minute | `30` |
|
|
59
|
+
| `ss` | 2-digit second | `45` |
|
|
60
|
+
| `SSS` | 3-digit milliseconds | `123` |
|
|
61
|
+
|
|
62
|
+
## Examples
|
|
63
|
+
|
|
64
|
+
### Parsing + formatting
|
|
65
|
+
|
|
66
|
+
```js
|
|
67
|
+
const date = runtime.resolve('date');
|
|
68
|
+
|
|
69
|
+
const d = date.parseISO('2024-06-15T14:30:00Z');
|
|
70
|
+
date.format(d, { locale: 'fr-FR', timeZone: 'Europe/Paris', dateStyle: 'long', timeStyle: 'short' });
|
|
71
|
+
// "15 juin 2024 à 16:30"
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Calendar arithmetic
|
|
75
|
+
|
|
76
|
+
```js
|
|
77
|
+
// End-of-month clamp: Jan 31 + 1 month → Feb 29 2024 (leap year)
|
|
78
|
+
const d = new Date(2024, 0, 31);
|
|
79
|
+
date.add(d, 1, 'months'); // 2024-02-29
|
|
80
|
+
|
|
81
|
+
// Diff in days
|
|
82
|
+
const a = new Date(2024, 2, 10);
|
|
83
|
+
const b = new Date(2024, 0, 1);
|
|
84
|
+
date.diff(a, b, 'days'); // 69
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### startOf / endOf
|
|
88
|
+
|
|
89
|
+
```js
|
|
90
|
+
const d = new Date(2024, 5, 15, 14, 30, 45);
|
|
91
|
+
date.startOf(d, 'months'); // 2024-06-01 00:00:00.000
|
|
92
|
+
date.endOf(d, 'months'); // 2024-06-30 23:59:59.999
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Timezone offset
|
|
96
|
+
|
|
97
|
+
```js
|
|
98
|
+
const d = new Date('2024-01-15T12:00:00Z');
|
|
99
|
+
date.getOffset(d, 'UTC'); // 0
|
|
100
|
+
date.getOffset(d, 'Europe/Paris'); // 60 (CET, winter)
|
|
101
|
+
date.getOffset(d, 'America/New_York'); // -300 (EST, winter)
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Worker Usage
|
|
105
|
+
|
|
106
|
+
```js
|
|
107
|
+
const worker = fw.createWorker(
|
|
108
|
+
function ({ libs, args }) {
|
|
109
|
+
const d = libs.date.parseISO(args[0]);
|
|
110
|
+
self.postMessage(libs.date.format(d, { locale: args[1], dateStyle: 'medium' }));
|
|
111
|
+
},
|
|
112
|
+
{ dependencies: ['date'], args: ['2024-01-15T12:00:00Z', 'fr-FR'] }
|
|
113
|
+
);
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Notes
|
|
117
|
+
|
|
118
|
+
- `parseISO` is strict: rejects formats without timezone (`2024-01-15`, `2024-01-15T10:30:00` without Z/±HH:MM).
|
|
119
|
+
- `add` is immutable: always returns a new `Date`.
|
|
120
|
+
- Month clamp: `add(jan-31, 1, 'months')` → last day of the target month (no overflow).
|
|
121
|
+
- No `toTimezone(d, tz)` API that returns a "shifted" Date — that is an anti-pattern (the resulting Date would lie about its UTC epoch). Use `format(d, { timeZone })` for display.
|
|
122
|
+
- `diff` uses `Math.trunc` (not round) — 23h59 = 0 days, not 1.
|
|
123
|
+
- No timezone DB polyfill — if `Intl.supportedValuesOf` is unavailable, `zones()` returns a minimal hardcoded list.
|
|
124
|
+
|
|
125
|
+
## See also
|
|
126
|
+
|
|
127
|
+
- [scheduler](../timing/scheduler.md) — cron + time intervals
|
|
128
|
+
- [i18n](../i18n/i18n.md) — localisation (Intl.MessageFormat, plurals)
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# IO / Timing
|
|
2
|
+
|
|
3
|
+
Low-level temporal primitives: monotonic clock, rate limiting, scheduling.
|
|
4
|
+
|
|
5
|
+
| Module | Returns | Deps | Description |
|
|
6
|
+
|--------|----------|------|-------------|
|
|
7
|
+
| [clock](./clock.md) | `{now, monotonic, since, iso, format}` | none | Monotonic clock — replacement for `performance.now()`, human formatting |
|
|
8
|
+
| [rateLimit](./rateLimit.md) | `{debounce, throttle}` | none | Debounce and throttle (lodash-compat) |
|
|
9
|
+
| [scheduler](./scheduler.md) | `{cron, interval, job}` | none | Cron expressions + interval + job scheduler |
|
|
10
|
+
|
|
11
|
+
## Common pattern
|
|
12
|
+
|
|
13
|
+
```js
|
|
14
|
+
const clock = runtime.resolve('clock');
|
|
15
|
+
const rateLimit = runtime.resolve('rateLimit');
|
|
16
|
+
const scheduler = runtime.resolve('scheduler');
|
|
17
|
+
|
|
18
|
+
// Monotonic clock
|
|
19
|
+
const t0 = clock.monotonic();
|
|
20
|
+
// ... operation ...
|
|
21
|
+
console.log(clock.format(clock.since(t0))); // e.g. "12.3 ms"
|
|
22
|
+
|
|
23
|
+
// Debounce
|
|
24
|
+
const debouncedFn = rateLimit.debounce(fn, 300);
|
|
25
|
+
|
|
26
|
+
// Throttle
|
|
27
|
+
const throttledFn = rateLimit.throttle(fn, 100);
|
|
28
|
+
|
|
29
|
+
// Cron job
|
|
30
|
+
const job = scheduler.job('0 * * * *', () => doHourlyTask());
|
|
31
|
+
job.start();
|
|
32
|
+
```
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: clock
|
|
3
|
+
category: io/timing
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# clock
|
|
11
|
+
|
|
12
|
+
> Horloge monotonique + wall-clock — replacement de `performance.now()`.
|
|
13
|
+
|
|
14
|
+
**Module** `clock` | **Source** `packages/front/fw/src/io/timing/clock.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
`performance.now()` is blocked by `sanity/base.js` in this framework. `clock` provides the same use cases: timestamping, interval measurement and human-readable formatting, at 1 ms resolution (`Date.now()`).
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const clock = runtime.resolve('clock');
|
|
22
|
+
// Returns: { now, monotonic, since, iso, format }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `now` | `() => number` | Milliseconds since epoch (wall-clock, may jump on NTP/DST) |
|
|
30
|
+
| `monotonic` | `() => number` | Non-decreasing milliseconds (flattened if wall-clock goes backward) |
|
|
31
|
+
| `since` | `(t0: number) => number` | `Math.max(0, monotonic() - t0)` — elapsed time in ms |
|
|
32
|
+
| `iso` | `() => string` | Snapshot `new Date().toISOString()` |
|
|
33
|
+
| `format` | `(ms: number) => string` | Human-readable duration: `'0.123 ms'` / `'12.3 ms'` / `'1.234 s'` / `'2.50 min'` / `'1.25 h'` |
|
|
34
|
+
|
|
35
|
+
### `clock.format(ms)` — thresholds
|
|
36
|
+
|
|
37
|
+
| Absolute value | Format | Example |
|
|
38
|
+
|----------------|--------|---------|
|
|
39
|
+
| < 1 ms | `N.NNN ms` | `'0.500 ms'` |
|
|
40
|
+
| 1 – 999 ms | `N.N ms` | `'12.3 ms'` |
|
|
41
|
+
| 1 s – 59 s | `N.NNN s` | `'1.234 s'` |
|
|
42
|
+
| 1 min – 59 min | `N.NN min` | `'2.50 min'` |
|
|
43
|
+
| ≥ 1 h | `N.NN h` | `'1.25 h'` |
|
|
44
|
+
|
|
45
|
+
`ms` non-finite (NaN, Infinity) → returns `String(ms)`.
|
|
46
|
+
|
|
47
|
+
## Examples
|
|
48
|
+
|
|
49
|
+
### Basic duration measurement
|
|
50
|
+
|
|
51
|
+
```js
|
|
52
|
+
const clock = runtime.resolve('clock');
|
|
53
|
+
|
|
54
|
+
const t0 = clock.monotonic();
|
|
55
|
+
await doWork();
|
|
56
|
+
console.log('Duration:', clock.format(clock.since(t0)));
|
|
57
|
+
// e.g. "Duration: 42.3 ms"
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### ISO timestamp for logs
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
console.log(clock.iso(), 'operation complete');
|
|
64
|
+
// "2024-01-15T10:30:00.123Z operation complete"
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Monotonic vs wall-clock
|
|
68
|
+
|
|
69
|
+
```js
|
|
70
|
+
// For absolute timestamps (logs, events)
|
|
71
|
+
const wallTs = clock.now(); // may jump if NTP adjusts
|
|
72
|
+
|
|
73
|
+
// For measuring intervals (performance, timers)
|
|
74
|
+
const mono = clock.monotonic(); // never decreases
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Worker Usage
|
|
78
|
+
|
|
79
|
+
```js
|
|
80
|
+
const worker = fw.createWorker(
|
|
81
|
+
function ({ libs, args }) {
|
|
82
|
+
const t0 = libs.clock.monotonic();
|
|
83
|
+
// processing...
|
|
84
|
+
const elapsed = libs.clock.since(t0);
|
|
85
|
+
self.postMessage({ elapsed, formatted: libs.clock.format(elapsed) });
|
|
86
|
+
},
|
|
87
|
+
{ dependencies: ['clock'] }
|
|
88
|
+
);
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
## Notes
|
|
92
|
+
|
|
93
|
+
- **1 ms resolution** (`Date.now()`) — lower precision than `performance.now()` (sub-ms) but consistent across all runtimes (browser, Node, Bun, Worker).
|
|
94
|
+
- `monotonic()` flattened if wall-clock goes backward (NTP, DST): the returned value stays stable until the wall-clock catches up.
|
|
95
|
+
- `since(t0)` returns `0` if `t0` is after the call (guard against accidental future `t0`).
|
|
96
|
+
- `format` is designed for human display, not algorithmic comparisons.
|
|
97
|
+
|
|
98
|
+
## See also
|
|
99
|
+
|
|
100
|
+
- [rateLimit](./rateLimit.md) — time-based debounce/throttle
|
|
101
|
+
- [scheduler](./scheduler.md) — cron + interval + job scheduler
|
|
102
|
+
- [atomics](../sync/atomics.md) — cross-worker synchronization with `SharedArrayBuffer`
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: rateLimit
|
|
3
|
+
category: io/timing
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# rateLimit
|
|
11
|
+
|
|
12
|
+
> Lodash-compatible debounce and throttle — limits the call frequency of a function.
|
|
13
|
+
|
|
14
|
+
**Module** `rateLimit` | **Source** `packages/front/fw/src/io/timing/rateLimit.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
Groups two classic time-based primitives: `debounce` (delay the call until calls stop) and `throttle` (at most one call per window). API close to lodash for common options.
|
|
17
|
+
|
|
18
|
+
## Resolve
|
|
19
|
+
|
|
20
|
+
```js
|
|
21
|
+
const rateLimit = runtime.resolve('rateLimit');
|
|
22
|
+
// Returns: { debounce, throttle }
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## API
|
|
26
|
+
|
|
27
|
+
| Method | Signature | Returns |
|
|
28
|
+
|--------|-----------|---------|
|
|
29
|
+
| `debounce` | `(fn, delay, options?) => DebouncedFn` | Wrapped function |
|
|
30
|
+
| `throttle` | `(fn, interval, options?) => ThrottledFn` | Wrapped function |
|
|
31
|
+
|
|
32
|
+
All wrapped functions expose:
|
|
33
|
+
|
|
34
|
+
| Method | Signature | Returns |
|
|
35
|
+
|--------|-----------|---------|
|
|
36
|
+
| `.cancel()` | `() => void` | Cancels the pending call |
|
|
37
|
+
| `.flush()` | `() => any` | Executes immediately if pending |
|
|
38
|
+
| `.pending()` | `() => boolean` | `true` if a call is pending |
|
|
39
|
+
|
|
40
|
+
### `rateLimit.debounce(fn, delay, options?)`
|
|
41
|
+
|
|
42
|
+
Delays execution of `fn` until `delay` ms have elapsed with no new call.
|
|
43
|
+
|
|
44
|
+
- `delay`: number **> 0**; throws otherwise.
|
|
45
|
+
- `fn` non-function: throws.
|
|
46
|
+
- Return value of the wrapped call: `undefined` (asynchronous). To retrieve the result, use `.flush()`.
|
|
47
|
+
- `this` is preserved.
|
|
48
|
+
|
|
49
|
+
### Options `debounce`
|
|
50
|
+
|
|
51
|
+
| Option | Type | Default | Description |
|
|
52
|
+
|--------|------|---------|-------------|
|
|
53
|
+
| `leading` | `boolean` | `false` | Call on the rising edge (first call immediate) |
|
|
54
|
+
| `trailing` | `boolean` | `true` | Call after the quiet period |
|
|
55
|
+
| `maxWait` | `number` | `undefined` | Max duration before forcing the call (continuous streams) |
|
|
56
|
+
|
|
57
|
+
### `rateLimit.throttle(fn, interval, options?)`
|
|
58
|
+
|
|
59
|
+
Guarantees at most one call per `interval` ms window.
|
|
60
|
+
|
|
61
|
+
- `interval`: number **> 0**; throws otherwise.
|
|
62
|
+
- `leading: false, trailing: false` is invalid → throws.
|
|
63
|
+
- Implemented via `debounce` with `maxWait = interval`.
|
|
64
|
+
|
|
65
|
+
### Options `throttle`
|
|
66
|
+
|
|
67
|
+
| Option | Type | Default | Description |
|
|
68
|
+
|--------|------|---------|-------------|
|
|
69
|
+
| `leading` | `boolean` | `true` | Fire at the start of the window |
|
|
70
|
+
| `trailing` | `boolean` | `true` | Fire at the end of the window if calls were missed |
|
|
71
|
+
|
|
72
|
+
## Examples
|
|
73
|
+
|
|
74
|
+
### Debounce an input (wait for typing to stop)
|
|
75
|
+
|
|
76
|
+
```js
|
|
77
|
+
const rateLimit = runtime.resolve('rateLimit');
|
|
78
|
+
|
|
79
|
+
const search = rateLimit.debounce((query) => {
|
|
80
|
+
fetchResults(query);
|
|
81
|
+
}, 300);
|
|
82
|
+
|
|
83
|
+
inputEl.addEventListener('input', e => search(e.target.value));
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
### Throttle a scroll handler (at most 1 call / 100 ms)
|
|
87
|
+
|
|
88
|
+
```js
|
|
89
|
+
const updateUI = rateLimit.throttle(() => {
|
|
90
|
+
const y = window.scrollY;
|
|
91
|
+
headerEl.classList.toggle('scrolled', y > 50);
|
|
92
|
+
}, 100);
|
|
93
|
+
|
|
94
|
+
window.addEventListener('scroll', updateUI, { passive: true });
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
### Cancel and flush in a cleanup
|
|
98
|
+
|
|
99
|
+
```js
|
|
100
|
+
const debouncedSave = rateLimit.debounce(saveToServer, 1000);
|
|
101
|
+
|
|
102
|
+
// In a component destroy:
|
|
103
|
+
function cleanup() {
|
|
104
|
+
debouncedSave.flush(); // immediate save if pending
|
|
105
|
+
debouncedSave.cancel(); // cancel all future calls
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
## Worker Usage
|
|
110
|
+
|
|
111
|
+
```js
|
|
112
|
+
const worker = fw.createWorker(
|
|
113
|
+
function ({ libs, args }) {
|
|
114
|
+
const throttled = libs.rateLimit.throttle(
|
|
115
|
+
(msg) => self.postMessage({ processed: msg }),
|
|
116
|
+
50
|
|
117
|
+
);
|
|
118
|
+
// Throttle postMessage calls from a high-frequency worker
|
|
119
|
+
for (const item of args) throttled(item);
|
|
120
|
+
throttled.flush();
|
|
121
|
+
},
|
|
122
|
+
{ dependencies: ['rateLimit'], args: dataStream }
|
|
123
|
+
);
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
## Notes
|
|
127
|
+
|
|
128
|
+
- Uses `setTimeout`/`clearTimeout` only — no `setImmediate`, no `requestAnimationFrame`.
|
|
129
|
+
- The return value of the wrapped call is always `undefined` except via `.flush()`.
|
|
130
|
+
- `this` is preserved: `obj.method = debounce(fn, 100); obj.method()` → `fn` sees `this === obj`.
|
|
131
|
+
- Difference vs lodash: `.pending()` returns `boolean` (lodash does not expose `.pending()`).
|
|
132
|
+
- For logical backpressure (HTTP rate limiting) → prefer [`tokenBucket`](../sync/tokenBucket.md).
|
|
133
|
+
|
|
134
|
+
## See also
|
|
135
|
+
|
|
136
|
+
- [scheduler](./scheduler.md) — cron + interval + job scheduler
|
|
137
|
+
- [tokenBucket](../sync/tokenBucket.md) — token bucket rate limiter (HTTP, backpressure)
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: scheduler
|
|
3
|
+
category: io/timing
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# scheduler
|
|
11
|
+
|
|
12
|
+
> 5-field cron parser + interval wrapper + job scheduler.
|
|
13
|
+
|
|
14
|
+
**Module** `scheduler` | **Source** `packages/front/fw/src/io/timing/scheduler.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const scheduler = runtime.resolve('scheduler');
|
|
20
|
+
// Returns: { cron, interval, job }
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
### `scheduler.cron(expression)` → CronInstance
|
|
26
|
+
|
|
27
|
+
Parses a 5-field cron expression. Throws `Error('scheduler: invalid cron expression …')` on invalid input.
|
|
28
|
+
|
|
29
|
+
| Method | Signature | Returns |
|
|
30
|
+
|--------|-----------|---------|
|
|
31
|
+
| `next` | `(from?: Date) => Date` | Next date strictly after `from` |
|
|
32
|
+
| `nextN` | `(n: number, from?: Date) => Date[]` | N next dates in ascending order |
|
|
33
|
+
| `matches` | `(date: Date) => boolean` | `true` if the date satisfies the expression |
|
|
34
|
+
| `expression` | `string` | Original expression |
|
|
35
|
+
| `fields` | `object` | Value sets for each field |
|
|
36
|
+
|
|
37
|
+
**Fields and ranges:**
|
|
38
|
+
|
|
39
|
+
| Field | Position | Range |
|
|
40
|
+
|-------|----------|-------|
|
|
41
|
+
| minute | 1st | 0–59 |
|
|
42
|
+
| hour | 2nd | 0–23 |
|
|
43
|
+
| day (of month) | 3rd | 1–31 |
|
|
44
|
+
| month | 4th | 1–12 |
|
|
45
|
+
| weekday | 5th | 0–6 (0 = Sunday) |
|
|
46
|
+
|
|
47
|
+
**Syntax accepted per field:**
|
|
48
|
+
|
|
49
|
+
| Pattern | Example | Meaning |
|
|
50
|
+
|---------|---------|---------|
|
|
51
|
+
| `*` | `*` | Any value |
|
|
52
|
+
| `N` | `5` | Fixed value |
|
|
53
|
+
| `N-M` | `9-17` | Range |
|
|
54
|
+
| `*/S` | `*/15` | Every S values |
|
|
55
|
+
| `N-M/S` | `0-30/5` | Range with step |
|
|
56
|
+
| `A,B,…` | `0,15,30,45` | List |
|
|
57
|
+
|
|
58
|
+
**day/weekday semantics:** if both fields are non-`*`, fires if **either** matches (standard cron behavior).
|
|
59
|
+
|
|
60
|
+
**Horizon:** if no date matches within the next 5 years → throws `'scheduler: no firing in 5y horizon'`.
|
|
61
|
+
|
|
62
|
+
### `scheduler.interval(callback, ms)` → IntervalInstance
|
|
63
|
+
|
|
64
|
+
| Method | Description |
|
|
65
|
+
|--------|-------------|
|
|
66
|
+
| `start()` | Starts the interval (idempotent) |
|
|
67
|
+
| `stop()` | Stops (idempotent) |
|
|
68
|
+
| `running` | getter `boolean` |
|
|
69
|
+
|
|
70
|
+
`start()` does not fire automatically on construction — explicit call required.
|
|
71
|
+
|
|
72
|
+
### `scheduler.job(expression, callback)` → JobInstance
|
|
73
|
+
|
|
74
|
+
| Method/Prop | Description |
|
|
75
|
+
|-------------|-------------|
|
|
76
|
+
| `start()` | Schedules the next firing, idempotent |
|
|
77
|
+
| `stop()` | Cancels the pending firing |
|
|
78
|
+
| `running` | getter `boolean` |
|
|
79
|
+
| `next` | getter `Date \| null` — next scheduled firing |
|
|
80
|
+
| `expression` | getter `string` |
|
|
81
|
+
|
|
82
|
+
- Missed firings (machine asleep) are **ignored** — no catch-up.
|
|
83
|
+
- If `callback` throws: log + continue (the job does not stop).
|
|
84
|
+
|
|
85
|
+
## Non-features (explicit)
|
|
86
|
+
|
|
87
|
+
- **No timezone**: uses the context's local `Date`.
|
|
88
|
+
- **No seconds field**: throws on 6 fields with a clear message.
|
|
89
|
+
- **No Quartz extensions**: `L`, `W`, `#`, `?` are not supported.
|
|
90
|
+
- **No catch-up** on missed firings.
|
|
91
|
+
- **No job pool** (dynamic add/remove): that belongs in `lib/`.
|
|
92
|
+
|
|
93
|
+
## Examples
|
|
94
|
+
|
|
95
|
+
### Cron — next firing
|
|
96
|
+
|
|
97
|
+
```js
|
|
98
|
+
const scheduler = runtime.resolve('scheduler');
|
|
99
|
+
const c = scheduler.cron('0 9 * * 1-5'); // Monday–Friday at 09:00
|
|
100
|
+
|
|
101
|
+
const next = c.next();
|
|
102
|
+
console.log('Next firing:', next.toLocaleString());
|
|
103
|
+
console.log('Following firings:', c.nextN(5));
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
### Simple interval
|
|
107
|
+
|
|
108
|
+
```js
|
|
109
|
+
const it = scheduler.interval(() => checkHealth(), 30_000);
|
|
110
|
+
it.start();
|
|
111
|
+
|
|
112
|
+
// Later
|
|
113
|
+
it.stop();
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### Cron job
|
|
117
|
+
|
|
118
|
+
```js
|
|
119
|
+
const job = scheduler.job('*/5 * * * *', async () => {
|
|
120
|
+
await syncData();
|
|
121
|
+
});
|
|
122
|
+
job.start();
|
|
123
|
+
|
|
124
|
+
// Show the next firing
|
|
125
|
+
console.log('Next:', job.next);
|
|
126
|
+
|
|
127
|
+
// Stop
|
|
128
|
+
job.stop();
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Pre-display check
|
|
132
|
+
|
|
133
|
+
```js
|
|
134
|
+
const c = scheduler.cron('0 12 * * *');
|
|
135
|
+
const upcoming = c.nextN(7); // next 7 noons
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
## Worker Usage
|
|
139
|
+
|
|
140
|
+
```js
|
|
141
|
+
const worker = fw.createWorker(
|
|
142
|
+
async function ({ libs }) {
|
|
143
|
+
const s = libs.scheduler;
|
|
144
|
+
const job = s.job('*/10 * * * *', () => {
|
|
145
|
+
// batch processing in the worker, without blocking the main thread
|
|
146
|
+
});
|
|
147
|
+
job.start();
|
|
148
|
+
},
|
|
149
|
+
{ dependencies: ['scheduler'] }
|
|
150
|
+
);
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## Notes
|
|
154
|
+
|
|
155
|
+
- The module uses `setTimeout` (not `setInterval`) for jobs — each firing recomputes the next one.
|
|
156
|
+
- `next()` uses an optimized search (jumps by month/day/hour) — not a minute-by-minute loop over 5 years.
|
|
157
|
+
- Local `Date`: in a browser context, cron hours correspond to the user's local timezone. In a worker, same timezone as the main thread.
|
|
158
|
+
|
|
159
|
+
## See also
|
|
160
|
+
|
|
161
|
+
- [rateLimit](./rateLimit.md) — debounce and throttle
|
|
162
|
+
- [abort](../sync/abort.md) — combine with job for timeout
|
|
163
|
+
- [cancellable](../sync/cancellable.md) — async task cancellation
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# IO / Utils
|
|
2
|
+
|
|
3
|
+
General utilities: application pub/sub, binary data manipulation, validation, reactive signals, error handling, identifiers.
|
|
4
|
+
|
|
5
|
+
| Module | Returns | Deps | Description |
|
|
6
|
+
|--------|----------|------|-------------|
|
|
7
|
+
| [eventBus](./eventBus.md) | `{create}` | none | Typed application pub/sub by topic (sticky, wildcards, scopes) |
|
|
8
|
+
| [queue](./queue.md) | Constructor `Queue` | none | Queue with configurable concurrency |
|
|
9
|
+
| [bitmap](./bitmap.md) | `{bytesToBits, bitsToBytes, padBitsToByte}` | none | Bits ↔ bytes conversion (LSB-first) |
|
|
10
|
+
| [valid](./valid.md) | `{is, isNumber, isString, validate, test, compile, formats}` | none | Type guards + JSON Schema validation (draft 2020-12 subset) |
|
|
11
|
+
| [ui8](./ui8.md) | `{equal, join, concat}` | none | Uint8Array utilities (comparison, concatenation) |
|
|
12
|
+
| [errors](./errors.md) | `{logger, guard, boundary}` | none | Structured logger, execution guard, UI boundary |
|
|
13
|
+
| [signal](./signal.md) | `{create, derived, batch, untrack, effect, resource, derivedAsync, computed, scheduleNotify, flushSync, inspectGraph}` | none | Lightweight reactive signals — mutable cells with subscriptions, derivations and a read-only dependency-graph snapshot |
|
|
14
|
+
|
|
15
|
+
> The `uuid` module is documented under [`crypto/utils/uuid`](../../crypto/utils/uuid.md) — its source lives in `src/crypto/utils/` because it depends on `crypto.getRandomValues`.
|
|
16
|
+
|
|
17
|
+
## Common pattern
|
|
18
|
+
|
|
19
|
+
```js
|
|
20
|
+
const eventBus = runtime.resolve('eventBus');
|
|
21
|
+
const bus = eventBus.create();
|
|
22
|
+
bus.on('app:ready', () => console.log('ready'));
|
|
23
|
+
bus.emit('app:ready');
|
|
24
|
+
|
|
25
|
+
const signal = runtime.resolve('signal');
|
|
26
|
+
const count = signal.create(0);
|
|
27
|
+
const stop = signal.effect(() => console.log('count =', count.get()));
|
|
28
|
+
count.set(1); // logs: count = 1
|
|
29
|
+
stop();
|
|
30
|
+
```
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
module: bitmap
|
|
3
|
+
category: io/utils
|
|
4
|
+
dependencies: []
|
|
5
|
+
returns: object
|
|
6
|
+
worker-safe: true
|
|
7
|
+
status: complete
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# bitmap
|
|
11
|
+
|
|
12
|
+
> Bits ↔ bytes conversion. LSB-first per byte (bit 0 = least significant bit).
|
|
13
|
+
|
|
14
|
+
**Module** `bitmap` | **Source** `packages/front/fw/src/io/utils/bitmap.js` | **Deps** none | **Worker-safe** yes
|
|
15
|
+
|
|
16
|
+
## Resolve
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
const bitmap = runtime.resolve('bitmap');
|
|
20
|
+
// Returns: { bytesToBits, bitsToBytes, padBitsToByte }
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## API
|
|
24
|
+
|
|
25
|
+
| Method | Signature | Description |
|
|
26
|
+
|--------|-----------|-------------|
|
|
27
|
+
| `bytesToBits` | `(ui8a: Uint8Array, ret?) => number[]` | Bytes → bit array (0/1), LSB-first |
|
|
28
|
+
| `bitsToBytes` | `(ba: number[], ret?, validate?) => Uint8Array` | Bits → bytes (length must be a multiple of 8) |
|
|
29
|
+
| `padBitsToByte` | `(arr: number[]) => number[]` | Pads to a multiple of 8 with zeros |
|
|
30
|
+
|
|
31
|
+
### `bitmap.bytesToBits(ui8a)`
|
|
32
|
+
|
|
33
|
+
LSB-first: byte `0b00000011` = `[1,1,0,0,0,0,0,0]`
|
|
34
|
+
|
|
35
|
+
```js
|
|
36
|
+
bitmap.bytesToBits(new Uint8Array([3])); // [1,1,0,0,0,0,0,0]
|
|
37
|
+
bitmap.bytesToBits(new Uint8Array([255])); // [1,1,1,1,1,1,1,1]
|
|
38
|
+
bitmap.bytesToBits(new Uint8Array([1,2])); // [1,0,0,0,0,0,0,0, 0,1,0,0,0,0,0,0]
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### `bitmap.bitsToBytes(ba, ret?, validate?)`
|
|
42
|
+
|
|
43
|
+
```js
|
|
44
|
+
bitmap.bitsToBytes([1,1,0,0,0,0,0,0]); // Uint8Array [3]
|
|
45
|
+
bitmap.bitsToBytes([0,1,0,0,0,0,0,0]); // Uint8Array [2]
|
|
46
|
+
|
|
47
|
+
// Strict length validation
|
|
48
|
+
bitmap.bitsToBytes([1,0,0,0,0,0,0], null, true); // throws — length 7
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
### `bitmap.padBitsToByte(arr)`
|
|
52
|
+
|
|
53
|
+
Modifies `arr` in place and returns it:
|
|
54
|
+
|
|
55
|
+
```js
|
|
56
|
+
const bits = [1, 0, 1]; // length 3
|
|
57
|
+
bitmap.padBitsToByte(bits); // → [1, 0, 1, 0, 0, 0, 0, 0] (5 zeros added)
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Examples
|
|
61
|
+
|
|
62
|
+
```js
|
|
63
|
+
const bitmap = runtime.resolve('bitmap');
|
|
64
|
+
|
|
65
|
+
// Round-trip
|
|
66
|
+
const bytes = new Uint8Array([42, 255, 0]);
|
|
67
|
+
const bits = bitmap.bytesToBits(bytes);
|
|
68
|
+
bitmap.padBitsToByte(bits); // ensure multiple of 8
|
|
69
|
+
const back = bitmap.bitsToBytes(bits);
|
|
70
|
+
// back ≡ bytes
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
## Worker Usage
|
|
74
|
+
|
|
75
|
+
```js
|
|
76
|
+
const worker = fw.createWorker(
|
|
77
|
+
function ({ libs, args }) {
|
|
78
|
+
const bits = libs.bitmap.bytesToBits(args.bytes);
|
|
79
|
+
libs.bitmap.padBitsToByte(bits);
|
|
80
|
+
const back = libs.bitmap.bitsToBytes(bits);
|
|
81
|
+
self.postMessage(back);
|
|
82
|
+
},
|
|
83
|
+
{ dependencies: ['bitmap'], args: { bytes: new Uint8Array([42, 255]) } }
|
|
84
|
+
);
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## Notes
|
|
88
|
+
|
|
89
|
+
- **LSB-first** order: bit 0 (least significant) is the first element of the array.
|
|
90
|
+
- `padBitsToByte`: no-op if length is already a multiple of 8.
|
|
91
|
+
- `bitsToBytes` with `validate=true`: throws if length is not a multiple of 8.
|
|
92
|
+
- Pre-computed lookup table (256 entries) for conversions.
|
|
93
|
+
|
|
94
|
+
## See also
|
|
95
|
+
|
|
96
|
+
- [ui8](./ui8.md) — general Uint8Array utilities
|