@awacloud/fw 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +79 -0
- package/LICENSE +176 -0
- package/NOTICE +12 -0
- package/README.md +355 -0
- package/dist/build/fw.core.pure.meta.json +29 -0
- package/dist/build/fw.core.pure.min.js +26 -0
- package/dist/build/fw.full.pure.meta.json +224 -0
- package/dist/build/fw.full.pure.min.js +60 -0
- package/dist/build/fw.minimal.pure.meta.json +21 -0
- package/dist/build/fw.minimal.pure.min.js +26 -0
- package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
- package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
- package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
- package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
- package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
- package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
- package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
- package/dist/build/fw.pack.realtime.pure.min.js +6 -0
- package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
- package/dist/build/fw.pack.sensors.pure.min.js +6 -0
- package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
- package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
- package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
- package/dist/build/fw.pwa.pure.meta.json +127 -0
- package/dist/build/fw.pwa.pure.min.js +55 -0
- package/dist/build/fw.site-interactive.pure.meta.json +81 -0
- package/dist/build/fw.site-interactive.pure.min.js +52 -0
- package/dist/build/fw.site.pure.meta.json +51 -0
- package/dist/build/fw.site.pure.min.js +35 -0
- package/dist/build/fw.spa.pure.meta.json +108 -0
- package/dist/build/fw.spa.pure.min.js +55 -0
- package/dist/build/io/compress/brotli_dict.bin +432 -0
- package/dist/build/sanity-base-classic.min.js +6 -0
- package/dist/build/sanity-community-classic.min.js +6 -0
- package/dist/build/sanity.min.js +6 -0
- package/dist/types/core/logger.d.ts +71 -0
- package/dist/types/core/logger.d.ts.map +1 -0
- package/dist/types/core/modules.d.ts +3962 -0
- package/dist/types/core/modules.d.ts.map +1 -0
- package/dist/types/core/readyState.d.ts +14 -0
- package/dist/types/core/readyState.d.ts.map +1 -0
- package/dist/types/core/runtime.d.ts +625 -0
- package/dist/types/core/runtime.d.ts.map +1 -0
- package/dist/types/core/worker-helper.d.ts +153 -0
- package/dist/types/core/worker-helper.d.ts.map +1 -0
- package/dist/types/crypto/cipher/aes.d.ts +55 -0
- package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
- package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
- package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
- package/dist/types/crypto/hash/adf.d.ts +65 -0
- package/dist/types/crypto/hash/adf.d.ts.map +1 -0
- package/dist/types/crypto/hash/argon2.d.ts +79 -0
- package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
- package/dist/types/crypto/hash/blake2b.d.ts +40 -0
- package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/hash/hkdf.d.ts +88 -0
- package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/hash/hmac.d.ts +85 -0
- package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
- package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/hash/poly1305.d.ts +31 -0
- package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha224.d.ts +80 -0
- package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha256.d.ts +82 -0
- package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha3.d.ts +111 -0
- package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha384.d.ts +84 -0
- package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512.d.ts +87 -0
- package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
- package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
- package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
- package/dist/types/crypto/mode/cbc.d.ts +38 -0
- package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
- package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/mode/cmac.d.ts +56 -0
- package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
- package/dist/types/crypto/mode/ctr.d.ts +52 -0
- package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
- package/dist/types/crypto/mode/gcm.d.ts +88 -0
- package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
- package/dist/types/crypto/mode/kw.d.ts +60 -0
- package/dist/types/crypto/mode/kw.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ecc.d.ts +284 -0
- package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
- package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
- package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
- package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
- package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
- package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/pkc/rsa.d.ts +175 -0
- package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
- package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/pkc/x25519.d.ts +37 -0
- package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
- package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
- package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
- package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
- package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
- package/dist/types/crypto/utils/asn1.d.ts +115 -0
- package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
- package/dist/types/crypto/utils/bitArray.d.ts +75 -0
- package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
- package/dist/types/crypto/utils/bn.d.ts +214 -0
- package/dist/types/crypto/utils/bn.d.ts.map +1 -0
- package/dist/types/crypto/utils/jws.d.ts +159 -0
- package/dist/types/crypto/utils/jws.d.ts.map +1 -0
- package/dist/types/crypto/utils/keyformat.d.ts +100 -0
- package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
- package/dist/types/crypto/utils/pad.d.ts +44 -0
- package/dist/types/crypto/utils/pad.d.ts.map +1 -0
- package/dist/types/crypto/utils/pem.d.ts +41 -0
- package/dist/types/crypto/utils/pem.d.ts.map +1 -0
- package/dist/types/crypto/utils/random.d.ts +203 -0
- package/dist/types/crypto/utils/random.d.ts.map +1 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
- package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
- package/dist/types/crypto/utils/totp.d.ts +183 -0
- package/dist/types/crypto/utils/totp.d.ts.map +1 -0
- package/dist/types/crypto/utils/uuid.d.ts +29 -0
- package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
- package/dist/types/crypto/wasm/aes.d.ts +59 -0
- package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
- package/dist/types/crypto/wasm/argon2.d.ts +70 -0
- package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
- package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
- package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
- package/dist/types/crypto/wasm/cmac.d.ts +42 -0
- package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ecc.d.ts +56 -0
- package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
- package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
- package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/wasm/hmac.d.ts +42 -0
- package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
- package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
- package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
- package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/rsa.d.ts +56 -0
- package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/runtime.d.ts +99 -0
- package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha2.d.ts +45 -0
- package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
- package/dist/types/crypto/wasm/sha3.d.ts +57 -0
- package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
- package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
- package/dist/types/crypto/wasm/x25519.d.ts +53 -0
- package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
- package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
- package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
- package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
- package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
- package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
- package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
- package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
- package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
- package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
- package/dist/types/dom/display/animate.d.ts +35 -0
- package/dist/types/dom/display/animate.d.ts.map +1 -0
- package/dist/types/dom/display/fullscreen.d.ts +59 -0
- package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
- package/dist/types/dom/fs/download.d.ts +36 -0
- package/dist/types/dom/fs/download.d.ts.map +1 -0
- package/dist/types/dom/fs/fsAccess.d.ts +107 -0
- package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
- package/dist/types/dom/fs/indexedDB.d.ts +62 -0
- package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
- package/dist/types/dom/fs/remoteStore.d.ts +64 -0
- package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
- package/dist/types/dom/fs/storage.d.ts +56 -0
- package/dist/types/dom/fs/storage.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/idle.d.ts +91 -0
- package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
- package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
- package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
- package/dist/types/dom/net/ajax.d.ts +27 -0
- package/dist/types/dom/net/ajax.d.ts.map +1 -0
- package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
- package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
- package/dist/types/dom/net/network.d.ts +80 -0
- package/dist/types/dom/net/network.d.ts.map +1 -0
- package/dist/types/dom/net/sse.d.ts +72 -0
- package/dist/types/dom/net/sse.d.ts.map +1 -0
- package/dist/types/dom/net/webrtc.d.ts +149 -0
- package/dist/types/dom/net/webrtc.d.ts.map +1 -0
- package/dist/types/dom/net/ws.d.ts +70 -0
- package/dist/types/dom/net/ws.d.ts.map +1 -0
- package/dist/types/dom/query/dnd.d.ts +86 -0
- package/dist/types/dom/query/dnd.d.ts.map +1 -0
- package/dist/types/dom/query/dom.d.ts +194 -0
- package/dist/types/dom/query/dom.d.ts.map +1 -0
- package/dist/types/dom/query/events.d.ts +135 -0
- package/dist/types/dom/query/events.d.ts.map +1 -0
- package/dist/types/dom/query/gesture.d.ts +59 -0
- package/dist/types/dom/query/gesture.d.ts.map +1 -0
- package/dist/types/dom/query/media.d.ts +156 -0
- package/dist/types/dom/query/media.d.ts.map +1 -0
- package/dist/types/dom/rendering/chart.d.ts +143 -0
- package/dist/types/dom/rendering/chart.d.ts.map +1 -0
- package/dist/types/dom/rendering/component.d.ts +92 -0
- package/dist/types/dom/rendering/component.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
- package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
- package/dist/types/dom/rendering/devtools.d.ts +68 -0
- package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
- package/dist/types/dom/rendering/parser.d.ts +216 -0
- package/dist/types/dom/rendering/parser.d.ts.map +1 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
- package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
- package/dist/types/dom/rendering/render.d.ts +121 -0
- package/dist/types/dom/rendering/render.d.ts.map +1 -0
- package/dist/types/dom/rendering/sanitize.d.ts +48 -0
- package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
- package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
- package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
- package/dist/types/dom/rendering/template.d.ts +251 -0
- package/dist/types/dom/rendering/template.d.ts.map +1 -0
- package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
- package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
- package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
- package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
- package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
- package/dist/types/dom/rendering/uiSession.d.ts +285 -0
- package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
- package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
- package/dist/types/dom/sensors/battery.d.ts +71 -0
- package/dist/types/dom/sensors/battery.d.ts.map +1 -0
- package/dist/types/dom/sensors/geolocation.d.ts +83 -0
- package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
- package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
- package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
- package/dist/types/dom/sensors/sensors.d.ts +191 -0
- package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
- package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
- package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
- package/dist/types/dom/sw/cache.d.ts +71 -0
- package/dist/types/dom/sw/cache.d.ts.map +1 -0
- package/dist/types/dom/sw/push.d.ts +77 -0
- package/dist/types/dom/sw/push.d.ts.map +1 -0
- package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
- package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
- package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
- package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
- package/dist/types/dom/utils/a11y.d.ts +53 -0
- package/dist/types/dom/utils/a11y.d.ts.map +1 -0
- package/dist/types/dom/utils/clipboard.d.ts +44 -0
- package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
- package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
- package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
- package/dist/types/dom/utils/focus.d.ts +123 -0
- package/dist/types/dom/utils/focus.d.ts.map +1 -0
- package/dist/types/dom/utils/form.d.ts +227 -0
- package/dist/types/dom/utils/form.d.ts.map +1 -0
- package/dist/types/dom/utils/formKit.d.ts +206 -0
- package/dist/types/dom/utils/formKit.d.ts.map +1 -0
- package/dist/types/dom/utils/keybindings.d.ts +53 -0
- package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
- package/dist/types/dom/utils/leaderElection.d.ts +70 -0
- package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
- package/dist/types/dom/utils/notifications.d.ts +164 -0
- package/dist/types/dom/utils/notifications.d.ts.map +1 -0
- package/dist/types/dom/utils/permissions.d.ts +35 -0
- package/dist/types/dom/utils/permissions.d.ts.map +1 -0
- package/dist/types/dom/utils/route.d.ts +117 -0
- package/dist/types/dom/utils/route.d.ts.map +1 -0
- package/dist/types/dom/utils/ua.d.ts +35 -0
- package/dist/types/dom/utils/ua.d.ts.map +1 -0
- package/dist/types/dom/utils/webauthn.d.ts +98 -0
- package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
- package/dist/types/io/binary/reader.d.ts +59 -0
- package/dist/types/io/binary/reader.d.ts.map +1 -0
- package/dist/types/io/binary/writer.d.ts +56 -0
- package/dist/types/io/binary/writer.d.ts.map +1 -0
- package/dist/types/io/calc/adler32.d.ts +31 -0
- package/dist/types/io/calc/adler32.d.ts.map +1 -0
- package/dist/types/io/calc/bigint.d.ts +74 -0
- package/dist/types/io/calc/bigint.d.ts.map +1 -0
- package/dist/types/io/calc/crc32.d.ts +36 -0
- package/dist/types/io/calc/crc32.d.ts.map +1 -0
- package/dist/types/io/calc/easing.d.ts +60 -0
- package/dist/types/io/calc/easing.d.ts.map +1 -0
- package/dist/types/io/codec/b64.d.ts +28 -0
- package/dist/types/io/codec/b64.d.ts.map +1 -0
- package/dist/types/io/codec/base32.d.ts +28 -0
- package/dist/types/io/codec/base32.d.ts.map +1 -0
- package/dist/types/io/codec/base58.d.ts +28 -0
- package/dist/types/io/codec/base58.d.ts.map +1 -0
- package/dist/types/io/codec/buffer.d.ts +66 -0
- package/dist/types/io/codec/buffer.d.ts.map +1 -0
- package/dist/types/io/codec/cbor.d.ts +43 -0
- package/dist/types/io/codec/cbor.d.ts.map +1 -0
- package/dist/types/io/codec/csv.d.ts +35 -0
- package/dist/types/io/codec/csv.d.ts.map +1 -0
- package/dist/types/io/codec/hex.d.ts +28 -0
- package/dist/types/io/codec/hex.d.ts.map +1 -0
- package/dist/types/io/codec/mime.d.ts +100 -0
- package/dist/types/io/codec/mime.d.ts.map +1 -0
- package/dist/types/io/codec/msgpack.d.ts +36 -0
- package/dist/types/io/codec/msgpack.d.ts.map +1 -0
- package/dist/types/io/codec/url.d.ts +52 -0
- package/dist/types/io/codec/url.d.ts.map +1 -0
- package/dist/types/io/codec/utf8.d.ts +22 -0
- package/dist/types/io/codec/utf8.d.ts.map +1 -0
- package/dist/types/io/codec/xml.d.ts +91 -0
- package/dist/types/io/codec/xml.d.ts.map +1 -0
- package/dist/types/io/compress/bitstream.d.ts +51 -0
- package/dist/types/io/compress/bitstream.d.ts.map +1 -0
- package/dist/types/io/compress/brotli.d.ts +86 -0
- package/dist/types/io/compress/brotli.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict.d.ts +76 -0
- package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
- package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_frame.d.ts +166 -0
- package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
- package/dist/types/io/compress/brotli_shared.d.ts +165 -0
- package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
- package/dist/types/io/compress/deflate.d.ts +89 -0
- package/dist/types/io/compress/deflate.d.ts.map +1 -0
- package/dist/types/io/compress/gzip.d.ts +100 -0
- package/dist/types/io/compress/gzip.d.ts.map +1 -0
- package/dist/types/io/compress/huffman.d.ts +37 -0
- package/dist/types/io/compress/huffman.d.ts.map +1 -0
- package/dist/types/io/compress/lz4.d.ts +45 -0
- package/dist/types/io/compress/lz4.d.ts.map +1 -0
- package/dist/types/io/compress/lz77.d.ts +66 -0
- package/dist/types/io/compress/lz77.d.ts.map +1 -0
- package/dist/types/io/compress/lzw.d.ts +37 -0
- package/dist/types/io/compress/lzw.d.ts.map +1 -0
- package/dist/types/io/compress/zip.d.ts +112 -0
- package/dist/types/io/compress/zip.d.ts.map +1 -0
- package/dist/types/io/compress/zlib.d.ts +97 -0
- package/dist/types/io/compress/zlib.d.ts.map +1 -0
- package/dist/types/io/i18n/i18n.d.ts +64 -0
- package/dist/types/io/i18n/i18n.d.ts.map +1 -0
- package/dist/types/io/math/fixed-point.d.ts +30 -0
- package/dist/types/io/math/fixed-point.d.ts.map +1 -0
- package/dist/types/io/math/geom.d.ts +125 -0
- package/dist/types/io/math/geom.d.ts.map +1 -0
- package/dist/types/io/math/interp.d.ts +48 -0
- package/dist/types/io/math/interp.d.ts.map +1 -0
- package/dist/types/io/math/linalg.d.ts +117 -0
- package/dist/types/io/math/linalg.d.ts.map +1 -0
- package/dist/types/io/math/stats.d.ts +45 -0
- package/dist/types/io/math/stats.d.ts.map +1 -0
- package/dist/types/io/structures/btree.d.ts +84 -0
- package/dist/types/io/structures/btree.d.ts.map +1 -0
- package/dist/types/io/structures/heap.d.ts +75 -0
- package/dist/types/io/structures/heap.d.ts.map +1 -0
- package/dist/types/io/structures/lruCache.d.ts +88 -0
- package/dist/types/io/structures/lruCache.d.ts.map +1 -0
- package/dist/types/io/structures/ringBuffer.d.ts +82 -0
- package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
- package/dist/types/io/structures/tree-walker.d.ts +95 -0
- package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
- package/dist/types/io/structures/trie.d.ts +71 -0
- package/dist/types/io/structures/trie.d.ts.map +1 -0
- package/dist/types/io/sync/abort.d.ts +59 -0
- package/dist/types/io/sync/abort.d.ts.map +1 -0
- package/dist/types/io/sync/atomics.d.ts +107 -0
- package/dist/types/io/sync/atomics.d.ts.map +1 -0
- package/dist/types/io/sync/cancellable.d.ts +69 -0
- package/dist/types/io/sync/cancellable.d.ts.map +1 -0
- package/dist/types/io/sync/channel.d.ts +70 -0
- package/dist/types/io/sync/channel.d.ts.map +1 -0
- package/dist/types/io/sync/mutex.d.ts +39 -0
- package/dist/types/io/sync/mutex.d.ts.map +1 -0
- package/dist/types/io/sync/semaphore.d.ts +40 -0
- package/dist/types/io/sync/semaphore.d.ts.map +1 -0
- package/dist/types/io/sync/tokenBucket.d.ts +53 -0
- package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
- package/dist/types/io/text/ansi.d.ts +125 -0
- package/dist/types/io/text/ansi.d.ts.map +1 -0
- package/dist/types/io/text/html-entities.d.ts +35 -0
- package/dist/types/io/text/html-entities.d.ts.map +1 -0
- package/dist/types/io/text/semver.d.ts +75 -0
- package/dist/types/io/text/semver.d.ts.map +1 -0
- package/dist/types/io/text/str.d.ts +88 -0
- package/dist/types/io/text/str.d.ts.map +1 -0
- package/dist/types/io/text/unicode.d.ts +70 -0
- package/dist/types/io/text/unicode.d.ts.map +1 -0
- package/dist/types/io/time/date.d.ts +73 -0
- package/dist/types/io/time/date.d.ts.map +1 -0
- package/dist/types/io/timing/clock.d.ts +39 -0
- package/dist/types/io/timing/clock.d.ts.map +1 -0
- package/dist/types/io/timing/rateLimit.d.ts +40 -0
- package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
- package/dist/types/io/timing/scheduler.d.ts +122 -0
- package/dist/types/io/timing/scheduler.d.ts.map +1 -0
- package/dist/types/io/utils/bitmap.d.ts +34 -0
- package/dist/types/io/utils/bitmap.d.ts.map +1 -0
- package/dist/types/io/utils/errors.d.ts +94 -0
- package/dist/types/io/utils/errors.d.ts.map +1 -0
- package/dist/types/io/utils/eventBus.d.ts +68 -0
- package/dist/types/io/utils/eventBus.d.ts.map +1 -0
- package/dist/types/io/utils/queue.d.ts +69 -0
- package/dist/types/io/utils/queue.d.ts.map +1 -0
- package/dist/types/io/utils/signal.d.ts +362 -0
- package/dist/types/io/utils/signal.d.ts.map +1 -0
- package/dist/types/io/utils/ui8.d.ts +34 -0
- package/dist/types/io/utils/ui8.d.ts.map +1 -0
- package/dist/types/io/utils/valid.d.ts +130 -0
- package/dist/types/io/utils/valid.d.ts.map +1 -0
- package/dist/types/main.d.ts +25 -0
- package/dist/types/main.d.ts.map +1 -0
- package/dist/types/process/message.d.ts +64 -0
- package/dist/types/process/message.d.ts.map +1 -0
- package/dist/types/process/rpc.d.ts +35 -0
- package/dist/types/process/rpc.d.ts.map +1 -0
- package/dist/types/process/workerPool.d.ts +62 -0
- package/dist/types/process/workerPool.d.ts.map +1 -0
- package/dist/types/sanity/base.d.ts +28 -0
- package/dist/types/sanity/base.d.ts.map +1 -0
- package/dist/types/sanity/community.d.ts +20 -0
- package/dist/types/sanity/community.d.ts.map +1 -0
- package/dist/types/sanity/lockdown-apply.d.ts +7 -0
- package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
- package/dist/types/sanity/lockdown.d.ts +43 -0
- package/dist/types/sanity/lockdown.d.ts.map +1 -0
- package/dist/types/sanity/wasm-gate.d.ts +128 -0
- package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
- package/docs/README.md +301 -0
- package/docs/api/README.md +33 -0
- package/docs/api/core/README.md +14 -0
- package/docs/api/core/logger.md +151 -0
- package/docs/api/core/main.md +105 -0
- package/docs/api/core/modules.md +123 -0
- package/docs/api/core/readyState.md +94 -0
- package/docs/api/core/runtime.md +499 -0
- package/docs/api/core/worker-helper.md +180 -0
- package/docs/api/crypto/README.md +39 -0
- package/docs/api/crypto/cipher/README.md +24 -0
- package/docs/api/crypto/cipher/aes.md +101 -0
- package/docs/api/crypto/cipher/chacha20.md +85 -0
- package/docs/api/crypto/hash/README.md +49 -0
- package/docs/api/crypto/hash/adf.md +61 -0
- package/docs/api/crypto/hash/argon2.md +92 -0
- package/docs/api/crypto/hash/blake2b.md +88 -0
- package/docs/api/crypto/hash/hkdf.md +82 -0
- package/docs/api/crypto/hash/hmac.md +90 -0
- package/docs/api/crypto/hash/pbkdf2.md +93 -0
- package/docs/api/crypto/hash/poly1305.md +71 -0
- package/docs/api/crypto/hash/sha224.md +61 -0
- package/docs/api/crypto/hash/sha256.md +84 -0
- package/docs/api/crypto/hash/sha3.md +89 -0
- package/docs/api/crypto/hash/sha384.md +58 -0
- package/docs/api/crypto/hash/sha512.md +73 -0
- package/docs/api/crypto/hash/sha512_224.md +59 -0
- package/docs/api/crypto/hash/sha512_256.md +58 -0
- package/docs/api/crypto/mode/README.md +33 -0
- package/docs/api/crypto/mode/cbc.md +69 -0
- package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
- package/docs/api/crypto/mode/cmac.md +79 -0
- package/docs/api/crypto/mode/ctr.md +66 -0
- package/docs/api/crypto/mode/gcm.md +93 -0
- package/docs/api/crypto/mode/kw.md +84 -0
- package/docs/api/crypto/pkc/README.md +48 -0
- package/docs/api/crypto/pkc/ecc.md +91 -0
- package/docs/api/crypto/pkc/ed25519.md +99 -0
- package/docs/api/crypto/pkc/hybridKem.md +178 -0
- package/docs/api/crypto/pkc/hybridSign.md +192 -0
- package/docs/api/crypto/pkc/ml_dsa.md +99 -0
- package/docs/api/crypto/pkc/ml_kem.md +90 -0
- package/docs/api/crypto/pkc/rsa.md +87 -0
- package/docs/api/crypto/pkc/slh_dsa.md +86 -0
- package/docs/api/crypto/pkc/x25519.md +84 -0
- package/docs/api/crypto/utils/README.md +39 -0
- package/docs/api/crypto/utils/aes_ctr.md +71 -0
- package/docs/api/crypto/utils/aes_modes.md +81 -0
- package/docs/api/crypto/utils/asn1-oid.md +130 -0
- package/docs/api/crypto/utils/asn1.md +69 -0
- package/docs/api/crypto/utils/bitArray.md +77 -0
- package/docs/api/crypto/utils/bn.md +67 -0
- package/docs/api/crypto/utils/jws.md +94 -0
- package/docs/api/crypto/utils/keyformat.md +78 -0
- package/docs/api/crypto/utils/pad.md +66 -0
- package/docs/api/crypto/utils/pem.md +63 -0
- package/docs/api/crypto/utils/random.md +103 -0
- package/docs/api/crypto/utils/rsaKeygen.md +118 -0
- package/docs/api/crypto/utils/totp.md +159 -0
- package/docs/api/crypto/utils/uuid.md +98 -0
- package/docs/api/crypto/wasm/README.md +76 -0
- package/docs/api/crypto/wasm/aes.md +128 -0
- package/docs/api/crypto/wasm/argon2.md +110 -0
- package/docs/api/crypto/wasm/blake2b.md +103 -0
- package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
- package/docs/api/crypto/wasm/cmac.md +119 -0
- package/docs/api/crypto/wasm/ecc.md +114 -0
- package/docs/api/crypto/wasm/ed25519.md +117 -0
- package/docs/api/crypto/wasm/hkdf.md +163 -0
- package/docs/api/crypto/wasm/hmac.md +129 -0
- package/docs/api/crypto/wasm/ml_dsa.md +99 -0
- package/docs/api/crypto/wasm/ml_kem.md +91 -0
- package/docs/api/crypto/wasm/pbkdf2.md +111 -0
- package/docs/api/crypto/wasm/rsa.md +113 -0
- package/docs/api/crypto/wasm/runtime.md +172 -0
- package/docs/api/crypto/wasm/sha2.md +95 -0
- package/docs/api/crypto/wasm/sha3.md +127 -0
- package/docs/api/crypto/wasm/slh_dsa.md +89 -0
- package/docs/api/crypto/wasm/x25519.md +116 -0
- package/docs/api/crypto/webcrypto/README.md +56 -0
- package/docs/api/crypto/webcrypto/aes.md +140 -0
- package/docs/api/crypto/webcrypto/aeskw.md +120 -0
- package/docs/api/crypto/webcrypto/digest.md +103 -0
- package/docs/api/crypto/webcrypto/ecc.md +122 -0
- package/docs/api/crypto/webcrypto/ed25519.md +121 -0
- package/docs/api/crypto/webcrypto/hkdf.md +141 -0
- package/docs/api/crypto/webcrypto/hmac.md +112 -0
- package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
- package/docs/api/crypto/webcrypto/rsa.md +149 -0
- package/docs/api/crypto/webcrypto/x25519.md +96 -0
- package/docs/api/dom/README.md +117 -0
- package/docs/api/dom/display/README.md +27 -0
- package/docs/api/dom/display/animate.md +113 -0
- package/docs/api/dom/display/fullscreen.md +121 -0
- package/docs/api/dom/fs/README.md +36 -0
- package/docs/api/dom/fs/download.md +108 -0
- package/docs/api/dom/fs/fsAccess.md +200 -0
- package/docs/api/dom/fs/indexedDB.md +219 -0
- package/docs/api/dom/fs/remoteStore.md +158 -0
- package/docs/api/dom/fs/storage.md +197 -0
- package/docs/api/dom/lifecycle/README.md +11 -0
- package/docs/api/dom/lifecycle/idle.md +89 -0
- package/docs/api/dom/lifecycle/visibility.md +73 -0
- package/docs/api/dom/lifecycle/wakeLock.md +94 -0
- package/docs/api/dom/net/README.md +31 -0
- package/docs/api/dom/net/ajax.md +176 -0
- package/docs/api/dom/net/broadcastChannel.md +110 -0
- package/docs/api/dom/net/network.md +137 -0
- package/docs/api/dom/net/sse.md +141 -0
- package/docs/api/dom/net/webrtc.md +158 -0
- package/docs/api/dom/net/ws.md +168 -0
- package/docs/api/dom/query/README.md +30 -0
- package/docs/api/dom/query/dnd.md +137 -0
- package/docs/api/dom/query/dom.md +275 -0
- package/docs/api/dom/query/events.md +211 -0
- package/docs/api/dom/query/gesture.md +137 -0
- package/docs/api/dom/query/media.md +188 -0
- package/docs/api/dom/rendering/README.md +41 -0
- package/docs/api/dom/rendering/chart.md +149 -0
- package/docs/api/dom/rendering/component.md +287 -0
- package/docs/api/dom/rendering/devtools-ui.md +129 -0
- package/docs/api/dom/rendering/devtools.md +157 -0
- package/docs/api/dom/rendering/parser.md +200 -0
- package/docs/api/dom/rendering/reactiveBind.md +234 -0
- package/docs/api/dom/rendering/render.md +219 -0
- package/docs/api/dom/rendering/sanitize.md +97 -0
- package/docs/api/dom/rendering/secPolicy.md +155 -0
- package/docs/api/dom/rendering/template.md +301 -0
- package/docs/api/dom/rendering/themeTokens.md +175 -0
- package/docs/api/dom/rendering/uiSession.md +546 -0
- package/docs/api/dom/rendering/virtualScroll.md +126 -0
- package/docs/api/dom/sensors/README.md +12 -0
- package/docs/api/dom/sensors/battery.md +70 -0
- package/docs/api/dom/sensors/geolocation.md +115 -0
- package/docs/api/dom/sensors/networkInfo.md +73 -0
- package/docs/api/dom/sensors/sensors.md +123 -0
- package/docs/api/dom/sw/README.md +31 -0
- package/docs/api/dom/sw/backgroundSync.md +145 -0
- package/docs/api/dom/sw/cache.md +116 -0
- package/docs/api/dom/sw/push.md +114 -0
- package/docs/api/dom/sw/serviceWorker.md +90 -0
- package/docs/api/dom/sw/sharedWorker.md +131 -0
- package/docs/api/dom/utils/README.md +25 -0
- package/docs/api/dom/utils/a11y.md +143 -0
- package/docs/api/dom/utils/clipboard.md +146 -0
- package/docs/api/dom/utils/entropyCollector.md +175 -0
- package/docs/api/dom/utils/focus.md +140 -0
- package/docs/api/dom/utils/form.md +196 -0
- package/docs/api/dom/utils/formKit.md +181 -0
- package/docs/api/dom/utils/keybindings.md +138 -0
- package/docs/api/dom/utils/leaderElection.md +130 -0
- package/docs/api/dom/utils/notifications.md +106 -0
- package/docs/api/dom/utils/permissions.md +82 -0
- package/docs/api/dom/utils/route.md +112 -0
- package/docs/api/dom/utils/ua.md +119 -0
- package/docs/api/dom/utils/webauthn.md +190 -0
- package/docs/api/io/README.md +20 -0
- package/docs/api/io/binary/README.md +29 -0
- package/docs/api/io/binary/reader.md +126 -0
- package/docs/api/io/binary/writer.md +127 -0
- package/docs/api/io/calc/README.md +22 -0
- package/docs/api/io/calc/adler32.md +75 -0
- package/docs/api/io/calc/bigint.md +105 -0
- package/docs/api/io/calc/crc32.md +74 -0
- package/docs/api/io/calc/easing.md +118 -0
- package/docs/api/io/codec/README.md +35 -0
- package/docs/api/io/codec/b64.md +92 -0
- package/docs/api/io/codec/base32.md +98 -0
- package/docs/api/io/codec/base58.md +104 -0
- package/docs/api/io/codec/buffer.md +144 -0
- package/docs/api/io/codec/cbor.md +179 -0
- package/docs/api/io/codec/csv.md +178 -0
- package/docs/api/io/codec/hex.md +75 -0
- package/docs/api/io/codec/mime.md +156 -0
- package/docs/api/io/codec/msgpack.md +142 -0
- package/docs/api/io/codec/url.md +265 -0
- package/docs/api/io/codec/utf8.md +84 -0
- package/docs/api/io/codec/xml.md +87 -0
- package/docs/api/io/compress/README.md +62 -0
- package/docs/api/io/compress/bitstream.md +131 -0
- package/docs/api/io/compress/brotli.md +232 -0
- package/docs/api/io/compress/brotli_dict.md +119 -0
- package/docs/api/io/compress/brotli_dict_words.md +142 -0
- package/docs/api/io/compress/brotli_frame.md +214 -0
- package/docs/api/io/compress/brotli_shared.md +144 -0
- package/docs/api/io/compress/deflate.md +474 -0
- package/docs/api/io/compress/gzip.md +130 -0
- package/docs/api/io/compress/huffman.md +210 -0
- package/docs/api/io/compress/lz4.md +278 -0
- package/docs/api/io/compress/lz77.md +180 -0
- package/docs/api/io/compress/lzw.md +121 -0
- package/docs/api/io/compress/zip.md +209 -0
- package/docs/api/io/compress/zlib.md +125 -0
- package/docs/api/io/i18n/README.md +23 -0
- package/docs/api/io/i18n/i18n.md +128 -0
- package/docs/api/io/math/README.md +24 -0
- package/docs/api/io/math/fixed-point.md +115 -0
- package/docs/api/io/math/geom.md +144 -0
- package/docs/api/io/math/interp.md +115 -0
- package/docs/api/io/math/linalg.md +138 -0
- package/docs/api/io/math/stats.md +109 -0
- package/docs/api/io/structures/README.md +31 -0
- package/docs/api/io/structures/btree.md +155 -0
- package/docs/api/io/structures/heap.md +166 -0
- package/docs/api/io/structures/lruCache.md +156 -0
- package/docs/api/io/structures/ringBuffer.md +188 -0
- package/docs/api/io/structures/tree-walker.md +132 -0
- package/docs/api/io/structures/trie.md +138 -0
- package/docs/api/io/sync/README.md +29 -0
- package/docs/api/io/sync/abort.md +129 -0
- package/docs/api/io/sync/atomics.md +159 -0
- package/docs/api/io/sync/cancellable.md +176 -0
- package/docs/api/io/sync/channel.md +125 -0
- package/docs/api/io/sync/mutex.md +93 -0
- package/docs/api/io/sync/semaphore.md +106 -0
- package/docs/api/io/sync/tokenBucket.md +139 -0
- package/docs/api/io/text/README.md +23 -0
- package/docs/api/io/text/ansi.md +182 -0
- package/docs/api/io/text/html-entities.md +79 -0
- package/docs/api/io/text/semver.md +158 -0
- package/docs/api/io/text/str.md +129 -0
- package/docs/api/io/text/unicode.md +89 -0
- package/docs/api/io/time/README.md +22 -0
- package/docs/api/io/time/date.md +128 -0
- package/docs/api/io/timing/README.md +32 -0
- package/docs/api/io/timing/clock.md +102 -0
- package/docs/api/io/timing/rateLimit.md +137 -0
- package/docs/api/io/timing/scheduler.md +163 -0
- package/docs/api/io/utils/README.md +30 -0
- package/docs/api/io/utils/bitmap.md +96 -0
- package/docs/api/io/utils/errors.md +165 -0
- package/docs/api/io/utils/eventBus.md +162 -0
- package/docs/api/io/utils/queue.md +141 -0
- package/docs/api/io/utils/signal.md +388 -0
- package/docs/api/io/utils/ui8.md +111 -0
- package/docs/api/io/utils/valid.md +272 -0
- package/docs/api/process/README.md +18 -0
- package/docs/api/process/message.md +166 -0
- package/docs/api/process/rpc.md +161 -0
- package/docs/api/process/workerPool.md +130 -0
- package/docs/api/sanity/base.md +132 -0
- package/docs/api/sanity/community.md +96 -0
- package/docs/api/sanity/lockdown.md +128 -0
- package/docs/api/typed.md +85 -0
- package/docs/dev/README.md +25 -0
- package/docs/dev/provenance.md +80 -0
- package/docs/dev/publishing.md +31 -0
- package/docs/dev/runtime.md +64 -0
- package/docs/dev/testing.md +61 -0
- package/docs/dev/types.md +35 -0
- package/docs/evidence/pqc-hybrid-evidence.md +438 -0
- package/docs/guide/README.md +38 -0
- package/docs/guide/_QUICK_REF.md +341 -0
- package/docs/guide/by-use-case.md +160 -0
- package/docs/guide/doc-format.md +306 -0
- package/docs/guide/gesture-dnd-side-channel.md +119 -0
- package/docs/guide/getting-started.md +134 -0
- package/docs/guide/hmr.md +187 -0
- package/docs/guide/integration-bundlers.md +193 -0
- package/docs/guide/integrations-hmr.md +103 -0
- package/docs/guide/module-creation-workflow.md +342 -0
- package/docs/guide/module-pattern.md +244 -0
- package/docs/guide/rendering-pipeline.md +422 -0
- package/docs/guide/security.md +346 -0
- package/docs/guide/test-format.md +190 -0
- package/docs/guide/tutorial-todo.md +298 -0
- package/docs/guide/typescript.md +215 -0
- package/docs/guide/worker-confinement.md +301 -0
- package/docs/guide/workers.md +168 -0
- package/docs/notes/lz77-deflate-factorization.md +96 -0
- package/docs/notes/worker-confinement-spike.md +302 -0
- package/docs/tools/README.md +56 -0
- package/docs/tools/aot.md +108 -0
- package/docs/tools/audit.md +61 -0
- package/docs/tools/bundler.md +215 -0
- package/docs/tools/codegen.md +64 -0
- package/docs/tools/jsx.md +236 -0
- package/docs/tools/precompilation.md +88 -0
- package/docs/tools/standalone.md +107 -0
- package/fw.config.json +129 -0
- package/integrations/README.md +52 -0
- package/integrations/_shared/catalog.generated.json +207 -0
- package/integrations/_shared/config-resolve.js +201 -0
- package/integrations/_shared/core.js +362 -0
- package/integrations/astro/README.md +96 -0
- package/integrations/astro/index.d.ts +42 -0
- package/integrations/astro/index.js +94 -0
- package/integrations/bun/README.md +62 -0
- package/integrations/bun/index.d.ts +30 -0
- package/integrations/bun/index.js +134 -0
- package/integrations/deno/README.md +55 -0
- package/integrations/deno/deno.json +10 -0
- package/integrations/esbuild/README.md +75 -0
- package/integrations/esbuild/backend.js +147 -0
- package/integrations/esbuild/index.d.ts +32 -0
- package/integrations/esbuild/index.js +147 -0
- package/integrations/eslint/README.md +27 -0
- package/integrations/eslint/no-factory-capture.js +99 -0
- package/integrations/jest/README.md +45 -0
- package/integrations/jest/bun-test-shim.js +43 -0
- package/integrations/nestjs/README.md +68 -0
- package/integrations/nestjs/index.d.ts +38 -0
- package/integrations/nestjs/index.js +99 -0
- package/integrations/nextjs/README.md +149 -0
- package/integrations/nextjs/index.d.ts +30 -0
- package/integrations/nextjs/index.js +98 -0
- package/integrations/nodejs/README.md +46 -0
- package/integrations/nodejs/package.node.example.json +31 -0
- package/integrations/rollup/README.md +65 -0
- package/integrations/rollup/backend.js +132 -0
- package/integrations/rollup/index.d.ts +32 -0
- package/integrations/rollup/index.js +84 -0
- package/integrations/turbopack/README.md +56 -0
- package/integrations/turbopack/index.d.ts +47 -0
- package/integrations/turbopack/index.js +164 -0
- package/integrations/typedoc/README.md +57 -0
- package/integrations/typedoc/categorize.js +121 -0
- package/integrations/typedoc/tsconfig.typedoc.json +14 -0
- package/integrations/typedoc/typedoc.json +19 -0
- package/integrations/vite/README.md +115 -0
- package/integrations/vite/index.d.ts +29 -0
- package/integrations/vite/index.js +182 -0
- package/integrations/vite/package.json +8 -0
- package/integrations/vite/vite-env.d.ts +36 -0
- package/integrations/vitest/README.md +77 -0
- package/integrations/vitest/bun-test-shim.js +92 -0
- package/integrations/vitest/vitest.config.js +41 -0
- package/integrations/webpack/README.md +53 -0
- package/integrations/webpack/index.d.ts +29 -0
- package/integrations/webpack/index.js +182 -0
- package/package.json +303 -0
- package/src/core/logger.js +373 -0
- package/src/core/modules.js +289 -0
- package/src/core/readyState.js +119 -0
- package/src/core/runtime.js +929 -0
- package/src/core/worker-helper.js +261 -0
- package/src/crypto/NIST_CONFORMANCE.md +249 -0
- package/src/crypto/cipher/aes.acvp.md +74 -0
- package/src/crypto/cipher/aes.js +512 -0
- package/src/crypto/cipher/chacha20.acvp.md +117 -0
- package/src/crypto/cipher/chacha20.js +147 -0
- package/src/crypto/hash/adf.acvp.md +144 -0
- package/src/crypto/hash/adf.js +127 -0
- package/src/crypto/hash/argon2.acvp.md +144 -0
- package/src/crypto/hash/argon2.js +517 -0
- package/src/crypto/hash/blake2b.acvp.md +122 -0
- package/src/crypto/hash/blake2b.js +367 -0
- package/src/crypto/hash/hkdf.acvp.md +128 -0
- package/src/crypto/hash/hkdf.js +145 -0
- package/src/crypto/hash/hmac.acvp.md +110 -0
- package/src/crypto/hash/hmac.js +177 -0
- package/src/crypto/hash/pbkdf2.acvp.md +122 -0
- package/src/crypto/hash/pbkdf2.js +120 -0
- package/src/crypto/hash/poly1305.acvp.md +111 -0
- package/src/crypto/hash/poly1305.js +126 -0
- package/src/crypto/hash/sha224.acvp.md +81 -0
- package/src/crypto/hash/sha224.js +60 -0
- package/src/crypto/hash/sha256.acvp.md +75 -0
- package/src/crypto/hash/sha256.js +217 -0
- package/src/crypto/hash/sha3.acvp.md +133 -0
- package/src/crypto/hash/sha3.js +391 -0
- package/src/crypto/hash/sha384.acvp.md +82 -0
- package/src/crypto/hash/sha384.js +61 -0
- package/src/crypto/hash/sha512.acvp.md +84 -0
- package/src/crypto/hash/sha512.js +314 -0
- package/src/crypto/hash/sha512_224.acvp.md +90 -0
- package/src/crypto/hash/sha512_224.js +66 -0
- package/src/crypto/hash/sha512_256.acvp.md +96 -0
- package/src/crypto/hash/sha512_256.js +75 -0
- package/src/crypto/mode/cbc.acvp.md +105 -0
- package/src/crypto/mode/cbc.js +136 -0
- package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
- package/src/crypto/mode/chacha20poly1305.js +190 -0
- package/src/crypto/mode/cmac.acvp.md +106 -0
- package/src/crypto/mode/cmac.js +172 -0
- package/src/crypto/mode/ctr.acvp.md +110 -0
- package/src/crypto/mode/ctr.js +174 -0
- package/src/crypto/mode/gcm.acvp.md +129 -0
- package/src/crypto/mode/gcm.js +333 -0
- package/src/crypto/mode/kw.acvp.md +145 -0
- package/src/crypto/mode/kw.js +323 -0
- package/src/crypto/pkc/ecc.acvp.md +181 -0
- package/src/crypto/pkc/ecc.js +941 -0
- package/src/crypto/pkc/ed25519.acvp.md +172 -0
- package/src/crypto/pkc/ed25519.js +582 -0
- package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
- package/src/crypto/pkc/hybridKem.js +255 -0
- package/src/crypto/pkc/hybridSign.js +437 -0
- package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
- package/src/crypto/pkc/ml_dsa.js +984 -0
- package/src/crypto/pkc/ml_kem.acvp.md +117 -0
- package/src/crypto/pkc/ml_kem.js +596 -0
- package/src/crypto/pkc/rsa.acvp.md +187 -0
- package/src/crypto/pkc/rsa.js +470 -0
- package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
- package/src/crypto/pkc/slh_dsa.js +820 -0
- package/src/crypto/pkc/x25519.acvp.md +113 -0
- package/src/crypto/pkc/x25519.js +290 -0
- package/src/crypto/utils/aes_ctr.acvp.md +67 -0
- package/src/crypto/utils/aes_ctr.js +134 -0
- package/src/crypto/utils/aes_modes.acvp.md +66 -0
- package/src/crypto/utils/aes_modes.js +241 -0
- package/src/crypto/utils/asn1-oid.js +369 -0
- package/src/crypto/utils/asn1.js +343 -0
- package/src/crypto/utils/bitArray.js +312 -0
- package/src/crypto/utils/bn.js +825 -0
- package/src/crypto/utils/jws.js +222 -0
- package/src/crypto/utils/keyformat.js +303 -0
- package/src/crypto/utils/pad.js +198 -0
- package/src/crypto/utils/pem.js +90 -0
- package/src/crypto/utils/random.acvp.md +167 -0
- package/src/crypto/utils/random.js +846 -0
- package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
- package/src/crypto/utils/rsaKeygen.js +448 -0
- package/src/crypto/utils/totp.js +409 -0
- package/src/crypto/utils/uuid.acvp.md +137 -0
- package/src/crypto/utils/uuid.js +176 -0
- package/src/crypto/wasm/aes.js +494 -0
- package/src/crypto/wasm/argon2.js +236 -0
- package/src/crypto/wasm/blake2b.js +213 -0
- package/src/crypto/wasm/chacha20poly1305.js +238 -0
- package/src/crypto/wasm/cmac.js +207 -0
- package/src/crypto/wasm/ecc.js +437 -0
- package/src/crypto/wasm/ed25519.js +307 -0
- package/src/crypto/wasm/hkdf.js +183 -0
- package/src/crypto/wasm/hmac.js +215 -0
- package/src/crypto/wasm/ml_dsa.js +375 -0
- package/src/crypto/wasm/ml_kem.js +313 -0
- package/src/crypto/wasm/pbkdf2.js +205 -0
- package/src/crypto/wasm/rsa.js +674 -0
- package/src/crypto/wasm/runtime.js +400 -0
- package/src/crypto/wasm/sha2.js +183 -0
- package/src/crypto/wasm/sha3.js +221 -0
- package/src/crypto/wasm/slh_dsa.js +397 -0
- package/src/crypto/wasm/x25519.js +241 -0
- package/src/crypto/webcrypto/aes.js +370 -0
- package/src/crypto/webcrypto/aeskw.js +185 -0
- package/src/crypto/webcrypto/digest.js +136 -0
- package/src/crypto/webcrypto/ecc.js +371 -0
- package/src/crypto/webcrypto/ed25519.js +248 -0
- package/src/crypto/webcrypto/hkdf.js +132 -0
- package/src/crypto/webcrypto/hmac.js +213 -0
- package/src/crypto/webcrypto/pbkdf2.js +146 -0
- package/src/crypto/webcrypto/rsa.js +415 -0
- package/src/crypto/webcrypto/x25519.js +250 -0
- package/src/dom/display/animate.js +154 -0
- package/src/dom/display/fullscreen.js +305 -0
- package/src/dom/fs/download.js +118 -0
- package/src/dom/fs/fsAccess.js +307 -0
- package/src/dom/fs/indexedDB.js +465 -0
- package/src/dom/fs/remoteStore.js +484 -0
- package/src/dom/fs/storage.js +440 -0
- package/src/dom/lifecycle/idle.js +133 -0
- package/src/dom/lifecycle/visibility.js +140 -0
- package/src/dom/lifecycle/wakeLock.js +187 -0
- package/src/dom/net/ajax.js +303 -0
- package/src/dom/net/broadcastChannel.js +89 -0
- package/src/dom/net/network.js +260 -0
- package/src/dom/net/sse.js +295 -0
- package/src/dom/net/webrtc.js +381 -0
- package/src/dom/net/ws.js +290 -0
- package/src/dom/query/dnd.js +409 -0
- package/src/dom/query/dom.js +831 -0
- package/src/dom/query/events.js +425 -0
- package/src/dom/query/gesture.js +396 -0
- package/src/dom/query/media.js +616 -0
- package/src/dom/rendering/chart.js +663 -0
- package/src/dom/rendering/component.js +469 -0
- package/src/dom/rendering/devtools-ui.js +399 -0
- package/src/dom/rendering/devtools.js +352 -0
- package/src/dom/rendering/parser.js +1055 -0
- package/src/dom/rendering/reactiveBind.js +341 -0
- package/src/dom/rendering/render.js +601 -0
- package/src/dom/rendering/sanitize.js +364 -0
- package/src/dom/rendering/secPolicy.js +281 -0
- package/src/dom/rendering/template.js +1031 -0
- package/src/dom/rendering/themeTokens.js +522 -0
- package/src/dom/rendering/uiSession-core.js +597 -0
- package/src/dom/rendering/uiSession-direct.js +251 -0
- package/src/dom/rendering/uiSession-list.js +751 -0
- package/src/dom/rendering/uiSession.js +145 -0
- package/src/dom/rendering/virtualScroll.js +341 -0
- package/src/dom/sensors/battery.js +153 -0
- package/src/dom/sensors/geolocation.js +156 -0
- package/src/dom/sensors/networkInfo.js +136 -0
- package/src/dom/sensors/sensors.js +340 -0
- package/src/dom/sw/backgroundSync.js +113 -0
- package/src/dom/sw/cache.js +139 -0
- package/src/dom/sw/push.js +181 -0
- package/src/dom/sw/serviceWorker.js +193 -0
- package/src/dom/sw/sharedWorker.js +192 -0
- package/src/dom/utils/a11y.js +244 -0
- package/src/dom/utils/clipboard.js +113 -0
- package/src/dom/utils/entropyCollector.js +344 -0
- package/src/dom/utils/focus.js +421 -0
- package/src/dom/utils/form.js +535 -0
- package/src/dom/utils/formKit.js +427 -0
- package/src/dom/utils/keybindings.js +574 -0
- package/src/dom/utils/leaderElection.js +280 -0
- package/src/dom/utils/notifications.js +218 -0
- package/src/dom/utils/permissions.js +107 -0
- package/src/dom/utils/route.js +482 -0
- package/src/dom/utils/ua.js +109 -0
- package/src/dom/utils/webauthn.js +369 -0
- package/src/external/README.md +15 -0
- package/src/io/binary/reader.js +374 -0
- package/src/io/binary/writer.js +351 -0
- package/src/io/calc/adler32.js +94 -0
- package/src/io/calc/bigint.js +276 -0
- package/src/io/calc/crc32.js +111 -0
- package/src/io/calc/easing.js +514 -0
- package/src/io/codec/b64.js +235 -0
- package/src/io/codec/base32.js +147 -0
- package/src/io/codec/base58.js +167 -0
- package/src/io/codec/buffer.js +630 -0
- package/src/io/codec/cbor.js +550 -0
- package/src/io/codec/csv.js +299 -0
- package/src/io/codec/hex.js +129 -0
- package/src/io/codec/mime.js +398 -0
- package/src/io/codec/msgpack.js +491 -0
- package/src/io/codec/url.js +530 -0
- package/src/io/codec/utf8.js +181 -0
- package/src/io/codec/xml.js +428 -0
- package/src/io/compress/bitstream.js +199 -0
- package/src/io/compress/brotli.js +3073 -0
- package/src/io/compress/brotli_dict.bin +432 -0
- package/src/io/compress/brotli_dict.js +356 -0
- package/src/io/compress/brotli_dict_words.js +157 -0
- package/src/io/compress/brotli_frame.js +420 -0
- package/src/io/compress/brotli_shared.js +715 -0
- package/src/io/compress/deflate.js +1432 -0
- package/src/io/compress/gzip.js +406 -0
- package/src/io/compress/huffman.js +322 -0
- package/src/io/compress/lz4.js +451 -0
- package/src/io/compress/lz77.js +408 -0
- package/src/io/compress/lzw.js +332 -0
- package/src/io/compress/zip.js +815 -0
- package/src/io/compress/zlib.js +340 -0
- package/src/io/i18n/i18n.js +236 -0
- package/src/io/math/fixed-point.js +269 -0
- package/src/io/math/geom.js +350 -0
- package/src/io/math/interp.js +263 -0
- package/src/io/math/linalg.js +472 -0
- package/src/io/math/stats.js +339 -0
- package/src/io/structures/btree.js +357 -0
- package/src/io/structures/heap.js +249 -0
- package/src/io/structures/lruCache.js +219 -0
- package/src/io/structures/ringBuffer.js +208 -0
- package/src/io/structures/tree-walker.js +413 -0
- package/src/io/structures/trie.js +219 -0
- package/src/io/sync/abort.js +196 -0
- package/src/io/sync/atomics.js +342 -0
- package/src/io/sync/cancellable.js +279 -0
- package/src/io/sync/channel.js +301 -0
- package/src/io/sync/mutex.js +148 -0
- package/src/io/sync/semaphore.js +156 -0
- package/src/io/sync/tokenBucket.js +208 -0
- package/src/io/text/ansi.js +536 -0
- package/src/io/text/html-entities.js +143 -0
- package/src/io/text/semver.js +375 -0
- package/src/io/text/str.js +243 -0
- package/src/io/text/unicode.js +188 -0
- package/src/io/time/date.js +355 -0
- package/src/io/timing/clock.js +79 -0
- package/src/io/timing/rateLimit.js +264 -0
- package/src/io/timing/scheduler.js +351 -0
- package/src/io/utils/bitmap.js +94 -0
- package/src/io/utils/errors.js +269 -0
- package/src/io/utils/eventBus.js +315 -0
- package/src/io/utils/queue.js +223 -0
- package/src/io/utils/signal.js +858 -0
- package/src/io/utils/ui8.js +99 -0
- package/src/io/utils/valid.js +556 -0
- package/src/main.js +41 -0
- package/src/polyfill/README.md +9 -0
- package/src/process/message.js +257 -0
- package/src/process/rpc.js +286 -0
- package/src/process/workerPool.js +392 -0
- package/src/sanity/base.js +374 -0
- package/src/sanity/community.js +254 -0
- package/src/sanity/lockdown-apply.js +58 -0
- package/src/sanity/lockdown.js +408 -0
- package/src/sanity/wasm-gate.js +316 -0
- package/src/typed.js +53 -0
- package/third-party/NOTICE-penner-easing +88 -0
- package/third-party/NOTICE-sjcl +50 -0
- package/tools/_lib/cli-help.js +55 -0
- package/tools/rendering/aot/index.js +148 -0
- package/tools/rendering/aot/lib/dom-codegen.js +295 -0
- package/tools/rendering/jsx/index.js +654 -0
- package/tools/rendering/precompilation/index.js +368 -0
- package/types/registry.generated.d.ts +217 -0
- package/types/typed.d.ts +106 -0
|
@@ -0,0 +1,1055 @@
|
|
|
1
|
+
// Copyright (c) 2026 AwaCloud SAS
|
|
2
|
+
// Author: Matthieu Bouilloux
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* @fileoverview HTML ↔ elm-array parser for the framework's virtual-DOM notation.
|
|
7
|
+
*
|
|
8
|
+
* Notation (see source/index.js MEMO):
|
|
9
|
+
* - `#{var_name}` - variable placeholder (text or attribute value)
|
|
10
|
+
* - `${slot_name}` - content slot (full text of a leaf element)
|
|
11
|
+
* - `<!-- $name --> … <!-- name$ -->` - iterate block delimited by HTML comments
|
|
12
|
+
*
|
|
13
|
+
* Rules:
|
|
14
|
+
* - A content slot becomes a `<span>` when it has sibling nodes, otherwise it
|
|
15
|
+
* is inlined as `elm.content` on the parent element.
|
|
16
|
+
* - An iterate block must not be used alongside sibling element nodes.
|
|
17
|
+
*
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* A variable-binding descriptor that maps a named placeholder to a rendered target.
|
|
22
|
+
*
|
|
23
|
+
* @typedef {Object} MapEntry
|
|
24
|
+
* @property {string} name - Placeholder variable name (from `#{name}`).
|
|
25
|
+
* @property {string} prop - Target property: an attribute name, or `'text'`.
|
|
26
|
+
* @property {boolean} [data] - `true` when the target is `elm.data[prop]` (attribute);
|
|
27
|
+
* omitted / `false` for text content.
|
|
28
|
+
* @property {boolean} [append] - Value is appended after the static base string.
|
|
29
|
+
* @property {boolean} [prepend] - Value is prepended before the static base string.
|
|
30
|
+
* @property {string} [tail] - Static run that immediately follows this variable in
|
|
31
|
+
* the source value. Appended after the resolved value so
|
|
32
|
+
* that interleaved static segments (e.g. the trailing run
|
|
33
|
+
* of `"prefix#{v}suffix"`, or the `"b"` in
|
|
34
|
+
* `"a#{v1}b#{v2}c"`) are preserved. Present only when a
|
|
35
|
+
* non-empty trailing run exists.
|
|
36
|
+
* @property {*} [default] - Fallback value when the variable is absent from the
|
|
37
|
+
* options passed to `render`.
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
/**
|
|
41
|
+
* A single node in the flat elm-array representation.
|
|
42
|
+
* Elements are stored in parent-before-child order.
|
|
43
|
+
*
|
|
44
|
+
* @typedef {Object} ElmNode
|
|
45
|
+
* @property {string} id - Element identifier, unique within the parsed
|
|
46
|
+
* document (preserves the HTML `id` attribute
|
|
47
|
+
* when present, otherwise auto-generated as
|
|
48
|
+
* `p<n>`, skipping any `p<n>` already used as
|
|
49
|
+
* an explicit id in the same document).
|
|
50
|
+
* @property {string} tag - Internal tag name.
|
|
51
|
+
* SVG child elements are prefixed: `svg_use`,
|
|
52
|
+
* `svg_rect`, … The synthetic `'text'` tag
|
|
53
|
+
* represents an inline bare-text node.
|
|
54
|
+
* @property {string} [parent] - `id` of the parent node (absent for roots).
|
|
55
|
+
* @property {string[]} [attrs] - Ordered list of tracked attribute names.
|
|
56
|
+
* @property {Object.<string,*>}[data] - Attribute values, keyed by attr name (may be string, boolean, null, etc).
|
|
57
|
+
* @property {string} [text] - Static text content (leaf nodes only).
|
|
58
|
+
* @property {string} [content]- Slot or iterate-block name.
|
|
59
|
+
* @property {ElmNode[]} [child] - Inline child nodes (runtime extension for nested elms).
|
|
60
|
+
* @property {boolean} [prepend]- When true, insert before existing children.
|
|
61
|
+
* @property {MapEntry[]} [map] - Variable binding descriptors.
|
|
62
|
+
*/
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Result returned by `fromHTML`.
|
|
66
|
+
*
|
|
67
|
+
* @typedef {Object} ParseResult
|
|
68
|
+
* @property {ElmNode[]} template - Flat, parent-ordered array of
|
|
69
|
+
* elm nodes for the main markup.
|
|
70
|
+
* @property {Object.<string, ElmNode[]>} [iterates]- Sub-templates for iterate blocks,
|
|
71
|
+
* keyed by block name. Present only
|
|
72
|
+
* when at least one iterate block was
|
|
73
|
+
* found in the HTML.
|
|
74
|
+
*/
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Internal tree structure built by `buildTree` for serialisation.
|
|
78
|
+
*
|
|
79
|
+
* @typedef {Object} ElmTree
|
|
80
|
+
* @property {Map<string, ElmNode>} byId - Nodes indexed by id.
|
|
81
|
+
* @property {Map<string, string[]>} kids - Children id arrays indexed by parent id.
|
|
82
|
+
* @property {string[]} roots - Ids of root-level nodes (no parent).
|
|
83
|
+
*/
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Manual cache controls exposed on the parser surface (test / power-user).
|
|
87
|
+
*
|
|
88
|
+
* @typedef {Object} ParserCache
|
|
89
|
+
* @property {() => void} clear - Clear all cached entries and reset stats.
|
|
90
|
+
* @property {(n: number) => void} setMax - Set the max cache size; 0 disables caching.
|
|
91
|
+
* @property {() => number} getMax - Current max cache size.
|
|
92
|
+
* @property {() => number} size - Current number of cached entries.
|
|
93
|
+
* @property {() => { hits: number, misses: number, evictions: number, size: number, max: number }} stats - Cache statistics snapshot.
|
|
94
|
+
*/
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Optional input of `fromHTML`.
|
|
98
|
+
*
|
|
99
|
+
* @typedef {Object} FromHTMLOptions
|
|
100
|
+
* @property {Iterable<string>} [reserveIds] - Explicit ids the caller knows the
|
|
101
|
+
* assembled document will contain, declared UP FRONT. They are reserved for
|
|
102
|
+
* the whole parser instance (this call and every later one), so an auto
|
|
103
|
+
* `p<n>` never collides with an explicit id the instance has not met yet —
|
|
104
|
+
* the direction per-call and per-instance accumulation cannot cover. Empty
|
|
105
|
+
* and non-string entries are ignored. Supplying the option BYPASSES the
|
|
106
|
+
* source-keyed `ParseResult` cache (read and write): the reservation changes
|
|
107
|
+
* which ids are minted, so a cached entry would violate the contract.
|
|
108
|
+
*/
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* Public surface returned by `parser.factory()`.
|
|
112
|
+
*
|
|
113
|
+
* @typedef {Object} ParserAPI
|
|
114
|
+
* @property {(htmlString: string, options?: FromHTMLOptions) => ParseResult} fromHTML - Parse HTML to a (cached) {@link ParseResult}.
|
|
115
|
+
* @property {(input: ElmNode[]|ParseResult) => string} toHTML - Serialise an elm array / ParseResult back to HTML.
|
|
116
|
+
* @property {ParserCache} cache - Manual cache controls.
|
|
117
|
+
*/
|
|
118
|
+
|
|
119
|
+
import { secPolicy } from './secPolicy.js';
|
|
120
|
+
|
|
121
|
+
export const parser = {
|
|
122
|
+
name: 'parser',
|
|
123
|
+
version: '1.0.0',
|
|
124
|
+
type: 'fw.dom.rendering',
|
|
125
|
+
dependencies: ['secPolicy'],
|
|
126
|
+
deps: [secPolicy],
|
|
127
|
+
|
|
128
|
+
/** @returns {ParserAPI} */
|
|
129
|
+
factory(secPolicy) {
|
|
130
|
+
|
|
131
|
+
// ── Server-side HTML tokenizer (DOMParser fallback) ──────────────────────
|
|
132
|
+
// Used by `fromHTML` when no `DOMParser` is available (Node/Bun without
|
|
133
|
+
// happy-dom). Produces a tree of plain JS objects exposing the subset
|
|
134
|
+
// of the DOM `Node` interface required by `walkElement` :
|
|
135
|
+
// { nodeType, tagName, attributes, childNodes, nodeValue, namespaceURI }
|
|
136
|
+
// - plus `getAttribute(name)` on element nodes.
|
|
137
|
+
//
|
|
138
|
+
// The tokenizer is **forgiving but minimal**. It handles well-formed
|
|
139
|
+
// HTML5-ish input :
|
|
140
|
+
// <tag>, <tag/>, </tag>, <tag a="v">, <tag a='v'>, <tag a>, <!-- … -->
|
|
141
|
+
// void elements (br/img/…), text with #{var} and ${slot} preserved,
|
|
142
|
+
// basic entities (& < > " ' numeric).
|
|
143
|
+
// It deliberately ignores DOCTYPE, CDATA, and processing instructions.
|
|
144
|
+
// For complex/broken HTML, a browser DOMParser polyfill (happy-dom,
|
|
145
|
+
// linkedom) remains a valid drop-in.
|
|
146
|
+
|
|
147
|
+
const SVG_TAG = 'svg';
|
|
148
|
+
|
|
149
|
+
const ENTITY_MAP = {
|
|
150
|
+
amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ',
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
function _decodeEntities(s) {
|
|
154
|
+
if (s.indexOf('&') === -1) return s;
|
|
155
|
+
return s.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (m, body) => {
|
|
156
|
+
if (body[0] === '#') {
|
|
157
|
+
const cp = body[1] === 'x' || body[1] === 'X'
|
|
158
|
+
? parseInt(body.slice(2), 16)
|
|
159
|
+
: parseInt(body.slice(1), 10);
|
|
160
|
+
if (Number.isFinite(cp) && cp >= 0 && cp <= 0x10FFFF) {
|
|
161
|
+
try { return String.fromCodePoint(cp); }
|
|
162
|
+
catch { return m; }
|
|
163
|
+
}
|
|
164
|
+
return m;
|
|
165
|
+
}
|
|
166
|
+
return ENTITY_MAP[body.toLowerCase()] ?? m;
|
|
167
|
+
});
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
function _makeElement(tagName, namespaceURI) {
|
|
171
|
+
const el = {
|
|
172
|
+
nodeType: NODE_ELEMENT,
|
|
173
|
+
tagName: tagName.toUpperCase(), // browsers report uppercase
|
|
174
|
+
namespaceURI: namespaceURI || null,
|
|
175
|
+
attributes: [],
|
|
176
|
+
childNodes: [],
|
|
177
|
+
_attrMap: null,
|
|
178
|
+
getAttribute(name) {
|
|
179
|
+
if (!this._attrMap) {
|
|
180
|
+
this._attrMap = Object.create(null);
|
|
181
|
+
for (const a of this.attributes) this._attrMap[a.name] = a.value;
|
|
182
|
+
}
|
|
183
|
+
return this._attrMap[name] ?? null;
|
|
184
|
+
},
|
|
185
|
+
};
|
|
186
|
+
return el;
|
|
187
|
+
}
|
|
188
|
+
function _makeText(value) { return { nodeType: NODE_TEXT, nodeValue: value }; }
|
|
189
|
+
function _makeComment(value) { return { nodeType: NODE_COMMENT, nodeValue: value }; }
|
|
190
|
+
|
|
191
|
+
// Parse an opening tag starting at `pos` (which points to '<').
|
|
192
|
+
// Returns { tag, attrs:[{name,value}], selfClose, end } where `end`
|
|
193
|
+
// is the index just past the closing '>'.
|
|
194
|
+
function _parseOpenTag(html, pos) {
|
|
195
|
+
const len = html.length;
|
|
196
|
+
// Expect '<' at pos already verified by caller.
|
|
197
|
+
let i = pos + 1;
|
|
198
|
+
// Tag name
|
|
199
|
+
const tagStart = i;
|
|
200
|
+
while (i < len) {
|
|
201
|
+
const c = html.charCodeAt(i);
|
|
202
|
+
// Letters, digits, '-', '_'
|
|
203
|
+
if ((c >= 0x30 && c <= 0x39) || (c >= 0x41 && c <= 0x5a)
|
|
204
|
+
|| (c >= 0x61 && c <= 0x7a) || c === 0x2d || c === 0x5f) {
|
|
205
|
+
i++;
|
|
206
|
+
} else break;
|
|
207
|
+
}
|
|
208
|
+
if (i === tagStart) return null;
|
|
209
|
+
const tag = html.slice(tagStart, i).toLowerCase();
|
|
210
|
+
|
|
211
|
+
const attrs = [];
|
|
212
|
+
let selfClose = false;
|
|
213
|
+
|
|
214
|
+
while (i < len) {
|
|
215
|
+
// Skip whitespace.
|
|
216
|
+
while (i < len && /\s/.test(html[i])) i++;
|
|
217
|
+
if (i >= len) return null;
|
|
218
|
+
const c = html[i];
|
|
219
|
+
if (c === '>') { i++; break; }
|
|
220
|
+
if (c === '/' && html[i + 1] === '>') { selfClose = true; i += 2; break; }
|
|
221
|
+
// Attribute name.
|
|
222
|
+
const nStart = i;
|
|
223
|
+
while (i < len && !/[\s=/>]/.test(html[i])) i++;
|
|
224
|
+
const name = html.slice(nStart, i).toLowerCase();
|
|
225
|
+
if (!name) { i++; continue; }
|
|
226
|
+
// Optional value.
|
|
227
|
+
while (i < len && /\s/.test(html[i])) i++;
|
|
228
|
+
let value = '';
|
|
229
|
+
if (html[i] === '=') {
|
|
230
|
+
i++;
|
|
231
|
+
while (i < len && /\s/.test(html[i])) i++;
|
|
232
|
+
const q = html[i];
|
|
233
|
+
if (q === '"' || q === "'") {
|
|
234
|
+
const vStart = ++i;
|
|
235
|
+
while (i < len && html[i] !== q) i++;
|
|
236
|
+
value = _decodeEntities(html.slice(vStart, i));
|
|
237
|
+
if (html[i] === q) i++;
|
|
238
|
+
} else {
|
|
239
|
+
const vStart = i;
|
|
240
|
+
while (i < len && !/[\s>]/.test(html[i])) i++;
|
|
241
|
+
value = _decodeEntities(html.slice(vStart, i));
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
attrs.push({ name, value });
|
|
245
|
+
}
|
|
246
|
+
return { tag, attrs, selfClose, end: i };
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
// ── Constants ────────────────────────────────────────────────────────────
|
|
250
|
+
|
|
251
|
+
const SVG_NS = 'http://www.w3.org/2000/svg';
|
|
252
|
+
|
|
253
|
+
const VOID_TAGS = new Set([
|
|
254
|
+
'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',
|
|
255
|
+
'link', 'meta', 'param', 'source', 'track', 'wbr'
|
|
256
|
+
]);
|
|
257
|
+
|
|
258
|
+
// DOM Node type constants - duplicated locally so `walkElement` runs
|
|
259
|
+
// identically against either a real DOM tree (browser, happy-dom) or
|
|
260
|
+
// the server-side tokenizer tree built below. Avoids reference to the
|
|
261
|
+
// global `Node` interface which is browser-only.
|
|
262
|
+
const NODE_ELEMENT = 1;
|
|
263
|
+
const NODE_TEXT = 3;
|
|
264
|
+
const NODE_COMMENT = 8;
|
|
265
|
+
|
|
266
|
+
// Explicit internal-tag → HTML-tag overrides
|
|
267
|
+
// Generic rule: svg_* → strip prefix (svg_use→use, svg_rect→rect, …)
|
|
268
|
+
// Exception: tag:'text' is a synthetic inline-text wrapper (→ bare text in toHTML,
|
|
269
|
+
// but rendered as <span> by template.js via its own tag === 'text' guard)
|
|
270
|
+
const INTERNAL_TO_HTML = { text: 'span' };
|
|
271
|
+
|
|
272
|
+
// Tags silently dropped during parsing - sourced from secPolicy
|
|
273
|
+
// (single source of truth for blocked tags across the framework).
|
|
274
|
+
const RE_BLOCKED_TAG = secPolicy.BLOCKED_TAGS_RE;
|
|
275
|
+
|
|
276
|
+
// ── Regex patterns ───────────────────────────────────────────────────────
|
|
277
|
+
|
|
278
|
+
const RE_SLOT = /^\s*\$\{([^}]+)\}\s*$/; // ${slot_name} – full text
|
|
279
|
+
const RE_VAR_SEP = /(#\{[^}]+\})/; // split token for #{var}
|
|
280
|
+
const RE_VAR_ONE = /^#\{([^}]+)\}$/; // single #{var} token
|
|
281
|
+
const RE_IT_S = /^\s*\$([a-zA-Z_]\w*)\s*$/; // comment: $name
|
|
282
|
+
const RE_IT_E = /^\s*([a-zA-Z_]\w*)\$\s*$/; // comment: name$
|
|
283
|
+
// Attribute-name shape regexes - sourced from secPolicy.
|
|
284
|
+
const RE_SAFE_A = secPolicy.SAFE_ATTR_NAME_RE; // attr must start with a letter
|
|
285
|
+
const RE_EVENT = secPolicy.EVENT_ATTR_RE; // block on* event attributes
|
|
286
|
+
|
|
287
|
+
function parseHTMLString(html) {
|
|
288
|
+
const root = _makeElement('root');
|
|
289
|
+
const stack = [{ el: root, ns: null }];
|
|
290
|
+
let pos = 0;
|
|
291
|
+
const len = html.length;
|
|
292
|
+
|
|
293
|
+
while (pos < len) {
|
|
294
|
+
const top = stack[stack.length - 1];
|
|
295
|
+
const ch = html[pos];
|
|
296
|
+
|
|
297
|
+
if (ch === '<') {
|
|
298
|
+
// Comment ?
|
|
299
|
+
if (html.startsWith('<!--', pos)) {
|
|
300
|
+
const end = html.indexOf('-->', pos + 4);
|
|
301
|
+
if (end === -1) break;
|
|
302
|
+
top.el.childNodes.push(_makeComment(html.slice(pos + 4, end)));
|
|
303
|
+
pos = end + 3;
|
|
304
|
+
continue;
|
|
305
|
+
}
|
|
306
|
+
// DOCTYPE / processing-instruction : skip.
|
|
307
|
+
if (html.charCodeAt(pos + 1) === 0x21 /* ! */
|
|
308
|
+
|| html.charCodeAt(pos + 1) === 0x3f /* ? */) {
|
|
309
|
+
const end = html.indexOf('>', pos);
|
|
310
|
+
if (end === -1) break;
|
|
311
|
+
pos = end + 1;
|
|
312
|
+
continue;
|
|
313
|
+
}
|
|
314
|
+
// Closing tag ?
|
|
315
|
+
if (html[pos + 1] === '/') {
|
|
316
|
+
const end = html.indexOf('>', pos);
|
|
317
|
+
if (end === -1) break;
|
|
318
|
+
const closeName = html.slice(pos + 2, end).trim().toLowerCase();
|
|
319
|
+
// Pop the stack until we find a matching tag (forgiving).
|
|
320
|
+
for (let i = stack.length - 1; i > 0; --i) {
|
|
321
|
+
if (stack[i].el.tagName.toLowerCase() === closeName) {
|
|
322
|
+
stack.length = i;
|
|
323
|
+
break;
|
|
324
|
+
}
|
|
325
|
+
}
|
|
326
|
+
pos = end + 1;
|
|
327
|
+
continue;
|
|
328
|
+
}
|
|
329
|
+
// Opening tag.
|
|
330
|
+
const open = _parseOpenTag(html, pos);
|
|
331
|
+
if (!open) { pos++; continue; }
|
|
332
|
+
// SVG namespace propagation : inside <svg>, all descendants are SVG.
|
|
333
|
+
const parentNS = top.ns;
|
|
334
|
+
const ns = (open.tag === SVG_TAG) ? SVG_NS : parentNS;
|
|
335
|
+
const el = _makeElement(open.tag, ns);
|
|
336
|
+
for (const a of open.attrs) el.attributes.push(a);
|
|
337
|
+
top.el.childNodes.push(el);
|
|
338
|
+
const isVoid = VOID_TAGS.has(open.tag) || open.selfClose;
|
|
339
|
+
if (!isVoid) stack.push({ el, ns });
|
|
340
|
+
pos = open.end;
|
|
341
|
+
continue;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
// Text node : up to the next '<'.
|
|
345
|
+
const next = html.indexOf('<', pos);
|
|
346
|
+
const textEnd = next === -1 ? len : next;
|
|
347
|
+
const raw = html.slice(pos, textEnd);
|
|
348
|
+
if (raw) top.el.childNodes.push(_makeText(_decodeEntities(raw)));
|
|
349
|
+
pos = textEnd;
|
|
350
|
+
}
|
|
351
|
+
return root;
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
// ── Notation (see source/index.js MEMO) ──────────────────────────────────
|
|
355
|
+
// #{var_name} → variable placeholder (text / attr)
|
|
356
|
+
// ${slot_name} → content slot (full text of a leaf)
|
|
357
|
+
// <!-- $name --> … <!-- name$ --> → iterate block (comment delimiters)
|
|
358
|
+
|
|
359
|
+
// "content slot" becomes span tag if he has neighbors
|
|
360
|
+
// else become part of parent tag
|
|
361
|
+
// "iterate block" must not be used with neighbor tag
|
|
362
|
+
|
|
363
|
+
// ── ID generator ─────────────────────────────────────────────────────────
|
|
364
|
+
|
|
365
|
+
let _seq = 0;
|
|
366
|
+
|
|
367
|
+
/**
|
|
368
|
+
* Explicit ids reserved for the WHOLE parser instance: every explicit id
|
|
369
|
+
* seen by a previous `fromHTML` call, plus every id a caller declared up
|
|
370
|
+
* front via {@link FromHTMLOptions}`.reserveIds`.
|
|
371
|
+
*
|
|
372
|
+
* A consumer may assemble ONE logical document from SEVERAL `fromHTML`
|
|
373
|
+
* calls on a shared instance (parsing each block separately). The
|
|
374
|
+
* per-call set alone gives no guarantee across that seam, and the harm
|
|
375
|
+
* is the same as within a call: `buildTree` merges by id with
|
|
376
|
+
* last-write-wins, so a cross-call collision DELETES a subtree from the
|
|
377
|
+
* assembled output.
|
|
378
|
+
*
|
|
379
|
+
* @type {Set<string>}
|
|
380
|
+
*/
|
|
381
|
+
const _reservedAll = new Set();
|
|
382
|
+
|
|
383
|
+
/**
|
|
384
|
+
* Fold an iterable of explicit ids into the instance-wide reserved set.
|
|
385
|
+
*
|
|
386
|
+
* Empty, whitespace-only and non-string entries are ignored (the same
|
|
387
|
+
* shape filter `collectExplicitIds` applies to `id` attributes).
|
|
388
|
+
*
|
|
389
|
+
* @param {Iterable<string>} [ids] - Ids to reserve; nullish is a no-op.
|
|
390
|
+
* @param {Set<string>} [into] - Optional per-call set to mirror into.
|
|
391
|
+
* @returns {void}
|
|
392
|
+
*/
|
|
393
|
+
function reserveInstanceIds(ids, into) {
|
|
394
|
+
if (!ids) return;
|
|
395
|
+
for (const raw of ids) {
|
|
396
|
+
if (typeof raw !== 'string') continue;
|
|
397
|
+
const id = raw.trim();
|
|
398
|
+
if (!id) continue;
|
|
399
|
+
_reservedAll.add(id);
|
|
400
|
+
if (into) into.add(id);
|
|
401
|
+
}
|
|
402
|
+
}
|
|
403
|
+
|
|
404
|
+
/**
|
|
405
|
+
* Generate a unique element ID of the form `p<n>`.
|
|
406
|
+
*
|
|
407
|
+
* The counter is scoped to the parser INSTANCE and keeps running across
|
|
408
|
+
* `fromHTML` calls (a site build shares one parser across every
|
|
409
|
+
* document, and the emitted ids are part of the hydrate-key surface —
|
|
410
|
+
* it must not restart per document).
|
|
411
|
+
*
|
|
412
|
+
* A value already used as an explicit `id` is skipped: `buildTree`
|
|
413
|
+
* indexes nodes by id with last-write-wins, so a collision between an
|
|
414
|
+
* auto-minted `pN` and an explicit `pN` silently drops one of the two
|
|
415
|
+
* nodes from the emitted HTML. Two reservation layers are consulted:
|
|
416
|
+
* `reserved` — every explicit id of the current document, collected up
|
|
417
|
+
* front by `collectExplicitIds` so ids appearing AFTER the mint point
|
|
418
|
+
* count too — and `_reservedAll`, the instance-wide set (earlier calls'
|
|
419
|
+
* explicit ids + any caller-supplied `reserveIds`).
|
|
420
|
+
*
|
|
421
|
+
* @param {Set<string>} [reserved] - Explicit ids of the document being
|
|
422
|
+
* parsed. Omitted / empty means "no document context".
|
|
423
|
+
* @returns {string} Next sequential ID string, unused in this document
|
|
424
|
+
* and unused anywhere this instance has reserved.
|
|
425
|
+
*/
|
|
426
|
+
const nextId = (reserved) => {
|
|
427
|
+
let id = 'p' + (_seq++);
|
|
428
|
+
while ((reserved && reserved.has(id)) || _reservedAll.has(id)) {
|
|
429
|
+
id = 'p' + (_seq++);
|
|
430
|
+
}
|
|
431
|
+
return id;
|
|
432
|
+
};
|
|
433
|
+
|
|
434
|
+
/**
|
|
435
|
+
* Collect every explicit `id` attribute of a parsed tree.
|
|
436
|
+
*
|
|
437
|
+
* Walks the whole node tree (DOM tree or internal-tokenizer tree alike)
|
|
438
|
+
* so that `nextId` knows the document's full id set before the first
|
|
439
|
+
* auto id is minted.
|
|
440
|
+
*
|
|
441
|
+
* @param {Node|Object} node - Root node to scan (inclusive of children).
|
|
442
|
+
* @param {Set<string>} [into] - Accumulator set (created when omitted).
|
|
443
|
+
* @returns {Set<string>} Set of trimmed, non-empty explicit ids.
|
|
444
|
+
*/
|
|
445
|
+
function collectExplicitIds(node, into) {
|
|
446
|
+
const out = into || new Set();
|
|
447
|
+
const kids = node.childNodes;
|
|
448
|
+
if (!kids) return out;
|
|
449
|
+
for (const c of kids) {
|
|
450
|
+
if (c.nodeType !== NODE_ELEMENT) continue;
|
|
451
|
+
const raw = c.getAttribute ? c.getAttribute('id') : null;
|
|
452
|
+
if (raw && raw.trim()) out.add(raw.trim());
|
|
453
|
+
collectExplicitIds(c, out);
|
|
454
|
+
}
|
|
455
|
+
return out;
|
|
456
|
+
}
|
|
457
|
+
|
|
458
|
+
// ── Tag helpers ──────────────────────────────────────────────────────────
|
|
459
|
+
|
|
460
|
+
/**
|
|
461
|
+
* Derive the internal tag name from a DOM element.
|
|
462
|
+
*
|
|
463
|
+
* SVG child elements (namespace = SVG_NS, tag ≠ `'svg'`) are prefixed with
|
|
464
|
+
* `svg_` so that `template.js` can clone them from their namespace-aware
|
|
465
|
+
* `<template class="svg_*">` entries.
|
|
466
|
+
*
|
|
467
|
+
* @param {Element} el - The DOM element to inspect.
|
|
468
|
+
* @returns {string} Internal tag name (e.g. `'div'`, `'svg_use'`).
|
|
469
|
+
*/
|
|
470
|
+
function internalTag(el) {
|
|
471
|
+
const raw = el.tagName.toLowerCase();
|
|
472
|
+
if (el.namespaceURI === SVG_NS && raw !== 'svg') return 'svg_' + raw;
|
|
473
|
+
return raw;
|
|
474
|
+
}
|
|
475
|
+
|
|
476
|
+
/**
|
|
477
|
+
* Convert an internal tag name to its HTML serialisation form.
|
|
478
|
+
*
|
|
479
|
+
* - Looks up an explicit override in `INTERNAL_TO_HTML`.
|
|
480
|
+
* - Strips the `svg_` prefix for SVG child elements.
|
|
481
|
+
* - Falls back to the tag unchanged.
|
|
482
|
+
*
|
|
483
|
+
* @param {string} tag - Internal tag name.
|
|
484
|
+
* @returns {string} HTML tag name to use when serialising.
|
|
485
|
+
*/
|
|
486
|
+
function htmlTagName(tag) {
|
|
487
|
+
if (INTERNAL_TO_HTML[tag]) return INTERNAL_TO_HTML[tag];
|
|
488
|
+
if (tag.startsWith('svg_')) return tag.slice(4); // svg_rect → rect
|
|
489
|
+
return tag;
|
|
490
|
+
}
|
|
491
|
+
|
|
492
|
+
// ── Shared helper: parse a raw string for #{var} placeholders ─────────────
|
|
493
|
+
//
|
|
494
|
+
// Returns { val, maps } where:
|
|
495
|
+
// val – static base stored in elm.data[prop] or elm.text
|
|
496
|
+
// maps – map-entry objects ready for elm.map
|
|
497
|
+
//
|
|
498
|
+
// Positioning rules (mirror render.js):
|
|
499
|
+
// "prefix#{v}" → append : true, val = "prefix"
|
|
500
|
+
// "#{v}suffix" → prepend : true, val = "suffix"
|
|
501
|
+
// "prefix#{v}suffix" → append : true, val = "prefix", tail = "suffix"
|
|
502
|
+
// "#{v}" → full replace, val = ""
|
|
503
|
+
// "a#{v1}b#{v2}c" → val = "a" (leading run); each entry appends its
|
|
504
|
+
// resolved value then its trailing run via `tail`
|
|
505
|
+
// (v1.tail = "b", v2.tail = "c").
|
|
506
|
+
|
|
507
|
+
/**
|
|
508
|
+
* Parse a raw string for `#{var}` placeholders and build the corresponding
|
|
509
|
+
* static base value and {@link MapEntry} descriptors.
|
|
510
|
+
*
|
|
511
|
+
* Positioning rules (mirrored by `render.js`):
|
|
512
|
+
* - `"prefix#{v}"` → `append: true`, `val = "prefix"`
|
|
513
|
+
* - `"#{v}suffix"` → `prepend: true`, `val = "suffix"`
|
|
514
|
+
* - `"prefix#{v}suffix"` → `append: true`, `val = "prefix"`, `tail = "suffix"`
|
|
515
|
+
* - `"#{v}"` → full replace, `val = ""`
|
|
516
|
+
* - `"a#{v1}b#{v2}c"` → `val = "a"` (leading run); each entry `append`s its
|
|
517
|
+
* resolved value then its trailing static run via `tail` (`v1.tail = "b"`,
|
|
518
|
+
* `v2.tail = "c"`). Empty runs are omitted.
|
|
519
|
+
*
|
|
520
|
+
* @param {string} raw - Raw string potentially containing `#{…}` tokens.
|
|
521
|
+
* @param {string} prop - Property name the placeholders map to.
|
|
522
|
+
* @param {boolean} isData - `true` when targeting an attribute (`elm.data[prop]`);
|
|
523
|
+
* `false` when targeting text content.
|
|
524
|
+
* @returns {{ val: string, maps: MapEntry[] }} Static base value and binding
|
|
525
|
+
* descriptors. Returns the original string and an empty array when no
|
|
526
|
+
* placeholders are found.
|
|
527
|
+
*/
|
|
528
|
+
function parseVarString(raw, prop, isData) {
|
|
529
|
+
const parts = raw.split(RE_VAR_SEP);
|
|
530
|
+
if (parts.length === 1) return { val: raw, maps: [] };
|
|
531
|
+
|
|
532
|
+
const vars = [];
|
|
533
|
+
parts.forEach((p, i) => {
|
|
534
|
+
const m = p.match(RE_VAR_ONE);
|
|
535
|
+
if (m) vars.push({ name: m[1], idx: i });
|
|
536
|
+
});
|
|
537
|
+
|
|
538
|
+
const maps = [];
|
|
539
|
+
|
|
540
|
+
// Single var: preserve the historical prefix-only / suffix-only /
|
|
541
|
+
// full-replace shapes byte-for-byte; add `tail` only for the
|
|
542
|
+
// both-sides `"prefix#{v}suffix"` case (previously lost the suffix).
|
|
543
|
+
if (vars.length === 1) {
|
|
544
|
+
const v = vars[0];
|
|
545
|
+
const before = parts.slice(0, v.idx).join('');
|
|
546
|
+
const after = parts.slice(v.idx + 1).join('');
|
|
547
|
+
const entry = { name: v.name, prop };
|
|
548
|
+
if (isData) entry.data = true;
|
|
549
|
+
|
|
550
|
+
if (before && !after) { entry.append = true; }
|
|
551
|
+
else if (!before && after) { entry.prepend = true; }
|
|
552
|
+
else if (before && after) { entry.append = true; entry.tail = after; }
|
|
553
|
+
// else: #{v} alone → full replace
|
|
554
|
+
|
|
555
|
+
maps.push(entry);
|
|
556
|
+
const base = entry.prepend ? after : before; // '' for full replace
|
|
557
|
+
return { val: base, maps };
|
|
558
|
+
}
|
|
559
|
+
|
|
560
|
+
// Multiple vars: ordered static/var segment sequence. The value is
|
|
561
|
+
// base + Σ (resolve(var_i) + tail_i)
|
|
562
|
+
// where `base` is the leading static run (before the first var) and
|
|
563
|
+
// each entry appends its resolved value followed by its trailing run.
|
|
564
|
+
const base = parts.slice(0, vars[0].idx).join('');
|
|
565
|
+
vars.forEach((v, i) => {
|
|
566
|
+
const nextIdx = (i + 1 < vars.length) ? vars[i + 1].idx : parts.length;
|
|
567
|
+
const tail = parts.slice(v.idx + 1, nextIdx).join('');
|
|
568
|
+
const entry = { name: v.name, prop, append: true };
|
|
569
|
+
if (isData) entry.data = true;
|
|
570
|
+
if (tail) entry.tail = tail;
|
|
571
|
+
maps.push(entry);
|
|
572
|
+
});
|
|
573
|
+
|
|
574
|
+
return { val: base, maps };
|
|
575
|
+
}
|
|
576
|
+
|
|
577
|
+
/**
|
|
578
|
+
* Reconstruct a raw `#{var}` string from a static base and its
|
|
579
|
+
* {@link MapEntry} descriptors. Inverse of {@link parseVarString},
|
|
580
|
+
* used by `toHTML` to regenerate the original template notation.
|
|
581
|
+
*
|
|
582
|
+
* @param {string} base - Static base value (may be `''` or `undefined`).
|
|
583
|
+
* @param {MapEntry[]} maps - Full map array; entries for other props are ignored.
|
|
584
|
+
* @param {string} prop - Target property to reconstruct.
|
|
585
|
+
* @param {boolean} isData - `true` for attribute entries; `false` for text.
|
|
586
|
+
* @returns {string} Reconstructed raw string with `#{…}` placeholders.
|
|
587
|
+
*/
|
|
588
|
+
function buildVarString(base, maps, prop, isData) {
|
|
589
|
+
const propMaps = (maps || []).filter(m =>
|
|
590
|
+
m.prop === prop && !!m.data === isData
|
|
591
|
+
);
|
|
592
|
+
if (propMaps.length === 0) return base ?? '';
|
|
593
|
+
|
|
594
|
+
if (propMaps.length === 1) {
|
|
595
|
+
const m = propMaps[0];
|
|
596
|
+
const ph = `#{${m.name}}`;
|
|
597
|
+
if (m.append) return (base || '') + ph + (m.tail || '');
|
|
598
|
+
if (m.prepend) return ph + (base || '');
|
|
599
|
+
return ph; // full replace
|
|
600
|
+
}
|
|
601
|
+
|
|
602
|
+
// Multiple vars: leading static base, then each placeholder followed
|
|
603
|
+
// by its trailing static run (`tail`).
|
|
604
|
+
let result = base || '';
|
|
605
|
+
propMaps.forEach(m => { result += `#{${m.name}}` + (m.tail || ''); });
|
|
606
|
+
return result;
|
|
607
|
+
}
|
|
608
|
+
|
|
609
|
+
/**
|
|
610
|
+
* Convert a flat, parent-ordered elm array into an {@link ElmTree} suited
|
|
611
|
+
* for recursive serialisation in `toHTML`.
|
|
612
|
+
*
|
|
613
|
+
* @param {ElmNode[]} elmArray - Flat elm array (parents before children).
|
|
614
|
+
* @returns {ElmTree} Tree representation with `byId`, `kids`, and `roots`.
|
|
615
|
+
*/
|
|
616
|
+
function buildTree(elmArray) {
|
|
617
|
+
const byId = new Map();
|
|
618
|
+
const kids = new Map();
|
|
619
|
+
const roots = [];
|
|
620
|
+
|
|
621
|
+
elmArray.forEach(elm => {
|
|
622
|
+
byId.set(elm.id, elm);
|
|
623
|
+
kids.set(elm.id, []);
|
|
624
|
+
});
|
|
625
|
+
elmArray.forEach(elm => {
|
|
626
|
+
if (elm.parent && byId.has(elm.parent)) {
|
|
627
|
+
kids.get(elm.parent).push(elm.id);
|
|
628
|
+
} else {
|
|
629
|
+
roots.push(elm.id);
|
|
630
|
+
}
|
|
631
|
+
});
|
|
632
|
+
|
|
633
|
+
return { byId, kids, roots };
|
|
634
|
+
}
|
|
635
|
+
|
|
636
|
+
/**
|
|
637
|
+
* Recursively serialise a single elm node and its descendants to an
|
|
638
|
+
* indented HTML string, restoring `#{var}` / `${slot}` / iterate-block
|
|
639
|
+
* notation as required.
|
|
640
|
+
*
|
|
641
|
+
* @param {string} id - Id of the node to serialise.
|
|
642
|
+
* @param {ElmTree} tree - Tree built by `buildTree`.
|
|
643
|
+
* @param {Object.<string, ElmNode[]>} iteratesMap - Sub-template arrays keyed by
|
|
644
|
+
* iterate-block name.
|
|
645
|
+
* @param {string} pad - Current indentation prefix.
|
|
646
|
+
* @returns {string} HTML fragment string for this node and its subtree.
|
|
647
|
+
*/
|
|
648
|
+
function serializeNode(id, tree, iteratesMap, pad) {
|
|
649
|
+
const elm = tree.byId.get(id);
|
|
650
|
+
if (!elm) return '';
|
|
651
|
+
|
|
652
|
+
// ── Synthetic text nodes ──────────────────────────────────────────────
|
|
653
|
+
// tag:'text' is a bare inline-text wrapper created by fromHTML when a
|
|
654
|
+
// text node has element siblings. In the HTML template notation it lives
|
|
655
|
+
// as plain text (no <span>), so we emit it without any wrapping tag.
|
|
656
|
+
if (elm.tag === 'text') {
|
|
657
|
+
return buildVarString(elm.text ?? '', elm.map || [], 'text', false);
|
|
658
|
+
}
|
|
659
|
+
|
|
660
|
+
const tag = htmlTagName(elm.tag);
|
|
661
|
+
const maps = elm.map || [];
|
|
662
|
+
const indent = pad || '';
|
|
663
|
+
const child0 = indent + ' '; // one level deeper (children)
|
|
664
|
+
const child1 = child0 + ' '; // two levels deeper (iterate content)
|
|
665
|
+
|
|
666
|
+
// ── Opening tag ──────────────────────────────────────────────────────
|
|
667
|
+
let attrStr = `id="${elm.id}"`;
|
|
668
|
+
if (elm.attrs) {
|
|
669
|
+
elm.attrs.forEach(attr => {
|
|
670
|
+
const base = elm.data?.[attr] ?? '';
|
|
671
|
+
attrStr += ` ${attr}="${buildVarString(base, maps, attr, true)}"`;
|
|
672
|
+
});
|
|
673
|
+
}
|
|
674
|
+
|
|
675
|
+
if (VOID_TAGS.has(tag)) {
|
|
676
|
+
return `${indent}<${tag} ${attrStr}>`;
|
|
677
|
+
}
|
|
678
|
+
|
|
679
|
+
// ── Inner content ────────────────────────────────────────────────────
|
|
680
|
+
let inner = '';
|
|
681
|
+
|
|
682
|
+
if (elm.content) {
|
|
683
|
+
const itTpl = iteratesMap && iteratesMap[elm.content];
|
|
684
|
+
if (itTpl) {
|
|
685
|
+
// Inline the iterate sub-template between comment delimiters
|
|
686
|
+
const subTree = buildTree(itTpl);
|
|
687
|
+
const subLines = subTree.roots
|
|
688
|
+
.map(rid => serializeNode(rid, subTree, iteratesMap, child1))
|
|
689
|
+
.join('\n');
|
|
690
|
+
inner =
|
|
691
|
+
`\n${child0}<!-- $${elm.content} -->\n` +
|
|
692
|
+
subLines +
|
|
693
|
+
`\n${child0}<!-- ${elm.content}$ -->\n${indent}`;
|
|
694
|
+
} else {
|
|
695
|
+
inner = `\${${elm.content}}`;
|
|
696
|
+
}
|
|
697
|
+
|
|
698
|
+
} else if (
|
|
699
|
+
Object.prototype.hasOwnProperty.call(elm, 'text') ||
|
|
700
|
+
maps.some(m => m.prop === 'text' && !m.data)
|
|
701
|
+
) {
|
|
702
|
+
// Leaf node: reconstruct text with #{var} placeholders
|
|
703
|
+
inner = buildVarString(elm.text ?? '', maps, 'text', false);
|
|
704
|
+
|
|
705
|
+
} else {
|
|
706
|
+
// Container: recurse into children
|
|
707
|
+
const childIds = tree.kids.get(id) || [];
|
|
708
|
+
if (childIds.length > 0) {
|
|
709
|
+
// If ANY child is a synthetic 'text' node the content is mixed
|
|
710
|
+
// inline/block → use inline mode (no newlines) to avoid adding
|
|
711
|
+
// spurious whitespace-text between the elements.
|
|
712
|
+
const hasSyntheticText = childIds.some(cid => {
|
|
713
|
+
const c = tree.byId.get(cid);
|
|
714
|
+
return c && c.tag === 'text';
|
|
715
|
+
});
|
|
716
|
+
|
|
717
|
+
if (hasSyntheticText) {
|
|
718
|
+
// Inline mode: children concatenated, no wrapping newlines.
|
|
719
|
+
// 'text' nodes emit bare strings; element nodes emit their tags
|
|
720
|
+
// without extra indentation inside the parent.
|
|
721
|
+
inner = childIds
|
|
722
|
+
.map(cid => serializeNode(cid, tree, iteratesMap, ''))
|
|
723
|
+
.join('');
|
|
724
|
+
} else {
|
|
725
|
+
// Block mode: each child on its own indented line.
|
|
726
|
+
inner =
|
|
727
|
+
'\n' +
|
|
728
|
+
childIds
|
|
729
|
+
.map(cid => serializeNode(cid, tree, iteratesMap, child0))
|
|
730
|
+
.join('\n') +
|
|
731
|
+
'\n' + indent;
|
|
732
|
+
}
|
|
733
|
+
}
|
|
734
|
+
}
|
|
735
|
+
|
|
736
|
+
return `${indent}<${tag} ${attrStr}>${inner}</${tag}>`;
|
|
737
|
+
}
|
|
738
|
+
|
|
739
|
+
// ── fromHTML ─────────────────────────────────────────────────────────────
|
|
740
|
+
|
|
741
|
+
/**
|
|
742
|
+
* Parse an HTML string into a flat elm-array representation.
|
|
743
|
+
*
|
|
744
|
+
* **Mixed content rules:**
|
|
745
|
+
* - An element whose sole content is a text node is a *leaf*:
|
|
746
|
+
* - `${slot}` → `elm.content = 'slot'`
|
|
747
|
+
* - `#{var}` / plain text → `elm.text` + `elm.map`
|
|
748
|
+
* - An element that has element children is a *container*:
|
|
749
|
+
* - Bare text nodes with element siblings become synthetic children:
|
|
750
|
+
* - `${slot}` → `{ tag: 'span', content: 'slot' }` (has siblings → span)
|
|
751
|
+
* - `#{var}` / plain text → `{ tag: 'text', text: …, map: … }`
|
|
752
|
+
* - Document order is preserved in the flat output array.
|
|
753
|
+
*
|
|
754
|
+
* **SVG:** Child elements of `<svg>` carry `namespaceURI = SVG_NS` and are
|
|
755
|
+
* tagged `svg_<localname>` to match the `template.js` `svg_*` convention.
|
|
756
|
+
*
|
|
757
|
+
* **Security:** Uses `DOMParser` only - never `innerHTML` setter, `eval`,
|
|
758
|
+
* or `Function`.
|
|
759
|
+
*
|
|
760
|
+
* **Id uniqueness:** auto-minted `p<n>` ids skip every explicit id of
|
|
761
|
+
* this document, every explicit id seen by an earlier call on the same
|
|
762
|
+
* instance, and every id passed through `reserveIdsInput`.
|
|
763
|
+
*
|
|
764
|
+
* @param {string} htmlString - HTML markup to parse.
|
|
765
|
+
* @param {Iterable<string>} [reserveIdsInput] - Caller-declared explicit
|
|
766
|
+
* ids to reserve instance-wide before the walk.
|
|
767
|
+
* @returns {ParseResult} Parsed result containing `template` and optional
|
|
768
|
+
* `iterates` sub-templates.
|
|
769
|
+
*/
|
|
770
|
+
// ── ParseResult cache ──────────────────────────────────────────────
|
|
771
|
+
// Keyed by the raw HTML source string. Bounded LRU-ish : on overflow
|
|
772
|
+
// we drop the oldest insertion (Map preserves insertion order, so the
|
|
773
|
+
// first key is the oldest). `_cacheStats` is exposed via getStats()
|
|
774
|
+
// for instrumentation.
|
|
775
|
+
let _cacheMax = 64; // entries; 0 disables caching
|
|
776
|
+
const _cacheMap = new Map();
|
|
777
|
+
const _cacheStats = { hits: 0, misses: 0, evictions: 0 };
|
|
778
|
+
|
|
779
|
+
function _cacheGet(key) {
|
|
780
|
+
if (_cacheMax === 0) return undefined;
|
|
781
|
+
const hit = _cacheMap.get(key);
|
|
782
|
+
if (hit !== undefined) {
|
|
783
|
+
// Bump to most-recent : delete + reinsert.
|
|
784
|
+
_cacheMap.delete(key);
|
|
785
|
+
_cacheMap.set(key, hit);
|
|
786
|
+
_cacheStats.hits++;
|
|
787
|
+
} else {
|
|
788
|
+
_cacheStats.misses++;
|
|
789
|
+
}
|
|
790
|
+
return hit;
|
|
791
|
+
}
|
|
792
|
+
|
|
793
|
+
function _cacheSet(key, value) {
|
|
794
|
+
if (_cacheMax === 0) return;
|
|
795
|
+
if (_cacheMap.size >= _cacheMax) {
|
|
796
|
+
// Drop oldest
|
|
797
|
+
const oldest = _cacheMap.keys().next().value;
|
|
798
|
+
_cacheMap.delete(oldest);
|
|
799
|
+
_cacheStats.evictions++;
|
|
800
|
+
}
|
|
801
|
+
_cacheMap.set(key, value);
|
|
802
|
+
}
|
|
803
|
+
|
|
804
|
+
const _fromHTMLImpl = function(htmlString, reserveIdsInput) {
|
|
805
|
+
// Resolve a tree root suitable for `walkElement`. In browser /
|
|
806
|
+
// happy-dom contexts we use DOMParser (battle-tested, fast). In
|
|
807
|
+
// pure-Node/Bun (SSR), we fall back to the framework's internal
|
|
808
|
+
// tokenizer (`parseHTMLString` below), which produces a tree
|
|
809
|
+
// matching the same Node-shape interface that walkElement consumes.
|
|
810
|
+
const rootNode = (typeof DOMParser !== 'undefined')
|
|
811
|
+
? new DOMParser().parseFromString(
|
|
812
|
+
'<html><body>' + htmlString + '</body></html>',
|
|
813
|
+
'text/html'
|
|
814
|
+
).body
|
|
815
|
+
: parseHTMLString(htmlString);
|
|
816
|
+
|
|
817
|
+
// Every explicit id of THIS document, collected before the walk so
|
|
818
|
+
// that an auto-minted `pN` never collides with an explicit `pN` —
|
|
819
|
+
// including one that only appears further down the tree.
|
|
820
|
+
const reserved = collectExplicitIds(rootNode);
|
|
821
|
+
// Cross-call layers, both applied BEFORE the walk as well:
|
|
822
|
+
// - ids the caller declared up front for the whole assembled
|
|
823
|
+
// document (covers explicit ids this instance has not met yet);
|
|
824
|
+
// - this document's explicit ids, folded into the instance set so
|
|
825
|
+
// a LATER call never re-mints them.
|
|
826
|
+
reserveInstanceIds(reserveIdsInput, reserved);
|
|
827
|
+
for (const id of reserved) _reservedAll.add(id);
|
|
828
|
+
|
|
829
|
+
const template = [];
|
|
830
|
+
const iterates = {};
|
|
831
|
+
|
|
832
|
+
function walkElement(el, parentId, out) {
|
|
833
|
+
const rawTag = el.tagName.toLowerCase();
|
|
834
|
+
if (RE_BLOCKED_TAG.test(rawTag)) return;
|
|
835
|
+
|
|
836
|
+
const tag = internalTag(el);
|
|
837
|
+
const atId = el.getAttribute('id');
|
|
838
|
+
const id = (atId && atId.trim()) ? atId.trim() : nextId(reserved);
|
|
839
|
+
|
|
840
|
+
const elm = { id, tag };
|
|
841
|
+
if (parentId !== null && parentId !== undefined) elm.parent = parentId;
|
|
842
|
+
|
|
843
|
+
const allMaps = [];
|
|
844
|
+
const attrs = [];
|
|
845
|
+
const data = {};
|
|
846
|
+
|
|
847
|
+
// ── Attributes ───────────────────────────────────────────────────
|
|
848
|
+
for (const attr of el.attributes) {
|
|
849
|
+
if (attr.name === 'id') continue;
|
|
850
|
+
if (!RE_SAFE_A.test(attr.name)) continue;
|
|
851
|
+
if (RE_EVENT.test(attr.name)) continue;
|
|
852
|
+
|
|
853
|
+
const { val, maps } = parseVarString(attr.value, attr.name, true);
|
|
854
|
+
attrs.push(attr.name);
|
|
855
|
+
data[attr.name] = val;
|
|
856
|
+
allMaps.push(...maps);
|
|
857
|
+
}
|
|
858
|
+
if (attrs.length > 0) {
|
|
859
|
+
elm.attrs = attrs;
|
|
860
|
+
elm.data = { ...data };
|
|
861
|
+
}
|
|
862
|
+
|
|
863
|
+
// ── Children: scan for iterate comment blocks ─────────────────────
|
|
864
|
+
const childNodes = Array.from(el.childNodes);
|
|
865
|
+
let iterateName = null;
|
|
866
|
+
let inIter = false;
|
|
867
|
+
const iterKids = []; // elements inside <!-- $name -->...<!-- name$ -->
|
|
868
|
+
const plainKids = []; // everything else (in document order)
|
|
869
|
+
|
|
870
|
+
for (const c of childNodes) {
|
|
871
|
+
if (c.nodeType === NODE_COMMENT) {
|
|
872
|
+
const sm = c.nodeValue.match(RE_IT_S);
|
|
873
|
+
const em = c.nodeValue.match(RE_IT_E);
|
|
874
|
+
if (sm) {
|
|
875
|
+
iterateName = sm[1];
|
|
876
|
+
inIter = true;
|
|
877
|
+
} else if (em && inIter) {
|
|
878
|
+
inIter = false;
|
|
879
|
+
}
|
|
880
|
+
} else if (inIter) {
|
|
881
|
+
if (c.nodeType === NODE_ELEMENT) iterKids.push(c);
|
|
882
|
+
} else {
|
|
883
|
+
plainKids.push(c);
|
|
884
|
+
}
|
|
885
|
+
}
|
|
886
|
+
|
|
887
|
+
// ── Content resolution ───────────────────────────────────────────
|
|
888
|
+
|
|
889
|
+
if (iterateName) {
|
|
890
|
+
// This element is the slot container for an iterate block.
|
|
891
|
+
// Elements between the comment delimiters form a separate template.
|
|
892
|
+
elm.content = iterateName;
|
|
893
|
+
const subOut = [];
|
|
894
|
+
iterKids.forEach(c => walkElement(c, null, subOut));
|
|
895
|
+
iterates[iterateName] = subOut;
|
|
896
|
+
|
|
897
|
+
if (allMaps.length > 0) elm.map = allMaps;
|
|
898
|
+
out.push(elm);
|
|
899
|
+
|
|
900
|
+
} else {
|
|
901
|
+
const elKids = plainKids.filter(c => c.nodeType === NODE_ELEMENT);
|
|
902
|
+
|
|
903
|
+
if (elKids.length === 0) {
|
|
904
|
+
// ── Leaf: sole text content ───────────────────────────────
|
|
905
|
+
const text = plainKids
|
|
906
|
+
.filter(c => c.nodeType === NODE_TEXT)
|
|
907
|
+
.map(c => c.nodeValue)
|
|
908
|
+
.join('')
|
|
909
|
+
.trim();
|
|
910
|
+
|
|
911
|
+
if (text) {
|
|
912
|
+
const slotM = text.match(RE_SLOT);
|
|
913
|
+
if (slotM) {
|
|
914
|
+
elm.content = slotM[1];
|
|
915
|
+
} else {
|
|
916
|
+
const { val, maps } = parseVarString(text, 'text', false);
|
|
917
|
+
elm.text = val;
|
|
918
|
+
allMaps.push(...maps);
|
|
919
|
+
}
|
|
920
|
+
}
|
|
921
|
+
|
|
922
|
+
if (allMaps.length > 0) elm.map = allMaps;
|
|
923
|
+
out.push(elm);
|
|
924
|
+
|
|
925
|
+
} else {
|
|
926
|
+
// ── Container: has element children ───────────────────────
|
|
927
|
+
// Push the parent first (order invariant: parent before children).
|
|
928
|
+
if (allMaps.length > 0) elm.map = allMaps;
|
|
929
|
+
out.push(elm);
|
|
930
|
+
|
|
931
|
+
// Process children IN DOCUMENT ORDER.
|
|
932
|
+
// Non-empty text nodes that live alongside element siblings
|
|
933
|
+
// cannot be represented as elm.text; they become synthetic
|
|
934
|
+
// child elements instead.
|
|
935
|
+
plainKids.forEach(c => {
|
|
936
|
+
if (c.nodeType === NODE_ELEMENT) {
|
|
937
|
+
walkElement(c, id, out);
|
|
938
|
+
|
|
939
|
+
} else if (c.nodeType === NODE_TEXT) {
|
|
940
|
+
const rawText = c.nodeValue.trim();
|
|
941
|
+
if (!rawText) return; // whitespace-only → skip
|
|
942
|
+
|
|
943
|
+
const slotM = rawText.match(RE_SLOT);
|
|
944
|
+
if (slotM) {
|
|
945
|
+
// ${slot} text node with element siblings → <span>
|
|
946
|
+
// (the memo rule: "has neighbours → span tag")
|
|
947
|
+
out.push({ id: nextId(reserved), tag: 'span', parent: id, content: slotM[1] });
|
|
948
|
+
} else {
|
|
949
|
+
// Plain text or #{var} with element siblings →
|
|
950
|
+
// synthetic 'text' node (rendered as <span> by
|
|
951
|
+
// template.js, serialised as bare text by toHTML).
|
|
952
|
+
const { val, maps } = parseVarString(rawText, 'text', false);
|
|
953
|
+
const syn = { id: nextId(reserved), tag: 'text', parent: id, text: val };
|
|
954
|
+
if (maps.length > 0) syn.map = maps;
|
|
955
|
+
out.push(syn);
|
|
956
|
+
}
|
|
957
|
+
}
|
|
958
|
+
});
|
|
959
|
+
}
|
|
960
|
+
}
|
|
961
|
+
}
|
|
962
|
+
|
|
963
|
+
Array.from(rootNode.childNodes).forEach(c => {
|
|
964
|
+
if (c.nodeType === NODE_ELEMENT) walkElement(c, null, template);
|
|
965
|
+
});
|
|
966
|
+
|
|
967
|
+
const result = { template };
|
|
968
|
+
if (Object.keys(iterates).length > 0) result.iterates = iterates;
|
|
969
|
+
return result;
|
|
970
|
+
};
|
|
971
|
+
|
|
972
|
+
// ── toHTML ───────────────────────────────────────────────────────────────
|
|
973
|
+
|
|
974
|
+
/**
|
|
975
|
+
* Convert an elm array (or a {@link ParseResult} object) back to an HTML
|
|
976
|
+
* string, reconstructing `#{var}` / `${slot}` / `<!-- $name -->` notation.
|
|
977
|
+
*
|
|
978
|
+
* Accepts either form:
|
|
979
|
+
* ```js
|
|
980
|
+
* toHTML(elmArray)
|
|
981
|
+
* toHTML({ template: elmArray, iterates: { name: elmArray } })
|
|
982
|
+
* ```
|
|
983
|
+
*
|
|
984
|
+
* @param {ElmNode[] | ParseResult} input - Flat elm array or a `ParseResult`
|
|
985
|
+
* as returned by `fromHTML`.
|
|
986
|
+
* @returns {string} Indented HTML string with the original template notation
|
|
987
|
+
* restored.
|
|
988
|
+
*/
|
|
989
|
+
const toHTML = function(input) {
|
|
990
|
+
const isArr = Array.isArray(input);
|
|
991
|
+
const tmpl = isArr ? input : (input.template || []);
|
|
992
|
+
const iterMap = isArr ? {} : (input.iterates || {});
|
|
993
|
+
|
|
994
|
+
const tree = buildTree(tmpl);
|
|
995
|
+
return tree.roots
|
|
996
|
+
.map(id => serializeNode(id, tree, iterMap, ''))
|
|
997
|
+
.join('\n');
|
|
998
|
+
};
|
|
999
|
+
|
|
1000
|
+
/**
|
|
1001
|
+
* Cached `fromHTML` : returns the same ParseResult for identical input
|
|
1002
|
+
* strings. The cached object is a frozen reference - callers that need
|
|
1003
|
+
* to mutate it should clone first. Cache is bounded; oldest entries are
|
|
1004
|
+
* evicted on overflow.
|
|
1005
|
+
*
|
|
1006
|
+
* Supplying `options.reserveIds` BYPASSES the cache in both directions:
|
|
1007
|
+
* the reservation changes which auto ids are minted, so a hit keyed on
|
|
1008
|
+
* the source string alone would return a stale `ParseResult` that
|
|
1009
|
+
* violates the reservation, and storing the reserved-set result under
|
|
1010
|
+
* that same key would poison later plain calls. The reservation itself
|
|
1011
|
+
* is still recorded on the instance, so it keeps applying to every
|
|
1012
|
+
* subsequent call.
|
|
1013
|
+
*
|
|
1014
|
+
* @param {string} htmlString - HTML markup to parse.
|
|
1015
|
+
* @param {FromHTMLOptions} [options] - Optional parse inputs.
|
|
1016
|
+
* @returns {ParseResult} Parsed result.
|
|
1017
|
+
*/
|
|
1018
|
+
const fromHTML = function(htmlString, options) {
|
|
1019
|
+
const reserveIdsInput = options ? options.reserveIds : undefined;
|
|
1020
|
+
if (typeof htmlString !== 'string') {
|
|
1021
|
+
return _fromHTMLImpl(htmlString, reserveIdsInput);
|
|
1022
|
+
}
|
|
1023
|
+
if (reserveIdsInput !== undefined && reserveIdsInput !== null) {
|
|
1024
|
+
return _fromHTMLImpl(htmlString, reserveIdsInput);
|
|
1025
|
+
}
|
|
1026
|
+
const cached = _cacheGet(htmlString);
|
|
1027
|
+
if (cached !== undefined) return cached;
|
|
1028
|
+
const result = _fromHTMLImpl(htmlString);
|
|
1029
|
+
_cacheSet(htmlString, result);
|
|
1030
|
+
return result;
|
|
1031
|
+
};
|
|
1032
|
+
|
|
1033
|
+
/**
|
|
1034
|
+
* Manual cache controls (test / power-user).
|
|
1035
|
+
*/
|
|
1036
|
+
const cache = {
|
|
1037
|
+
/** Clear all cached entries. */
|
|
1038
|
+
clear() { _cacheMap.clear(); _cacheStats.hits = 0; _cacheStats.misses = 0; _cacheStats.evictions = 0; },
|
|
1039
|
+
/** Get/set the max cache size; 0 disables caching. */
|
|
1040
|
+
setMax(n) {
|
|
1041
|
+
_cacheMax = Math.max(0, n | 0);
|
|
1042
|
+
while (_cacheMap.size > _cacheMax) {
|
|
1043
|
+
const oldest = _cacheMap.keys().next().value;
|
|
1044
|
+
_cacheMap.delete(oldest);
|
|
1045
|
+
_cacheStats.evictions++;
|
|
1046
|
+
}
|
|
1047
|
+
},
|
|
1048
|
+
getMax() { return _cacheMax; },
|
|
1049
|
+
size() { return _cacheMap.size; },
|
|
1050
|
+
stats() { return { ..._cacheStats, size: _cacheMap.size, max: _cacheMax }; },
|
|
1051
|
+
};
|
|
1052
|
+
|
|
1053
|
+
return { fromHTML, toHTML, cache };
|
|
1054
|
+
}
|
|
1055
|
+
};
|