@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/errors/logger.d.ts
CHANGED
|
@@ -1,135 +1,61 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
* @module errors/logger
|
|
7
|
-
*/
|
|
1
|
+
import { isDevelopment } from '../env';
|
|
2
|
+
export declare const errorRecovery: ErrorRecovery;
|
|
3
|
+
// Global error logger instance
|
|
4
|
+
export declare const errorLogger: ErrorLogger;
|
|
5
|
+
export declare const devHelpers: DevHelpers;
|
|
8
6
|
/**
|
|
9
7
|
* Error recovery strategies
|
|
10
8
|
*
|
|
11
9
|
* NOTE: Auto-recovery is opt-in via configuration.
|
|
12
10
|
* Use configureErrorHandling({ enableAutoRecovery: true }) to enable.
|
|
13
11
|
*/
|
|
14
|
-
export interface ErrorRecovery {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
fixes: string[];
|
|
19
|
-
};
|
|
20
|
-
createFallbackContent(sectionType: string, error: Error): string;
|
|
12
|
+
export declare interface ErrorRecovery {
|
|
13
|
+
isEnabled(): boolean
|
|
14
|
+
fixCommonSyntaxErrors(template: string): { fixed: string, fixes: string[] }
|
|
15
|
+
createFallbackContent(sectionType: string, error: Error): string
|
|
21
16
|
}
|
|
22
|
-
export declare const errorRecovery: ErrorRecovery;
|
|
23
17
|
/**
|
|
24
18
|
* Error logger configuration options
|
|
25
19
|
*/
|
|
26
|
-
export interface ErrorLoggerOptions {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
logFormat?: 'json' | 'text';
|
|
35
|
-
/** Maximum log file size in bytes before rotation (default: 10MB) */
|
|
36
|
-
maxFileSize?: number;
|
|
37
|
-
/** Number of rotated log files to keep (default: 5) */
|
|
38
|
-
maxLogFiles?: number;
|
|
39
|
-
/** Minimum error level to log to file: 'all', 'error', 'warning' (default: 'all') */
|
|
40
|
-
minLevel?: 'all' | 'error' | 'warning';
|
|
20
|
+
export declare interface ErrorLoggerOptions {
|
|
21
|
+
maxErrors?: number
|
|
22
|
+
enableFileLogging?: boolean
|
|
23
|
+
logFilePath?: string
|
|
24
|
+
logFormat?: 'json' | 'text'
|
|
25
|
+
maxFileSize?: number
|
|
26
|
+
maxLogFiles?: number
|
|
27
|
+
minLevel?: 'all' | 'error' | 'warning'
|
|
41
28
|
}
|
|
42
29
|
/**
|
|
43
30
|
* Error log entry structure
|
|
44
31
|
*/
|
|
45
|
-
export interface ErrorLogEntry {
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
32
|
+
export declare interface ErrorLogEntry {
|
|
33
|
+
timestamp: Date
|
|
34
|
+
error: Error
|
|
35
|
+
context?: unknown
|
|
36
|
+
level?: 'error' | 'warning' | 'info'
|
|
50
37
|
}
|
|
51
38
|
/**
|
|
52
|
-
*
|
|
39
|
+
* Development mode helpers
|
|
53
40
|
*/
|
|
54
|
-
export declare
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
private logFilePath;
|
|
59
|
-
private logFormat;
|
|
60
|
-
private maxFileSize;
|
|
61
|
-
private maxLogFiles;
|
|
62
|
-
private minLevel;
|
|
63
|
-
private writeQueue;
|
|
64
|
-
constructor(options?: ErrorLoggerOptions);
|
|
65
|
-
/**
|
|
66
|
-
* Configure the error logger
|
|
67
|
-
*/
|
|
68
|
-
configure(options: ErrorLoggerOptions): void;
|
|
69
|
-
/**
|
|
70
|
-
* Log an error with optional context
|
|
71
|
-
*/
|
|
72
|
-
log(error: Error, context?: unknown, level?: 'error' | 'warning' | 'info'): void;
|
|
73
|
-
/**
|
|
74
|
-
* Check if error level should be logged based on minLevel setting
|
|
75
|
-
*/
|
|
76
|
-
private shouldLog;
|
|
77
|
-
/**
|
|
78
|
-
* Format an error entry for logging
|
|
79
|
-
*/
|
|
80
|
-
private formatEntry;
|
|
81
|
-
/**
|
|
82
|
-
* Write error entry to file (async, non-blocking)
|
|
83
|
-
*/
|
|
84
|
-
private writeToFile;
|
|
85
|
-
/**
|
|
86
|
-
* Rotate log files if current file exceeds max size
|
|
87
|
-
*/
|
|
88
|
-
private rotateIfNeeded;
|
|
89
|
-
/**
|
|
90
|
-
* Get recent errors from memory
|
|
91
|
-
*/
|
|
92
|
-
getRecentErrors(limit?: number): ErrorLogEntry[];
|
|
93
|
-
/**
|
|
94
|
-
* Get errors filtered by type
|
|
95
|
-
*/
|
|
96
|
-
getErrorsByType(errorType: string): ErrorLogEntry[];
|
|
97
|
-
/**
|
|
98
|
-
* Get errors filtered by level
|
|
99
|
-
*/
|
|
100
|
-
getErrorsByLevel(level: 'error' | 'warning' | 'info'): ErrorLogEntry[];
|
|
101
|
-
/**
|
|
102
|
-
* Clear all errors from memory
|
|
103
|
-
*/
|
|
104
|
-
clear(): void;
|
|
105
|
-
/**
|
|
106
|
-
* Clear log file
|
|
107
|
-
*/
|
|
108
|
-
clearLogFile(): Promise<void>;
|
|
109
|
-
/**
|
|
110
|
-
* Get error statistics
|
|
111
|
-
*/
|
|
112
|
-
getStats(): {
|
|
113
|
-
total: number;
|
|
114
|
-
byType: Record<string, number>;
|
|
115
|
-
byLevel: Record<string, number>;
|
|
116
|
-
};
|
|
117
|
-
/**
|
|
118
|
-
* Export errors to a file (for debugging/reporting)
|
|
119
|
-
*/
|
|
120
|
-
exportToFile(filePath: string, format?: 'json' | 'text'): Promise<void>;
|
|
121
|
-
/**
|
|
122
|
-
* Wait for all pending writes to complete
|
|
123
|
-
*/
|
|
124
|
-
flush(): Promise<void>;
|
|
41
|
+
export declare interface DevHelpers {
|
|
42
|
+
isDevelopment(): boolean
|
|
43
|
+
logDetailedError(error: Error, context?: unknown): void
|
|
44
|
+
createErrorReport(error: Error, context?: unknown): string
|
|
125
45
|
}
|
|
126
|
-
export declare const errorLogger: ErrorLogger;
|
|
127
46
|
/**
|
|
128
|
-
*
|
|
47
|
+
* Error logging and monitoring with optional file persistence
|
|
129
48
|
*/
|
|
130
|
-
export
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
49
|
+
export declare class ErrorLogger {
|
|
50
|
+
constructor(options?: ErrorLoggerOptions);
|
|
51
|
+
configure(options: ErrorLoggerOptions): void;
|
|
52
|
+
log(error: Error, context?: unknown, level?: 'error' | 'warning' | 'info'): void;
|
|
53
|
+
getRecentErrors(limit?: number): ErrorLogEntry[];
|
|
54
|
+
getErrorsByType(errorType: string): ErrorLogEntry[];
|
|
55
|
+
getErrorsByLevel(level: 'error' | 'warning' | 'info'): ErrorLogEntry[];
|
|
56
|
+
clear(): void;
|
|
57
|
+
clearLogFile(): Promise<void>;
|
|
58
|
+
getStats(): { total: number, byType: Record<string, number>, byLevel: Record<string, number> };
|
|
59
|
+
exportToFile(filePath: string, format?: 'json' | 'text'): Promise<void>;
|
|
60
|
+
flush(): Promise<void>;
|
|
134
61
|
}
|
|
135
|
-
export declare const devHelpers: DevHelpers;
|
|
@@ -1,56 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
* Parameter and Content Sanitization
|
|
3
|
-
*
|
|
4
|
-
* Provides sanitization utilities for directive parameters, file paths,
|
|
5
|
-
* expressions, and component props.
|
|
6
|
-
*
|
|
7
|
-
* @module errors/sanitizer
|
|
8
|
-
*/
|
|
9
|
-
/**
|
|
10
|
-
* Options for parameter sanitization
|
|
11
|
-
*/
|
|
12
|
-
export interface SanitizeOptions {
|
|
13
|
-
/** Allow HTML in parameter values (default: false) */
|
|
14
|
-
allowHtml?: boolean;
|
|
15
|
-
/** Maximum length for string parameters (default: 10000) */
|
|
16
|
-
maxLength?: number;
|
|
17
|
-
/** Allow special characters (default: true for most, false for paths) */
|
|
18
|
-
allowSpecialChars?: boolean;
|
|
19
|
-
/** Custom sanitization function */
|
|
20
|
-
customSanitizer?: (value: string) => string;
|
|
21
|
-
}
|
|
22
|
-
/**
|
|
23
|
-
* Result of parameter sanitization
|
|
24
|
-
*/
|
|
25
|
-
export interface SanitizedParam {
|
|
26
|
-
/** Sanitized value */
|
|
27
|
-
value: string;
|
|
28
|
-
/** Whether the value was modified */
|
|
29
|
-
modified: boolean;
|
|
30
|
-
/** Warnings generated during sanitization */
|
|
31
|
-
warnings: string[];
|
|
32
|
-
}
|
|
33
|
-
/**
|
|
34
|
-
* Validation utilities
|
|
35
|
-
*/
|
|
36
|
-
export declare const validators: {
|
|
37
|
-
/**
|
|
38
|
-
* Validate file path is safe and doesn't escape the allowed directory
|
|
39
|
-
*/
|
|
40
|
-
isValidFilePath(filePath: string, allowedDir?: string): boolean;
|
|
41
|
-
/**
|
|
42
|
-
* Validate template variable name
|
|
43
|
-
*/
|
|
44
|
-
isValidVariableName(name: string): boolean;
|
|
45
|
-
/**
|
|
46
|
-
* Validate directive name
|
|
47
|
-
*/
|
|
48
|
-
isValidDirectiveName(name: string): boolean;
|
|
49
|
-
/**
|
|
50
|
-
* Check if string contains potentially malicious content
|
|
51
|
-
*/
|
|
52
|
-
isSafeContent(content: string): boolean;
|
|
53
|
-
};
|
|
1
|
+
import path from 'node:path';
|
|
54
2
|
/**
|
|
55
3
|
* Sanitize a directive parameter value
|
|
56
4
|
*/
|
|
@@ -71,3 +19,30 @@ export declare function sanitizeDirectiveParams(params: string[], options?: Sani
|
|
|
71
19
|
* Validate and sanitize component props
|
|
72
20
|
*/
|
|
73
21
|
export declare function sanitizeComponentProps(props: Record<string, unknown>): Record<string, unknown>;
|
|
22
|
+
/**
|
|
23
|
+
* Validation utilities
|
|
24
|
+
* @defaultValue `{ isValidFilePath: (filePath: string, allowedDir?: string) => boolean }`
|
|
25
|
+
*/
|
|
26
|
+
export declare const validators: {
|
|
27
|
+
/**
|
|
28
|
+
* Validate file path is safe and doesn't escape the allowed directory
|
|
29
|
+
*/
|
|
30
|
+
isValidFilePath: (filePath: string, allowedDir?: string) => boolean
|
|
31
|
+
};
|
|
32
|
+
/**
|
|
33
|
+
* Options for parameter sanitization
|
|
34
|
+
*/
|
|
35
|
+
export declare interface SanitizeOptions {
|
|
36
|
+
allowHtml?: boolean
|
|
37
|
+
maxLength?: number
|
|
38
|
+
allowSpecialChars?: boolean
|
|
39
|
+
customSanitizer?: (value: string) => string
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* Result of parameter sanitization
|
|
43
|
+
*/
|
|
44
|
+
export declare interface SanitizedParam {
|
|
45
|
+
value: string
|
|
46
|
+
modified: boolean
|
|
47
|
+
warnings: string[]
|
|
48
|
+
}
|
package/dist/errors/types.d.ts
CHANGED
|
@@ -1,24 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Error Types and Classes
|
|
3
|
-
*
|
|
4
|
-
* Custom error classes for better error classification and handling.
|
|
5
|
-
*
|
|
6
|
-
* @module errors/types
|
|
7
|
-
*/
|
|
8
1
|
import type { ErrorCode } from './codes';
|
|
9
|
-
/**
|
|
10
|
-
* Error handling configuration
|
|
11
|
-
*/
|
|
12
|
-
export interface ErrorConfig {
|
|
13
|
-
/** Show relative paths instead of absolute (default: false) */
|
|
14
|
-
showRelativePaths: boolean;
|
|
15
|
-
/** Base directory for relative path calculation */
|
|
16
|
-
baseDir?: string;
|
|
17
|
-
/** Enable auto-recovery for common syntax errors (default: false in production) */
|
|
18
|
-
enableAutoRecovery: boolean;
|
|
19
|
-
/** Log warnings when auto-recovery is applied */
|
|
20
|
-
logRecoveryWarnings: boolean;
|
|
21
|
-
}
|
|
22
2
|
/**
|
|
23
3
|
* Configure error handling behavior
|
|
24
4
|
*/
|
|
@@ -35,58 +15,65 @@ export declare function resetErrorConfig(): void;
|
|
|
35
15
|
* Format file path based on configuration
|
|
36
16
|
*/
|
|
37
17
|
export declare function formatFilePath(filePath: string): string;
|
|
18
|
+
/**
|
|
19
|
+
* Error handling configuration
|
|
20
|
+
*/
|
|
21
|
+
export declare interface ErrorConfig {
|
|
22
|
+
showRelativePaths: boolean
|
|
23
|
+
baseDir?: string
|
|
24
|
+
enableAutoRecovery: boolean
|
|
25
|
+
logRecoveryWarnings: boolean
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Error context information
|
|
29
|
+
*/
|
|
30
|
+
export declare interface ErrorContext {
|
|
31
|
+
filePath: string
|
|
32
|
+
template: string
|
|
33
|
+
offset: number
|
|
34
|
+
match: string
|
|
35
|
+
}
|
|
38
36
|
/**
|
|
39
37
|
* Base STX error class
|
|
40
38
|
*/
|
|
41
39
|
export declare class StxError extends Error {
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
constructor(message: string, code: string, filePath?: string | undefined, line?: number | undefined, column?: number | undefined, context?: string | undefined, numericCode?: ErrorCode);
|
|
40
|
+
numericCode: ErrorCode;
|
|
41
|
+
public code: string;
|
|
42
|
+
public filePath?: string;
|
|
43
|
+
public line?: number;
|
|
44
|
+
public column?: number;
|
|
45
|
+
public context?: string;
|
|
46
|
+
constructor(message: string, code: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
50
47
|
}
|
|
51
48
|
/**
|
|
52
49
|
* Syntax error in template
|
|
53
50
|
*/
|
|
54
51
|
export declare class StxSyntaxError extends StxError {
|
|
55
|
-
|
|
52
|
+
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
56
53
|
}
|
|
57
54
|
/**
|
|
58
55
|
* Runtime error during template processing
|
|
59
56
|
*/
|
|
60
57
|
export declare class StxRuntimeError extends StxError {
|
|
61
|
-
|
|
58
|
+
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
62
59
|
}
|
|
63
60
|
/**
|
|
64
61
|
* Security-related error
|
|
65
62
|
*/
|
|
66
63
|
export declare class StxSecurityError extends StxError {
|
|
67
|
-
|
|
64
|
+
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
68
65
|
}
|
|
69
66
|
/**
|
|
70
67
|
* File operation error
|
|
71
68
|
*/
|
|
72
69
|
export declare class StxFileError extends StxError {
|
|
73
|
-
|
|
70
|
+
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
74
71
|
}
|
|
75
72
|
/**
|
|
76
73
|
* Validation error - these are ALWAYS fatal and cannot be recovered from.
|
|
77
74
|
* Used for enforcing coding standards like prohibited DOM API usage.
|
|
78
75
|
*/
|
|
79
76
|
export declare class StxValidationError extends StxError {
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
83
|
-
}
|
|
84
|
-
/**
|
|
85
|
-
* Error context information
|
|
86
|
-
*/
|
|
87
|
-
export interface ErrorContext {
|
|
88
|
-
filePath: string;
|
|
89
|
-
template: string;
|
|
90
|
-
offset: number;
|
|
91
|
-
match: string;
|
|
77
|
+
readonly isFatal: boolean;
|
|
78
|
+
constructor(message: string, filePath?: string, line?: number, column?: number, context?: string, numericCode?: ErrorCode);
|
|
92
79
|
}
|
package/dist/events.d.ts
CHANGED
|
@@ -1,95 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Event Directives Module
|
|
3
|
-
*
|
|
4
|
-
* Provides Alpine.js-style event handling for STX templates.
|
|
5
|
-
* Transforms `@click`, `@keydown.enter`, etc. into client-side event listeners.
|
|
6
|
-
*
|
|
7
|
-
* ## Supported Syntax
|
|
8
|
-
*
|
|
9
|
-
* ### Basic Events
|
|
10
|
-
* ```html
|
|
11
|
-
* <button @click="count++">Increment</button>
|
|
12
|
-
* <button @click="handleClick()">Click me</button>
|
|
13
|
-
* <form @submit="handleSubmit()">...</form>
|
|
14
|
-
* ```
|
|
15
|
-
*
|
|
16
|
-
* ### Event Modifiers
|
|
17
|
-
* ```html
|
|
18
|
-
* <form @submit.prevent="handleSubmit()">...</form>
|
|
19
|
-
* <a @click.prevent.stop="navigate()">Link</a>
|
|
20
|
-
* <button @click.once="initialize()">Init</button>
|
|
21
|
-
* <div @click.self="onlyThis()">...</div>
|
|
22
|
-
* <input @keydown.capture="log()">
|
|
23
|
-
* ```
|
|
24
|
-
*
|
|
25
|
-
* ### Key Modifiers
|
|
26
|
-
* ```html
|
|
27
|
-
* <input @keydown.enter="submit()">
|
|
28
|
-
* <input @keyup.escape="cancel()">
|
|
29
|
-
* <input @keydown.space="toggle()">
|
|
30
|
-
* <input @keydown.ctrl.s="save()">
|
|
31
|
-
* <input @keydown.meta.enter="send()">
|
|
32
|
-
* ```
|
|
33
|
-
*
|
|
34
|
-
* ### Mouse Modifiers
|
|
35
|
-
* ```html
|
|
36
|
-
* <div @click.left="handleLeft()">
|
|
37
|
-
* <div @click.right="handleRight()">
|
|
38
|
-
* <div @click.middle="handleMiddle()">
|
|
39
|
-
* ```
|
|
40
|
-
*
|
|
41
|
-
* ### Special Variables
|
|
42
|
-
* ```html
|
|
43
|
-
* <input @input="value = $event.target.value">
|
|
44
|
-
* <button @click="handleClick($el)">Uses element</button>
|
|
45
|
-
* ```
|
|
46
|
-
*
|
|
47
|
-
* @module events
|
|
48
|
-
*/
|
|
49
|
-
export interface ParsedEvent {
|
|
50
|
-
/** Original attribute string (e.g., "@click.prevent") */
|
|
51
|
-
attribute: string;
|
|
52
|
-
/** Event name (e.g., "click", "keydown") */
|
|
53
|
-
event: string;
|
|
54
|
-
/** Handler expression (e.g., "count++", "handleClick()") */
|
|
55
|
-
handler: string;
|
|
56
|
-
/** Event modifiers */
|
|
57
|
-
modifiers: EventModifiers;
|
|
58
|
-
/** Unique element ID for binding */
|
|
59
|
-
elementId: string;
|
|
60
|
-
}
|
|
61
|
-
export interface EventModifiers {
|
|
62
|
-
/** Call preventDefault() */
|
|
63
|
-
prevent: boolean;
|
|
64
|
-
/** Call stopPropagation() */
|
|
65
|
-
stop: boolean;
|
|
66
|
-
/** Only fire once */
|
|
67
|
-
once: boolean;
|
|
68
|
-
/** Use capture mode */
|
|
69
|
-
capture: boolean;
|
|
70
|
-
/** Only fire if event.target === element */
|
|
71
|
-
self: boolean;
|
|
72
|
-
/** Passive event listener */
|
|
73
|
-
passive: boolean;
|
|
74
|
-
/** Not passive, for a scroll-blocking event whose handler calls preventDefault() itself */
|
|
75
|
-
nonpassive: boolean;
|
|
76
|
-
/** Key modifiers (enter, escape, space, etc.) */
|
|
77
|
-
keys: string[];
|
|
78
|
-
/** System modifiers (ctrl, alt, shift, meta) */
|
|
79
|
-
systemKeys: string[];
|
|
80
|
-
/** Mouse button (left, right, middle) */
|
|
81
|
-
mouse: string | null;
|
|
82
|
-
/** Debounce delay in ms */
|
|
83
|
-
debounce: number | null;
|
|
84
|
-
/** Throttle delay in ms */
|
|
85
|
-
throttle: number | null;
|
|
86
|
-
}
|
|
87
|
-
/**
|
|
88
|
-
* Events the browser waits on before it scrolls. A listener for one that is not
|
|
89
|
-
* passive holds every scroll starting on its element until the main thread has
|
|
90
|
-
* run it, which on a phone is a visible stall at the start of the gesture.
|
|
91
|
-
*/
|
|
92
|
-
export declare const SCROLL_BLOCKING_EVENTS: ReadonlySet<string>;
|
|
93
1
|
/**
|
|
94
2
|
* Whether a directive's listener is passive. `.passive` always is; a
|
|
95
3
|
* scroll-blocking event is by default, unless `.prevent` needs preventDefault()
|
|
@@ -134,11 +42,41 @@ export declare function generateRuntimeScript(events: ParsedEvent[]): string;
|
|
|
134
42
|
* @returns Object with processed template and collected bindings
|
|
135
43
|
*/
|
|
136
44
|
export declare function extractAndProcessEvents(template: string, namespace?: string): {
|
|
137
|
-
|
|
138
|
-
|
|
45
|
+
template: string
|
|
46
|
+
bindings: ParsedEvent[]
|
|
139
47
|
};
|
|
140
48
|
export declare function processEventDirectives(template: string, context: Record<string, unknown>, _filePath: string): string;
|
|
141
49
|
/**
|
|
142
50
|
* Check if a template contains event directives
|
|
143
51
|
*/
|
|
144
52
|
export declare function hasEventDirectives(template: string): boolean;
|
|
53
|
+
/**
|
|
54
|
+
* Events the browser waits on before it scrolls. A listener for one that is not
|
|
55
|
+
* passive holds every scroll starting on its element until the main thread has
|
|
56
|
+
* run it, which on a phone is a visible stall at the start of the gesture.
|
|
57
|
+
*/
|
|
58
|
+
export declare const SCROLL_BLOCKING_EVENTS: ReadonlySet<string>;
|
|
59
|
+
// =============================================================================
|
|
60
|
+
// Types
|
|
61
|
+
// =============================================================================
|
|
62
|
+
export declare interface ParsedEvent {
|
|
63
|
+
attribute: string
|
|
64
|
+
event: string
|
|
65
|
+
handler: string
|
|
66
|
+
modifiers: EventModifiers
|
|
67
|
+
elementId: string
|
|
68
|
+
}
|
|
69
|
+
export declare interface EventModifiers {
|
|
70
|
+
prevent: boolean
|
|
71
|
+
stop: boolean
|
|
72
|
+
once: boolean
|
|
73
|
+
capture: boolean
|
|
74
|
+
self: boolean
|
|
75
|
+
passive: boolean
|
|
76
|
+
nonpassive: boolean
|
|
77
|
+
keys: string[]
|
|
78
|
+
systemKeys: string[]
|
|
79
|
+
mouse: string | null
|
|
80
|
+
debounce: number | null
|
|
81
|
+
throttle: number | null
|
|
82
|
+
}
|
package/dist/expressions.d.ts
CHANGED
|
@@ -1,41 +1,4 @@
|
|
|
1
|
-
|
|
2
|
-
* Module for processing template expressions and filters
|
|
3
|
-
*
|
|
4
|
-
* Expression Syntax:
|
|
5
|
-
* ==================
|
|
6
|
-
* - `{{ expression }}` - Escaped output (HTML entities escaped)
|
|
7
|
-
* - `{!! expression !!}` - Raw/unescaped output
|
|
8
|
-
* - `{{ expression | filter }}` - Apply filter to expression
|
|
9
|
-
* - `{{ expression | filter:arg1,arg2 }}` - Filter with arguments
|
|
10
|
-
* - `{{ expression | filter1 | filter2 }}` - Filter chain
|
|
11
|
-
*
|
|
12
|
-
* Filter Parsing:
|
|
13
|
-
* ===============
|
|
14
|
-
* The filter parser uses character-by-character parsing to handle:
|
|
15
|
-
* - Pipe `|` as filter separator (but not `||` logical OR)
|
|
16
|
-
* - Colon `:` as argument separator
|
|
17
|
-
* - Quoted strings with proper escape handling
|
|
18
|
-
* - Nested parentheses in expressions
|
|
19
|
-
*
|
|
20
|
-
* Key parsing rules:
|
|
21
|
-
* - `||` (double pipe) is preserved as logical OR, not filter separator
|
|
22
|
-
* - Arguments after `:` are split by `,` respecting quotes and parens
|
|
23
|
-
* - Filter names must be alphanumeric with underscores
|
|
24
|
-
*
|
|
25
|
-
* Available Built-in Filters:
|
|
26
|
-
* ===========================
|
|
27
|
-
* String: uppercase, lowercase, capitalize, truncate, replace, stripTags
|
|
28
|
-
* Number: number, currency, abs, round
|
|
29
|
-
* Array: join, first, last, length, reverse, slice
|
|
30
|
-
* Utility: escape, json, default, urlencode
|
|
31
|
-
* i18n: translate, pluralize, date
|
|
32
|
-
*/
|
|
33
|
-
/**
|
|
34
|
-
* Add basic filter support to expressions
|
|
35
|
-
* Filter functions receive the value to transform, optional args, and the context object
|
|
36
|
-
*/
|
|
37
|
-
export type FilterFunction = (value: any, context: Record<string, any>, ...args: any[]) => any;
|
|
38
|
-
export declare const defaultFilters: Record<string, FilterFunction>;
|
|
1
|
+
declare function getTranslateRegex(key: string): RegExp;
|
|
39
2
|
/**
|
|
40
3
|
* Register a custom filter
|
|
41
4
|
*
|
|
@@ -173,11 +136,7 @@ export declare function usesSignalsInScript(template: string, filePath?: string)
|
|
|
173
136
|
* the server as the request's Host header - a string, so `.key` was undefined
|
|
174
137
|
* and the row rendered empty - and the client never saw the mustache.
|
|
175
138
|
*/
|
|
176
|
-
export declare function clientLoopScopes(html: string): Array<{
|
|
177
|
-
start: number;
|
|
178
|
-
end: number;
|
|
179
|
-
names: Set<string>;
|
|
180
|
-
}>;
|
|
139
|
+
export declare function clientLoopScopes(html: string): Array<{ start: number, end: number, names: Set<string> }>;
|
|
181
140
|
export declare function interpolateScriptExpressions(scriptBody: string, context: Record<string, any>, filePath?: string): string;
|
|
182
141
|
/**
|
|
183
142
|
* Interpolate expressions in a `<script>` tag's ATTRIBUTES.
|
|
@@ -197,18 +156,6 @@ export declare function interpolateScriptExpressions(scriptBody: string, context
|
|
|
197
156
|
* client" semantics used everywhere else.
|
|
198
157
|
*/
|
|
199
158
|
export declare function interpolateScriptAttributes(attrs: string, context: Record<string, any>): string;
|
|
200
|
-
/**
|
|
201
|
-
* Options for {@link interpolateScriptsInTemplate}.
|
|
202
|
-
*/
|
|
203
|
-
export interface InterpolateScriptsOptions {
|
|
204
|
-
/**
|
|
205
|
-
* Skip `<script server>` tags. Useful when the template still contains
|
|
206
|
-
* unstripped server scripts (e.g. inside `processDirectives`) whose bodies
|
|
207
|
-
* are executed rather than embedded — running `{{ }}` substitution on
|
|
208
|
-
* them would produce invalid JS. Default: `false`.
|
|
209
|
-
*/
|
|
210
|
-
skipServer?: boolean;
|
|
211
|
-
}
|
|
212
159
|
/**
|
|
213
160
|
* Interpolate server expressions inside every `<script>` tag in a template,
|
|
214
161
|
* skipping any script that opts out via `data-raw`, `type="application/json"`,
|
|
@@ -227,13 +174,6 @@ export declare function processExpressions(template: string, context: Record<str
|
|
|
227
174
|
* Apply filters to a value
|
|
228
175
|
*/
|
|
229
176
|
export declare function applyFilters(value: any, filterExpression: string, context: Record<string, any>): any;
|
|
230
|
-
/**
|
|
231
|
-
* An expression the safe evaluator refused to run, and the rule that refused it.
|
|
232
|
-
*/
|
|
233
|
-
export interface ExpressionRejection {
|
|
234
|
-
expression: string;
|
|
235
|
-
rule: string;
|
|
236
|
-
}
|
|
237
177
|
/** Forget which rejections were reported. For tests. */
|
|
238
178
|
export declare function resetRejectedExpressionWarnings(): void;
|
|
239
179
|
/**
|
|
@@ -248,3 +188,58 @@ export declare function evaluateExpression(expression: string, context: Record<s
|
|
|
248
188
|
* HTML unescape function to reverse escapeHtml
|
|
249
189
|
*/
|
|
250
190
|
export declare function unescapeHtml(html: string): string;
|
|
191
|
+
/**
|
|
192
|
+
* =============================================================================
|
|
193
|
+
// Built-in Filters
|
|
194
|
+
// =============================================================================
|
|
195
|
+
* @defaultValue
|
|
196
|
+
* ```ts
|
|
197
|
+
* {
|
|
198
|
+
* uppercase: (value: any, _context: Record<string, any>) => unknown | string,
|
|
199
|
+
* lowercase: (value: any, _context: Record<string, any>) => unknown | string,
|
|
200
|
+
* capitalize: (value: any, _context: Record<string, any>) => unknown,
|
|
201
|
+
* number: (value: any, _context: Record<string, any>, decimals?: number) => unknown,
|
|
202
|
+
* fmt: (value: any, _context: Record<string, any>, locale?: string) => unknown,
|
|
203
|
+
* join: (value: any, _context: Record<string, any>, separator?: string) => string | ReturnType<any.join>,
|
|
204
|
+
* escape: (value: any, _context: Record<string, any>) => string | ReturnType<unknown>,
|
|
205
|
+
* translate: (value: any, context: Record<string, any>, params?: Record<string, any>) => unknown,
|
|
206
|
+
* t: (value: any, context: Record<string, any>, params?: Record<string, any>) => unknown,
|
|
207
|
+
* truncate: (value: any, _context: Record<string, any>, length?: number, suffix?: string) => unknown,
|
|
208
|
+
* date: (value: any, _context: Record<string, any>, format?: string, locale?: string) => unknown,
|
|
209
|
+
* currency: (value: any, _context: Record<string, any>, currencyCode?: string, locale?: string) => unknown,
|
|
210
|
+
* pluralize: (value: any, _context: Record<string, any>, singular: string, plural?: string) => unknown,
|
|
211
|
+
* first: (value: any, _context: Record<string, any>) => unknown,
|
|
212
|
+
* last: (value: any, _context: Record<string, any>) => unknown,
|
|
213
|
+
* length: (value: any, _context: Record<string, any>) => unknown,
|
|
214
|
+
* json: (value: any, _context: Record<string, any>, pretty?: boolean) => unknown,
|
|
215
|
+
* default: (value: any, _context: Record<string, any>, defaultValue?: any) => any,
|
|
216
|
+
* reverse: (value: any, _context: Record<string, any>) => unknown,
|
|
217
|
+
* slice: (value: any, _context: Record<string, any>, start?: number, end?: number) => unknown,
|
|
218
|
+
* replace: (value: any, _context: Record<string, any>, search: string, replacement?: string) => unknown,
|
|
219
|
+
* stripTags: (value: any, _context: Record<string, any>) => unknown,
|
|
220
|
+
* urlencode: (value: any, _context: Record<string, any>) => string | ReturnType<unknown>,
|
|
221
|
+
* abs: (value: any, _context: Record<string, any>) => number | ReturnType<unknown.abs>,
|
|
222
|
+
* round: (value: any, _context: Record<string, any>, decimals?: number) => unknown
|
|
223
|
+
* }
|
|
224
|
+
* ```
|
|
225
|
+
*/
|
|
226
|
+
export declare const defaultFilters: Record<string, FilterFunction>;
|
|
227
|
+
/**
|
|
228
|
+
* Options for {@link interpolateScriptsInTemplate}.
|
|
229
|
+
*/
|
|
230
|
+
export declare interface InterpolateScriptsOptions {
|
|
231
|
+
skipServer?: boolean
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* An expression the safe evaluator refused to run, and the rule that refused it.
|
|
235
|
+
*/
|
|
236
|
+
export declare interface ExpressionRejection {
|
|
237
|
+
expression: string
|
|
238
|
+
rule: string
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* Add basic filter support to expressions
|
|
242
|
+
* Filter functions receive the value to transform, optional args, and the context object
|
|
243
|
+
*/
|
|
244
|
+
// eslint-disable-next-line pickier/no-unused-vars
|
|
245
|
+
export type FilterFunction = (value: any, context: Record<string, any>, ...args: any[]) => any;
|