@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/document-shell.d.ts
CHANGED
|
@@ -1,45 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Document Shell Generator
|
|
3
|
-
*
|
|
4
|
-
* Auto-generates the HTML document wrapper around page content.
|
|
5
|
-
* No .stx file needs to write <!DOCTYPE>, <html>, <head>, or <body>.
|
|
6
|
-
* The shell is configured via stx.config.ts `app.head` and enhanced
|
|
7
|
-
* at build/serve time with runtime scripts, CSS, and meta tags.
|
|
8
|
-
*
|
|
9
|
-
* @module document-shell
|
|
10
|
-
*/
|
|
11
|
-
import type { ColorModeBootConfig } from './color-mode-boot';
|
|
12
1
|
import type { AppHeadConfig } from './types/config-types';
|
|
13
|
-
|
|
14
|
-
* Inline x-cloak rule shipped in the SSR <head> (stacksjs/stx#1736).
|
|
15
|
-
*
|
|
16
|
-
* Must be parsed by the browser BEFORE first paint — so it goes in the head
|
|
17
|
-
* as static markup, not injected by the runtime script (which runs after the
|
|
18
|
-
* body has already painted, the window where false `:if` branches / hidden
|
|
19
|
-
* `:show` elements flash). The `data-stx-cloak` marker makes injection
|
|
20
|
-
* idempotent. The runtime's own late injection (signals.ts) is retained as a
|
|
21
|
-
* belt-and-suspenders for SPA-nav fragments that arrive without SSR head
|
|
22
|
-
* emission.
|
|
23
|
-
*/
|
|
24
|
-
export declare const CLOAK_STYLE = "<style data-stx-cloak>[x-cloak]{display:none !important}</style>";
|
|
25
|
-
/**
|
|
26
|
-
* Markers recording which `<html>` attributes stx itself wrote from `htmlAttrs`
|
|
27
|
-
* (stacksjs/stx#1798).
|
|
28
|
-
*
|
|
29
|
-
* The router needs them to reconcile the root element across an SPA layout
|
|
30
|
-
* change. It cannot just diff `<html>` against the incoming document: by then
|
|
31
|
-
* the color-mode boot script has added its own `dark` class / `data-theme`, and
|
|
32
|
-
* `animation.ts` has added `data-reduced-motion`, none of which exist in the
|
|
33
|
-
* server response — a blind diff would strip them on every navigation and
|
|
34
|
-
* flash the wrong theme. These say exactly what stx put there, so the router
|
|
35
|
-
* can remove precisely that much and leave runtime state alone.
|
|
36
|
-
*
|
|
37
|
-
* `class` is tracked separately because it is the one attribute that gets
|
|
38
|
-
* *merged* into at runtime, so it has to be reconciled token-by-token rather
|
|
39
|
-
* than replaced wholesale.
|
|
40
|
-
*/
|
|
41
|
-
export declare const HTML_ATTRS_MARKER = "data-stx-html-attrs";
|
|
42
|
-
export declare const HTML_CLASS_MARKER = "data-stx-html-class";
|
|
2
|
+
import type { ColorModeBootConfig } from './color-mode-boot';
|
|
43
3
|
/** Emit `k="v"` pairs with every value attribute-escaped. */
|
|
44
4
|
/**
|
|
45
5
|
* The identity of a `<meta>` tag, for deduplication.
|
|
@@ -61,10 +21,7 @@ export declare function metaDedupKey(m: Record<string, string>): string;
|
|
|
61
21
|
* and open markup of its own. JavaScript is left alone: `<\/` is only
|
|
62
22
|
* equivalent inside a string literal.
|
|
63
23
|
*/
|
|
64
|
-
export declare function inlineScriptContent(s: {
|
|
65
|
-
content?: unknown;
|
|
66
|
-
type?: unknown;
|
|
67
|
-
}): string;
|
|
24
|
+
export declare function inlineScriptContent(s: { content?: unknown, type?: unknown }): string;
|
|
68
25
|
/**
|
|
69
26
|
* Build the attribute string for the shell's `<html>` open tag.
|
|
70
27
|
*
|
|
@@ -135,10 +92,7 @@ export declare function cloakStyleFragment(html: string): string | null;
|
|
|
135
92
|
* comments and `<script>` blocks are stepped over, never moved), so a `<style>`
|
|
136
93
|
* sitting next to the markup it styles further down the page is left alone.
|
|
137
94
|
*/
|
|
138
|
-
export declare function hoistLeadingHeadTags(content: string): {
|
|
139
|
-
body: string;
|
|
140
|
-
hoisted: string[];
|
|
141
|
-
};
|
|
95
|
+
export declare function hoistLeadingHeadTags(content: string): { body: string, hoisted: string[] };
|
|
142
96
|
/**
|
|
143
97
|
* Generate the full HTML document shell wrapping page content.
|
|
144
98
|
*
|
|
@@ -148,38 +102,22 @@ export declare function hoistLeadingHeadTags(content: string): {
|
|
|
148
102
|
* @returns Complete HTML document
|
|
149
103
|
*/
|
|
150
104
|
export declare function generateDocumentShell(content: string, headConfig?: AppHeadConfig, options?: {
|
|
151
|
-
|
|
152
|
-
title?: string
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
styles?: string[];
|
|
168
|
-
/** Extra scripts to inject before </body> (e.g. signals runtime, router) */
|
|
169
|
-
bodyScripts?: string[];
|
|
170
|
-
/** Extra scripts/tags for <head> */
|
|
171
|
-
headScripts?: string[];
|
|
172
|
-
/** Stacks to inject (from @push directives) */
|
|
173
|
-
headStack?: string;
|
|
174
|
-
bodyStack?: string;
|
|
175
|
-
/**
|
|
176
|
-
* Pre-paint color-mode config (stacksjs/stx#1794). When present, the boot
|
|
177
|
-
* script is emitted at the very top of <head> — above the stylesheets,
|
|
178
|
-
* because a stylesheet link ahead of it would block its execution and
|
|
179
|
-
* delay the one thing it exists to do early.
|
|
180
|
-
*/
|
|
181
|
-
colorMode?: ColorModeBootConfig;
|
|
182
|
-
}): string;
|
|
105
|
+
|
|
106
|
+
title?: string
|
|
107
|
+
|
|
108
|
+
titleIsHtml?: boolean
|
|
109
|
+
|
|
110
|
+
styles?: string[]
|
|
111
|
+
|
|
112
|
+
bodyScripts?: string[]
|
|
113
|
+
|
|
114
|
+
headScripts?: string[]
|
|
115
|
+
|
|
116
|
+
headStack?: string
|
|
117
|
+
bodyStack?: string
|
|
118
|
+
|
|
119
|
+
colorMode?: ColorModeBootConfig
|
|
120
|
+
}): string;
|
|
183
121
|
export declare function startsDocument(html: string): boolean;
|
|
184
122
|
/**
|
|
185
123
|
* Does this output already carry a document wrapper?
|
|
@@ -227,3 +165,33 @@ export declare function injectConfigHeadTags(html: string, headConfig?: AppHeadC
|
|
|
227
165
|
* so runtime `useHead` tags aren't double-emitted).
|
|
228
166
|
*/
|
|
229
167
|
export declare function ensureDocumentShell(html: string, headConfig?: AppHeadConfig, options?: Parameters<typeof generateDocumentShell>[2], alreadyHasShell?: boolean): string;
|
|
168
|
+
/**
|
|
169
|
+
* Inline x-cloak rule shipped in the SSR <head> (stacksjs/stx#1736).
|
|
170
|
+
*
|
|
171
|
+
* Must be parsed by the browser BEFORE first paint — so it goes in the head
|
|
172
|
+
* as static markup, not injected by the runtime script (which runs after the
|
|
173
|
+
* body has already painted, the window where false `:if` branches / hidden
|
|
174
|
+
* `:show` elements flash). The `data-stx-cloak` marker makes injection
|
|
175
|
+
* idempotent. The runtime's own late injection (signals.ts) is retained as a
|
|
176
|
+
* belt-and-suspenders for SPA-nav fragments that arrive without SSR head
|
|
177
|
+
* emission.
|
|
178
|
+
*/
|
|
179
|
+
export declare const CLOAK_STYLE: '<style data-stx-cloak>[x-cloak]{display:none !important}</style>';
|
|
180
|
+
/**
|
|
181
|
+
* Markers recording which `<html>` attributes stx itself wrote from `htmlAttrs`
|
|
182
|
+
* (stacksjs/stx#1798).
|
|
183
|
+
*
|
|
184
|
+
* The router needs them to reconcile the root element across an SPA layout
|
|
185
|
+
* change. It cannot just diff `<html>` against the incoming document: by then
|
|
186
|
+
* the color-mode boot script has added its own `dark` class / `data-theme`, and
|
|
187
|
+
* `animation.ts` has added `data-reduced-motion`, none of which exist in the
|
|
188
|
+
* server response — a blind diff would strip them on every navigation and
|
|
189
|
+
* flash the wrong theme. These say exactly what stx put there, so the router
|
|
190
|
+
* can remove precisely that much and leave runtime state alone.
|
|
191
|
+
*
|
|
192
|
+
* `class` is tracked separately because it is the one attribute that gets
|
|
193
|
+
* *merged* into at runtime, so it has to be reconciled token-by-token rather
|
|
194
|
+
* than replaced wholesale.
|
|
195
|
+
*/
|
|
196
|
+
export declare const HTML_ATTRS_MARKER: 'data-stx-html-attrs';
|
|
197
|
+
export declare const HTML_CLASS_MARKER: 'data-stx-html-class';
|
|
@@ -1,12 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Dynamic Component Support
|
|
3
|
-
*
|
|
4
|
-
* Handles `<component :is="expr">` syntax for runtime component switching.
|
|
5
|
-
* Server-side: evaluates the expression and resolves the component.
|
|
6
|
-
* Client-side: signals runtime watches :is binding and swaps content.
|
|
7
|
-
*
|
|
8
|
-
* @module dynamic-components
|
|
9
|
-
*/
|
|
10
1
|
import type { StxOptions } from './types';
|
|
11
2
|
/**
|
|
12
3
|
* Process `<component :is="expr">` tags in the template.
|
|
@@ -32,4 +32,4 @@
|
|
|
32
32
|
* generated `await import('stx')` rejected and the shadowing binding was never
|
|
33
33
|
* created. The failure needed a real install to appear.
|
|
34
34
|
*/
|
|
35
|
-
export declare const STX_ENGINE_BINDING_NAMES: readonly ['module', 'exports', 'require', 'props', '$props', '$bool', '$num', 'defineProps', 'withDefaults', 'defineClientPayload', 'useServerData', 'useRuntimeConfig', 'useServerRuntimeConfig', 'state', 'derived', 'effect', 'batch', 'onMount', 'onDestroy', 'definePageMeta', 'useRoute', 'useRouter', 'useHead', 'useSeoMeta',
|
|
35
|
+
export declare const STX_ENGINE_BINDING_NAMES: readonly ['module', 'exports', 'require', 'props', '$props', '$bool', '$num', 'defineProps', 'withDefaults', 'defineClientPayload', 'useServerData', 'useRuntimeConfig', 'useServerRuntimeConfig', 'state', 'derived', 'effect', 'batch', 'onMount', 'onDestroy', 'definePageMeta', 'useRoute', 'useRouter', 'useHead', 'useSeoMeta', unknown];
|
package/dist/env.d.ts
CHANGED
|
@@ -1,3 +1,29 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* The environment gates, read through a destructure rather than directly off
|
|
3
|
+
* `process.env.NODE_ENV`.
|
|
4
|
+
*
|
|
5
|
+
* This package is built by transforming each source file with `Bun.Transpiler`
|
|
6
|
+
* (see `build.ts`), and the transpiler CONSTANT-FOLDS
|
|
7
|
+
* `process.env.NODE_ENV === 'production'` against the environment it is itself
|
|
8
|
+
* running in. The release machine does not set NODE_ENV, so all three of these
|
|
9
|
+
* shipped as `return !1`: in every installed copy of stx, `isProduction()` and
|
|
10
|
+
* `isTest()` were permanently false and `isDevelopment()` permanently true,
|
|
11
|
+
* whatever the consuming app's NODE_ENV said.
|
|
12
|
+
*
|
|
13
|
+
* Which quietly put every app's renderer in development mode. The visible
|
|
14
|
+
* consequence was the error boundaries: `showBoundaries` in `process.ts` is
|
|
15
|
+
* `!isProduction() && !isTest()`, so a failed `<script server>` or `@include`
|
|
16
|
+
* rendered its red diagnostic -- absolute build-machine paths included -- to
|
|
17
|
+
* end users on a production deploy, which is how it was reported
|
|
18
|
+
* (stacksjs/stx#2035). `app-shell.ts` also always chose its `dev` variant and
|
|
19
|
+
* the error logger always used development verbosity.
|
|
20
|
+
*
|
|
21
|
+
* `process.env['NODE_ENV']` folds in exactly the same way. Destructuring does
|
|
22
|
+
* not, and nor does a computed key; this is the readable one. Pinned by
|
|
23
|
+
* `test/env-gates-survive-the-build.test.ts`, which runs the build's own
|
|
24
|
+
* transpiler over this file -- the source is correct either way, so nothing
|
|
25
|
+
* that reads the source can see the bug.
|
|
26
|
+
*/
|
|
1
27
|
export declare function isProduction(): boolean;
|
|
2
28
|
export declare function isDevelopment(): boolean;
|
|
3
29
|
export declare function isTest(): boolean;
|
|
@@ -1,3 +1,23 @@
|
|
|
1
|
+
/** Every marker removed, for output no boundary claimed. */
|
|
2
|
+
export declare function stripRenderFailedMarkers(html: string): string;
|
|
3
|
+
export declare function processErrorBoundaryDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
|
|
4
|
+
/**
|
|
5
|
+
* Wrap content in a try/catch for SSR error handling.
|
|
6
|
+
* Returns the fallback if an error occurs during rendering.
|
|
7
|
+
*/
|
|
8
|
+
export declare function withErrorBoundary<T>(render: () => T | Promise<T>, fallback: T, onError?: (error: Error) => void): Promise<T>;
|
|
9
|
+
/**
|
|
10
|
+
* Create an error boundary wrapper function.
|
|
11
|
+
*/
|
|
12
|
+
export declare function createErrorBoundary<T>(fallback: T, options?: ErrorBoundaryOptions): (render: () => T | Promise<T>) => Promise<T>;
|
|
13
|
+
/**
|
|
14
|
+
* Generate CSS for error boundary styling.
|
|
15
|
+
*/
|
|
16
|
+
export declare function generateErrorBoundaryCSS(): string;
|
|
17
|
+
/**
|
|
18
|
+
* Generate client-side runtime for error boundaries.
|
|
19
|
+
*/
|
|
20
|
+
export declare function generateErrorBoundaryRuntime(): string;
|
|
1
21
|
/**
|
|
2
22
|
* STX Error Boundaries
|
|
3
23
|
*
|
|
@@ -19,49 +39,22 @@
|
|
|
19
39
|
* @enderrorBoundary
|
|
20
40
|
* ```
|
|
21
41
|
*/
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
42
|
+
// =============================================================================
|
|
43
|
+
// Types
|
|
44
|
+
// =============================================================================
|
|
45
|
+
export declare interface ErrorBoundaryOptions {
|
|
46
|
+
onError?: (error: Error, info: ErrorInfo) => void
|
|
47
|
+
logErrors?: boolean
|
|
48
|
+
id?: string
|
|
29
49
|
}
|
|
30
|
-
export interface ErrorInfo {
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
/** Timestamp */
|
|
36
|
-
timestamp: number;
|
|
37
|
-
/** Boundary ID */
|
|
38
|
-
boundaryId: string;
|
|
50
|
+
export declare interface ErrorInfo {
|
|
51
|
+
componentName?: string
|
|
52
|
+
stack?: string
|
|
53
|
+
timestamp: number
|
|
54
|
+
boundaryId: string
|
|
39
55
|
}
|
|
40
|
-
export interface ErrorBoundaryState {
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
error: Error | null;
|
|
45
|
-
/** Error info */
|
|
46
|
-
info: ErrorInfo | null;
|
|
56
|
+
export declare interface ErrorBoundaryState {
|
|
57
|
+
hasError: boolean
|
|
58
|
+
error: Error | null
|
|
59
|
+
info: ErrorInfo | null
|
|
47
60
|
}
|
|
48
|
-
/** Every marker removed, for output no boundary claimed. */
|
|
49
|
-
export declare function stripRenderFailedMarkers(html: string): string;
|
|
50
|
-
export declare function processErrorBoundaryDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
|
|
51
|
-
/**
|
|
52
|
-
* Wrap content in a try/catch for SSR error handling.
|
|
53
|
-
* Returns the fallback if an error occurs during rendering.
|
|
54
|
-
*/
|
|
55
|
-
export declare function withErrorBoundary<T>(render: () => T | Promise<T>, fallback: T, onError?: (error: Error) => void): Promise<T>;
|
|
56
|
-
/**
|
|
57
|
-
* Create an error boundary wrapper function.
|
|
58
|
-
*/
|
|
59
|
-
export declare function createErrorBoundary<T>(fallback: T, options?: ErrorBoundaryOptions): (render: () => T | Promise<T>) => Promise<T>;
|
|
60
|
-
/**
|
|
61
|
-
* Generate CSS for error boundary styling.
|
|
62
|
-
*/
|
|
63
|
-
export declare function generateErrorBoundaryCSS(): string;
|
|
64
|
-
/**
|
|
65
|
-
* Generate client-side runtime for error boundaries.
|
|
66
|
-
*/
|
|
67
|
-
export declare function generateErrorBoundaryRuntime(): string;
|
package/dist/error-handling.d.ts
CHANGED
package/dist/errors/codes.d.ts
CHANGED
|
@@ -1,23 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Error Codes and Localized Messages
|
|
3
|
-
*
|
|
4
|
-
* Provides numeric error codes for programmatic error handling
|
|
5
|
-
* and localized error message templates.
|
|
6
|
-
*
|
|
7
|
-
* @module errors/codes
|
|
8
|
-
*/
|
|
9
|
-
/**
|
|
10
|
-
* Error message template with placeholder support
|
|
11
|
-
* Placeholders use {{name}} syntax
|
|
12
|
-
*/
|
|
13
|
-
export interface ErrorMessageTemplate {
|
|
14
|
-
message: string;
|
|
15
|
-
help?: string;
|
|
16
|
-
}
|
|
17
|
-
/**
|
|
18
|
-
* Localized error messages by error code
|
|
19
|
-
*/
|
|
20
|
-
export type ErrorMessages = Record<number, ErrorMessageTemplate>;
|
|
21
1
|
/**
|
|
22
2
|
* Set the locale for error messages
|
|
23
3
|
*/
|
|
@@ -43,6 +23,10 @@ export declare function getErrorMessage(code: number, params?: Record<string, st
|
|
|
43
23
|
* Format an error with localized message
|
|
44
24
|
*/
|
|
45
25
|
export declare function formatLocalizedError(code: number, params?: Record<string, string>): string;
|
|
26
|
+
/**
|
|
27
|
+
* Get error code name from numeric code
|
|
28
|
+
*/
|
|
29
|
+
export declare function getErrorCodeName(code: number): string | undefined;
|
|
46
30
|
/**
|
|
47
31
|
* Numeric error codes for programmatic error handling
|
|
48
32
|
*
|
|
@@ -56,37 +40,45 @@ export declare function formatLocalizedError(code: number, params?: Record<strin
|
|
|
56
40
|
* - 1600-1699: Expression errors
|
|
57
41
|
*/
|
|
58
42
|
export declare const ErrorCodes: {
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
43
|
+
UNCLOSED_DIRECTIVE: 1001;
|
|
44
|
+
UNCLOSED_EXPRESSION: 1002;
|
|
45
|
+
INVALID_DIRECTIVE_SYNTAX: 1003;
|
|
46
|
+
MALFORMED_EXPRESSION: 1004;
|
|
47
|
+
UNEXPECTED_TOKEN: 1005;
|
|
48
|
+
UNDEFINED_VARIABLE: 1101;
|
|
49
|
+
TYPE_ERROR: 1102;
|
|
50
|
+
EVALUATION_ERROR: 1103;
|
|
51
|
+
INFINITE_LOOP: 1104;
|
|
52
|
+
CIRCULAR_REFERENCE: 1105;
|
|
53
|
+
UNSAFE_EXPRESSION: 1201;
|
|
54
|
+
PATH_TRAVERSAL: 1202;
|
|
55
|
+
XSS_ATTEMPT: 1203;
|
|
56
|
+
CODE_INJECTION: 1204;
|
|
57
|
+
DOM_API_VIOLATION: 1205;
|
|
58
|
+
FILE_NOT_FOUND: 1301;
|
|
59
|
+
FILE_READ_ERROR: 1302;
|
|
60
|
+
INVALID_FILE_PATH: 1303;
|
|
61
|
+
PERMISSION_DENIED: 1304;
|
|
62
|
+
INVALID_CONFIG: 1401;
|
|
63
|
+
MISSING_REQUIRED_CONFIG: 1402;
|
|
64
|
+
DEPRECATED_CONFIG: 1403;
|
|
65
|
+
COMPONENT_NOT_FOUND: 1501;
|
|
66
|
+
INVALID_PROPS: 1502;
|
|
67
|
+
COMPONENT_RENDER_ERROR: 1503;
|
|
68
|
+
FILTER_NOT_FOUND: 1601;
|
|
69
|
+
INVALID_FILTER_ARGS: 1602;
|
|
70
|
+
EXPRESSION_TIMEOUT: 1603
|
|
87
71
|
};
|
|
88
|
-
export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
|
|
89
72
|
/**
|
|
90
|
-
*
|
|
73
|
+
* Error message template with placeholder support
|
|
74
|
+
* Placeholders use {{name}} syntax
|
|
91
75
|
*/
|
|
92
|
-
export declare
|
|
76
|
+
export declare interface ErrorMessageTemplate {
|
|
77
|
+
message: string
|
|
78
|
+
help?: string
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Localized error messages by error code
|
|
82
|
+
*/
|
|
83
|
+
export type ErrorMessages = Record<number, ErrorMessageTemplate>;
|
|
84
|
+
export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
|
|
@@ -1,63 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Error Formatting Utilities
|
|
3
|
-
*
|
|
4
|
-
* Provides standardized error message formatting for different output formats.
|
|
5
|
-
*
|
|
6
|
-
* @module errors/formatter
|
|
7
|
-
*/
|
|
8
1
|
import type { ErrorCode } from './codes';
|
|
9
2
|
import type { ErrorContext } from './types';
|
|
10
|
-
/**
|
|
11
|
-
* Error output format options
|
|
12
|
-
*/
|
|
13
|
-
export type ErrorOutputFormat = 'html' | 'text' | 'json' | 'console';
|
|
14
|
-
/**
|
|
15
|
-
* Standardized error message options
|
|
16
|
-
*/
|
|
17
|
-
export interface ErrorMessageOptions {
|
|
18
|
-
/** Error type/category (e.g., 'Directive', 'Expression', 'Syntax') */
|
|
19
|
-
type: string;
|
|
20
|
-
/** The error message */
|
|
21
|
-
message: string;
|
|
22
|
-
/** Numeric error code */
|
|
23
|
-
code?: ErrorCode;
|
|
24
|
-
/** File path where error occurred */
|
|
25
|
-
filePath?: string;
|
|
26
|
-
/** Line number */
|
|
27
|
-
line?: number;
|
|
28
|
-
/** Column number */
|
|
29
|
-
column?: number;
|
|
30
|
-
/** Template content for context */
|
|
31
|
-
template?: string;
|
|
32
|
-
/** Position offset in template */
|
|
33
|
-
offset?: number;
|
|
34
|
-
/** The problematic code snippet */
|
|
35
|
-
snippet?: string;
|
|
36
|
-
/** Suggestion for fixing the error */
|
|
37
|
-
suggestion?: string;
|
|
38
|
-
/** Output format */
|
|
39
|
-
format?: ErrorOutputFormat;
|
|
40
|
-
}
|
|
41
|
-
/**
|
|
42
|
-
* Standardized error message result
|
|
43
|
-
*/
|
|
44
|
-
export interface StandardizedError {
|
|
45
|
-
/** Formatted error message for display */
|
|
46
|
-
formatted: string;
|
|
47
|
-
/** Raw error data */
|
|
48
|
-
data: {
|
|
49
|
-
type: string;
|
|
50
|
-
code: number | undefined;
|
|
51
|
-
codeName: string | undefined;
|
|
52
|
-
message: string;
|
|
53
|
-
filePath: string | undefined;
|
|
54
|
-
line: number | undefined;
|
|
55
|
-
column: number | undefined;
|
|
56
|
-
snippet: string | undefined;
|
|
57
|
-
suggestion: string | undefined;
|
|
58
|
-
timestamp: string;
|
|
59
|
-
};
|
|
60
|
-
}
|
|
61
3
|
/**
|
|
62
4
|
* Create a standardized error message in any format
|
|
63
5
|
*/
|
|
@@ -82,3 +24,41 @@ export declare function safeExecute<T>(operation: () => T, fallback: T, errorHan
|
|
|
82
24
|
* Async version of safe wrapper
|
|
83
25
|
*/
|
|
84
26
|
export declare function safeExecuteAsync<T>(operation: () => Promise<T>, fallback: T, errorHandler?: (error: Error) => void): Promise<T>;
|
|
27
|
+
/**
|
|
28
|
+
* Standardized error message options
|
|
29
|
+
*/
|
|
30
|
+
export declare interface ErrorMessageOptions {
|
|
31
|
+
type: string
|
|
32
|
+
message: string
|
|
33
|
+
code?: ErrorCode
|
|
34
|
+
filePath?: string
|
|
35
|
+
line?: number
|
|
36
|
+
column?: number
|
|
37
|
+
template?: string
|
|
38
|
+
offset?: number
|
|
39
|
+
snippet?: string
|
|
40
|
+
suggestion?: string
|
|
41
|
+
format?: ErrorOutputFormat
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Standardized error message result
|
|
45
|
+
*/
|
|
46
|
+
export declare interface StandardizedError {
|
|
47
|
+
formatted: string
|
|
48
|
+
data: {
|
|
49
|
+
type: string
|
|
50
|
+
code: number | undefined
|
|
51
|
+
codeName: string | undefined
|
|
52
|
+
message: string
|
|
53
|
+
filePath: string | undefined
|
|
54
|
+
line: number | undefined
|
|
55
|
+
column: number | undefined
|
|
56
|
+
snippet: string | undefined
|
|
57
|
+
suggestion: string | undefined
|
|
58
|
+
timestamp: string
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Error output format options
|
|
63
|
+
*/
|
|
64
|
+
export type ErrorOutputFormat = 'html' | 'text' | 'json' | 'console';
|
package/dist/errors/index.d.ts
CHANGED
|
@@ -5,8 +5,64 @@
|
|
|
5
5
|
*
|
|
6
6
|
* @module errors
|
|
7
7
|
*/
|
|
8
|
-
|
|
9
|
-
export {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
8
|
+
// Error codes and localization
|
|
9
|
+
export {
|
|
10
|
+
clearErrorMessages,
|
|
11
|
+
type ErrorCode,
|
|
12
|
+
ErrorCodes,
|
|
13
|
+
type ErrorMessages,
|
|
14
|
+
type ErrorMessageTemplate,
|
|
15
|
+
formatLocalizedError,
|
|
16
|
+
getErrorCodeName,
|
|
17
|
+
getErrorLocale,
|
|
18
|
+
getErrorMessage,
|
|
19
|
+
registerErrorMessages,
|
|
20
|
+
setErrorLocale,
|
|
21
|
+
} from './codes';
|
|
22
|
+
// Error formatting
|
|
23
|
+
export {
|
|
24
|
+
consoleError,
|
|
25
|
+
createEnhancedError,
|
|
26
|
+
type ErrorMessageOptions,
|
|
27
|
+
type ErrorOutputFormat,
|
|
28
|
+
formatError,
|
|
29
|
+
inlineError,
|
|
30
|
+
safeExecute,
|
|
31
|
+
safeExecuteAsync,
|
|
32
|
+
type StandardizedError,
|
|
33
|
+
} from './formatter';
|
|
34
|
+
// Logger and recovery
|
|
35
|
+
export {
|
|
36
|
+
devHelpers,
|
|
37
|
+
type ErrorLogEntry,
|
|
38
|
+
ErrorLogger,
|
|
39
|
+
errorLogger,
|
|
40
|
+
type ErrorLoggerOptions,
|
|
41
|
+
errorRecovery,
|
|
42
|
+
} from './logger';
|
|
43
|
+
// Sanitization
|
|
44
|
+
export {
|
|
45
|
+
sanitizeComponentProps,
|
|
46
|
+
sanitizeDirectiveParam,
|
|
47
|
+
sanitizeDirectiveParams,
|
|
48
|
+
type SanitizedParam,
|
|
49
|
+
sanitizeExpression,
|
|
50
|
+
sanitizeFilePath,
|
|
51
|
+
type SanitizeOptions,
|
|
52
|
+
validators,
|
|
53
|
+
} from './sanitizer';
|
|
54
|
+
// Error types and classes
|
|
55
|
+
export {
|
|
56
|
+
configureErrorHandling,
|
|
57
|
+
type ErrorConfig,
|
|
58
|
+
type ErrorContext,
|
|
59
|
+
formatFilePath,
|
|
60
|
+
getErrorConfig,
|
|
61
|
+
resetErrorConfig,
|
|
62
|
+
StxError,
|
|
63
|
+
StxFileError,
|
|
64
|
+
StxRuntimeError,
|
|
65
|
+
StxSecurityError,
|
|
66
|
+
StxSyntaxError,
|
|
67
|
+
StxValidationError,
|
|
68
|
+
} from './types';
|