@awacloud/fw 0.1.0 → 1.0.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 +125 -0
- package/NOTICE +8 -0
- package/README.md +163 -31
- package/dist/build/fw.core.pure.meta.json +6 -6
- package/dist/build/fw.core.pure.min.js +15 -12
- package/dist/build/fw.full.pure.meta.json +13 -7
- package/dist/build/fw.full.pure.min.js +45 -42
- package/dist/build/fw.minimal.pure.meta.json +6 -6
- package/dist/build/fw.minimal.pure.min.js +16 -13
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
- package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
- package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
- package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
- package/dist/build/fw.pwa.pure.meta.json +7 -6
- package/dist/build/fw.pwa.pure.min.js +38 -35
- package/dist/build/fw.site-interactive.pure.meta.json +6 -6
- package/dist/build/fw.site-interactive.pure.min.js +37 -34
- package/dist/build/fw.site.pure.meta.json +6 -6
- package/dist/build/fw.site.pure.min.js +24 -21
- package/dist/build/fw.spa.pure.meta.json +8 -7
- package/dist/build/fw.spa.pure.min.js +41 -38
- package/dist/build/sanity-base-classic.min.js +1 -1
- package/dist/build/sanity.min.js +1 -1
- package/dist/types/core/internal.d.ts +29 -0
- package/dist/types/core/internal.d.ts.map +1 -0
- package/dist/types/core/logger.d.ts +23 -4
- package/dist/types/core/logger.d.ts.map +1 -1
- package/dist/types/core/modules.d.ts +374 -61
- package/dist/types/core/modules.d.ts.map +1 -1
- package/dist/types/core/runtime.d.ts +10 -6
- package/dist/types/core/runtime.d.ts.map +1 -1
- package/dist/types/core/worker-helper.d.ts +35 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -1
- package/dist/types/crypto/cipher/aes.d.ts +1 -7
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
- package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
- package/dist/types/crypto/hash/argon2.d.ts +0 -15
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha224.d.ts +1 -1
- package/dist/types/crypto/hash/sha256.d.ts +4 -13
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
- package/dist/types/crypto/hash/sha384.d.ts +1 -1
- package/dist/types/crypto/hash/sha512.d.ts +4 -13
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
- package/dist/types/crypto/mode/cmac.d.ts +0 -6
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
- package/dist/types/crypto/mode/ctr.d.ts +0 -6
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
- package/dist/types/crypto/mode/gcm.d.ts +0 -9
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ecc.d.ts +0 -1
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
- package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
- package/dist/types/crypto/pkc/rsa.d.ts +0 -24
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
- package/dist/types/crypto/pkc/x25519.d.ts +0 -6
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
- package/dist/types/crypto/utils/bitArray.d.ts +0 -8
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
- package/dist/types/crypto/utils/jws.d.ts +6 -14
- package/dist/types/crypto/utils/jws.d.ts.map +1 -1
- package/dist/types/crypto/utils/keyformat.d.ts +52 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
- package/dist/types/crypto/utils/random.d.ts +1 -10
- package/dist/types/crypto/utils/random.d.ts.map +1 -1
- package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
- package/dist/types/crypto/utils/x509.d.ts +397 -0
- package/dist/types/crypto/utils/x509.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +2 -1
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
- package/dist/types/crypto/wasm/runtime.d.ts +13 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
- package/dist/types/dom/fs/fileIntake.d.ts +59 -0
- package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
- package/dist/types/dom/query/dnd.d.ts.map +1 -1
- package/dist/types/dom/query/sound.d.ts +89 -0
- package/dist/types/dom/query/sound.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -1
- package/dist/types/dom/rendering/component.d.ts +9 -3
- package/dist/types/dom/rendering/component.d.ts.map +1 -1
- package/dist/types/dom/rendering/parser.d.ts +39 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -1
- package/dist/types/dom/rendering/render.d.ts.map +1 -1
- package/dist/types/dom/rendering/sanitize.d.ts +4 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
- package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
- package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +9 -3
- package/dist/types/dom/rendering/template.d.ts.map +1 -1
- package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
- package/dist/types/dom/rendering/uiSession.d.ts +18 -6
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
- package/dist/types/dom/sw/installPrompt.d.ts +89 -0
- package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
- package/dist/types/dom/sw/precache.d.ts +149 -0
- package/dist/types/dom/sw/precache.d.ts.map +1 -0
- package/dist/types/dom/sw/swUpdate.d.ts +129 -0
- package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +8 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
- package/dist/types/dom/utils/route.d.ts.map +1 -1
- package/dist/types/dom/utils/ua.d.ts +2 -2
- package/dist/types/dom/utils/ua.d.ts.map +1 -1
- package/dist/types/io/calc/crc32.d.ts.map +1 -1
- package/dist/types/io/codec/b64.d.ts +24 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -1
- package/dist/types/io/codec/cbor.d.ts +1 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -1
- package/dist/types/io/codec/hex.d.ts.map +1 -1
- package/dist/types/io/codec/msgpack.d.ts +1 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -1
- package/dist/types/io/codec/url.d.ts +3 -1
- package/dist/types/io/codec/url.d.ts.map +1 -1
- package/dist/types/io/codec/utf8.d.ts.map +1 -1
- package/dist/types/io/compress/bitstream.d.ts +1 -1
- package/dist/types/io/compress/brotli.d.ts +0 -1
- package/dist/types/io/compress/brotli.d.ts.map +1 -1
- package/dist/types/io/compress/brotli_shared.d.ts +0 -4
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
- package/dist/types/io/compress/deflate.d.ts +14 -1
- package/dist/types/io/compress/deflate.d.ts.map +1 -1
- package/dist/types/io/compress/gzip.d.ts +4 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -1
- package/dist/types/io/compress/huffman.d.ts +7 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -1
- package/dist/types/io/compress/lz4.d.ts +4 -2
- package/dist/types/io/compress/lz4.d.ts.map +1 -1
- package/dist/types/io/compress/lz77.d.ts +17 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -1
- package/dist/types/io/compress/lzw.d.ts +2 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -1
- package/dist/types/io/compress/zip.d.ts.map +1 -1
- package/dist/types/io/compress/zlib.d.ts +9 -2
- package/dist/types/io/compress/zlib.d.ts.map +1 -1
- package/dist/types/io/math/linalg.d.ts.map +1 -1
- package/dist/types/process/rpc.d.ts.map +1 -1
- package/dist/types/process/workerPool.d.ts.map +1 -1
- package/dist/types/sanity/base.d.ts +12 -2
- package/dist/types/sanity/base.d.ts.map +1 -1
- package/dist/types/sanity/lockdown.d.ts +6 -5
- package/dist/types/sanity/lockdown.d.ts.map +1 -1
- package/dist/types/sanity/wasm-gate.d.ts +1 -1
- package/docs/README.md +17 -10
- package/docs/api/README.md +5 -5
- package/docs/api/core/logger.md +2 -1
- package/docs/api/core/modules.md +3 -3
- package/docs/api/core/runtime.md +9 -9
- package/docs/api/core/worker-helper.md +12 -2
- package/docs/api/crypto/README.md +1 -1
- package/docs/api/crypto/cipher/README.md +2 -2
- package/docs/api/crypto/cipher/aes.md +5 -10
- package/docs/api/crypto/cipher/chacha20.md +3 -8
- package/docs/api/crypto/hash/README.md +5 -5
- package/docs/api/crypto/hash/adf.md +21 -11
- package/docs/api/crypto/hash/argon2.md +3 -12
- package/docs/api/crypto/hash/blake2b.md +12 -14
- package/docs/api/crypto/hash/pbkdf2.md +1 -1
- package/docs/api/crypto/hash/sha224.md +2 -2
- package/docs/api/crypto/hash/sha256.md +4 -4
- package/docs/api/crypto/hash/sha3.md +2 -2
- package/docs/api/crypto/hash/sha384.md +1 -1
- package/docs/api/crypto/hash/sha512.md +5 -5
- package/docs/api/crypto/hash/sha512_224.md +1 -1
- package/docs/api/crypto/hash/sha512_256.md +1 -1
- package/docs/api/crypto/mode/README.md +3 -3
- package/docs/api/crypto/mode/cbc.md +2 -2
- package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
- package/docs/api/crypto/mode/cmac.md +4 -4
- package/docs/api/crypto/mode/ctr.md +2 -3
- package/docs/api/crypto/mode/gcm.md +5 -5
- package/docs/api/crypto/mode/kw.md +4 -4
- package/docs/api/crypto/pkc/README.md +8 -8
- package/docs/api/crypto/pkc/ecc.md +19 -17
- package/docs/api/crypto/pkc/ed25519.md +10 -15
- package/docs/api/crypto/pkc/hybridKem.md +8 -2
- package/docs/api/crypto/pkc/hybridSign.md +34 -7
- package/docs/api/crypto/pkc/ml_dsa.md +20 -19
- package/docs/api/crypto/pkc/ml_kem.md +3 -3
- package/docs/api/crypto/pkc/rsa.md +7 -9
- package/docs/api/crypto/pkc/slh_dsa.md +12 -12
- package/docs/api/crypto/pkc/x25519.md +5 -4
- package/docs/api/crypto/utils/README.md +7 -7
- package/docs/api/crypto/utils/aes_modes.md +2 -5
- package/docs/api/crypto/utils/asn1.md +25 -16
- package/docs/api/crypto/utils/jws.md +6 -4
- package/docs/api/crypto/utils/keyformat.md +24 -15
- package/docs/api/crypto/utils/pad.md +1 -1
- package/docs/api/crypto/utils/pem.md +3 -3
- package/docs/api/crypto/utils/random.md +3 -4
- package/docs/api/crypto/utils/rsaKeygen.md +2 -2
- package/docs/api/crypto/utils/totp.md +2 -2
- package/docs/api/crypto/utils/uuid.md +5 -5
- package/docs/api/crypto/utils/x509.md +124 -0
- package/docs/api/crypto/wasm/aes.md +1 -1
- package/docs/api/crypto/wasm/argon2.md +6 -4
- package/docs/api/crypto/wasm/ml_kem.md +1 -0
- package/docs/api/crypto/wasm/pbkdf2.md +8 -8
- package/docs/api/crypto/wasm/rsa.md +1 -1
- package/docs/api/crypto/wasm/runtime.md +27 -10
- package/docs/api/crypto/webcrypto/aes.md +1 -1
- package/docs/api/crypto/webcrypto/aeskw.md +2 -2
- package/docs/api/crypto/webcrypto/digest.md +3 -5
- package/docs/api/crypto/webcrypto/ecc.md +1 -1
- package/docs/api/crypto/webcrypto/ed25519.md +1 -1
- package/docs/api/crypto/webcrypto/rsa.md +3 -2
- package/docs/api/crypto/webcrypto/x25519.md +1 -1
- package/docs/api/dom/README.md +6 -1
- package/docs/api/dom/fs/README.md +1 -0
- package/docs/api/dom/fs/fileIntake.md +120 -0
- package/docs/api/dom/fs/fsAccess.md +1 -0
- package/docs/api/dom/fs/indexedDB.md +1 -1
- package/docs/api/dom/fs/storage.md +1 -1
- package/docs/api/dom/query/README.md +2 -1
- package/docs/api/dom/query/dnd.md +4 -1
- package/docs/api/dom/query/dom.md +5 -0
- package/docs/api/dom/query/sound.md +103 -0
- package/docs/api/dom/rendering/README.md +4 -3
- package/docs/api/dom/rendering/chart.md +5 -4
- package/docs/api/dom/rendering/component.md +25 -3
- package/docs/api/dom/rendering/parser.md +5 -2
- package/docs/api/dom/rendering/reactiveBind.md +1 -1
- package/docs/api/dom/rendering/render.md +2 -2
- package/docs/api/dom/rendering/sanitize.md +10 -2
- package/docs/api/dom/rendering/secPolicy.md +4 -4
- package/docs/api/dom/rendering/styleSheet.md +85 -0
- package/docs/api/dom/rendering/template.md +20 -5
- package/docs/api/dom/rendering/themeTokens.md +6 -3
- package/docs/api/dom/rendering/uiSession.md +18 -5
- package/docs/api/dom/rendering/virtualScroll.md +2 -2
- package/docs/api/dom/sensors/geolocation.md +1 -1
- package/docs/api/dom/sw/README.md +7 -1
- package/docs/api/dom/sw/cache.md +2 -1
- package/docs/api/dom/sw/installPrompt.md +111 -0
- package/docs/api/dom/sw/precache.md +124 -0
- package/docs/api/dom/sw/serviceWorker.md +4 -2
- package/docs/api/dom/sw/swUpdate.md +112 -0
- package/docs/api/dom/utils/clipboard.md +56 -5
- package/docs/api/dom/utils/entropyCollector.md +1 -1
- package/docs/api/dom/utils/keybindings.md +17 -2
- package/docs/api/dom/utils/leaderElection.md +2 -2
- package/docs/api/dom/utils/route.md +1 -0
- package/docs/api/dom/utils/ua.md +15 -10
- package/docs/api/io/calc/crc32.md +4 -1
- package/docs/api/io/codec/README.md +2 -2
- package/docs/api/io/codec/b64.md +31 -2
- package/docs/api/io/codec/buffer.md +1 -1
- package/docs/api/io/codec/cbor.md +6 -4
- package/docs/api/io/codec/csv.md +178 -178
- package/docs/api/io/codec/hex.md +10 -2
- package/docs/api/io/codec/msgpack.md +4 -3
- package/docs/api/io/codec/url.md +4 -3
- package/docs/api/io/codec/utf8.md +3 -3
- package/docs/api/io/compress/bitstream.md +6 -3
- package/docs/api/io/compress/brotli.md +36 -4
- package/docs/api/io/compress/brotli_shared.md +1 -1
- package/docs/api/io/compress/deflate.md +42 -34
- package/docs/api/io/compress/gzip.md +26 -6
- package/docs/api/io/compress/huffman.md +2 -1
- package/docs/api/io/compress/lz4.md +5 -3
- package/docs/api/io/compress/lz77.md +26 -3
- package/docs/api/io/compress/lzw.md +13 -8
- package/docs/api/io/compress/zip.md +36 -10
- package/docs/api/io/compress/zlib.md +21 -5
- package/docs/api/io/math/linalg.md +1 -1
- package/docs/api/io/utils/valid.md +1 -1
- package/docs/api/process/rpc.md +3 -2
- package/docs/api/process/workerPool.md +1 -1
- package/docs/api/sanity/base.md +9 -5
- package/docs/api/sanity/lockdown.md +7 -6
- package/docs/api/surface.json +12311 -0
- package/docs/api/typed.md +5 -3
- package/docs/dev/README.md +2 -0
- package/docs/dev/bench.md +76 -0
- package/docs/dev/crypto-references.md +54 -0
- package/docs/dev/provenance.md +30 -7
- package/docs/dev/publishing.md +7 -7
- package/docs/dev/runtime.md +1 -1
- package/docs/dev/testing.md +13 -0
- package/docs/evidence/l4-evidence.md +86 -0
- package/docs/evidence/pqc-hybrid-evidence.md +7 -6
- package/docs/guide/README.md +1 -0
- package/docs/guide/_QUICK_REF.md +5 -5
- package/docs/guide/doc-format.md +4 -3
- package/docs/guide/integrations-hmr.md +1 -1
- package/docs/guide/module-creation-workflow.md +8 -8
- package/docs/guide/rendering-pipeline.md +11 -4
- package/docs/guide/security.md +7 -5
- package/docs/guide/stability.md +123 -0
- package/docs/guide/tutorial-todo.md +20 -8
- package/docs/guide/typescript.md +9 -0
- package/docs/guide/worker-confinement.md +30 -17
- package/docs/notes/lz77-deflate-factorization.md +3 -3
- package/docs/tools/README.md +1 -1
- package/docs/tools/bundler.md +3 -3
- package/docs/tools/codegen.md +1 -1
- package/docs/tools/standalone.md +0 -1
- package/fw.config.json +2 -2
- package/integrations/_shared/catalog.generated.json +7 -1
- package/integrations/_shared/core.js +1 -1
- package/integrations/astro/index.js +1 -1
- package/integrations/eslint/README.md +7 -1
- package/integrations/nextjs/index.js +1 -1
- package/integrations/nodejs/README.md +3 -3
- package/integrations/turbopack/index.js +2 -2
- package/integrations/typedoc/categorize.js +1 -1
- package/integrations/typedoc/typedoc.json +2 -1
- package/integrations/vite/index.js +2 -2
- package/integrations/vite/vite-env.d.ts +7 -4
- package/integrations/webpack/index.js +3 -3
- package/package.json +76 -10
- package/src/core/internal.js +31 -0
- package/src/core/logger.js +95 -23
- package/src/core/modules.js +17 -8
- package/src/core/readyState.js +1 -1
- package/src/core/runtime.js +74 -27
- package/src/core/worker-helper.js +83 -4
- package/src/crypto/NIST_CONFORMANCE.md +47 -34
- package/src/crypto/cipher/aes.acvp.md +7 -8
- package/src/crypto/cipher/aes.js +280 -229
- package/src/crypto/cipher/chacha20.acvp.md +6 -7
- package/src/crypto/cipher/chacha20.js +91 -61
- package/src/crypto/hash/adf.js +1 -1
- package/src/crypto/hash/argon2.acvp.md +11 -15
- package/src/crypto/hash/argon2.js +9 -24
- package/src/crypto/hash/blake2b.js +157 -125
- package/src/crypto/hash/hkdf.acvp.md +15 -15
- package/src/crypto/hash/hkdf.js +1 -1
- package/src/crypto/hash/hmac.acvp.md +10 -12
- package/src/crypto/hash/hmac.js +5 -1
- package/src/crypto/hash/pbkdf2.acvp.md +13 -13
- package/src/crypto/hash/pbkdf2.js +36 -8
- package/src/crypto/hash/poly1305.acvp.md +10 -6
- package/src/crypto/hash/poly1305.js +171 -50
- package/src/crypto/hash/sha224.acvp.md +3 -3
- package/src/crypto/hash/sha224.js +4 -4
- package/src/crypto/hash/sha256.acvp.md +2 -2
- package/src/crypto/hash/sha256.js +514 -50
- package/src/crypto/hash/sha3.acvp.md +9 -9
- package/src/crypto/hash/sha3.js +127 -71
- package/src/crypto/hash/sha384.acvp.md +3 -3
- package/src/crypto/hash/sha384.js +4 -4
- package/src/crypto/hash/sha512.acvp.md +7 -8
- package/src/crypto/hash/sha512.js +107 -108
- package/src/crypto/hash/sha512_224.acvp.md +6 -6
- package/src/crypto/hash/sha512_224.js +2 -2
- package/src/crypto/hash/sha512_256.acvp.md +6 -6
- package/src/crypto/hash/sha512_256.js +2 -2
- package/src/crypto/mode/cbc.acvp.md +2 -2
- package/src/crypto/mode/cbc.js +1 -1
- package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
- package/src/crypto/mode/chacha20poly1305.js +3 -3
- package/src/crypto/mode/cmac.acvp.md +5 -5
- package/src/crypto/mode/cmac.js +8 -8
- package/src/crypto/mode/ctr.acvp.md +2 -2
- package/src/crypto/mode/ctr.js +1 -3
- package/src/crypto/mode/gcm.acvp.md +6 -6
- package/src/crypto/mode/gcm.js +7 -7
- package/src/crypto/mode/kw.acvp.md +4 -4
- package/src/crypto/mode/kw.js +5 -5
- package/src/crypto/pkc/ecc.acvp.md +13 -13
- package/src/crypto/pkc/ecc.js +9 -11
- package/src/crypto/pkc/ed25519.acvp.md +30 -34
- package/src/crypto/pkc/ed25519.js +453 -94
- package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
- package/src/crypto/pkc/hybridSign.js +103 -24
- package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
- package/src/crypto/pkc/ml_dsa.js +29 -32
- package/src/crypto/pkc/ml_kem.acvp.md +7 -7
- package/src/crypto/pkc/ml_kem.js +15 -21
- package/src/crypto/pkc/rsa.acvp.md +11 -15
- package/src/crypto/pkc/rsa.js +7 -44
- package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
- package/src/crypto/pkc/slh_dsa.js +16 -18
- package/src/crypto/pkc/x25519.acvp.md +13 -10
- package/src/crypto/pkc/x25519.js +273 -29
- package/src/crypto/utils/aes_modes.acvp.md +1 -2
- package/src/crypto/utils/aes_modes.js +2 -2
- package/src/crypto/utils/asn1-oid.js +1 -1
- package/src/crypto/utils/asn1.js +1 -1
- package/src/crypto/utils/bitArray.js +33 -48
- package/src/crypto/utils/bn.js +1 -1
- package/src/crypto/utils/jws.js +37 -41
- package/src/crypto/utils/keyformat.js +181 -2
- package/src/crypto/utils/pem.js +1 -1
- package/src/crypto/utils/random.acvp.md +5 -5
- package/src/crypto/utils/random.js +845 -846
- package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
- package/src/crypto/utils/rsaKeygen.js +6 -6
- package/src/crypto/utils/totp.js +1 -1
- package/src/crypto/utils/uuid.acvp.md +5 -5
- package/src/crypto/utils/uuid.js +11 -10
- package/src/crypto/utils/x509.js +591 -0
- package/src/crypto/wasm/aes.js +1 -1
- package/src/crypto/wasm/aes.scalar.wasm +0 -0
- package/src/crypto/wasm/argon2.js +17 -1
- package/src/crypto/wasm/argon2.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
- package/src/crypto/wasm/blake2b.simd.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
- package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
- package/src/crypto/wasm/cmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ecc.js +3 -3
- package/src/crypto/wasm/ecc.scalar.wasm +0 -0
- package/src/crypto/wasm/ed25519.js +1 -1
- package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
- package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
- package/src/crypto/wasm/hmac.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.js +2 -2
- package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
- package/src/crypto/wasm/ml_kem.js +2 -2
- package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
- package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
- package/src/crypto/wasm/pbkdf2.js +8 -6
- package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
- package/src/crypto/wasm/rsa.js +6 -5
- package/src/crypto/wasm/rsa.scalar.wasm +0 -0
- package/src/crypto/wasm/runtime.js +84 -17
- package/src/crypto/wasm/sha2.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.scalar.wasm +0 -0
- package/src/crypto/wasm/sha3.simd.wasm +0 -0
- package/src/crypto/wasm/slh_dsa.js +1 -1
- package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
- package/src/crypto/wasm/x25519.js +1 -1
- package/src/crypto/wasm/x25519.scalar.wasm +0 -0
- package/src/crypto/webcrypto/aes.js +8 -2
- package/src/crypto/webcrypto/aeskw.js +7 -2
- package/src/crypto/webcrypto/digest.js +1 -15
- package/src/crypto/webcrypto/ecc.js +2 -2
- package/src/crypto/webcrypto/ed25519.js +2 -2
- package/src/crypto/webcrypto/hmac.js +2 -2
- package/src/crypto/webcrypto/rsa.js +7 -2
- package/src/crypto/webcrypto/x25519.js +2 -2
- package/src/dom/display/animate.js +1 -1
- package/src/dom/display/fullscreen.js +1 -1
- package/src/dom/fs/download.js +1 -1
- package/src/dom/fs/fileIntake.js +192 -0
- package/src/dom/fs/fsAccess.js +2 -3
- package/src/dom/fs/indexedDB.js +1 -1
- package/src/dom/fs/remoteStore.js +1 -1
- package/src/dom/fs/storage.js +1 -1
- package/src/dom/lifecycle/idle.js +1 -1
- package/src/dom/lifecycle/visibility.js +1 -1
- package/src/dom/lifecycle/wakeLock.js +1 -1
- package/src/dom/net/ajax.js +1 -1
- package/src/dom/net/network.js +1 -1
- package/src/dom/net/sse.js +1 -1
- package/src/dom/net/webrtc.js +1 -1
- package/src/dom/net/ws.js +1 -1
- package/src/dom/query/dnd.js +56 -4
- package/src/dom/query/dom.js +1 -1
- package/src/dom/query/events.js +1 -1
- package/src/dom/query/gesture.js +1 -1
- package/src/dom/query/media.js +1 -1
- package/src/dom/query/sound.js +333 -0
- package/src/dom/rendering/chart.js +736 -663
- package/src/dom/rendering/component.js +25 -14
- package/src/dom/rendering/devtools.js +2 -2
- package/src/dom/rendering/parser.js +155 -12
- package/src/dom/rendering/render.js +14 -4
- package/src/dom/rendering/sanitize.js +11 -4
- package/src/dom/rendering/secPolicy.js +6 -4
- package/src/dom/rendering/styleSheet.js +217 -0
- package/src/dom/rendering/template.js +72 -13
- package/src/dom/rendering/themeTokens.js +542 -522
- package/src/dom/rendering/uiSession-core.js +51 -6
- package/src/dom/rendering/uiSession-direct.js +1 -1
- package/src/dom/rendering/uiSession-list.js +4 -4
- package/src/dom/rendering/uiSession.js +1 -1
- package/src/dom/rendering/virtualScroll.js +341 -341
- package/src/dom/sensors/battery.js +1 -1
- package/src/dom/sensors/geolocation.js +1 -1
- package/src/dom/sensors/networkInfo.js +1 -1
- package/src/dom/sensors/sensors.js +1 -1
- package/src/dom/sw/backgroundSync.js +1 -1
- package/src/dom/sw/cache.js +1 -1
- package/src/dom/sw/installPrompt.js +151 -0
- package/src/dom/sw/precache.js +257 -0
- package/src/dom/sw/push.js +1 -1
- package/src/dom/sw/sharedWorker.js +1 -1
- package/src/dom/sw/swUpdate.js +239 -0
- package/src/dom/utils/a11y.js +1 -1
- package/src/dom/utils/clipboard.js +56 -6
- package/src/dom/utils/entropyCollector.js +1 -1
- package/src/dom/utils/focus.js +1 -1
- package/src/dom/utils/form.js +1 -1
- package/src/dom/utils/keybindings.js +600 -574
- package/src/dom/utils/leaderElection.js +1 -1
- package/src/dom/utils/notifications.js +1 -1
- package/src/dom/utils/permissions.js +107 -107
- package/src/dom/utils/route.js +14 -2
- package/src/dom/utils/ua.js +42 -28
- package/src/dom/utils/webauthn.js +1 -1
- package/src/io/binary/reader.js +1 -1
- package/src/io/binary/writer.js +1 -1
- package/src/io/calc/bigint.js +1 -1
- package/src/io/calc/crc32.js +28 -2
- package/src/io/calc/easing.js +514 -514
- package/src/io/codec/b64.js +189 -52
- package/src/io/codec/base32.js +1 -1
- package/src/io/codec/base58.js +1 -1
- package/src/io/codec/buffer.js +1 -1
- package/src/io/codec/cbor.js +111 -18
- package/src/io/codec/csv.js +1 -1
- package/src/io/codec/hex.js +51 -6
- package/src/io/codec/mime.js +1 -1
- package/src/io/codec/msgpack.js +47 -6
- package/src/io/codec/url.js +24 -7
- package/src/io/codec/utf8.js +5 -3
- package/src/io/codec/xml.js +1 -1
- package/src/io/compress/bitstream.js +2 -2
- package/src/io/compress/brotli.js +663 -163
- package/src/io/compress/brotli_dict.js +1 -1
- package/src/io/compress/brotli_dict_words.js +1 -1
- package/src/io/compress/brotli_frame.js +1 -1
- package/src/io/compress/brotli_shared.js +7 -7
- package/src/io/compress/deflate.js +87 -53
- package/src/io/compress/gzip.js +187 -74
- package/src/io/compress/huffman.js +24 -1
- package/src/io/compress/lz4.js +45 -7
- package/src/io/compress/lz77.js +148 -63
- package/src/io/compress/lzw.js +35 -19
- package/src/io/compress/zip.js +862 -815
- package/src/io/compress/zlib.js +87 -7
- package/src/io/i18n/i18n.js +1 -1
- package/src/io/math/fixed-point.js +1 -1
- package/src/io/math/geom.js +1 -1
- package/src/io/math/interp.js +1 -1
- package/src/io/math/linalg.js +10 -4
- package/src/io/math/stats.js +1 -1
- package/src/io/structures/btree.js +1 -1
- package/src/io/structures/heap.js +1 -1
- package/src/io/structures/lruCache.js +1 -1
- package/src/io/structures/ringBuffer.js +1 -1
- package/src/io/structures/tree-walker.js +1 -1
- package/src/io/structures/trie.js +1 -1
- package/src/io/sync/abort.js +1 -1
- package/src/io/sync/atomics.js +1 -1
- package/src/io/sync/cancellable.js +1 -1
- package/src/io/sync/channel.js +1 -1
- package/src/io/sync/mutex.js +1 -1
- package/src/io/sync/semaphore.js +1 -1
- package/src/io/sync/tokenBucket.js +1 -1
- package/src/io/text/ansi.js +1 -1
- package/src/io/text/html-entities.js +1 -1
- package/src/io/time/date.js +1 -1
- package/src/io/timing/clock.js +1 -1
- package/src/io/timing/rateLimit.js +1 -1
- package/src/io/timing/scheduler.js +1 -1
- package/src/io/utils/errors.js +1 -1
- package/src/io/utils/eventBus.js +1 -1
- package/src/io/utils/signal.js +1 -1
- package/src/io/utils/valid.js +1 -1
- package/src/main.js +1 -1
- package/src/process/message.js +1 -1
- package/src/process/rpc.js +7 -3
- package/src/process/workerPool.js +11 -4
- package/src/sanity/base.js +85 -39
- package/src/sanity/lockdown-apply.js +3 -3
- package/src/sanity/lockdown.js +58 -32
- package/src/sanity/wasm-gate.js +2 -2
- package/src/typed.js +7 -3
- package/third-party/NOTICE-brotli-dictionary.txt +69 -0
- package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
- package/third-party/NOTICE-whatwg-entities.txt +44 -0
- package/types/registry.generated.d.ts +7 -1
- package/types/typed.d.ts +7 -3
- package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
- package/docs/api/crypto/utils/aes_ctr.md +0 -71
- package/src/crypto/utils/aes_ctr.acvp.md +0 -67
- package/src/crypto/utils/aes_ctr.js +0 -134
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,131 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [1.0.0] - 2026-11-19
|
|
8
|
+
|
|
9
|
+
### Breaking
|
|
10
|
+
|
|
11
|
+
- **jws** — `verify` / `verifyJwt` refuse a non-canonical base64url part: a length of 1 mod 4, or non-zero unused bits in the last character (RFC 4648 §3.5). Such a part decodes to the same bytes as the canonical spelling, so a token had several accepted spellings. Every conformant encoder writes the canonical form; a token that relied on another spelling now verifies to `false`.
|
|
12
|
+
- **jws** — `verify` / `verifyJwt` require `expectedAlg` (an alg, or a non-empty array of algs) and throw a `TypeError` without it, before reading the token: the token header no longer chooses the algorithm (RFC 8725 §3.1; an `HS256` token MAC-ed with an Ed25519 public key used to verify). Migration: pass the algorithm the key is for, `jws.verify(token, key, { expectedAlg: 'EdDSA' })`.
|
|
13
|
+
- **zlib, gzip, zip** — `unzlibSync` / `UnzlibStream` check the Adler-32, `gunzipSync` / `GunzipStream` each member's CRC-32 and ISIZE, `unzipSync` each entry's CRC-32 and size, by default (RFC 1950 §2.3, RFC 1952 §2.3.1, APPNOTE 4.4.7): a corrupted trailer now throws code 16, and a zlib frame too short for a deflate stream and its trailer code 0, where they used to decode. Migration: `{ verify: false }` keeps the old acceptance.
|
|
14
|
+
- **sanity/base** — `applyBase()` also blocks `Range.prototype.createContextualFragment` (it throws `'not allowed'`, as `document.write` does): `document.createRange().createContextualFragment(html)` used to parse markup after the lock (measured in Chromium). The 15-step report is unchanged (the `Element.prototype` step covers it). Migration: build nodes with the DOM API or `textContent`.
|
|
15
|
+
- **runtime** — `list()` returns a frozen array of frozen copies of the definitions (each `dependencies` a frozen copy), and `core/modules.js` exports the registry array frozen: an edit through `list()` or a `push` / `splice` on the imported array now throws instead of changing what every importer resolves; a row is no longer `===` the registered object. Migration: build a new array (`[...modules, mine]`) and compare rows by `name` / `version`.
|
|
16
|
+
- **crypto** — the deprecated and always-`false` stubs are removed: `aes.bitsliced` (use `aes.fn`, the constant-time path), the `aes_ctr` module (use `aes_modes.ctr`; the registry has 208 modules), `rsa.pkcs1v15Sign` / `pkcs1v15Verify` / `pkcs1v15Encrypt` / `pkcs1v15Decrypt` (use `pssSign` / `pssVerify`, `oaepEncrypt` / `oaepDecrypt`), `ed25519.ed448.*`, `argon2.hashD` / `hashI` (use `hash`, Argon2id), `chacha20.xchacha20`, and the `webcryptoDigest.sha1` shorthand (`digest('SHA-1', data)` stays). A call to one now throws `TypeError: … is not a function` (or `undefined` is read) where it returned `false`. Migration: the replacements above; a feature probe reads `typeof x.name === 'function'`.
|
|
17
|
+
- **ml_dsa** — `sign` / `signPh` without `rnd` are hedged (32 random bytes, FIPS 204 §3.4): two signatures of one message now differ, where they were byte-identical (the zero `rnd`). `hybridSign` inherits it; its self-KAT lock is regenerated (keys unchanged). Migration: pass `new Uint8Array(32)` as `rnd` for the deterministic mode (KAT vectors).
|
|
18
|
+
- **webcrypto** — `generateKey` of `webcryptoAes`, `webcryptoEcc`, `webcryptoEd25519`, `webcryptoHmac`, `webcryptoRsa`, `webcryptoX25519` and `webcryptoAesKw.generateKek` make the secret or private key non-extractable by default (`exportKey` / `wrapKey` of it now fail); public keys still export. Migration: pass `extractable: true` where the key is exported.
|
|
19
|
+
- **uuid** — `v4()` returns the canonical `xxxxxxxx-xxxx-4xxx-Nxxx-xxxxxxxxxxxx` form (36 chars) by default, where it returned 32 hex without dashes, and so does `v1()` (`xxxxxxxx-xxxx-1xxx-…`). Migration: `v4(false, false, 'compact')` / `v1(false, false, 'compact')`.
|
|
20
|
+
- **pbkdf2** — a count below 1 (0, a negative, `NaN`) returns `false`: a count of 0 used to derive a key from the PRF's first block without iterating. Migration: a count of at least 1 (the default is 600 000).
|
|
21
|
+
- **ed25519, ml_dsa, slh_dsa** (pure tier), **hybridSign** — one argument order for every signature scheme and tier, the WebCrypto one the wasm and WebCrypto tiers already use: `sign(key, message, …)` and `verify(key, signature, message, …)`. Changed: `ed25519.verify` / `verifyPh` / `verifyCtx` were `(publicKey, message, signature, …)`; `ml_dsa<N>` and `slh_dsa_*` `sign` / `signPh` were `(message, secretKey, …)` and `verify` / `verifyPh` `(signature, message, publicKey, …)`. So do the `hybridSign` variants' `verify`, which was `(publicKey, message, signature, ctx?)` and is `(publicKey, signature, message, ctx?)`. A call in the old order returns `false` (the lengths do not match) or a wrong verdict, it does not throw. Migration: reorder the arguments.
|
|
22
|
+
- **wasmPbkdf2** — `deriveBits(password, salt, lengthBits, …)` takes the length in bits (a positive multiple of 8), as `pbkdf2` and `webcryptoPbkdf2`; it took bytes. Migration: multiply the length by 8 (32 bytes → 256).
|
|
23
|
+
- **deflate, zlib, gzip, zip, lz4, lzw** — one typed error convention for the compressors, the brotli one: `e.code` is a string (`'EEOF'`, `'EBADFORMAT'`, `'EMAXOUT'`, `'ECHECKSUM'`, `'EUNSAFEPATH'`…; the table is in each module's page), where the deflate family put a number; the number stays in `e.errno`. lz4 and lzw errors, which carried no code, now do (`'EBADSTREAM'`, `'EMAXOUT'`, `'EBADARG'`). Migration: compare `e.code` with the name, or read `e.errno` for the number.
|
|
24
|
+
- **parser** — `fromHTML` keeps the boundary space a text node shows beside an inline sibling: `or <span>choose a file</span>` gives the text `"or "` (it gave `"or"`, rendered "orchoose a file"). No node is added: whitespace-only nodes (they would render as `<span>`s), whitespace beside block elements, at a parent's edges and around a leaf's sole text are still dropped. On the site templates of this repository 98 of 147 parse differently, text content only. Migration: none for rendering; a test that pins elm-array text sees the spaces.
|
|
25
|
+
- **lz4** — `Lz4CompressStream` emits a block for every chunk: a chunk that does not compress (12 bytes or less, or incompressible) becomes a block of literals, where it was forwarded raw and `Lz4DecompressStream` then mis-decoded it (a wire change). A chunk past the size limit throws `EMAXOUT`.
|
|
26
|
+
- **cbor, msgpack, zip** — `cbor.decode` / `msgpack.decode` maps decoded to objects, and the `unzipSync` result, have a `null` prototype: no key is inherited (`toString`, `hasOwnProperty`, `constructor` are absent unless decoded). Migration: `Object.hasOwn(obj, k)` instead of `obj.hasOwnProperty(k)`; `toEqual` comparisons are unaffected.
|
|
27
|
+
- **cbor** — `decode` refuses the 17 not-well-formed items of RFC 8949 App. F it accepted (a throw): definite strings shorter than their length, two-byte simple values below 32 (`f800`–`f81f`), nested indefinite string chunks, and a break (`ff`) on its own or inside a definite array, map or tag. `encode` writes every safe integer as an integer (major 0 / 1), where integers beyond ±2^32 became float64: `1e12` is `1b000000e8d4a51000` (9 bytes, as RFC 8949 App. A), and decodes back to the same number (a wire change). Migration: none for well-formed input; a peer that expected the float64 form reads an integer.
|
|
28
|
+
- **cbor, msgpack** — `decode` stops at a nesting limit, `maxDepth` (default 512 levels of arrays, maps and CBOR tags): a deeper input throws `nesting deeper than maxDepth`, where it recursed until the engine's stack overflowed (a 200 000-deep array is 200 KB of input). Migration: `decode(bytes, { maxDepth: n })` for deeper data.
|
|
29
|
+
- **url** — `parseURL`'s `query` reads `+` as a space, as `URLSearchParams` and HTML forms do: `?q=fw+examples` gives `{ q: 'fw examples' }` (it gave `'fw+examples'`), and `buildURL(parseURL(x))` writes it `%20`, keeping the meaning. Migration: `parseURL(x, base, { space: 'percent' })` for the literal reading; `parseQuery`'s own default is unchanged.
|
|
30
|
+
- **zip** — extracted entry names use `/`: a `\` separator (.NET Framework archives) becomes `/`, as other unzip tools present it, so `out['docs/readme.md']` where it was `out['docs\\readme.md']`. Migration: look names up with `/`.
|
|
31
|
+
- **crypto, brotli, bitArray, ctr, jws** — no API object carries a `_` key any more: the `_internal` hatches of `aes`, `argon2`, `brotli`, `brotliShared`, `chacha20`, `cmac`, `ecc`, `ed25519`, `gcm`, `hybridSign`, `ml_dsa` / `ml_kem` / `slh_dsa` (and their variants), `random`, `rsa`, `rsaKeygen`, `sha256`, `sha512` and `x25519`, and `ml_dsa._ntt` / `ml_kem._ntt` and kin, move to the internal slot, a non-enumerable property keyed by `Symbol.for('@awacloud/fw/internal')`, outside the API (`docs/guide/stability.md`); `ctr._calculate` (the same function as `encrypt`), `bitArray._shiftRight` / `_xor4` and `jws._b64uEnc` / `_b64uDec` are gone. Migration: base64url through `b64.url.fromBytes` / `toBytes` (which returns `false` without a warning where `_b64uDec` warned); `ctr.encrypt`; a vector test that needs an internal reads `api[Symbol.for('@awacloud/fw/internal')]`, which carries no semver promise.
|
|
32
|
+
|
|
33
|
+
### Added
|
|
34
|
+
|
|
35
|
+
- **logger** — `log.native(on?)`: the realm's `console` calls print as the native console does (in production too) while still recorded; `native(false)` restores the default. The takeover itself is unchanged.
|
|
36
|
+
- **lz77** — `createScanner(data, opts)`: the scan, resumable. Each `fill(tokens, max)` writes the next `max` tokens at most in the `encodeTokens` format and resumes where it stopped; the fills concatenate to the `encodeTokens` stream whatever `max` is, a lazy step's match carried across a cut included. `encodeTokens` is now one fill over the whole input.
|
|
37
|
+
- **sound** (new module, `dom/query`) — short sound clips in memory: `record(streamHandle, { maxMs })` with a live `level()`, `fromBytes`, `fromBuffer`, `trim`, `normalize`, `play(clip, { rate, gain, when })`, `rate(semitones)`, `clip.bytes()` (16-bit PCM WAV), `disposeAll()`. Web Audio + MediaRecorder, main thread only, never touches storage or the network.
|
|
38
|
+
- **x509** (new module, `crypto/utils`) — X.509 v3 certificates (RFC 5280) for Ed25519 and ECDSA P-256 keys: `create(spec, signer)` (self-signed or issued; names, serial, UTCTime / GeneralizedTime validity, `basicConstraints`, `keyUsage`, `extKeyUsage`, `subjectAltName`, key identifiers), `parse(der)`, `verify(der, issuerKey)`, `toPem` / `fromPem`. Read by node's `X509Certificate` and openssl; reads openssl's.
|
|
39
|
+
- **createWorker** — `revoke: [names]` removes ambient globals inside the worker before the user function runs, from every owner on the global's prototype chain (Chrome keeps `fetch` on `WorkerGlobalScope.prototype`), and fails closed when a name stays reachable; `lockdown: true | { url }` runs `lockdown()` in the worker's realm (a module worker importing `sanity/lockdown.js`). Both run after `workerFw`, so its resolved modules are the grant. Without them nothing changes.
|
|
40
|
+
- **parser** — `createCache({ max })` and `fromHTML(html, { cache })`: one parse cache shared by several parser instances (one per route of a site build). It is transparent: a hit returns exactly what a fresh parse on the calling instance would, auto ids minted by that instance's own counter, so sharing it cannot create an id collision; only the parse is saved.
|
|
41
|
+
- **keyformat** — RSA keys: `encodeRsaPublicKey` / `decodeRsaPublicKey` and `encodeRsaPrivateKey` / `decodeRsaPrivateKey` (PKCS#1), `encodeSpkiRsa` / `decodeSpkiRsa` and `encodePkcs8Rsa` / `decodePkcs8Rsa`, on the `{ n, e, … }` shapes `rsaKeygen` returns and `rsa` takes. The encodings are byte-identical to node's DER; decoding is strict.
|
|
42
|
+
- **hybridSign** — `fromComponents(kind, { pq, trad })` and `toComponents(kind, bytes)` on both variants, for public keys, secret keys and signatures: a composite built from components made elsewhere (an external ML-DSA key, the official LAMPS wire form), or split back. Malformed input is `false`; results are copies.
|
|
43
|
+
- **crypto/wasm** — `wasmRuntime.configure({ baseUrl })` and `load(name, exports, { baseUrl })`: the WASM tier fetches its binaries from the directory you name (an absolute URL), for a build that inlines the factory elsewhere, a CDN or a Worker served from another place. `configure` is the default for every later load, the algorithm wrappers included; it stays open under `lockdown()`. The default is still this module's own directory, and every `load` still compiles afresh: under JavaScriptCore, `chacha20poly1305.simd.wasm` returns a wrong tag once one compiled module has run it about six times, so no compile memo is kept.
|
|
44
|
+
- **io/compress** — `maxOutput` (bytes) on every decoder: `inflateSync`, `unzlibSync`, `gunzipSync` (over every member), `unzipSync` (over every entry), `brotliDecompressSync`, their async forms and the `InflateStream`, `UnzlibStream`, `GunzipStream`, `BrotliDecompressStream` constructors (the stream's total). One byte more throws code 7 (`EMAXOUT` in brotli) before the buffer grows past the cap; `unzipSync` checks each declared entry size before allocating it. Absent, nothing changes. The bound a caller needs against a decompression bomb.
|
|
45
|
+
- **sanity/base** — `applyBase()` reports `failures: [{ step, target, message }]`, one entry per slot a step could not harden (a non-configurable property, a frozen namespace); `[]` on a clean apply. `steps` keeps its 15-step order.
|
|
46
|
+
- **fileIntake** (`dom/fs`) — picker, OS file drop and keyboard-operable dropzone wired to one `onFiles(files, source)` callback.
|
|
47
|
+
- **installPrompt** (`dom/sw`) — the `beforeinstallprompt` deferral (+ `appinstalled`) and the File Handling `launchQueue` consumer.
|
|
48
|
+
- **swUpdate** (`dom/sw`) — the waiting-release update flow: report a waiting release once to a controlled page, check, apply, read the worker version.
|
|
49
|
+
- **precache** (`dom/sw`) — worker-side release precache with cache-first / network-first strategies and the skip-waiting / version message protocol.
|
|
50
|
+
- **clipboard** — `setRich({ html, text })` writes one item with a `text/html` and a `text/plain` flavour (strings or promises, written synchronously inside the user gesture), and `isSupported()` gains the `richWrite` flag; `set`, `get` and `share` are unchanged.
|
|
51
|
+
- **sanitize** — `sanitizeHtml(html, { allowDataImage: true })` keeps a `data:image/*` URL on `<img src>` only, the opt-in its comment documented but never honoured; `href` and every other `src` still drop `data:`, and the default is unchanged.
|
|
52
|
+
- **runtime** — a module descriptor may declare `type: 'app.<sub>'`, the namespace for an application's own modules (`fw`, `sd`, `sde`, `sdc` and `lib` were the only accepted prefixes, so an app had to borrow one or omit `type`).
|
|
53
|
+
- **zlib, gzip, zip** — `verify: true` on `unzlibSync`, `gunzipSync`, `unzipSync`, their async twins and the `UnzlibStream` / `GunzipStream` streams checks the integrity trailer against the decoded bytes (Adler-32; CRC-32 and ISIZE; each zip entry's CRC-32 and size) and throws code 16 `incorrect data check` on a mismatch; with it, a zlib frame shorter than a deflate stream and its trailer throws code 0 `unexpected EOF` instead of inflating to an empty array. It is the default; `verify: false` skips the check (see Breaking).
|
|
54
|
+
- **exports** — `.js` twins `./typed.js`, `./sanity/base.js`, `./sanity/community.js`, `./sanity/lockdown.js`, `./sanity/lockdown-apply.js`; `types` on every `./sanity/*` module key; `@awacloud/fw/eslint` exports the `fw/no-factory-capture` rule. The README lists the subpaths and which ones need a build in a checkout.
|
|
55
|
+
- **deflate** — `inflateSync(data, { onEnd })` reports the input bytes a deflate stream used; `InflateStream` gains `ended` and `rest()` (the input after the final block). What a container reads on from.
|
|
56
|
+
- **zlib, gzip** — `UnzlibStream.flush()` / `GunzipStream.flush()` end a stream that may have no trailer: the last 4 / 8 bytes, held back as a presumed trailer, are decoded and emitted (a truncated PDF FlateDecode stream lost them).
|
|
57
|
+
- **huffman** — `kraft(codeLengths)` reports an over-subscribed or incomplete code-length set; `buildMap` is unchanged.
|
|
58
|
+
- **lz4** — `compress(src)` and `compress(src, opts)` compress the whole of `src`; `compress(src, len, opts)` is unchanged.
|
|
59
|
+
- **render** — `toHTML` marks the root(s) of each iterate row with `data-fw-row="<i>"`, the row's 0-based index, when hydration markers are on (the default). The rows still share their `data-fw-id` values, which `UIList.adopt` relies on; the index makes one row addressable (`[data-fw-id="app:item"][data-fw-row="2"]`). `hydrate: false` emits neither.
|
|
60
|
+
- **lzw** — an `earlyChange` option (`true` widens the code one code early, the TIFF / PDF `/EarlyChange 1` rule; `false` at `2^n` entries, the GIF and .Z rule), defaulting to `bigEndian`, so `bigEndian: true` alone stays the TIFF / PDF profile and `earlyChange: false` with it reads a PDF `/EarlyChange 0` stream.
|
|
61
|
+
- **b64** — `url.fromBytes(bytes)`, `url.toBytes(str)` and `url.test(str)`: base64url (RFC 4648 § 5), no padding, with a strict decoder that accepts the canonical unpadded form only (no `=`, no `+` / `/`, no length of 1 mod 4, zero unused bits in the last character) and returns `false` otherwise. `jws` encodes and decodes its token parts with it.
|
|
62
|
+
- **API stability** — the public surface is written down and frozen by a gate: `docs/guide/stability.md` says what SemVer covers (every `exports` entry and the names it exports, each registry module's API keys and kinds, the published declarations, the documented behaviour; not the internal slot, the `_` methods of classes, error message text or bundle internals), the rules from 1.0.0 and the deprecation cycle (a minor deprecates and keeps the old name working for at least one more minor and six months, the next major removes). `docs/api/surface.json` is the snapshot; `bun run api:surface:check` prints a classified diff (breaking, additive, internal, types) and fails on drift, and `prepack` runs it.
|
|
63
|
+
- **docs** — `docs/evidence/l4-evidence.md`: what backs the L4 criteria (the frozen API, the conformance vectors per standard with the remaining thin spots, the sites that run fw in production).
|
|
64
|
+
- **styleSheet** (new module, `dom/rendering`) — attaches CSS text to a document as a `<style>` element (default) or as a constructable stylesheet in `adoptedStyleSheets` (`mode('adopted')`), the channel a CSP `style-src` without `'unsafe-inline'` accepts: `attach(css, { id, attrs, nonce, mode, head })` returns a handle with `set(css)` and `detach()`.
|
|
65
|
+
|
|
66
|
+
### Changed
|
|
67
|
+
|
|
68
|
+
- **ua** — detection follows MDN's method: `navigator.userAgentData` (UA Client Hints) first, else "Mobi" anywhere in the UA for `mobile()` and a few tokens for `platform()`; the two verbatim pattern lists are gone. Results that change: an iPad Safari UA ("Mobile/…") is now mobile; a UA matched only by the old 4-character prefix list (old feature phones, e.g. `SAMSUNG-GT-…`) is not; Chrome OS reads `'linux'` (was `'unknown'`); a Mac UA with more than one touch point (iPadOS desktop mode) reads `'ios'`; where UA-CH exists its values win over the UA string. The `UaAPI` surface is unchanged.
|
|
69
|
+
- **crypto** — a verify or an authenticated decrypt that returns `false` (an AEAD tag mismatch, a signature that does not verify, an OAEP or key-unwrap failure) logs `CORRUPT` at warn level instead of `console.error`, in the pure, WebCrypto and wasm tiers. `console.error` stays for nonce reuse, a dead entropy source, `BUG` and real faults. A page that correctly rejects a tampered input no longer shows a console error.
|
|
70
|
+
- **jws** — a malformed token warns once per call instead of once per part, and a signature that does not verify is reported at warn level instead of `console.error`.
|
|
71
|
+
- **keybindings** — punctuation keys `Plus`, `Minus`, `Equal` (and the literal `-` / `=`) parse and match on `event.key`, Shift ignored; `Shift+Plus` is refused.
|
|
72
|
+
- **sha256** (and `sha224`, `hmac`, `pbkdf2`, `hkdf`, `ecc`'s HMAC-DRBG, `jws`, `totp` through it) — the compression unrolled on int32 (generated; the schedule in an `Int32Array`, the registers renamed instead of moved), and bytes onto an empty buffer hashed straight from the `Uint8Array`: 1 MiB 10.7 → 6.4 ms (Bun), 10.5 → 4.6 ms (Node). `pbkdf2` with its default PRF (HMAC-SHA-256) runs each iteration as two compressions on the key's inner and outer states, without allocation: 10 000 iterations 26.8 → 4.7 ms (Bun), 14.9 → 4.0 ms (Node). Same outputs.
|
|
73
|
+
- **sha3** (SHA3-224/256/384/512, SHAKE128/256, and `ml_kem` / `ml_dsa` / `slh_dsa` through them) — Keccak-f[1600] unrolled on int32 locals (generated; no allocation per permutation) and absorption four bytes per word: SHA3-256 of 1 MiB 45 → 12 ms (Bun), 47 → 21 ms (Node). Same outputs.
|
|
74
|
+
- **sha512** (and `sha384`, `sha512_224`, `sha512_256`, `ed25519`'s hashing) — int32-only rounds (round constants and the message schedule in `Int32Array`s, carries from bit operations), and bytes onto an empty buffer hashed straight from the `Uint8Array`: 1 MiB 42 → 14 ms (Bun), 34 → 10.4 ms (Node). Same digests.
|
|
75
|
+
- **blake2b** (and `argon2`, which hashes with it) — the compression runs on int32 locals with generated inline mixing: 1 MiB 46 → 9.0 ms (Bun), 51 → 6.3 ms (Node). Same outputs.
|
|
76
|
+
- **poly1305, chacha20, chacha20poly1305** — `poly1305` no longer uses `BigInt`: ten 13-bit limbs, products exact in doubles, the block loop unrolled, the `h ≥ p` reduction by mask — no secret-dependent branch, where `BigInt` operations run in value-dependent time. `chacha20` keeps its state in locals with inline quarter-rounds and XORs whole keystream words. Same outputs (`node:crypto`'s AEAD byte for byte). 1 MiB AEAD encrypt: 43 → 7.9 ms (Bun), 38 → 5.0 ms (Node).
|
|
77
|
+
- **ed25519, x25519** — faster, same outputs: the field multiply and square are unrolled (no allocation; squaring by symmetry), inversion and square root use addition chains, `sign` / `keyPair` multiply the base point through a constant-time table (signed radix-16 digits, entries chosen by a full scan and masks), and `verify` multiplies its public point through a 4-bit window with the dedicated doubling. Bun / Node: `sign` 3.7 → 0.45 ms / 5.7 → 0.32 ms (×8 / ×18), `verify` 5.7 → 1.2 / 10.6 → 0.8 ms (×4.6 / ×13), `x25519.scalarMult` 1.6 → 0.72 / 2.4 → 0.63 ms (×2.2 / ×3.9). The first `keyPair` / `sign` of a factory builds the table (about 4 ms).
|
|
78
|
+
- **brotli** (encoder) — incompressible input is stored at once: a sampled entropy test, then a repeat probe over content-defined anchors, before LZ77, the dictionary scan and the entropy coding would spend their time on it (q6 on 256 KiB of uniform bytes: 12.8 → 0.6 ms Bun, 12.0 → 1.1 ms Node; with the dictionary blob loaded 43 → 0.6 / 94 → 1.1 ms). The dictionary scan visits only the prefix groups that can match the input's first byte, behind a Bloom filter per table; LZ77 runs through `encodeTokens` instead of a callback per token; distance codes are computed in O(1). q6 text and json 19-37 % faster. The output is byte-identical at every quality, with and without the dictionary.
|
|
79
|
+
- **brotli** (encoder) — repeated distances are coded through the distance cache (RFC 7932 §4: the last four distances and their ±1..3 neighbours, code 0 on implicit-distance insert-and-copy symbols); a code is used only where it saves more than its place in the distance alphabet costs. JSON-like input 2.3-3.7 % smaller at q 1-11, period-structured data ~21 %, source code ~0.5 %; prose unchanged; no input of the bench set larger. Still about 15 % above the reference encoder at q6 on text and 13 % on JSON.
|
|
80
|
+
- **brotli** (decoder) — text-like streams decode about 30 % faster (`node:zlib` q6, 120 KiB of text: 2.9 → 2.0 ms Bun, 2.4 → 1.7 ms Node; JSON 9-18 %): a static-dictionary word is copied by a loop instead of `subarray` + `set` (44 % of a text decode under V8), the literal loop keeps its state and bit position in locals and reads the prefix table inline, insert-and-copy symbols split through tables, and the output is reserved once per meta-block.
|
|
81
|
+
- **brotli** (encoder) — smaller output at every quality from 1, still decoded by every Brotli decoder; a consumer that pins encoder bytes sees the change. The built-in dictionary is used from 4-byte words (was 6); a copy whose bytes repeat at a cached distance takes that distance's cache code; q7 now searches deeper than q6 (a 64-candidate chain ended by a 32-byte match; q8-9 64 ended at 64 bytes, q10-11 128). With the dictionary blob, q6 on 256 KiB of English Markdown is 0.6 % smaller (4 % above the reference encoder), q7 3.5 % smaller (1.5 % above); JSON 0.7 % smaller at q6, 2.5 % at q7, 3 % at q11; source 2-3 % at q7. q6 encodes 5-17 % slower; q7 is 20-50 % slower than q6.
|
|
82
|
+
- **brotli** (decoder) — a command's reads (insert-and-copy symbol, length extras, distance symbol and extras) run on a local bit position like the literal loop's, and the dictionary copies left the hot loop: `node:zlib` q6 streams decode 11-12 % faster on Bun (text and JSON), unchanged on Node.
|
|
83
|
+
- **hex, b64, crc32** — faster, same outputs. `hex.fromBytes` and `b64.fromBytes` / `toBytes` use the platform's `Uint8Array` `toHex` / `toBase64` / `fromBase64` where the realm has them (JavaScriptCore, SpiderMonkey) and JS paths over typed arrays elsewhere (V8). 1 MiB, Bun / Node: hex encode 36 → 0.6 / 42 → 1.2 ms, base64 encode 23 → 0.2 / 16 → 1.1 ms, decode 7 → 0.2 / 13 → 2.0 ms. `crc32` folds sixteen bytes a step (slicing-by-16): 1.6 → 0.5 / 0.6 ms. Arrays of numbers and malformed base64 give exactly the results they gave (the original decoder still reads every non-canonical input).
|
|
84
|
+
- **deflate** (and `zlib`, `gzip`, `zip`, built on it) — the encoder holds one block of tokens (128 KiB) instead of the whole input's: `deflateSync` on N bytes held `8 × N` bytes of tokens until it returned (a 32 MiB input peaked at +260 MiB of array buffers, now +60 MiB, mostly the output). The scan skips the match probe when a position's hash bucket is empty or older than the window: on incompressible input about 20 % faster under Bun, a few percent under Node; other inputs unchanged. The output is byte-identical at every level.
|
|
85
|
+
- **aes** — the constant-time default `aes.fn` is bitsliced: the state as 8 bit-planes, SubBytes as the GF(2^8) inverse on the planes, round keys bitsliced once at schedule time. It is about 20× faster (AES-128-CTR over 64 KiB: 130 ms → 5.5 ms on Bun, 127 → 5.8 ms on Node; AES-256-GCM about 14×), about 11× the T-table path instead of about 270×. Outputs are unchanged (FIPS-197, ACVP AFT / MCT, the `ttable` cross-check). Everything built on it speeds up the same way: `aes_modes`, `random.drbg`, `adf`, pdf's ISO 32000-2 Algorithm 2.B (about 0.7 s → 40 ms a hardening).
|
|
86
|
+
- **component, template, themeTokens** — the CSS they inject (scoped component CSS, `template.style`, the token variables) goes through the new `styleSheet` module; nothing changes by default. After `runtime.resolve('styleSheet').mode('adopted')` it is attached as constructable stylesheets, which a CSP `style-src 'self'` accepts where it refuses an inline `<style>`. Each module takes `styleSheet` as its last dependency; a hand-wired factory call without it behaves as before.
|
|
87
|
+
- **crypto** — each module whose loops were flattened for speed (`aes`, `ed25519`, `x25519`, `chacha20`, `poly1305`, `blake2b`, `sha3`, `sha256`) keeps its logical implementation in a co-located `<module>.reference.js`, proven equal to the fast code by a differential test; `pbkdf2` is covered by a differential test of its two-compression fast path against its general loop (`pbkdf2.differential.test.js`, no duplicated reference). The references live in the git repository only: they are not in the npm package, its exports or its types. The generated code is regenerated by `tools/crypto-gen.js`. See `docs/dev/crypto-references.md`.
|
|
88
|
+
|
|
89
|
+
### Fixed
|
|
90
|
+
|
|
91
|
+
- **wasmArgon2** — Argon2id tags are interoperable. The WASM tier's core, built from `@awacloud/fw-wasm-crypto`, started the address-word cursor at word 0 in the first segment of pass 0 where RFC 9106 §3.4.1.2 takes word `i mod 128`: every parameter set whose segment length (`m / (4·p)`) is 4 or more gave a tag no other Argon2id implementation reproduces. It now also runs `m ≥ 16384` KiB and refuses `m` above 1 GiB. A tag this tier computed before this release does not verify with it. The pure-JS `argon2` module does not share the defect: it reproduces the RFC 9106 §5.3 test vector (segment length 8) and gives the same tag as the fixed WASM module on every parameter set measured, segment lengths 2 to 16.
|
|
92
|
+
- **lzw** — the default (GIF) profile widened its codes one code early, the TIFF rule, in the encoder and the decoder alike: fw read its own streams, but no real GIF — a GDI+ GIF failed with `EBADSTREAM` past 510 codes — and no GIF decoder read fw's. It now widens at `2^n` entries, as GIF and `.Z` do, checked both ways against GDI+; the TIFF / PDF profile (`bigEndian: true`) is unchanged. A stream fw wrote LSB-first before this fix is not a GIF stream: read it with `{ earlyChange: true }`.
|
|
93
|
+
- **docs** — the API pages of `ecc`, `asn1`, `adf`, `blake2b`, `aes_modes`, `random` and `webcryptoDigest` described keys the modules do not have (`ecc.secretKey` / `sign` at the top level, `asn1.encode` / `decode`, `adf.transform`, `blake2b.fn`, `aes_modes.kwp`, `random.range`, the removed `sha1`); they now list the real API, with examples that run, and a test keeps every page's key list within the frozen surface.
|
|
94
|
+
- **aes** — the key expansion of the constant-time path read the S-box table at indices taken from key bytes (a cache-timing leak of the key, once per scheduled key); its SubWord now goes through the bitsliced core, like the rounds.
|
|
95
|
+
- **logger** — a second fw entry in the same realm (two bundles, a bundle next to the sources, several test files importing fw in one process) no longer throws at import: its logger joins the `console` proxy the first entry installed — both record the same calls, printing follows the first entry's `ENV.DEV` — instead of redefining the locked `console` (`TypeError: Attempting to change value of a readonly property.`, then `Cannot access 'fw' before initialization`). A `console` another script locked is left alone. The takeover itself is now documented (README *Logging and `console`*, `logger.md`): recorded in `fw.log`, printed only in dev, methods not reassignable, `--no-log` to opt out.
|
|
96
|
+
- **chart** — the default ticks are round values (a step of 1, 2, 2.5 or 5 × 10ⁿ) inside the domain, labelled at their step's precision, as the JSDoc promised: they split the 5 %-padded range evenly (842.5, 457.5, 0.2999…, an x axis at −0.25 / 1.13 / 3.88). The plot padding fits the labels: the fixed 40 px clipped a `"1035 ms"` label to `"035 ms"`. And `color` accepts any CSS colour: area and bar fills appended `'33'` / `'aa'` to it, so only a 6-digit hex worked — `rgb(...)` filled with the previous fill style instead. A hex renders pixel-identical (Chromium). Given `ticks` / `format` are unchanged.
|
|
97
|
+
- **dnd** — the default drag preview keeps its source's rendered width and height: appended to `<body>` with `position: fixed`, the clone took its intrinsic width (a 256 px card was drawn 393 px wide, or narrower and wrapped, depending on its content). And a pointer drag no longer selects the text it crosses: `user-select` is `none` while a drag is active (restored at the end, on cancel and on dispose), and a selection the gesture started is cleared.
|
|
98
|
+
- **hmac** — a `Uint8Array` key is read as its bytes, as documented; its elements were taken as 32-bit words, so `new hmac.fn(bytes)` (and `hmac.verify(bytes, …)`) computed a different MAC than every other HMAC-SHA-256. fw's own callers (`jws`, `totp`, `ecc`, `slh_dsa`, `pbkdf2`) convert their keys to bitArrays first and were not affected.
|
|
99
|
+
- **brotli** — the encoder could write a stream that decodes to other bytes, in `node:zlib` and fw alike. Two defects: a literal run longer than 22593 bytes followed by a match was split with a 2-byte copy at distance 1 that was never in the input (any insert length fits one command: insert code 23 reaches 22594 + 2^24 − 1); and the bit writer lost the top bits of fields wider than 17 bits — distance extras past about 512 KiB, the 24 extra bits of insert code 23, MLEN past 2 MiB. An input over about 1 MiB with a far match, or any input holding a long incompressible run before a repeat (two copies of a 30 KB binary, say), was affected; text-like inputs rarely were.
|
|
100
|
+
- **hex docs** — the page said `toBytes` ignores the last character of an odd-length input and decodes an invalid character as `NaN`; it throws in both cases (`hex: odd-length input`, `hex: invalid character at index N`).
|
|
101
|
+
- **docs** — the dom index pages described `media` as "JS media queries"; it is the camera, microphone and screen stream module.
|
|
102
|
+
- **pem docs** — `decode` returns `{ label, bytes }`, not the bytes alone; the crypto/utils index named `pem` and `bitArray` as `keyformat` dependencies (it depends on `asn1` only).
|
|
103
|
+
- **keyformat docs** — the examples called `encodePkcs8Edwards` with an object and `OID.Ed25519`, passed a PEM string to `decodePkcs8Edwards`, and promised a `publicKey` it does not return; they now match the API (`(oid, seed)`, `OID.ED25519`, `pem.decode(text).bytes`).
|
|
104
|
+
- **licence notices** — `third-party/` carries the notices of the two inlined third-party tables: the WHATWG named character references of `io/text/html-entities` (BSD-3-Clause) and the RFC 7932 Brotli dictionary `io/compress/brotli_dict.bin` (the IETF Trust's BSD terms, and the MIT notice of google/brotli, where the file was copied from). `docs/dev/provenance.md` records both origins.
|
|
105
|
+
- **crypto/wasm** — the published package carries the 22 `.wasm` binaries of the WASM tier, next to `runtime.js`, with their licence texts (`third-party/NOTICE-fw-wasm-crypto.txt`, the attribution of the vendored C sources they are built from). The `files` list left them out, so in an installed package every `wasm*` module was unavailable (the tier is no-throw: `load` reported a failed fetch) and `@awacloud/fw/crypto/*.wasm` resolved to a missing file.
|
|
106
|
+
- **sha256, sha512** (and `sha224`, `sha384`, `sha512_224`, `sha512_256`, built on them) — a `Uint8Array` passed to `hash()` or `update()` is hashed as its bytes. It used to be read as a bitArray of 32-bit words, so `sha256.hash(bytes of 'abc')` returned a wrong digest instead of `ba7816bf…`. Strings and bitArrays hash as before.
|
|
107
|
+
- **sanity/base** — `[].__proto__` reads `Array.prototype` again (the `__proto__` guard is installed on `Object.prototype` only, the prototype that owns the accessor; it used to shadow the getter on the eight others), and `insertAdjacentHTML(position, html)` inserts the text as documented (it became a getter-less accessor, so the call threw a `TypeError`). The docs now state what the tier does not do: the `({}).constructor.constructor` escape, `Range.prototype.createContextualFragment`, the `debugger` statement.
|
|
108
|
+
- **lockdown** — in a browser realm the composed `base` tier now applies synchronously, before the intrinsic freeze, so it is in force when `lockdown()` returns. It used to run on a later tick, after `Math`, `JSON` and `Date` were frozen, and aborted on its first wrapper assignment without a report: `Math.random()` stayed callable after `lockdown()`. A base failure is now reported on the console, and `harden()` no longer reads the global `Reflect`, which `base` blocks.
|
|
109
|
+
- **fileIntake** — the type build (`tsconfig.types.json`) failed with TS2488 on the picker's `FileList` spread; it now uses `Array.from` (same behaviour, emitted `.d.ts` unchanged), and an integration test keeps the type build at zero diagnostics.
|
|
110
|
+
- **runtime** — the highest registered version follows SemVer 2.0.0 § 11: numeric pre-release identifiers compare numerically (`1.0.0-beta.11` over `1.0.0-beta.2`), a hyphen inside a pre-release is kept (`1.0.0-rc-2` over `1.0.0-rc-1`), numeric identifiers sort below alphanumeric ones, a longer identifier set wins a tie, and build metadata is ignored (`1.0.5+build.1` used to rank below `1.0.4`). The same order applies inside a worker (`runtimeSource`).
|
|
111
|
+
- **secPolicy** — `isSafeUrl(url, schemes)` honours a `Set` of schemes, as documented; it fell back to the default schemes, so `new Set(['https'])` still admitted `http:`, `mailto:`, `tel:` and `ftp:`. And a parameter-less `data:image/<type>,…` URL (RFC 2397, e.g. a URL-encoded SVG) is accepted wherever `data:image` is: template and render by default, `sanitizeHtml(html, { allowDataImage: true })` on `<img src>`; only the `;base64` / `;utf8` spellings passed.
|
|
112
|
+
- **template** — a tag outside the context's catalogue (`output`, a custom element, an `svg_<name>` child) is created and rendered instead of being dropped with its children moved to the context root; blocked tags (`script`, `object`, `embed`, `iframe`) and invalid names are still not rendered. `clearContext` on a page context empties `document.body` and removes the context's own `<style>` / `<script>`, instead of removing `body` from the document. `elm()` no longer writes a generated `id` into the caller's node.
|
|
113
|
+
- **parser** — `fromHTML` returns a deep copy of its cached `ParseResult` on every call, so a caller's mutation no longer reaches the next caller of the same source; two calls no longer return the same object (the JSDoc called it frozen; it was shared and mutable).
|
|
114
|
+
- **keybindings** — chords sharing a first key (`Ctrl+K Ctrl+A` and `Ctrl+K Ctrl+H`) all complete: a pending chord keeps every candidate and each key narrows the set. Only the highest-priority candidate used to be kept, so the others could never fire.
|
|
115
|
+
- **route** — `go(path)` to a new hash runs the handlers once: the `hashchange` its own assignment causes no longer dispatches a second time (a handler that fetched ran its request twice). The `hashchange` listener now skips an event whose hash equals the last dispatched one, which also ignores late duplicates.
|
|
116
|
+
- **workerPool** — aborting an in-flight job always gives its slot a fresh worker. With `respawnOnCrash: false` the slot kept the terminated worker, so the next job was posted to it and never settled; and an abort on a slot `resize()` had removed spawned an orphan worker.
|
|
117
|
+
- **worker-helper** — `createWorker` with `ENV.LOG` on and no `ENV.DEV` (documented optional) builds the worker; it threw on `ENV.DEV.toString()`. The `workerFw` example names `runtime.resolve('processMessage').workerFramework`: the descriptor has no such property, so the documented line silently used the default bootstrap.
|
|
118
|
+
- **processRPC** — `open(port, { timeout })` clamps the timeout to 2^31-1 ms; `timeout: Infinity` (or any value above the timer range) made every call and the handshake fail at once.
|
|
119
|
+
- **uiSession** — a portal renders into a host it owns (`<div data-fw-portal="<name>">` appended to its target). On the default target, `document.body`, `portal.clear()` emptied the whole page and `closePortal()` removed `body` from the document; both now act on the host only. `prepend(items)` (and an item's `prepend: true` in `add`) inserts before the target's existing children, in the items' order; it appended.
|
|
120
|
+
- **vite-env** — the virtual-module types (`runtime`, `modules`, `install`) no longer degrade to `any` when `vite-env.d.ts` is read by path under `moduleResolution: "node"`: its type queries use relative paths instead of `@awacloud/fw/…` specifiers, which that resolution cannot follow.
|
|
121
|
+
- **exports** — `@awacloud/fw/io/codec/hex` (and every extension-less `io`, `dom`, `crypto`, `process` subpath) names the `.js` file; it mapped to a path with no extension, which Node cannot load (bundlers that add extensions hid it). The binary assets keep their own keys (`./io/*.bin`, `./crypto/*.wasm`). Co-located `*.test.js`, `*.kat.js` and the markdown sources under `src/` are no longer reachable through the map (the published package never shipped them).
|
|
122
|
+
- **gzip** — a file of several members (RFC 1952 § 2.2) decodes to all of them, in order, through `gunzipSync` and `GunzipStream`. It returned the first member only, or threw `output exceeds provided buffer` (the output was sized from the last member's ISIZE). Trailing zero bytes are ignored, as `node:zlib` does.
|
|
123
|
+
- **url** — `buildURL` no longer writes `//` after a scheme that has no authority: `mailto:someone@example.com` rebuilt as `mailto://someone@example.com`. The fallback parser (a realm without `URL`) reads a bracketed IPv6 host: `https://[::1]:8080/x` gave the host `[`.
|
|
124
|
+
- **cbor, msgpack, zip** — a map key or a zip entry named `__proto__` is decoded as an own property; it used to replace the result object's prototype with the decoded value (`decode(...).polluted` read through it). `zipSync` dropped such an entry the same way. `Object.prototype` itself was never written.
|
|
125
|
+
- **gzip, zlib streams** — a header split across chunks decodes: `GunzipStream` failed on any chunking under 10 bytes (it inflated the rest of the header), and `UnzlibStream` on a dictionary frame chunked under 6; the header parser now reports a header that runs past the bytes at hand (code 6 when `final`).
|
|
126
|
+
- **linalg** — `mat3.transpose(m, m)` (output aliased to the input) transposes in place; it read already-overwritten cells (`[1,4,7,4,5,8,7,8,9]` for `[1..9]`). A sweep of the other 30 vector and matrix operations under both aliases found no other case; it is now a test.
|
|
127
|
+
- **utf8** — the fallback encoder (no `TextEncoder`) replaces an unpaired high surrogate at the end of a string with U+FFFD, as `TextEncoder` and the mid-string case do; it emitted the raw surrogate (`ED A0 80`).
|
|
128
|
+
- **typed** — `createRuntime(ns)` with a module namespace (`import * as ns from '@awacloud/fw/core/modules'`, i.e. `{ default: [...] }`) registers the modules; it registered nothing, silently. Arrays, objects of descriptors and such namespaces are accepted, in the code, the docs and `types/typed.d.ts`.
|
|
129
|
+
- **themeTokens** — its `<style>` element carries the page's `<meta name="csp-nonce">` nonce, as `component` and `template` do.
|
|
130
|
+
|
|
131
|
+
|
|
7
132
|
## [0.1.0] - 2026-09-29
|
|
8
133
|
|
|
9
134
|
### Added
|
package/NOTICE
CHANGED
|
@@ -10,3 +10,11 @@ AWACLOUD and AWA are trademarks of Towards Conseil, used under licence.
|
|
|
10
10
|
Third-party components:
|
|
11
11
|
- Stanford Javascript Crypto Library (SJCL) — Copyright (c) 2009-2015, Emily Stark, Mike Hamburg and Dan Boneh at Stanford University. All rights reserved. — BSD-2-Clause — licence text: third-party/NOTICE-sjcl
|
|
12
12
|
- Robert Penner's easing equations / jQuery Easing v1.3 — Copyright © 2001 Robert Penner; Copyright © 2008 George McGinley Smith — BSD-3-Clause — licence text: third-party/NOTICE-penner-easing
|
|
13
|
+
- WHATWG HTML Standard named character references (io/text/html-entities) — Copyright © WHATWG (Apple, Google, Mozilla, Microsoft). — BSD-3-Clause — licence text: third-party/NOTICE-whatwg-entities.txt
|
|
14
|
+
- RFC 7932 Brotli static dictionary (io/compress/brotli_dict.bin) — Copyright (c) 2016 IETF Trust and the persons identified as authors of the code. All rights reserved.; Copyright (c) 2009, 2010, 2013-2016 by the Brotli Authors. — BSD-3-Clause AND MIT — licence text: third-party/NOTICE-brotli-dictionary.txt
|
|
15
|
+
- mlkem-native v1.2.0 — Copyright (c) The mlkem-native project authors — Apache-2.0 AND MIT AND ISC AND CC0-1.0 — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
|
16
|
+
- PQClean (commit 202a8f9, ML-DSA clean subset + FIPS-202/SHA-2 helpers) — The PQClean contributors — CC0-1.0 — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
|
17
|
+
- OpenSSL SLH-DSA (FIPS-205) core — Copyright 2024-2025 The OpenSSL Project Authors. All Rights Reserved. — Apache-2.0 — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
|
18
|
+
- BearSSL v0.6 — Copyright (c) 2016 Thomas Pornin <pornin@bolet.org> — MIT — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
|
19
|
+
- fiat-crypto v0.1.6 — Copyright (c) 2015-2020 the fiat-crypto authors — MIT AND BSD-1-Clause AND Apache-2.0 — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
|
20
|
+
- libsodium 1.0.22 — Copyright (c) 2013-2024 Frank Denis and contributors — ISC — licence text: third-party/NOTICE-fw-wasm-crypto.txt
|
package/README.md
CHANGED
|
@@ -2,9 +2,81 @@
|
|
|
2
2
|
|
|
3
3
|
> JavaScript browser framework — full stack control, security by default, zero npm dependencies.
|
|
4
4
|
|
|
5
|
-
`@awacloud/fw` is a standalone framework for websites and web applications of moderate complexity. It takes the opposite stance from the modern toolchain (mandatory bundler, opaque dependency tree, supply chain to audit) by providing **
|
|
5
|
+
`@awacloud/fw` is a standalone framework for websites and web applications of moderate complexity. It takes the opposite stance from the modern toolchain (mandatory bundler, opaque dependency tree, supply chain to audit) by providing **208 autonomous modules** (the `src/core/modules.js` registry; a test of the source repository keeps this count equal to it) organised around an explicit resolution runtime and a global-lockdown layer that runs **before any other code**.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## Installation
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @awacloud/fw
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Quick start
|
|
14
|
+
|
|
15
|
+
On Bun (or any ESM runtime that resolves the package), import the entry and
|
|
16
|
+
resolve modules from the runtime:
|
|
17
|
+
|
|
18
|
+
```js
|
|
19
|
+
import fw from '@awacloud/fw';
|
|
20
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
21
|
+
fw.runtime.registerAll(modules);
|
|
22
|
+
|
|
23
|
+
const hex = fw.runtime.resolve('hex');
|
|
24
|
+
const utf8 = fw.runtime.resolve('utf8');
|
|
25
|
+
console.log(hex.fromBytes(utf8.toBytes('fw'))); // 6677
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
In a browser, load the sanity tier first, as a classic script, then map the package in an
|
|
29
|
+
import map and resolve modules from the runtime:
|
|
30
|
+
|
|
31
|
+
```html
|
|
32
|
+
<script src="/node_modules/@awacloud/fw/dist/build/sanity.min.js"></script>
|
|
33
|
+
<script type="importmap">
|
|
34
|
+
{ "imports": {
|
|
35
|
+
"@awacloud/fw": "/node_modules/@awacloud/fw/src/main.js",
|
|
36
|
+
"@awacloud/fw/": "/node_modules/@awacloud/fw/src/"
|
|
37
|
+
}}
|
|
38
|
+
</script>
|
|
39
|
+
<script type="module">
|
|
40
|
+
import fw from '@awacloud/fw';
|
|
41
|
+
import modules from '@awacloud/fw/core/modules.js';
|
|
42
|
+
fw.runtime.registerAll(modules);
|
|
43
|
+
|
|
44
|
+
const hex = fw.runtime.resolve('hex');
|
|
45
|
+
const utf8 = fw.runtime.resolve('utf8');
|
|
46
|
+
console.log(hex.fromBytes(utf8.toBytes('fw'))); // "6677"
|
|
47
|
+
</script>
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Paths assume `node_modules/` is reachable from the HTTP docroot (the default
|
|
51
|
+
after `npm install`). [Use cases](#use-cases) go further;
|
|
52
|
+
[Production build](#production-build) replaces the import map with bundles.
|
|
53
|
+
|
|
54
|
+
## Logging and `console`
|
|
55
|
+
|
|
56
|
+
Importing the entry (`@awacloud/fw`, `src/main.js`), or a preset bundle built
|
|
57
|
+
without `--no-log`, **takes over `console`** in a browser-shaped realm (one
|
|
58
|
+
with `window`): `window.console` becomes a non-configurable, non-writable
|
|
59
|
+
proxy that records every call in `fw.log` (an in-memory ring buffer, 1024
|
|
60
|
+
entries by default).
|
|
61
|
+
|
|
62
|
+
- **Printing**: in a dev build (`ENV.DEV`, the unbuilt sources) the calls are
|
|
63
|
+
also printed, with their stack; in a production build they are recorded
|
|
64
|
+
only — nothing reaches the browser console. Read them with
|
|
65
|
+
`fw.log.get()`, or stream them with `fw.log.subscribe(fn)`.
|
|
66
|
+
- **No reassignment**: `console.error = …` is refused with a warning, so a
|
|
67
|
+
test spy assigned that way stays silent; subscribe to `fw.log` instead.
|
|
68
|
+
- **A second fw entry** in the same realm (two bundles, a bundle plus the
|
|
69
|
+
sources, several test files in one process) joins the proxy the first one
|
|
70
|
+
installed: its own `log` records the same calls, and printing follows the
|
|
71
|
+
first entry's `ENV.DEV`. A `console` another script locked is left alone.
|
|
72
|
+
- **Native printing**: `log.native(true)` keeps the recording but prints
|
|
73
|
+
every `console` call as the native console does, in production too
|
|
74
|
+
(`log.native(false)` restores the default).
|
|
75
|
+
- **Opting out**: build with `--no-log` (`ENV.LOG = false`): no logger, no
|
|
76
|
+
takeover, `fw.log` is `false`. Under Node / Bun without a `window`, and
|
|
77
|
+
in workers outside `createWorker`, nothing is taken over.
|
|
78
|
+
|
|
79
|
+
See [`docs/api/core/logger.md`](./docs/api/core/logger.md).
|
|
8
80
|
|
|
9
81
|
## Why `@awacloud/fw`
|
|
10
82
|
|
|
@@ -145,28 +217,6 @@ export const myModule = {
|
|
|
145
217
|
|
|
146
218
|
The `factory` is called **once** by the runtime, after dependency resolution. The body of `factory` must be self-contained (no references to module-scope bindings) to remain serializable to a Worker.
|
|
147
219
|
|
|
148
|
-
## Installation
|
|
149
|
-
|
|
150
|
-
```bash
|
|
151
|
-
npm install @awacloud/fw
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
### Statically served HTML
|
|
155
|
-
|
|
156
|
-
```html
|
|
157
|
-
<script src="/node_modules/@awacloud/fw/dist/build/sanity.min.js"></script>
|
|
158
|
-
<script type="importmap">
|
|
159
|
-
{ "imports": {
|
|
160
|
-
"@awacloud/fw": "/node_modules/@awacloud/fw/src/main.js",
|
|
161
|
-
"@awacloud/fw/": "/node_modules/@awacloud/fw/src/"
|
|
162
|
-
}}
|
|
163
|
-
</script>
|
|
164
|
-
<script type="module">
|
|
165
|
-
import fw from '@awacloud/fw';
|
|
166
|
-
// ...
|
|
167
|
-
</script>
|
|
168
|
-
```
|
|
169
|
-
|
|
170
220
|
## Production build
|
|
171
221
|
|
|
172
222
|
The `sanity.min.js` bundle is **always isolated** and loaded as a classic script to guarantee the lockdown runs before any other code, without depending on the `defer` of modules or the import map. The rest of the framework is served via one (or more) ESM bundle built according to the chosen preset.
|
|
@@ -269,15 +319,15 @@ lockdown(); // default tier — composes base in a browser realm
|
|
|
269
319
|
|
|
270
320
|
| API | Behaviour after lockdown |
|
|
271
321
|
|---|---|
|
|
272
|
-
| `eval`, `new Function`, `Reflect` (property access) | `throw` |
|
|
322
|
+
| `eval`, `new Function`, `Reflect` (property access) | `throw` (`lockdown()` also closes the `({}).constructor.constructor` escape, which `base` alone leaves open) |
|
|
273
323
|
| `Math.random` | `throw` (force usage of `crypto.getRandomValues`) |
|
|
274
324
|
| `crypto.randomUUID` | `throw` (force usage of the framework's `uuid`, which is traceable) |
|
|
275
325
|
| `performance.now` | `throw` (timing vector — use the framework's `clock`) |
|
|
276
326
|
| `history.pushState`, `replaceState`, `go`, `back`, `forward` | `throw` (use the framework's `route`) |
|
|
277
|
-
| `Element.innerHTML`, `outerHTML
|
|
278
|
-
| Native prototypes (`Array
|
|
327
|
+
| `Element.innerHTML`, `outerHTML` (setters), `insertAdjacentHTML` (call) | redirect to `innerText`/`outerText`/`insertAdjacentText` (no parse, no XSS) |
|
|
328
|
+
| Native prototypes (`Object`, `Array`, `Function`, `String`, `Number`, `Boolean`, `Date`, `RegExp`, `Error`) | `Object.freeze` (`lockdown()` freezes every intrinsic) |
|
|
279
329
|
|
|
280
|
-
Consequence: any third-party code attempting these APIs **fails loudly**, which is both a safety net and an incompatibility detector. The fw modules that need them (e.g. `uuid`, `route`, `clock`, `random`) go through controlled channels.
|
|
330
|
+
fw itself works with or without a sanity tier: no module requires one. Consequence of applying one: any third-party code attempting these APIs **fails loudly**, which is both a safety net and an incompatibility detector. The fw modules that need them (e.g. `uuid`, `route`, `clock`, `random`) go through controlled channels.
|
|
281
331
|
|
|
282
332
|
See [`docs/guide/security.md`](./docs/guide/security.md) for the full tier spectrum (`community` / `base` / `lockdown`) and [`docs/guide/worker-confinement.md`](./docs/guide/worker-confinement.md) for the confinement half (Workers, capability grants).
|
|
283
333
|
|
|
@@ -297,12 +347,14 @@ See [`docs/guide/security.md`](./docs/guide/security.md) for the full tier spect
|
|
|
297
347
|
- [Integrations](./integrations/README.md) — bundlers, frameworks, runners
|
|
298
348
|
- [Security](./docs/guide/security.md) — sanity tier spectrum and honest threat model
|
|
299
349
|
- [NIST/RFC conformance](./src/crypto/NIST_CONFORMANCE.md) — crypto vector status
|
|
350
|
+
- [API stability](./docs/guide/stability.md) — the public surface, SemVer rules and deprecation cycle; the snapshot [`docs/api/surface.json`](./docs/api/surface.json)
|
|
351
|
+
- [L4 evidence](./docs/evidence/l4-evidence.md) — frozen API, conformance vectors, production use
|
|
300
352
|
|
|
301
353
|
## Playground
|
|
302
354
|
|
|
303
|
-
Runnable examples for `@awacloud/fw` — see [`playground/README.md`](https://github.com/awacloud/awa/blob/main/packages/front/fw/playground/README.md) (not part of the published npm package; browse it in the source repository).
|
|
355
|
+
Runnable examples for `@awacloud/fw` — see [`playground/README.md`](https://github.com/awacloud/awa/blob/main/packages/front/fw/playground/README.md) (not part of the published npm package; browse it in the source repository). Two axes: [`playground/integrations/`](https://github.com/awacloud/awa/blob/main/packages/front/fw/playground/integrations/README.md) (one example per integration) and [`playground/usecases/`](https://github.com/awacloud/awa/blob/main/packages/front/fw/playground/usecases/README.md) (small realistic apps). Serve the **package root** and open `/playground/`: `node playground/_tools/serve.mjs .`.
|
|
304
356
|
|
|
305
|
-
The `
|
|
357
|
+
The starter templates (`hello`, `todo`, `vite-ts`, `worker-rpc`) come with the source repository's `create-fw-app` scaffolding tool (`tools/create-fw-app/`), which copies one into a directory of a checkout.
|
|
306
358
|
|
|
307
359
|
## Development & tests
|
|
308
360
|
|
|
@@ -331,6 +383,86 @@ Detailed DX sheets in **[`docs/dev/`](docs/dev/README.md)**:
|
|
|
331
383
|
|
|
332
384
|
Each layer **includes** fw; it does not replace it. A site with no application complexity can stop at fw.
|
|
333
385
|
|
|
386
|
+
## Exposed sub-paths
|
|
387
|
+
|
|
388
|
+
Every module of the `io`, `dom`, `crypto` and `process` areas is reachable
|
|
389
|
+
by its path under `src/<area>/`, with its type declarations.
|
|
390
|
+
|
|
391
|
+
| Sub-path | Target | Usage |
|
|
392
|
+
|---|---|---|
|
|
393
|
+
| `@awacloud/fw` | `src/main.js` | Entry: `ENV`, `log`, `runtime`, `createWorker`, `domReady` (default export and named exports) |
|
|
394
|
+
| `@awacloud/fw/core/runtime` | `src/core/runtime.js` | `ModuleRuntime` and `runtimeSource`, to build a runtime of your own |
|
|
395
|
+
| `@awacloud/fw/core/worker-helper` | `src/core/worker-helper.js` | `createWorkerRuntime`, the worker bootstrap behind `createWorker` |
|
|
396
|
+
| `@awacloud/fw/core/readyState` | `src/core/readyState.js` | `readyState()`, the DOM ready-state helper behind `domReady` |
|
|
397
|
+
| `@awacloud/fw/core/logger` | `src/core/logger.js` | `logger`, the logger behind `log` |
|
|
398
|
+
| `@awacloud/fw/core/modules` | `src/core/modules.js` | Default export: the registry, every module descriptor, for `runtime.registerAll` |
|
|
399
|
+
| `@awacloud/fw/core/runtime.js` | `src/core/runtime.js` | Same, with the `.js` suffix |
|
|
400
|
+
| `@awacloud/fw/core/worker-helper.js` | `src/core/worker-helper.js` | Same, with the `.js` suffix |
|
|
401
|
+
| `@awacloud/fw/core/readyState.js` | `src/core/readyState.js` | Same, with the `.js` suffix |
|
|
402
|
+
| `@awacloud/fw/core/logger.js` | `src/core/logger.js` | Same, with the `.js` suffix |
|
|
403
|
+
| `@awacloud/fw/core/modules.js` | `src/core/modules.js` | Same, with the `.js` suffix |
|
|
404
|
+
| `@awacloud/fw/typed` | `src/typed.js` | `asTyped(rt)` and `createRuntime(ms)`: `resolve(name)` typed by module name |
|
|
405
|
+
| `@awacloud/fw/typed.js` | `src/typed.js` | Same, with the `.js` suffix |
|
|
406
|
+
| `@awacloud/fw/io/*.bin` | `src/io/*.bin` | Binary assets: `@awacloud/fw/io/compress/brotli_dict.bin`, the RFC 7932 dictionary |
|
|
407
|
+
| `@awacloud/fw/io/*.js` | `src/io/*.js` | One io module by path, with the `.js` suffix (the form an import map resolves), e.g. `@awacloud/fw/io/codec/hex.js` |
|
|
408
|
+
| `@awacloud/fw/io/*` | `src/io/*.js` | The same modules without the suffix, through the exports map, e.g. `@awacloud/fw/io/codec/hex` |
|
|
409
|
+
| `@awacloud/fw/dom/*.js` | `src/dom/*.js` | One dom module by path, with the `.js` suffix (the form an import map resolves), e.g. `@awacloud/fw/dom/rendering/template.js` |
|
|
410
|
+
| `@awacloud/fw/dom/*` | `src/dom/*.js` | The same modules without the suffix, through the exports map, e.g. `@awacloud/fw/dom/rendering/template` |
|
|
411
|
+
| `@awacloud/fw/crypto/*.wasm` | `src/crypto/*.wasm` | The WASM tier binaries, e.g. `@awacloud/fw/crypto/wasm/sha3.simd.wasm` |
|
|
412
|
+
| `@awacloud/fw/crypto/*.js` | `src/crypto/*.js` | One crypto module by path, with the `.js` suffix (the form an import map resolves), e.g. `@awacloud/fw/crypto/hash/sha256.js` |
|
|
413
|
+
| `@awacloud/fw/crypto/*` | `src/crypto/*.js` | The same modules without the suffix, through the exports map, e.g. `@awacloud/fw/crypto/hash/sha256` |
|
|
414
|
+
| `@awacloud/fw/process/*.js` | `src/process/*.js` | One process module by path, with the `.js` suffix (the form an import map resolves), e.g. `@awacloud/fw/process/workerPool.js` |
|
|
415
|
+
| `@awacloud/fw/process/*` | `src/process/*.js` | The same modules without the suffix, through the exports map, e.g. `@awacloud/fw/process/workerPool` |
|
|
416
|
+
| `@awacloud/fw/sanity/base` | `src/sanity/base.js` | `applyBase()`: the `base` tier as an ES module |
|
|
417
|
+
| `@awacloud/fw/sanity/base.js` | `src/sanity/base.js` | Same, with the `.js` suffix |
|
|
418
|
+
| `@awacloud/fw/sanity/base.classic` | `dist/build/sanity-base-classic.min.js` | The `base` tier as a classic script (build output) |
|
|
419
|
+
| `@awacloud/fw/sanity/community` | `src/sanity/community.js` | `applyCommunity()`: the `community` tier as an ES module |
|
|
420
|
+
| `@awacloud/fw/sanity/community.js` | `src/sanity/community.js` | Same, with the `.js` suffix |
|
|
421
|
+
| `@awacloud/fw/sanity/community.classic` | `dist/build/sanity-community-classic.min.js` | The `community` tier as a classic script (build output) |
|
|
422
|
+
| `@awacloud/fw/sanity/lockdown` | `src/sanity/lockdown.js` | `lockdown` and `harden`: the `lockdown` tier |
|
|
423
|
+
| `@awacloud/fw/sanity/lockdown.js` | `src/sanity/lockdown.js` | Same, with the `.js` suffix |
|
|
424
|
+
| `@awacloud/fw/sanity/lockdown.apply` | `src/sanity/lockdown-apply.js` | No exports: importing it runs `lockdown()` |
|
|
425
|
+
| `@awacloud/fw/sanity/lockdown-apply.js` | `src/sanity/lockdown-apply.js` | Same as `@awacloud/fw/sanity/lockdown.apply`, by its file name |
|
|
426
|
+
| `@awacloud/fw/config` | `fw.config.json` | `fw.config.json`: the build presets and side-bundles, as data |
|
|
427
|
+
| `@awacloud/fw/vite` | `integrations/vite/index.js` | The Vite plugin (default export) |
|
|
428
|
+
| `@awacloud/fw/vite-env` | `integrations/vite/vite-env.d.ts` | Types only: the plugin's virtual modules (`/// <reference types="@awacloud/fw/vite-env" />`) |
|
|
429
|
+
| `@awacloud/fw/esbuild` | `integrations/esbuild/index.js` | The esbuild integration |
|
|
430
|
+
| `@awacloud/fw/rollup` | `integrations/rollup/index.js` | The Rollup integration |
|
|
431
|
+
| `@awacloud/fw/bun` | `integrations/bun/index.js` | The Bun bundler integration |
|
|
432
|
+
| `@awacloud/fw/webpack` | `integrations/webpack/index.js` | The webpack integration |
|
|
433
|
+
| `@awacloud/fw/astro` | `integrations/astro/index.js` | The Astro integration |
|
|
434
|
+
| `@awacloud/fw/vitest/shim` | `integrations/vitest/bun-test-shim.js` | A `bun:test` stand-in, to run `bun:test` suites under Vitest |
|
|
435
|
+
| `@awacloud/fw/jest/shim` | `integrations/jest/bun-test-shim.js` | A `bun:test` stand-in, to run `bun:test` suites under Jest |
|
|
436
|
+
| `@awacloud/fw/next` | `integrations/nextjs/index.js` | The Next.js integration |
|
|
437
|
+
| `@awacloud/fw/turbopack` | `integrations/turbopack/index.js` | The Turbopack integration |
|
|
438
|
+
| `@awacloud/fw/nest` | `integrations/nestjs/index.js` | The NestJS integration |
|
|
439
|
+
| `@awacloud/fw/eslint` | `integrations/eslint/no-factory-capture.js` | The `fw/no-factory-capture` ESLint rule |
|
|
440
|
+
| `@awacloud/fw/dist/build/*` | `dist/build/*` | Build outputs: the classic sanity scripts and the preset bundles |
|
|
441
|
+
|
|
442
|
+
Test files, KAT vectors and the markdown sources under `src/` are not
|
|
443
|
+
exported.
|
|
444
|
+
|
|
445
|
+
The `*.classic` scripts and `dist/build/*` are build outputs: shipped in the
|
|
446
|
+
published package; in a source checkout, run `bun run prebuild` in
|
|
447
|
+
`packages/front/fw` first.
|
|
448
|
+
|
|
449
|
+
## Maturity
|
|
450
|
+
|
|
451
|
+
L4 (`awa.maturity` in `package.json`), the top of the monorepo's L0 to L4
|
|
452
|
+
scale. The public API is frozen: [`docs/guide/stability.md`](./docs/guide/stability.md)
|
|
453
|
+
says what SemVer covers and how a breaking change is deprecated first, and a
|
|
454
|
+
snapshot gate keeps the package equal to
|
|
455
|
+
[`docs/api/surface.json`](./docs/api/surface.json). Every standard the package
|
|
456
|
+
implements runs its conformance vectors, and fw runs in production — see
|
|
457
|
+
[`docs/evidence/l4-evidence.md`](./docs/evidence/l4-evidence.md). The published
|
|
458
|
+
surface (`src/`, `integrations/`) is covered by the package's test suite under a
|
|
459
|
+
92 % line-coverage floor, and every registry module has a reference page under
|
|
460
|
+
[`docs/api/`](./docs/api/README.md). The version is 1.0.0: the
|
|
461
|
+
public surface is frozen under SemVer (see [`docs/guide/stability.md`](./docs/guide/stability.md)),
|
|
462
|
+
and every break of the 0.x line is listed under **Breaking** in [`CHANGELOG.md`](./CHANGELOG.md). The crypto
|
|
463
|
+
tier's API is frozen with the rest; its assurance is an early release, see
|
|
464
|
+
[Crypto tier — early release](#crypto-tier--early-release).
|
|
465
|
+
|
|
334
466
|
## Licence
|
|
335
467
|
|
|
336
468
|
Apache-2.0 — see [`LICENSE`](./LICENSE) in this package.
|
|
@@ -339,7 +471,7 @@ Copyright (c) 2026 AwaCloud SAS
|
|
|
339
471
|
|
|
340
472
|
## Project
|
|
341
473
|
|
|
342
|
-
- Website: https://awaforge.eu
|
|
474
|
+
- Website: https://awaforge.eu/
|
|
343
475
|
- Source: [`packages/front/fw`](https://github.com/awacloud/awa/tree/main/packages/front/fw)
|
|
344
476
|
- Issues: this package's own repository has issues disabled — report at
|
|
345
477
|
https://github.com/awacloud/awa/issues
|
|
@@ -17,13 +17,13 @@
|
|
|
17
17
|
"name": "core",
|
|
18
18
|
"variant": "pure",
|
|
19
19
|
"bytes": {
|
|
20
|
-
"min":
|
|
21
|
-
"minGz":
|
|
22
|
-
"dev":
|
|
23
|
-
"devGz":
|
|
20
|
+
"min": 33600,
|
|
21
|
+
"minGz": 11625,
|
|
22
|
+
"dev": 70439,
|
|
23
|
+
"devGz": 15091
|
|
24
24
|
},
|
|
25
25
|
"hashSha256": {
|
|
26
|
-
"min": "
|
|
27
|
-
"dev": "
|
|
26
|
+
"min": "48fe65b45d713cef2476ed93399a6c0352aa3d396646481035e68c5755ee2c3d",
|
|
27
|
+
"dev": "02dc52b7096f21a64233a81a36ff8af3ab7dc46bdb5f03bce8e74d39a61c959b"
|
|
28
28
|
}
|
|
29
29
|
}
|