@stacksjs/stx 0.2.572 → 0.2.573
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/dist/a11y.d.ts +51 -111
- package/dist/animation.d.ts +131 -74
- package/dist/api-client.d.ts +11 -21
- package/dist/api-handler.d.ts +4 -4
- package/dist/appearance-bootstrap.d.ts +16 -77
- package/dist/application-layers.d.ts +11 -20
- package/dist/asset-roots.d.ts +7 -27
- package/dist/assets.d.ts +7 -9
- package/dist/async-components.d.ts +56 -78
- package/dist/auth.d.ts +0 -3
- package/dist/browser-core-imports.d.ts +2 -2
- package/dist/build-externalize-repeated.d.ts +0 -25
- package/dist/build-externalize.d.ts +18 -53
- package/dist/build-id.d.ts +40 -28
- package/dist/build-message.d.ts +20 -44
- package/dist/builtins/attrs.d.ts +0 -14
- package/dist/builtins/drawer.d.ts +3 -22
- package/dist/builtins/icon.d.ts +17 -19
- package/dist/builtins/image-alpha.d.ts +8 -8
- package/dist/builtins/image-delivery.d.ts +38 -40
- package/dist/builtins/image-placeholder.d.ts +12 -50
- package/dist/builtins/image-warmup-worker.d.ts +1 -1
- package/dist/builtins/image-worker.d.ts +6 -32
- package/dist/builtins/index.d.ts +16 -6
- package/dist/builtins/modal.d.ts +13 -23
- package/dist/builtins/safe-image.d.ts +2 -42
- package/dist/builtins/stx-image.d.ts +44 -24
- package/dist/builtins/stx-link.d.ts +5 -8
- package/dist/builtins/stx-loading-indicator.d.ts +11 -10
- package/dist/builtins/suspense.d.ts +6 -27
- package/dist/builtins/toast.d.ts +15 -16
- package/dist/builtins/transition-group.d.ts +1 -25
- package/dist/caching.d.ts +24 -21
- package/dist/{chunk-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
- package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
- package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
- package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
- package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
- package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
- package/dist/chunk-557wtdps.js +2 -0
- package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
- package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
- package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
- package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
- package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
- package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
- package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
- package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
- package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
- package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
- package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
- package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
- package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
- package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
- package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
- package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
- package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
- package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
- package/dist/{chunk-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
- package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
- package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
- package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
- package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
- package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
- package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
- package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
- package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
- package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
- package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
- package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
- package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
- package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
- package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
- package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
- package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
- package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
- package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
- package/dist/chunk-zpz6q2fh.js +2 -0
- package/dist/chunk-zxt94g45.js +2 -0
- package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
- package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
- package/dist/cli.js +7 -7
- package/dist/client/directive.d.ts +0 -7
- package/dist/client/index.d.ts +1 -0
- package/dist/client/signals-appearance-runtime.d.ts +1 -1
- package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
- package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
- package/dist/client/signals-class-runtime.d.ts +1 -1
- package/dist/client/signals-component-api-runtime.d.ts +1 -1
- package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-component-props-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
- package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
- package/dist/client/signals-context-runtime.d.ts +1 -1
- package/dist/client/signals-cookie-runtime.d.ts +1 -1
- package/dist/client/signals-devtools-runtime.d.ts +1 -1
- package/dist/client/signals-dialog-runtime.d.ts +1 -1
- package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
- package/dist/client/signals-drawer-runtime.d.ts +1 -1
- package/dist/client/signals-effect-runtime.d.ts +1 -1
- package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
- package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
- package/dist/client/signals-expression-runtime.d.ts +1 -1
- package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
- package/dist/client/signals-for-runtime.d.ts +1 -1
- package/dist/client/signals-globals-runtime.d.ts +1 -1
- package/dist/client/signals-handler-runtime.d.ts +1 -1
- package/dist/client/signals-head-runtime.d.ts +1 -1
- package/dist/client/signals-helpers-runtime.d.ts +1 -1
- package/dist/client/signals-host-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-if-chain-runtime.d.ts +1 -1
- package/dist/client/signals-if-runtime.d.ts +1 -1
- package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
- package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
- package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
- package/dist/client/signals-loop-row-runtime.d.ts +1 -1
- package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-model-runtime.d.ts +1 -1
- package/dist/client/signals-mount-runtime.d.ts +1 -1
- package/dist/client/signals-navigation-runtime.d.ts +1 -1
- package/dist/client/signals-notify-runtime.d.ts +1 -1
- package/dist/client/signals-optimistic-runtime.d.ts +1 -1
- package/dist/client/signals-overlay-runtime.d.ts +1 -1
- package/dist/client/signals-pipe-runtime.d.ts +1 -1
- package/dist/client/signals-proxy-runtime.d.ts +1 -1
- package/dist/client/signals-query-runtime.d.ts +1 -1
- package/dist/client/signals-reactive-runtime.d.ts +1 -1
- package/dist/client/signals-ref-runtime.d.ts +1 -1
- package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
- package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
- package/dist/client/signals-show-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-runtime.d.ts +1 -1
- package/dist/client/signals-state-runtime.d.ts +1 -1
- package/dist/client/signals-storage-runtime.d.ts +1 -1
- package/dist/client/signals-store-registry-runtime.d.ts +1 -1
- package/dist/client/signals-style-runtime.d.ts +1 -1
- package/dist/client/signals-suspense-runtime.d.ts +1 -1
- package/dist/client/signals-timer-runtime.d.ts +1 -1
- package/dist/client/signals-toast-runtime.d.ts +1 -1
- package/dist/client/signals-tooltip-runtime.d.ts +1 -1
- package/dist/client/signals-transition-group-runtime.d.ts +1 -1
- package/dist/client/signals-websocket-runtime.d.ts +1 -1
- package/dist/client-helpers.d.ts +1 -312
- package/dist/client-module-registry.d.ts +4 -27
- package/dist/client-parameter-bindings.d.ts +1 -4
- package/dist/client-script-bundler.d.ts +55 -103
- package/dist/client-script.d.ts +69 -127
- package/dist/color-mode-boot.d.ts +21 -58
- package/dist/component-client-factories.d.ts +8 -9
- package/dist/component-contract-checks.d.ts +15 -18
- package/dist/component-contract.d.ts +6 -6
- package/dist/component-hmr.d.ts +8 -7
- package/dist/component-model.d.ts +14 -20
- package/dist/component-processing.d.ts +51 -59
- package/dist/component-registry.d.ts +28 -99
- package/dist/component-renderer.d.ts +19 -16
- package/dist/component-resolution.d.ts +8 -8
- package/dist/component-tags.d.ts +1 -1
- package/dist/composable-loader.d.ts +6 -41
- package/dist/composables/use-fetch.d.ts +45 -114
- package/dist/composables/use-form.d.ts +2 -56
- package/dist/composables/use-intersection-observer.d.ts +1 -1
- package/dist/composables.d.ts +75 -74
- package/dist/composition-api.d.ts +19 -43
- package/dist/computed.d.ts +93 -86
- package/dist/conditionals.d.ts +0 -24
- package/dist/config.d.ts +30 -24
- package/dist/config.js +3 -0
- package/dist/craft-bridge.d.ts +1 -467
- package/dist/craft-components.d.ts +234 -680
- package/dist/craft-entry.js +1 -1
- package/dist/craft.js +1 -1
- package/dist/csp.d.ts +41 -107
- package/dist/database.d.ts +1 -1
- package/dist/defer.d.ts +0 -24
- package/dist/dev-server/terminal-colors.d.ts +32 -32
- package/dist/dev-server/ts-css.d.ts +26 -35
- package/dist/dev-server/types.d.ts +33 -29
- package/dist/directive-api.d.ts +42 -85
- package/dist/directive-arguments.d.ts +14 -39
- package/dist/document-shell.d.ts +49 -81
- package/dist/dynamic-components.d.ts +0 -9
- package/dist/engine-bindings.d.ts +1 -1
- package/dist/env.d.ts +26 -0
- package/dist/error-boundaries.d.ts +36 -43
- package/dist/error-handling.d.ts +1 -1
- package/dist/errors/codes.d.ts +43 -51
- package/dist/errors/formatter.d.ts +38 -58
- package/dist/errors/index.d.ts +61 -5
- package/dist/errors/logger.d.ts +40 -114
- package/dist/errors/sanitizer.d.ts +28 -53
- package/dist/errors/types.d.ts +31 -44
- package/dist/events.d.ts +32 -94
- package/dist/expressions.d.ts +57 -62
- package/dist/find-body-tag.d.ts +5 -34
- package/dist/first-script-tag.d.ts +0 -23
- package/dist/forms-validation.d.ts +117 -149
- package/dist/forms.d.ts +161 -120
- package/dist/framework-composables.d.ts +0 -32
- package/dist/head-injection.d.ts +30 -32
- package/dist/head-keys.d.ts +12 -15
- package/dist/head.d.ts +110 -139
- package/dist/heatmap.d.ts +76 -152
- package/dist/html-masking.d.ts +38 -62
- package/dist/hydration-runtime.d.ts +24 -20
- package/dist/hydration.d.ts +11 -10
- package/dist/i18n.d.ts +34 -95
- package/dist/image-optimization/auto-sibling.d.ts +4 -32
- package/dist/imported-signals.d.ts +0 -36
- package/dist/includes.d.ts +6 -69
- package/dist/index.d.ts +2 -1
- package/dist/init.d.ts +12 -20
- package/dist/internal-markdown.d.ts +8 -12
- package/dist/interpolation-context.d.ts +15 -15
- package/dist/island-chunking.d.ts +13 -30
- package/dist/keep-alive.d.ts +52 -72
- package/dist/layout-types.d.ts +2 -27
- package/dist/lazy-module.d.ts +0 -10
- package/dist/loading-indicator.d.ts +8 -5
- package/dist/loop-binding.d.ts +4 -7
- package/dist/loops.d.ts +25 -67
- package/dist/markdown.d.ts +1 -0
- package/dist/media/image/component.d.ts +9 -25
- package/dist/media/image/directive.d.ts +1 -15
- package/dist/media/image/placeholder.d.ts +9 -20
- package/dist/media/image/processor/cache.d.ts +18 -40
- package/dist/media/image/processor/index.d.ts +10 -1
- package/dist/media/image/processor/optimizer.d.ts +1 -12
- package/dist/media/image/processor/responsive.d.ts +6 -16
- package/dist/media/image/srcset.d.ts +49 -47
- package/dist/media/shared/cache.d.ts +31 -51
- package/dist/media/shared/hash.d.ts +0 -7
- package/dist/media/types.d.ts +754 -1235
- package/dist/media/video/directive.d.ts +1 -15
- package/dist/media/video/index.d.ts +17 -39
- package/dist/media/video/processor/cache.d.ts +19 -42
- package/dist/media/video/processor/index.d.ts +18 -1
- package/dist/media/video/processor/streaming.d.ts +10 -17
- package/dist/media/video/processor/thumbnail.d.ts +15 -21
- package/dist/media/video/processor/transcoder.d.ts +1 -11
- package/dist/meta-arguments.d.ts +14 -39
- package/dist/method-spoofing.d.ts +0 -7
- package/dist/middleware.d.ts +0 -60
- package/dist/native/bridge/protocol.d.ts +2 -1
- package/dist/native/compiler/headwind-to-style.d.ts +383 -359
- package/dist/native/compiler/icons.d.ts +249 -243
- package/dist/native/compiler/svg.d.ts +35 -24
- package/dist/native/runtime/jsc-globals.d.ts +1 -1
- package/dist/native/runtime/native-host.d.ts +1 -1
- package/dist/native/runtime/native-host.js +3 -0
- package/dist/offline/app-service-worker.d.ts +50 -114
- package/dist/offline/kept-store.d.ts +23 -37
- package/dist/offline/query-cache.d.ts +55 -126
- package/dist/owned-routes.d.ts +0 -31
- package/dist/page-response.d.ts +8 -39
- package/dist/parser/directive-parser.d.ts +45 -57
- package/dist/parser/expression-parser.d.ts +35 -33
- package/dist/parser/index.d.ts +39 -4
- package/dist/parser/tokenizer.d.ts +49 -61
- package/dist/partial-hydration.d.ts +51 -82
- package/dist/performance-utils.d.ts +115 -255
- package/dist/placeholder.d.ts +9 -18
- package/dist/plugin-system.d.ts +115 -264
- package/dist/process.d.ts +4 -9
- package/dist/process.js +6 -4
- package/dist/prop-sentinels.d.ts +11 -11
- package/dist/public-env.d.ts +0 -14
- package/dist/pwa/directives.d.ts +20 -12
- package/dist/pwa/inject.d.ts +0 -10
- package/dist/pwa/precache.d.ts +16 -22
- package/dist/pwa/service-worker.d.ts +0 -12
- package/dist/pwa.js +1 -1
- package/dist/reactive-bindings.d.ts +11 -34
- package/dist/reactive-tracking.d.ts +0 -36
- package/dist/reactive.d.ts +41 -58
- package/dist/render-memo.d.ts +5 -23
- package/dist/resolve-stx-targets.d.ts +6 -44
- package/dist/route-middleware.d.ts +35 -2
- package/dist/route-rules.d.ts +10 -13
- package/dist/router.d.ts +9 -8
- package/dist/routes.d.ts +3 -1
- package/dist/runtime-config-server.d.ts +14 -17
- package/dist/runtime-config.d.ts +2 -3
- package/dist/runtime-globals.d.ts +90 -122
- package/dist/runtime-injection.d.ts +0 -8
- package/dist/scaffolding.d.ts +30 -26
- package/dist/script-emit.d.ts +0 -30
- package/dist/script-validation.d.ts +6 -12
- package/dist/seo.d.ts +75 -153
- package/dist/server-api.d.ts +9 -12
- package/dist/server-bindings.d.ts +1 -26
- package/dist/server-data.d.ts +4 -5
- package/dist/sfc-template.d.ts +8 -8
- package/dist/signal-processing.d.ts +37 -53
- package/dist/signals-api.d.ts +58 -135
- package/dist/signals.d.ts +18 -24
- package/dist/site-url.d.ts +31 -28
- package/dist/slots.d.ts +20 -86
- package/dist/source-signature.d.ts +5 -28
- package/dist/ssg.d.ts +158 -337
- package/dist/ssg.js +2 -2
- package/dist/state-dir.d.ts +4 -4
- package/dist/store-loader.d.ts +0 -10
- package/dist/story/analytics.d.ts +60 -138
- package/dist/story/bookmarks.d.ts +34 -87
- package/dist/story/cli.d.ts +69 -123
- package/dist/story/collect/scanner.d.ts +0 -4
- package/dist/story/collect/tree.d.ts +1 -8
- package/dist/story/commands/build.d.ts +6 -11
- package/dist/story/commands/dev.d.ts +8 -15
- package/dist/story/commands/preview.d.ts +7 -13
- package/dist/story/config-watcher.d.ts +13 -20
- package/dist/story/config.d.ts +8 -11
- package/dist/story/context.d.ts +8 -14
- package/dist/story/hmr.d.ts +26 -24
- package/dist/story/hot-swap.d.ts +23 -34
- package/dist/story/keyboard-shortcuts.d.ts +18 -23
- package/dist/story/output.d.ts +44 -46
- package/dist/story/performance.d.ts +45 -107
- package/dist/story/presets.d.ts +41 -107
- package/dist/story/renderer.d.ts +27 -41
- package/dist/story/search.d.ts +12 -23
- package/dist/story/server.d.ts +11 -21
- package/dist/story/setup.d.ts +15 -23
- package/dist/story/testing.d.ts +40 -65
- package/dist/story/types.d.ts +160 -262
- package/dist/streaming.d.ts +57 -119
- package/dist/strip-literals.d.ts +1 -25
- package/dist/stx-module-imports.d.ts +7 -0
- package/dist/stx-virtual-ts.d.ts +102 -253
- package/dist/style-scoping.d.ts +8 -21
- package/dist/suspense.d.ts +52 -67
- package/dist/teleport.d.ts +0 -22
- package/dist/template-syntax-escape.d.ts +8 -8
- package/dist/template-tag-balance.d.ts +6 -22
- package/dist/testing.d.ts +26 -11
- package/dist/theme-tokens.d.ts +388 -134
- package/dist/transitions.d.ts +55 -66
- package/dist/ts-css-config.d.ts +12 -70
- package/dist/types/component-types.d.ts +122 -187
- package/dist/types/config-types.d.ts +341 -956
- package/dist/types/context-types.d.ts +24 -46
- package/dist/types/csp-types.d.ts +66 -70
- package/dist/types/directive-types.d.ts +156 -223
- package/dist/types/index.d.ts +110 -6
- package/dist/types/pwa-types.d.ts +148 -273
- package/dist/types.d.ts +1 -0
- package/dist/unresolved-identifiers.d.ts +22 -24
- package/dist/url-safety.d.ts +32 -32
- package/dist/utils.d.ts +21 -36
- package/dist/validator.d.ts +26 -28
- package/dist/variable-extractor.d.ts +19 -49
- package/dist/view-composers.d.ts +81 -80
- package/dist/virtual-scrolling.d.ts +82 -101
- package/dist/visual-testing.d.ts +10 -9
- package/dist/vue-template.d.ts +0 -23
- package/dist/web-components/css-scoping.d.ts +11 -21
- package/dist/web-components.d.ts +58 -81
- package/dist/x-element.d.ts +1 -0
- package/package.json +6 -6
- package/stx.d.ts +2 -2
- package/dist/app-service-worker.d.ts +0 -165
- package/dist/chunk-49gwmcrn.js +0 -2
- package/dist/chunk-6va5pe2m.js +0 -2
- package/dist/chunk-bm2q1srp.js +0 -2
- package/dist/signals-context-runtime.d.ts +0 -2
- package/dist/signals-drawer-runtime.d.ts +0 -2
- package/dist/signals-host-runtime.d.ts +0 -9
- package/dist/signals-loop-conditional-runtime.d.ts +0 -2
- package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
- package/dist/signals-notify-runtime.d.ts +0 -2
- package/dist/signals-optimistic-runtime.d.ts +0 -2
- package/dist/signals-overlay-runtime.d.ts +0 -2
- package/dist/signals-scope-disposal-runtime.d.ts +0 -2
- package/dist/signals-spa-load-control-runtime.d.ts +0 -2
- package/dist/signals-storage-runtime.d.ts +0 -2
package/dist/head-injection.d.ts
CHANGED
|
@@ -1,35 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* One splice into `<head>` instead of one per thing being injected
|
|
3
|
-
* (stacksjs/stx#1945).
|
|
4
|
-
*
|
|
5
|
-
* Several passes each add a small fragment to the head of a finished page: the
|
|
6
|
-
* x-cloak style, the color-mode boot script, the build-id meta. Each was
|
|
7
|
-
* written the obvious way -- find the anchor, return
|
|
8
|
-
* `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
|
|
9
|
-
* of the whole document. On a 212KB page that is 212KB allocated to insert a
|
|
10
|
-
* few hundred bytes, three times over, and the measured cost of the top-level
|
|
11
|
-
* pipeline was dominated by exactly this shape: of 86 assignments in a render,
|
|
12
|
-
* only ten produced a new string, and six of them were whole-document copies
|
|
13
|
-
* made to insert something small.
|
|
14
|
-
*
|
|
15
|
-
* A pass that contributes a fragment instead of splicing it lets all of them
|
|
16
|
-
* share one rebuild. Order is preserved within each anchor, which is the part
|
|
17
|
-
* that matters: the boot script has to precede the cloak style in the head, and
|
|
18
|
-
* both have to be live before first paint.
|
|
19
|
-
*
|
|
20
|
-
* Nothing here decides WHETHER a fragment applies. Each caller keeps its own
|
|
21
|
-
* guard -- idempotence checks, config gates -- and simply contributes nothing
|
|
22
|
-
* when it does not apply, so a page that needs no injections is not rebuilt.
|
|
23
|
-
*
|
|
24
|
-
* @module head-injection
|
|
25
|
-
*/
|
|
26
|
-
/** Fragments waiting to be spliced into one document. */
|
|
27
|
-
export interface HeadInjections {
|
|
28
|
-
/** Inserted immediately after the `<head ...>` open tag, in push order. */
|
|
29
|
-
afterOpen: string[];
|
|
30
|
-
/** Inserted immediately before `</head>`, in push order. */
|
|
31
|
-
beforeClose: string[];
|
|
32
|
-
}
|
|
33
1
|
export declare function createHeadInjections(): HeadInjections;
|
|
34
2
|
/** Whether anything was contributed, so a caller can skip the rebuild entirely. */
|
|
35
3
|
export declare function hasHeadInjections(injections: HeadInjections): boolean;
|
|
@@ -59,3 +27,33 @@ export declare function applyHeadInjections(html: string, injections: HeadInject
|
|
|
59
27
|
* through here.
|
|
60
28
|
*/
|
|
61
29
|
export declare function headInsertionPoint(html: string): number | null;
|
|
30
|
+
/**
|
|
31
|
+
* One splice into `<head>` instead of one per thing being injected
|
|
32
|
+
* (stacksjs/stx#1945).
|
|
33
|
+
*
|
|
34
|
+
* Several passes each add a small fragment to the head of a finished page: the
|
|
35
|
+
* x-cloak style, the color-mode boot script, the build-id meta. Each was
|
|
36
|
+
* written the obvious way -- find the anchor, return
|
|
37
|
+
* `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
|
|
38
|
+
* of the whole document. On a 212KB page that is 212KB allocated to insert a
|
|
39
|
+
* few hundred bytes, three times over, and the measured cost of the top-level
|
|
40
|
+
* pipeline was dominated by exactly this shape: of 86 assignments in a render,
|
|
41
|
+
* only ten produced a new string, and six of them were whole-document copies
|
|
42
|
+
* made to insert something small.
|
|
43
|
+
*
|
|
44
|
+
* A pass that contributes a fragment instead of splicing it lets all of them
|
|
45
|
+
* share one rebuild. Order is preserved within each anchor, which is the part
|
|
46
|
+
* that matters: the boot script has to precede the cloak style in the head, and
|
|
47
|
+
* both have to be live before first paint.
|
|
48
|
+
*
|
|
49
|
+
* Nothing here decides WHETHER a fragment applies. Each caller keeps its own
|
|
50
|
+
* guard -- idempotence checks, config gates -- and simply contributes nothing
|
|
51
|
+
* when it does not apply, so a page that needs no injections is not rebuilt.
|
|
52
|
+
*
|
|
53
|
+
* @module head-injection
|
|
54
|
+
*/
|
|
55
|
+
/** Fragments waiting to be spliced into one document. */
|
|
56
|
+
export declare interface HeadInjections {
|
|
57
|
+
afterOpen: string[]
|
|
58
|
+
beforeClose: string[]
|
|
59
|
+
}
|
package/dist/head-keys.d.ts
CHANGED
|
@@ -1,3 +1,15 @@
|
|
|
1
|
+
/** Forget which warnings were printed, so a test sees them again. */
|
|
2
|
+
export declare function resetHeadKeyWarnings(): void;
|
|
3
|
+
/** The known key an unknown one most likely meant, or undefined. */
|
|
4
|
+
export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
|
|
5
|
+
/**
|
|
6
|
+
* Read a head config with the plural list keys folded into their singular,
|
|
7
|
+
* warning (once) about those and about any other key stx does not know.
|
|
8
|
+
*
|
|
9
|
+
* Returns the input itself when every key is known. Memoized per object, so a
|
|
10
|
+
* config read on every render is checked once.
|
|
11
|
+
*/
|
|
12
|
+
export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: { known: readonly string[], source: string }): T;
|
|
1
13
|
/**
|
|
2
14
|
* Catch a head config key that stx would otherwise ignore without a word.
|
|
3
15
|
*
|
|
@@ -24,18 +36,3 @@
|
|
|
24
36
|
export declare const APP_HEAD_KEYS: readonly string[];
|
|
25
37
|
/** Keys `useHead()` understands (see `HeadConfig`). */
|
|
26
38
|
export declare const USE_HEAD_KEYS: readonly string[];
|
|
27
|
-
/** Forget which warnings were printed, so a test sees them again. */
|
|
28
|
-
export declare function resetHeadKeyWarnings(): void;
|
|
29
|
-
/** The known key an unknown one most likely meant, or undefined. */
|
|
30
|
-
export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
|
|
31
|
-
/**
|
|
32
|
-
* Read a head config with the plural list keys folded into their singular,
|
|
33
|
-
* warning (once) about those and about any other key stx does not know.
|
|
34
|
-
*
|
|
35
|
-
* Returns the input itself when every key is known. Memoized per object, so a
|
|
36
|
-
* config read on every render is checked once.
|
|
37
|
-
*/
|
|
38
|
-
export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: {
|
|
39
|
-
known: readonly string[];
|
|
40
|
-
source: string;
|
|
41
|
-
}): T;
|
package/dist/head.d.ts
CHANGED
|
@@ -1,137 +1,3 @@
|
|
|
1
|
-
export interface MetaTag {
|
|
2
|
-
name?: string;
|
|
3
|
-
property?: string;
|
|
4
|
-
content: string;
|
|
5
|
-
httpEquiv?: string;
|
|
6
|
-
charset?: string;
|
|
7
|
-
}
|
|
8
|
-
export interface LinkTag {
|
|
9
|
-
rel: string;
|
|
10
|
-
href: string;
|
|
11
|
-
type?: string;
|
|
12
|
-
sizes?: string;
|
|
13
|
-
crossorigin?: string;
|
|
14
|
-
as?: string;
|
|
15
|
-
media?: string;
|
|
16
|
-
}
|
|
17
|
-
export interface ScriptTag {
|
|
18
|
-
src?: string;
|
|
19
|
-
type?: string;
|
|
20
|
-
async?: boolean;
|
|
21
|
-
defer?: boolean;
|
|
22
|
-
content?: string;
|
|
23
|
-
id?: string;
|
|
24
|
-
}
|
|
25
|
-
export interface HeadConfig {
|
|
26
|
-
title?: string;
|
|
27
|
-
titleTemplate?: string | ((title: string) => string);
|
|
28
|
-
base?: {
|
|
29
|
-
href?: string;
|
|
30
|
-
target?: string;
|
|
31
|
-
};
|
|
32
|
-
meta?: MetaTag[];
|
|
33
|
-
link?: LinkTag[];
|
|
34
|
-
script?: ScriptTag[];
|
|
35
|
-
style?: {
|
|
36
|
-
content: string;
|
|
37
|
-
type?: string;
|
|
38
|
-
}[];
|
|
39
|
-
htmlAttrs?: Record<string, string>;
|
|
40
|
-
bodyAttrs?: Record<string, string>;
|
|
41
|
-
}
|
|
42
|
-
export interface SeoMeta {
|
|
43
|
-
title?: string;
|
|
44
|
-
titleTemplate?: string;
|
|
45
|
-
description?: string;
|
|
46
|
-
keywords?: string | string[];
|
|
47
|
-
author?: string;
|
|
48
|
-
robots?: string;
|
|
49
|
-
canonical?: string;
|
|
50
|
-
ogTitle?: string;
|
|
51
|
-
ogDescription?: string;
|
|
52
|
-
ogImage?: string;
|
|
53
|
-
/** Describes the image for people who cannot see it. Also the card's alt. */
|
|
54
|
-
ogImageAlt?: string;
|
|
55
|
-
/** Pixel size, so a scraper can lay the card out before fetching the image. */
|
|
56
|
-
ogImageWidth?: number;
|
|
57
|
-
ogImageHeight?: number;
|
|
58
|
-
/** MIME type, `image/jpeg` */
|
|
59
|
-
ogImageType?: string;
|
|
60
|
-
ogUrl?: string;
|
|
61
|
-
ogType?: string;
|
|
62
|
-
ogSiteName?: string;
|
|
63
|
-
ogLocale?: string;
|
|
64
|
-
profileFirstName?: string;
|
|
65
|
-
profileLastName?: string;
|
|
66
|
-
profileUsername?: string;
|
|
67
|
-
twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
|
|
68
|
-
twitterTitle?: string;
|
|
69
|
-
twitterDescription?: string;
|
|
70
|
-
twitterImage?: string;
|
|
71
|
-
/** Defaults to `ogImageAlt` when the card falls back to `ogImage`. */
|
|
72
|
-
twitterImageAlt?: string;
|
|
73
|
-
twitterSite?: string;
|
|
74
|
-
twitterCreator?: string;
|
|
75
|
-
articleAuthor?: string;
|
|
76
|
-
articlePublishedTime?: string;
|
|
77
|
-
articleModifiedTime?: string;
|
|
78
|
-
articleSection?: string;
|
|
79
|
-
articleTags?: string[];
|
|
80
|
-
}
|
|
81
|
-
/**
|
|
82
|
-
* Layouts that exist on disk, augmented by the generated
|
|
83
|
-
* `<state-dir>/layout-types.d.ts` (stacksjs/stx#1879).
|
|
84
|
-
*
|
|
85
|
-
* Empty here on purpose. A project that has not generated the declaration —
|
|
86
|
-
* or has not added the state directory to its tsconfig — keeps `layout` typed
|
|
87
|
-
* as `string`, so nothing breaks; a project that has gets a type error for a
|
|
88
|
-
* name with no layout behind it.
|
|
89
|
-
*/
|
|
90
|
-
export interface KnownLayouts {
|
|
91
|
-
}
|
|
92
|
-
/**
|
|
93
|
-
* A layout name: the generated union when one is available, otherwise any
|
|
94
|
-
* string.
|
|
95
|
-
*
|
|
96
|
-
* `keyof KnownLayouts` is `never` while the interface is empty, which is what
|
|
97
|
-
* makes the fallback work.
|
|
98
|
-
*/
|
|
99
|
-
export type LayoutName = keyof KnownLayouts extends never ? string : keyof KnownLayouts;
|
|
100
|
-
export interface PageMeta {
|
|
101
|
-
title?: string;
|
|
102
|
-
description?: string;
|
|
103
|
-
/** Static HTTP response status for this page. */
|
|
104
|
-
status?: number;
|
|
105
|
-
/**
|
|
106
|
-
* Layout for this page, by name (`'app'` → `<layoutsDir>/app.stx`), or
|
|
107
|
-
* `false` for none — the same as `@nolayout`.
|
|
108
|
-
*
|
|
109
|
-
* Precedence: `@extends`/`@layout` in the template wins, then this, then an
|
|
110
|
-
* auto-discovered `_layout.stx`, then `defaultLayout`.
|
|
111
|
-
*
|
|
112
|
-
* Do NOT hand-write `<meta name="stx-layout" content="…">` instead. That tag
|
|
113
|
-
* is stx *output*: the router reads it to decide between a fragment swap and
|
|
114
|
-
* a full-document swap, and a page asserting a group it does not belong to
|
|
115
|
-
* mis-routes rather than mis-styles. This field is the authoring surface; the
|
|
116
|
-
* meta tag is derived from the layout that actually resolved (#1879).
|
|
117
|
-
*
|
|
118
|
-
* Typed as the union of layouts on disk when the generated
|
|
119
|
-
* `<state-dir>/layout-types.d.ts` is in scope, so a typo is a type error
|
|
120
|
-
* rather than an unlayouted page.
|
|
121
|
-
*/
|
|
122
|
-
layout?: LayoutName | false;
|
|
123
|
-
middleware?: string | string[];
|
|
124
|
-
transition?: string | {
|
|
125
|
-
name: string;
|
|
126
|
-
mode?: string;
|
|
127
|
-
};
|
|
128
|
-
keepAlive?: boolean;
|
|
129
|
-
key?: string | ((route: unknown) => string);
|
|
130
|
-
validate?: (route: {
|
|
131
|
-
params: Record<string, string>;
|
|
132
|
-
}) => boolean | Promise<boolean>;
|
|
133
|
-
[key: string]: unknown;
|
|
134
|
-
}
|
|
135
1
|
/**
|
|
136
2
|
* Get the current accumulated head config.
|
|
137
3
|
*/
|
|
@@ -238,10 +104,7 @@ export declare function applyHead(config?: HeadConfig): void;
|
|
|
238
104
|
* @endhead
|
|
239
105
|
* ```
|
|
240
106
|
*/
|
|
241
|
-
export declare function processHeadDirective(content: string): {
|
|
242
|
-
content: string;
|
|
243
|
-
headContent: string;
|
|
244
|
-
};
|
|
107
|
+
export declare function processHeadDirective(content: string): { content: string; headContent: string };
|
|
245
108
|
/**
|
|
246
109
|
* Process @title directive.
|
|
247
110
|
*
|
|
@@ -268,4 +131,112 @@ export declare function processTitleDirective(content: string, context: Record<s
|
|
|
268
131
|
* ```
|
|
269
132
|
*/
|
|
270
133
|
export declare function processMetaDirective(content: string, context: Record<string, unknown>, filePath?: string): string;
|
|
271
|
-
|
|
134
|
+
// =============================================================================
|
|
135
|
+
// Types
|
|
136
|
+
// =============================================================================
|
|
137
|
+
export declare interface MetaTag {
|
|
138
|
+
name?: string
|
|
139
|
+
property?: string
|
|
140
|
+
content: string
|
|
141
|
+
httpEquiv?: string
|
|
142
|
+
charset?: string
|
|
143
|
+
}
|
|
144
|
+
export declare interface LinkTag {
|
|
145
|
+
rel: string
|
|
146
|
+
href: string
|
|
147
|
+
type?: string
|
|
148
|
+
sizes?: string
|
|
149
|
+
crossorigin?: string
|
|
150
|
+
as?: string
|
|
151
|
+
media?: string
|
|
152
|
+
}
|
|
153
|
+
export declare interface ScriptTag {
|
|
154
|
+
src?: string
|
|
155
|
+
type?: string
|
|
156
|
+
async?: boolean
|
|
157
|
+
defer?: boolean
|
|
158
|
+
content?: string
|
|
159
|
+
id?: string
|
|
160
|
+
}
|
|
161
|
+
export declare interface HeadConfig {
|
|
162
|
+
title?: string
|
|
163
|
+
titleTemplate?: string | ((title: string) => string)
|
|
164
|
+
base?: { href?: string; target?: string }
|
|
165
|
+
meta?: MetaTag[]
|
|
166
|
+
link?: LinkTag[]
|
|
167
|
+
script?: ScriptTag[]
|
|
168
|
+
style?: { content: string; type?: string }[]
|
|
169
|
+
htmlAttrs?: Record<string, string>
|
|
170
|
+
bodyAttrs?: Record<string, string>
|
|
171
|
+
}
|
|
172
|
+
export declare interface SeoMeta {
|
|
173
|
+
title?: string
|
|
174
|
+
titleTemplate?: string
|
|
175
|
+
description?: string
|
|
176
|
+
keywords?: string | string[]
|
|
177
|
+
author?: string
|
|
178
|
+
robots?: string
|
|
179
|
+
canonical?: string
|
|
180
|
+
ogTitle?: string
|
|
181
|
+
ogDescription?: string
|
|
182
|
+
ogImage?: string
|
|
183
|
+
ogImageAlt?: string
|
|
184
|
+
ogImageWidth?: number
|
|
185
|
+
ogImageHeight?: number
|
|
186
|
+
ogImageType?: string
|
|
187
|
+
ogUrl?: string
|
|
188
|
+
ogType?: string
|
|
189
|
+
ogSiteName?: string
|
|
190
|
+
ogLocale?: string
|
|
191
|
+
profileFirstName?: string
|
|
192
|
+
profileLastName?: string
|
|
193
|
+
profileUsername?: string
|
|
194
|
+
twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player'
|
|
195
|
+
twitterTitle?: string
|
|
196
|
+
twitterDescription?: string
|
|
197
|
+
twitterImage?: string
|
|
198
|
+
twitterImageAlt?: string
|
|
199
|
+
twitterSite?: string
|
|
200
|
+
twitterCreator?: string
|
|
201
|
+
articleAuthor?: string
|
|
202
|
+
articlePublishedTime?: string
|
|
203
|
+
articleModifiedTime?: string
|
|
204
|
+
articleSection?: string
|
|
205
|
+
articleTags?: string[]
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Layouts that exist on disk, augmented by the generated
|
|
209
|
+
* `<state-dir>/layout-types.d.ts` (stacksjs/stx#1879).
|
|
210
|
+
*
|
|
211
|
+
* Empty here on purpose. A project that has not generated the declaration —
|
|
212
|
+
* or has not added the state directory to its tsconfig — keeps `layout` typed
|
|
213
|
+
* as `string`, so nothing breaks; a project that has gets a type error for a
|
|
214
|
+
* name with no layout behind it.
|
|
215
|
+
*/
|
|
216
|
+
export declare interface KnownLayouts {}
|
|
217
|
+
export declare interface PageMeta {
|
|
218
|
+
title?: string
|
|
219
|
+
description?: string
|
|
220
|
+
status?: number
|
|
221
|
+
layout?: LayoutName | false
|
|
222
|
+
middleware?: string | string[]
|
|
223
|
+
transition?: string | { name: string; mode?: string }
|
|
224
|
+
keepAlive?: boolean
|
|
225
|
+
key?: string | ((route: unknown) => string)
|
|
226
|
+
validate?: (route: { params: Record<string, string> }) => boolean | Promise<boolean>
|
|
227
|
+
[key: string]: unknown
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* A layout name: the generated union when one is available, otherwise any
|
|
231
|
+
* string.
|
|
232
|
+
*
|
|
233
|
+
* `keyof KnownLayouts` is `never` while the interface is empty, which is what
|
|
234
|
+
* makes the fallback work.
|
|
235
|
+
*/
|
|
236
|
+
export type LayoutName = keyof KnownLayouts extends never ? string : keyof KnownLayouts;
|
|
237
|
+
// =============================================================================
|
|
238
|
+
// Exports
|
|
239
|
+
// =============================================================================
|
|
240
|
+
export {
|
|
241
|
+
usePageTitle as useTitle
|
|
242
|
+
};
|
package/dist/heatmap.d.ts
CHANGED
|
@@ -1,4 +1,29 @@
|
|
|
1
1
|
import type { CustomDirective, StxOptions } from './types';
|
|
2
|
+
/**
|
|
3
|
+
* Generate heatmap tracking script based on configuration
|
|
4
|
+
*/
|
|
5
|
+
export declare function generateHeatmapScript(options: StxOptions): string;
|
|
6
|
+
/**
|
|
7
|
+
* Inject heatmap script into HTML
|
|
8
|
+
* Scripts are injected just before </body> for optimal loading
|
|
9
|
+
*/
|
|
10
|
+
export declare function injectHeatmap(html: string, options: StxOptions): string;
|
|
11
|
+
/**
|
|
12
|
+
* Parse inline heatmap configuration from directive parameters
|
|
13
|
+
*/
|
|
14
|
+
declare function parseInlineConfig(paramsStr: string): Partial<HeatmapConfig>;
|
|
15
|
+
/**
|
|
16
|
+
* Create a heatmap aggregator instance
|
|
17
|
+
*/
|
|
18
|
+
export declare function createHeatmapAggregator(): HeatmapAggregator;
|
|
19
|
+
/**
|
|
20
|
+
* Default heatmap configuration
|
|
21
|
+
*/
|
|
22
|
+
export declare const defaultHeatmapConfig: HeatmapConfig;
|
|
23
|
+
/**
|
|
24
|
+
* Custom @heatmap directive for explicit placement
|
|
25
|
+
*/
|
|
26
|
+
export declare const heatmapDirective: CustomDirective;
|
|
2
27
|
/**
|
|
3
28
|
* Heatmap Module
|
|
4
29
|
*
|
|
@@ -33,174 +58,73 @@ import type { CustomDirective, StxOptions } from './types';
|
|
|
33
58
|
/**
|
|
34
59
|
* Heatmap tracking configuration
|
|
35
60
|
*/
|
|
36
|
-
export interface HeatmapConfig {
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
/** Session timeout in minutes (default: 30) */
|
|
56
|
-
sessionTimeout?: number;
|
|
57
|
-
/** Enable local storage for offline data */
|
|
58
|
-
persistData?: boolean;
|
|
59
|
-
/** Storage key prefix (default: 'stx_heatmap') */
|
|
60
|
-
storagePrefix?: string;
|
|
61
|
-
/** Custom data attributes to capture on clicks */
|
|
62
|
-
captureAttributes?: string[];
|
|
63
|
-
/** Element selectors to ignore */
|
|
64
|
-
ignoreSelectors?: string[];
|
|
65
|
-
/** Zone definitions for grouped tracking */
|
|
66
|
-
zones?: HeatmapZone[];
|
|
67
|
-
/** Enable visual overlay for development */
|
|
68
|
-
debugOverlay?: boolean;
|
|
69
|
-
/** Minimum viewport width to track (mobile optimization) */
|
|
70
|
-
minViewportWidth?: number;
|
|
71
|
-
/** Maximum viewport width to track */
|
|
72
|
-
maxViewportWidth?: number;
|
|
61
|
+
export declare interface HeatmapConfig {
|
|
62
|
+
enabled: boolean
|
|
63
|
+
trackMouse?: boolean
|
|
64
|
+
trackClicks?: boolean
|
|
65
|
+
trackScroll?: boolean
|
|
66
|
+
samplingRate?: number
|
|
67
|
+
honorDnt?: boolean
|
|
68
|
+
endpoint?: string
|
|
69
|
+
batchSize?: number
|
|
70
|
+
maxDataPoints?: number
|
|
71
|
+
sessionTimeout?: number
|
|
72
|
+
persistData?: boolean
|
|
73
|
+
storagePrefix?: string
|
|
74
|
+
captureAttributes?: string[]
|
|
75
|
+
ignoreSelectors?: string[]
|
|
76
|
+
zones?: HeatmapZone[]
|
|
77
|
+
debugOverlay?: boolean
|
|
78
|
+
minViewportWidth?: number
|
|
79
|
+
maxViewportWidth?: number
|
|
73
80
|
}
|
|
74
81
|
/**
|
|
75
82
|
* Zone definition for grouped tracking
|
|
76
83
|
*/
|
|
77
|
-
export interface HeatmapZone {
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
selector: string;
|
|
82
|
-
/** Zone label for reports */
|
|
83
|
-
label?: string;
|
|
84
|
+
export declare interface HeatmapZone {
|
|
85
|
+
id: string
|
|
86
|
+
selector: string
|
|
87
|
+
label?: string
|
|
84
88
|
}
|
|
85
89
|
/**
|
|
86
90
|
* Heatmap data point
|
|
87
91
|
*/
|
|
88
|
-
export interface HeatmapDataPoint {
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
/** Element selector (for clicks) */
|
|
98
|
-
el?: string;
|
|
99
|
-
/** Zone ID if within a defined zone */
|
|
100
|
-
zone?: string;
|
|
101
|
-
/** Scroll depth percentage (for scroll events) */
|
|
102
|
-
depth?: number;
|
|
103
|
-
/** Custom attributes captured */
|
|
104
|
-
attrs?: Record<string, string>;
|
|
92
|
+
export declare interface HeatmapDataPoint {
|
|
93
|
+
x: number
|
|
94
|
+
y: number
|
|
95
|
+
type: 'move' | 'click' | 'scroll'
|
|
96
|
+
t: number
|
|
97
|
+
el?: string
|
|
98
|
+
zone?: string
|
|
99
|
+
depth?: number
|
|
100
|
+
attrs?: Record<string, string>
|
|
105
101
|
}
|
|
106
102
|
/**
|
|
107
103
|
* Heatmap session data
|
|
108
104
|
*/
|
|
109
|
-
export interface HeatmapSession {
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
vh: number;
|
|
118
|
-
/** Data points */
|
|
119
|
-
points: HeatmapDataPoint[];
|
|
120
|
-
/** Session start time */
|
|
121
|
-
started: number;
|
|
122
|
-
/** Last activity time */
|
|
123
|
-
lastActivity: number;
|
|
105
|
+
export declare interface HeatmapSession {
|
|
106
|
+
sid: string
|
|
107
|
+
page: string
|
|
108
|
+
vw: number
|
|
109
|
+
vh: number
|
|
110
|
+
points: HeatmapDataPoint[]
|
|
111
|
+
started: number
|
|
112
|
+
lastActivity: number
|
|
124
113
|
}
|
|
125
|
-
/**
|
|
126
|
-
* Default heatmap configuration
|
|
127
|
-
*/
|
|
128
|
-
export declare const defaultHeatmapConfig: HeatmapConfig;
|
|
129
|
-
/**
|
|
130
|
-
* Generate heatmap tracking script based on configuration
|
|
131
|
-
*/
|
|
132
|
-
export declare function generateHeatmapScript(options: StxOptions): string;
|
|
133
|
-
/**
|
|
134
|
-
* Inject heatmap script into HTML
|
|
135
|
-
* Scripts are injected just before </body> for optimal loading
|
|
136
|
-
*/
|
|
137
|
-
export declare function injectHeatmap(html: string, options: StxOptions): string;
|
|
138
|
-
/**
|
|
139
|
-
* Custom @heatmap directive for explicit placement
|
|
140
|
-
*/
|
|
141
|
-
export declare const heatmapDirective: CustomDirective;
|
|
142
114
|
/**
|
|
143
115
|
* Server-side heatmap data aggregator
|
|
144
116
|
* For processing collected heatmap data into visualizations
|
|
145
117
|
*/
|
|
146
118
|
export declare class HeatmapAggregator {
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
*/
|
|
159
|
-
getClickData(page: string): HeatmapDataPoint[];
|
|
160
|
-
/**
|
|
161
|
-
* Get movement heatmap data
|
|
162
|
-
*/
|
|
163
|
-
getMovementData(page: string): HeatmapDataPoint[];
|
|
164
|
-
/**
|
|
165
|
-
* Get scroll depth data
|
|
166
|
-
*/
|
|
167
|
-
getScrollData(page: string): {
|
|
168
|
-
depth: number;
|
|
169
|
-
count: number;
|
|
170
|
-
}[];
|
|
171
|
-
/**
|
|
172
|
-
* Get zone interaction statistics
|
|
173
|
-
*/
|
|
174
|
-
getZoneStats(page: string): Map<string, {
|
|
175
|
-
clicks: number;
|
|
176
|
-
hovers: number;
|
|
177
|
-
}>;
|
|
178
|
-
/**
|
|
179
|
-
* Generate heatmap grid data (for server-side rendering)
|
|
180
|
-
*/
|
|
181
|
-
generateGridData(page: string, gridSize?: number): {
|
|
182
|
-
x: number;
|
|
183
|
-
y: number;
|
|
184
|
-
intensity: number;
|
|
185
|
-
}[][];
|
|
186
|
-
/**
|
|
187
|
-
* Export all data as JSON
|
|
188
|
-
*/
|
|
189
|
-
exportJSON(): string;
|
|
190
|
-
/**
|
|
191
|
-
* Clear all data
|
|
192
|
-
*/
|
|
193
|
-
clear(): void;
|
|
194
|
-
/**
|
|
195
|
-
* Get session count
|
|
196
|
-
*/
|
|
197
|
-
get sessionCount(): number;
|
|
198
|
-
/**
|
|
199
|
-
* Get total data points
|
|
200
|
-
*/
|
|
201
|
-
get totalPoints(): number;
|
|
119
|
+
addSession(data: HeatmapSession): void;
|
|
120
|
+
getPageData(page: string): HeatmapDataPoint[];
|
|
121
|
+
getClickData(page: string): HeatmapDataPoint[];
|
|
122
|
+
getMovementData(page: string): HeatmapDataPoint[];
|
|
123
|
+
getScrollData(page: string): { depth: number, count: number }[];
|
|
124
|
+
getZoneStats(page: string): Map<string, { clicks: number, hovers: number }>;
|
|
125
|
+
generateGridData(page: string, gridSize?: number): { x: number, y: number, intensity: number }[][];
|
|
126
|
+
exportJSON(): string;
|
|
127
|
+
clear(): void;
|
|
128
|
+
get sessionCount(): number;
|
|
129
|
+
get totalPoints(): number;
|
|
202
130
|
}
|
|
203
|
-
/**
|
|
204
|
-
* Create a heatmap aggregator instance
|
|
205
|
-
*/
|
|
206
|
-
export declare function createHeatmapAggregator(): HeatmapAggregator;
|