@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/html-masking.d.ts
CHANGED
|
@@ -1,35 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Element-position-aware masking.
|
|
3
|
-
*
|
|
4
|
-
* Several pipeline stages temporarily replace `<script>…</script>` bodies or
|
|
5
|
-
* `<!-- … -->` comments with sentinel placeholders so later passes don't process
|
|
6
|
-
* their contents, then restore them at the end. A naive global regex
|
|
7
|
-
* (`/<script…>…<\/script>/g`, `/<!--…-->/g`) also matches such a token when it
|
|
8
|
-
* appears INSIDE a quoted attribute value — e.g. `aria-label="<script>x</script>"`
|
|
9
|
-
* or `title="<!-- "><img onerror=alert(1)> -->"`. The renderer's HTML-escaping
|
|
10
|
-
* then runs against the harmless placeholder, and the raw token is restored into
|
|
11
|
-
* the attribute afterward, breaking out of it — an XSS.
|
|
12
|
-
*
|
|
13
|
-
* `maskAtElementPosition` walks the string tracking tag/attribute/quote state and
|
|
14
|
-
* only masks tokens that begin at *element position* (not within an open tag, not
|
|
15
|
-
* inside a quoted attribute value). A token embedded in an attribute is left in
|
|
16
|
-
* place to be escaped normally.
|
|
17
|
-
*
|
|
18
|
-
* This is a leaf module (no stx imports) so any stage can use it without risking
|
|
19
|
-
* an import cycle.
|
|
20
|
-
*
|
|
21
|
-
* @module html-masking
|
|
22
|
-
*/
|
|
23
|
-
/**
|
|
24
|
-
* Locate a maskable token starting at `html[i]`.
|
|
25
|
-
* @returns the end index (exclusive) of the token, or -1 if none starts here.
|
|
26
|
-
*/
|
|
27
|
-
export type TokenMatcher = (html: string, i: number) => number;
|
|
28
|
-
export interface ElementPositionToken {
|
|
29
|
-
start: number;
|
|
30
|
-
end: number;
|
|
31
|
-
token: string;
|
|
32
|
-
}
|
|
33
1
|
/** Matches a real `<script…>…</script>` element (through the first `</script>`). */
|
|
34
2
|
export declare function matchScriptElement(html: string, i: number): number;
|
|
35
3
|
/** Matches a real `<style…>…</style>` element (through the first `</style>`). */
|
|
@@ -81,36 +49,7 @@ export declare function clearMaskCache(): void;
|
|
|
81
49
|
* Note: HTML attributes do not use backslash escaping, so a `"`/`'` always
|
|
82
50
|
* toggles the surrounding quote — matching how browsers parse attribute values.
|
|
83
51
|
*/
|
|
84
|
-
export declare function maskAtElementPosition(html: string, match: TokenMatcher, placeholder: (token: string, index: number) => string,
|
|
85
|
-
/**
|
|
86
|
-
* Opt in to memoisation. Must fully determine what `placeholder` returns for
|
|
87
|
-
* a given index — two calls sharing a key MUST be interchangeable.
|
|
88
|
-
*/
|
|
89
|
-
cacheKey?: string): {
|
|
90
|
-
output: string;
|
|
91
|
-
tokens: string[];
|
|
92
|
-
};
|
|
93
|
-
export interface StashedScripts {
|
|
94
|
-
/** The document with each `<script>` element replaced by a NUL sentinel. */
|
|
95
|
-
output: string;
|
|
96
|
-
/** The removed script elements, in placeholder order. */
|
|
97
|
-
scripts: string[];
|
|
98
|
-
/**
|
|
99
|
-
* Put the scripts back.
|
|
100
|
-
*
|
|
101
|
-
* Returns the pre-stash document unchanged when `html` is still the masked
|
|
102
|
-
* output. Stashing replaces each script with a sentinel and restoring puts
|
|
103
|
-
* exactly those scripts back at exactly those sentinels, so when nothing
|
|
104
|
-
* edited the masked document in between, the replace pass can only rebuild,
|
|
105
|
-
* character by character, a string the caller already handed us.
|
|
106
|
-
*
|
|
107
|
-
* That is the common case, not a corner: one render of the #1945 fixture
|
|
108
|
-
* reaches this having changed nothing in FOUR of five passes, rebuilding
|
|
109
|
-
* 445,208 bytes to arrive back where it started. The component loop stashes
|
|
110
|
-
* on every pass but only the first pass resolves anything.
|
|
111
|
-
*/
|
|
112
|
-
restore: (html: string) => string;
|
|
113
|
-
}
|
|
52
|
+
export declare function maskAtElementPosition(html: string, match: TokenMatcher, placeholder: (token: string, index: number) => string, cacheKey?: string): { output: string, tokens: string[] };
|
|
114
53
|
export declare function stashScriptElements(html: string): StashedScripts;
|
|
115
54
|
/**
|
|
116
55
|
* Drop cached stash results.
|
|
@@ -123,3 +62,40 @@ export declare function stashScriptElements(html: string): StashedScripts;
|
|
|
123
62
|
export declare function clearStashCache(): void;
|
|
124
63
|
/** Restore scripts stashed by {@link stashScriptElements}. */
|
|
125
64
|
export declare function restoreStashedScripts(html: string, scripts: string[]): string;
|
|
65
|
+
export declare interface ElementPositionToken {
|
|
66
|
+
start: number
|
|
67
|
+
end: number
|
|
68
|
+
token: string
|
|
69
|
+
}
|
|
70
|
+
export declare interface StashedScripts {
|
|
71
|
+
output: string
|
|
72
|
+
scripts: string[]
|
|
73
|
+
restore: (html: string) => string
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Element-position-aware masking.
|
|
77
|
+
*
|
|
78
|
+
* Several pipeline stages temporarily replace `<script>…</script>` bodies or
|
|
79
|
+
* `<!-- … -->` comments with sentinel placeholders so later passes don't process
|
|
80
|
+
* their contents, then restore them at the end. A naive global regex
|
|
81
|
+
* (`/<script…>…<\/script>/g`, `/<!--…-->/g`) also matches such a token when it
|
|
82
|
+
* appears INSIDE a quoted attribute value — e.g. `aria-label="<script>x</script>"`
|
|
83
|
+
* or `title="<!-- "><img onerror=alert(1)> -->"`. The renderer's HTML-escaping
|
|
84
|
+
* then runs against the harmless placeholder, and the raw token is restored into
|
|
85
|
+
* the attribute afterward, breaking out of it — an XSS.
|
|
86
|
+
*
|
|
87
|
+
* `maskAtElementPosition` walks the string tracking tag/attribute/quote state and
|
|
88
|
+
* only masks tokens that begin at *element position* (not within an open tag, not
|
|
89
|
+
* inside a quoted attribute value). A token embedded in an attribute is left in
|
|
90
|
+
* place to be escaped normally.
|
|
91
|
+
*
|
|
92
|
+
* This is a leaf module (no stx imports) so any stage can use it without risking
|
|
93
|
+
* an import cycle.
|
|
94
|
+
*
|
|
95
|
+
* @module html-masking
|
|
96
|
+
*/
|
|
97
|
+
/**
|
|
98
|
+
* Locate a maskable token starting at `html[i]`.
|
|
99
|
+
* @returns the end index (exclusive) of the token, or -1 if none starts here.
|
|
100
|
+
*/
|
|
101
|
+
export type TokenMatcher = (html: string, i: number) => number;
|
|
@@ -1,23 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Unified Hydration Runtime for Islands Architecture
|
|
3
|
-
*
|
|
4
|
-
* Replaces the per-strategy inline scripts with a single runtime that handles
|
|
5
|
-
* all hydration strategies. Injected once per page when islands are present.
|
|
6
|
-
*
|
|
7
|
-
* The runtime:
|
|
8
|
-
* 1. Component registry — maps names to dynamic imports
|
|
9
|
-
* 2. hydrateIsland(element) — loads component, reads props, calls hydrate/mount
|
|
10
|
-
* 3. Strategy dispatcher — sets up triggers per data-strategy attribute
|
|
11
|
-
* 4. initIslands() — processes all .stx-island:not(.hydrated) on DOMContentLoaded
|
|
12
|
-
*
|
|
13
|
-
* @module hydration-runtime
|
|
14
|
-
*/
|
|
15
|
-
export interface IslandMeta {
|
|
16
|
-
id: string;
|
|
17
|
-
component: string;
|
|
18
|
-
strategy: string;
|
|
19
|
-
props: Record<string, unknown>;
|
|
20
|
-
}
|
|
21
1
|
/**
|
|
22
2
|
* Generate the unified hydration bootstrap script.
|
|
23
3
|
*
|
|
@@ -42,3 +22,27 @@ export declare function extractComponentName(content: string): string | null;
|
|
|
42
22
|
* Parses :prop="value" bindings.
|
|
43
23
|
*/
|
|
44
24
|
export declare function extractBoundProps(content: string, context: Record<string, unknown>): Record<string, unknown>;
|
|
25
|
+
/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
|
|
26
|
+
/**
|
|
27
|
+
* Unified Hydration Runtime for Islands Architecture
|
|
28
|
+
*
|
|
29
|
+
* Replaces the per-strategy inline scripts with a single runtime that handles
|
|
30
|
+
* all hydration strategies. Injected once per page when islands are present.
|
|
31
|
+
*
|
|
32
|
+
* The runtime:
|
|
33
|
+
* 1. Component registry — maps names to dynamic imports
|
|
34
|
+
* 2. hydrateIsland(element) — loads component, reads props, calls hydrate/mount
|
|
35
|
+
* 3. Strategy dispatcher — sets up triggers per data-strategy attribute
|
|
36
|
+
* 4. initIslands() — processes all .stx-island:not(.hydrated) on DOMContentLoaded
|
|
37
|
+
*
|
|
38
|
+
* @module hydration-runtime
|
|
39
|
+
*/
|
|
40
|
+
// ============================================================================
|
|
41
|
+
// Types
|
|
42
|
+
// ============================================================================
|
|
43
|
+
export declare interface IslandMeta {
|
|
44
|
+
id: string
|
|
45
|
+
component: string
|
|
46
|
+
strategy: string
|
|
47
|
+
props: Record<string, unknown>
|
|
48
|
+
}
|
package/dist/hydration.d.ts
CHANGED
|
@@ -31,6 +31,16 @@ export declare function hydrate(options?: HydrationOptions): Promise<void>;
|
|
|
31
31
|
* Generate hydration CSS
|
|
32
32
|
*/
|
|
33
33
|
export declare function generateHydrationCSS(): string;
|
|
34
|
+
declare const __dtsx_default_export__: {
|
|
35
|
+
HydrationRuntime: typeof HydrationRuntime;
|
|
36
|
+
serializeState: typeof serializeState;
|
|
37
|
+
generateStateScript: typeof generateStateScript;
|
|
38
|
+
generateHydrationScript: typeof generateHydrationScript;
|
|
39
|
+
generateHydrationCSS: typeof generateHydrationCSS;
|
|
40
|
+
extractState: typeof extractState;
|
|
41
|
+
getHydrationRuntime: typeof getHydrationRuntime;
|
|
42
|
+
hydrate: typeof hydrate
|
|
43
|
+
};
|
|
34
44
|
// =============================================================================
|
|
35
45
|
// Types
|
|
36
46
|
// =============================================================================
|
|
@@ -84,13 +94,4 @@ export declare class HydrationRuntime {
|
|
|
84
94
|
// =============================================================================
|
|
85
95
|
// Exports
|
|
86
96
|
// =============================================================================
|
|
87
|
-
export default
|
|
88
|
-
HydrationRuntime,
|
|
89
|
-
serializeState,
|
|
90
|
-
generateStateScript,
|
|
91
|
-
generateHydrationScript,
|
|
92
|
-
generateHydrationCSS,
|
|
93
|
-
extractState,
|
|
94
|
-
getHydrationRuntime,
|
|
95
|
-
hydrate,
|
|
96
|
-
};
|
|
97
|
+
export default __dtsx_default_export__;
|
package/dist/i18n.d.ts
CHANGED
|
@@ -1,89 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Module for internationalization (i18n) support
|
|
3
|
-
*
|
|
4
|
-
* Features:
|
|
5
|
-
* - Translation file loading (JSON, YAML, JS)
|
|
6
|
-
* - Lazy loading with deduplication
|
|
7
|
-
* - Background preloading for multiple locales
|
|
8
|
-
* - Nested key access (e.g., 'messages.welcome')
|
|
9
|
-
* - Parameter replacement (e.g., ':name' → 'John')
|
|
10
|
-
* - Basic pluralization support
|
|
11
|
-
* - ICU MessageFormat support
|
|
12
|
-
* - Translation caching with invalidation
|
|
13
|
-
*
|
|
14
|
-
* ## Lazy Loading
|
|
15
|
-
*
|
|
16
|
-
* Translations are loaded lazily with request deduplication:
|
|
17
|
-
* ```ts
|
|
18
|
-
* // Multiple simultaneous calls share the same promise
|
|
19
|
-
* const [t1, t2] = await Promise.all([
|
|
20
|
-
* loadTranslation('en', options),
|
|
21
|
-
* loadTranslation('en', options), // Reuses same request
|
|
22
|
-
* ])
|
|
23
|
-
* ```
|
|
24
|
-
*
|
|
25
|
-
* ## Background Preloading
|
|
26
|
-
*
|
|
27
|
-
* Preload translations in the background:
|
|
28
|
-
* ```ts
|
|
29
|
-
* // Fire and forget - doesn't block
|
|
30
|
-
* preloadTranslationsBackground({
|
|
31
|
-
* locales: ['en', 'es', 'fr', 'de'],
|
|
32
|
-
* parallel: true,
|
|
33
|
-
* onLocaleLoaded: (locale) => console.log(`${locale} ready`)
|
|
34
|
-
* }, options)
|
|
35
|
-
*
|
|
36
|
-
* // Later, check if loaded or wait
|
|
37
|
-
* if (isLoaded('es')) {
|
|
38
|
-
* const translations = getTranslationSync('es')
|
|
39
|
-
* }
|
|
40
|
-
else {
|
|
41
|
-
* await waitForLocale('es', 5000) // Wait up to 5s
|
|
42
|
-
* }
|
|
43
|
-
* ```
|
|
44
|
-
*
|
|
45
|
-
* ## Pluralization
|
|
46
|
-
*
|
|
47
|
-
* Use the `|` separator to define plural forms:
|
|
48
|
-
* ```yaml
|
|
49
|
-
* items: "One item|:count items"
|
|
50
|
-
* ```
|
|
51
|
-
*
|
|
52
|
-
* Or for more complex pluralization:
|
|
53
|
-
* ```yaml
|
|
54
|
-
* apples: "{0} No apples|{1} One apple|[2,*] :count apples"
|
|
55
|
-
* ```
|
|
56
|
-
*
|
|
57
|
-
* ## Cache Management
|
|
58
|
-
*
|
|
59
|
-
* The translation cache can be managed via:
|
|
60
|
-
* - `clearTranslationCache()` - Clear all cached translations
|
|
61
|
-
* - `clearTranslationCache('en')` - Clear specific locale
|
|
62
|
-
* - `getTranslationCacheStats()` - Get cache statistics
|
|
63
|
-
*/
|
|
64
1
|
import type { I18nConfig, StxOptions } from './types';
|
|
65
|
-
export declare const defaultI18nConfig: I18nConfig;
|
|
66
|
-
/**
|
|
67
|
-
* Loading state for async translation loading
|
|
68
|
-
*/
|
|
69
|
-
type LoadingState = 'idle' | 'loading' | 'loaded' | 'error';
|
|
70
|
-
/**
|
|
71
|
-
* Preload configuration
|
|
72
|
-
*/
|
|
73
|
-
export interface PreloadConfig {
|
|
74
|
-
/** Locales to preload */
|
|
75
|
-
locales: string[];
|
|
76
|
-
/** Whether to load in parallel (true) or sequentially (false) */
|
|
77
|
-
parallel?: boolean;
|
|
78
|
-
/** Priority order - higher priority locales load first in sequential mode */
|
|
79
|
-
priority?: Record<string, number>;
|
|
80
|
-
/** Callback when a locale finishes loading */
|
|
81
|
-
onLocaleLoaded?: (locale: string) => void;
|
|
82
|
-
/** Callback when all locales are loaded */
|
|
83
|
-
onComplete?: () => void;
|
|
84
|
-
/** Callback on error */
|
|
85
|
-
onError?: (locale: string, error: Error) => void;
|
|
86
|
-
}
|
|
87
2
|
/**
|
|
88
3
|
* Clear the translation cache
|
|
89
4
|
* @param locale - Optional locale to clear. If not provided, clears all.
|
|
@@ -93,13 +8,9 @@ export declare function clearTranslationCache(locale?: string): void;
|
|
|
93
8
|
* Get translation cache statistics
|
|
94
9
|
*/
|
|
95
10
|
export declare function getTranslationCacheStats(): {
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
locale: string;
|
|
100
|
-
loadedAt: Date;
|
|
101
|
-
keyCount: number;
|
|
102
|
-
}>;
|
|
11
|
+
size: number
|
|
12
|
+
locales: string[]
|
|
13
|
+
entries: Array<{ locale: string, loadedAt: Date, keyCount: number }>
|
|
103
14
|
};
|
|
104
15
|
/**
|
|
105
16
|
* Get the loading state for a locale
|
|
@@ -307,8 +218,6 @@ export declare function isICUFormat(message: string): boolean;
|
|
|
307
218
|
* // => '5 items'
|
|
308
219
|
*/
|
|
309
220
|
export declare function getTranslation(key: string, translations: Record<string, any>, fallbackToKey?: boolean, params?: Record<string, any>): string;
|
|
310
|
-
/** Text direction of a document or element. */
|
|
311
|
-
export type TextDirection = 'ltr' | 'rtl';
|
|
312
221
|
/**
|
|
313
222
|
* Resolve the writing direction of a BCP 47 locale tag.
|
|
314
223
|
*
|
|
@@ -334,9 +243,39 @@ export declare function isRtlLocale(locale: string | undefined | null): boolean;
|
|
|
334
243
|
/**
|
|
335
244
|
* Process @translate directive
|
|
336
245
|
*/
|
|
246
|
+
// eslint-disable-next-line pickier/no-unused-vars
|
|
337
247
|
export declare function processTranslateDirective(template: string, context: Record<string, any>, filePath: string, options: StxOptions): Promise<string>;
|
|
338
248
|
/**
|
|
339
249
|
* Create a translation filter for expressions
|
|
340
250
|
*/
|
|
341
251
|
export declare function createTranslateFilter(translations: Record<string, any>, fallbackToKey?: boolean): (value: string, params?: Record<string, any>) => string;
|
|
342
|
-
|
|
252
|
+
// =============================================================================
|
|
253
|
+
// Configuration
|
|
254
|
+
// =============================================================================
|
|
255
|
+
// Default i18n configuration
|
|
256
|
+
export declare const defaultI18nConfig: I18nConfig;
|
|
257
|
+
/**
|
|
258
|
+
* Preload configuration
|
|
259
|
+
*/
|
|
260
|
+
export declare interface PreloadConfig {
|
|
261
|
+
locales: string[]
|
|
262
|
+
parallel?: boolean
|
|
263
|
+
priority?: Record<string, number>
|
|
264
|
+
onLocaleLoaded?: (locale: string) => void
|
|
265
|
+
onComplete?: () => void
|
|
266
|
+
onError?: (locale: string, error: Error) => void
|
|
267
|
+
}
|
|
268
|
+
/**
|
|
269
|
+
* Signature of ts-i18n's `loadLocale`. Returns the merged translation tree for
|
|
270
|
+
* a locale, or `undefined` when no file exists for it.
|
|
271
|
+
*/
|
|
272
|
+
declare type LoadLocaleFn = (
|
|
273
|
+
locale: string,
|
|
274
|
+
options: { translationsDir: string, defaultLocale?: string, sources?: Array<'ts' | 'yaml' | 'json'> },
|
|
275
|
+
) => Promise<Record<string, any> | undefined>;
|
|
276
|
+
/**
|
|
277
|
+
* Loading state for async translation loading
|
|
278
|
+
*/
|
|
279
|
+
declare type LoadingState = 'idle' | 'loading' | 'loaded' | 'error';
|
|
280
|
+
/** Text direction of a document or element. */
|
|
281
|
+
export type TextDirection = 'ltr' | 'rtl';
|
|
@@ -1,35 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Auto-Sibling Image Discovery
|
|
3
|
-
*
|
|
4
|
-
* NuxtImage-style sugar: if a `.webp` (or `.avif`) sits next to a `.jpg`/
|
|
5
|
-
* `.png` on disk, rewrite plain `<img src="hero.jpg">` into
|
|
6
|
-
*
|
|
7
|
-
* <picture>
|
|
8
|
-
* <source type="image/avif" srcset="/images/hero.avif">
|
|
9
|
-
* <source type="image/webp" srcset="/images/hero.webp">
|
|
10
|
-
* <img src="/images/hero.jpg" alt="…">
|
|
11
|
-
* </picture>
|
|
12
|
-
*
|
|
13
|
-
* No consumer change required — drop the optimized format next to the
|
|
14
|
-
* original asset and capable browsers pick it up.
|
|
15
|
-
*
|
|
16
|
-
* Skipped intentionally:
|
|
17
|
-
* - `<img>` already inside a `<picture>` (don't double-wrap)
|
|
18
|
-
* - Remote URLs (http://, https://, protocol-relative `//cdn/…`)
|
|
19
|
-
* - data: URIs
|
|
20
|
-
* - sources whose extension isn't a known raster format
|
|
21
|
-
* - images whose resolved path is outside `publicDir` (we don't probe
|
|
22
|
-
* arbitrary paths on disk)
|
|
23
|
-
*/
|
|
24
|
-
export interface AutoSiblingOptions {
|
|
25
|
-
/** Filesystem root for resolving src URLs (typically the stx config's `publicDir`). */
|
|
26
|
-
publicDir: string;
|
|
27
|
-
/** Sibling formats to probe for, in priority order (most-preferred first). */
|
|
28
|
-
formats?: Array<{
|
|
29
|
-
ext: string;
|
|
30
|
-
mime: string;
|
|
31
|
-
}>;
|
|
32
|
-
}
|
|
33
1
|
/**
|
|
34
2
|
* Scan `html` for plain `<img>` tags whose src resolves to a real file
|
|
35
3
|
* inside `publicDir`, probe for sibling-format files (e.g. `hero.webp`
|
|
@@ -40,3 +8,7 @@ export interface AutoSiblingOptions {
|
|
|
40
8
|
* found, returns the input unchanged (no allocations beyond the scan).
|
|
41
9
|
*/
|
|
42
10
|
export declare function rewriteImagesWithSiblings(html: string, options: AutoSiblingOptions): Promise<string>;
|
|
11
|
+
export declare interface AutoSiblingOptions {
|
|
12
|
+
publicDir: string
|
|
13
|
+
formats?: Array<{ ext: string, mime: string }>
|
|
14
|
+
}
|
|
@@ -1,39 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Does a client script reach signal APIs through a module it imports?
|
|
3
|
-
*
|
|
4
|
-
* Every signal decision in the pipeline is a syntactic scan for `state(`,
|
|
5
|
-
* `derived(`, `effect(` and friends in the script's own text. That is exact
|
|
6
|
-
* for a script that declares its own signals and blind to one that factors
|
|
7
|
-
* them out:
|
|
8
|
-
*
|
|
9
|
-
* ```stx
|
|
10
|
-
* <script client>
|
|
11
|
-
* import { makeProbe } from '../functions/probe-factory'
|
|
12
|
-
* const { signal } = makeProbe() // <- names no signal API
|
|
13
|
-
* </script>
|
|
14
|
-
* ```
|
|
15
|
-
*
|
|
16
|
-
* With no match, the page is treated as static: `{{ signal() }}` is evaluated
|
|
17
|
-
* server-side (undefined, so empty), no setup function is generated, and
|
|
18
|
-
* `<body>` gets no `data-stx` for the runtime to invoke. Nothing logs. The
|
|
19
|
-
* page renders its static half and every binding is inert, which reads as a
|
|
20
|
-
* data problem rather than a hydration one. stacksjs/stacks#2394.
|
|
21
|
-
*
|
|
22
|
-
* The bundler resolves this authoritatively, but it is async and expensive,
|
|
23
|
-
* and the gate that decides whether to preserve `{{ }}` for the client is
|
|
24
|
-
* synchronous and runs once per template, partial and component. So this walks
|
|
25
|
-
* the same edges the bundler would, cheaply: read the imported file, look for
|
|
26
|
-
* the same API calls, recurse a bounded distance.
|
|
27
|
-
*
|
|
28
|
-
* Deliberately a subset of what bundling sees - relative specifiers only, a
|
|
29
|
-
* few levels deep. Anything it misses is caught later by the async
|
|
30
|
-
* bundle-and-retest in signal-processing.ts, which can only ever be MORE
|
|
31
|
-
* permissive. The reverse (a gate that says signals where the setup pass finds
|
|
32
|
-
* none) would leave a literal mustache on the page, so the two must lean this
|
|
33
|
-
* way round.
|
|
34
|
-
*
|
|
35
|
-
* @module imported-signals
|
|
36
|
-
*/
|
|
37
1
|
/**
|
|
38
2
|
* Whether `script` declares signals somewhere in the modules it imports.
|
|
39
3
|
*
|
package/dist/includes.d.ts
CHANGED
|
@@ -1,71 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Includes Module
|
|
3
|
-
*
|
|
4
|
-
* Processes include, partial, and stack directives for template composition.
|
|
5
|
-
* This module enables building complex templates from reusable pieces.
|
|
6
|
-
*
|
|
7
|
-
* ## Include Directives
|
|
8
|
-
*
|
|
9
|
-
* | Directive | Description |
|
|
10
|
-
* |-----------|-------------|
|
|
11
|
-
* | `@include('path')` | Include a partial template |
|
|
12
|
-
* | `@include('path', { vars })` | Include with local variables |
|
|
13
|
-
* | `@partial('path')` | Alias for @include |
|
|
14
|
-
* | `@includeIf('path')` | Include only if file exists |
|
|
15
|
-
* | `@includeWhen(cond, 'path')` | Include if condition is true |
|
|
16
|
-
* | `@includeUnless(cond, 'path')` | Include if condition is false |
|
|
17
|
-
* | `@includeFirst(['a','b'])` | Include first existing file |
|
|
18
|
-
* | `@once...@endonce` | Include content only once per request |
|
|
19
|
-
*
|
|
20
|
-
* ## Stack Directives
|
|
21
|
-
*
|
|
22
|
-
* | Directive | Description |
|
|
23
|
-
* |-----------|-------------|
|
|
24
|
-
* | `@push('name')...@endpush` | Add content to end of stack |
|
|
25
|
-
* | `@prepend('name')...@endprepend` | Add content to start of stack |
|
|
26
|
-
* | `@stack('name')` | Output stack contents |
|
|
27
|
-
*
|
|
28
|
-
* ## Path Resolution
|
|
29
|
-
*
|
|
30
|
-
* Paths are resolved in this order:
|
|
31
|
-
* 1. If path starts with `./` or `../`: Relative to current template
|
|
32
|
-
* 2. Otherwise: Relative to `partialsDir` (from config)
|
|
33
|
-
*
|
|
34
|
-
* Paths without `.stx` extension automatically get it appended.
|
|
35
|
-
*
|
|
36
|
-
* ## Security
|
|
37
|
-
*
|
|
38
|
-
* Path traversal attacks are blocked. Includes must resolve to:
|
|
39
|
-
* - The configured partials directory, OR
|
|
40
|
-
* - The directory containing the current template
|
|
41
|
-
*
|
|
42
|
-
* Uses safe evaluation for expression evaluation to prevent code injection.
|
|
43
|
-
*
|
|
44
|
-
* ## @once Directive
|
|
45
|
-
*
|
|
46
|
-
* The `@once` directive ensures content is only rendered once per request.
|
|
47
|
-
* This is useful for including scripts or styles that should not be duplicated.
|
|
48
|
-
*
|
|
49
|
-
* **Important**: In server environments, use request-scoped tracking:
|
|
50
|
-
*
|
|
51
|
-
* ```typescript
|
|
52
|
-
* // Option 1: Clear global store per request
|
|
53
|
-
* app.use((req, res, next) => {
|
|
54
|
-
* clearOnceStore()
|
|
55
|
-
* next()
|
|
56
|
-
* })
|
|
57
|
-
*
|
|
58
|
-
* // Option 2: Use request-scoped store (recommended)
|
|
59
|
-
* const context = {
|
|
60
|
-
* __onceStore: new Set<string>(),
|
|
61
|
-
* ...otherData
|
|
62
|
-
* }
|
|
63
|
-
* ```
|
|
64
|
-
*
|
|
65
|
-
* @module includes
|
|
66
|
-
*/
|
|
67
|
-
import type { StxOptions } from './types';
|
|
68
1
|
import { LRUCache } from './performance-utils';
|
|
2
|
+
import type { StxOptions } from './types';
|
|
69
3
|
/** Forget which partials were warned about, for tests. */
|
|
70
4
|
export declare function resetUnscopedSignalWarnings(): void;
|
|
71
5
|
/**
|
|
@@ -85,8 +19,6 @@ export declare function resetUnscopedSignalWarnings(): void;
|
|
|
85
19
|
* them is not read as markup.
|
|
86
20
|
*/
|
|
87
21
|
export declare function topLevelElements(html: string): string[];
|
|
88
|
-
export declare const partialsCache: LRUCache<string, string>;
|
|
89
|
-
export declare const onceStore: Set<string>;
|
|
90
22
|
/**
|
|
91
23
|
* Clear the @once store - useful for testing and resetting state
|
|
92
24
|
*
|
|
@@ -188,3 +120,8 @@ export declare function processStackPushDirectives(template: string, stacks: Rec
|
|
|
188
120
|
* ```
|
|
189
121
|
*/
|
|
190
122
|
export declare function processStackReplacements(template: string, stacks: Record<string, string[]>): string;
|
|
123
|
+
export declare const partialsCache: LRUCache<string, string>;
|
|
124
|
+
// Global store to track what has been included via @once
|
|
125
|
+
// WARNING: This persists across requests in long-running servers!
|
|
126
|
+
// Use clearOnceStore() at the start of each request, or use request-scoped tracking via context.__onceStore
|
|
127
|
+
export declare const onceStore: Set<string>;
|
package/dist/index.d.ts
CHANGED
|
@@ -17,6 +17,7 @@ export type {
|
|
|
17
17
|
PropValidationError,
|
|
18
18
|
PropValidationResult,
|
|
19
19
|
} from './props';
|
|
20
|
+
declare const __dtsx_default_export__: {};
|
|
20
21
|
// ============================================================
|
|
21
22
|
// STX Core Exports
|
|
22
23
|
// Note: Some modules have overlapping exports. If you need specific
|
|
@@ -392,4 +393,4 @@ export {
|
|
|
392
393
|
} from './props';
|
|
393
394
|
export { isMarkdownPath, type MarkdownRenderer, type MarkdownView, protectCodeBlocks, renderMarkdownView } from './markdown-view';
|
|
394
395
|
// Default export for the stx module
|
|
395
|
-
export default
|
|
396
|
+
export default __dtsx_default_export__;
|
package/dist/init.d.ts
CHANGED
|
@@ -4,27 +4,19 @@
|
|
|
4
4
|
export declare function initFile(fileName?: string, options?: InitOptions): Promise<boolean>;
|
|
5
5
|
/**
|
|
6
6
|
* Available template presets with descriptions
|
|
7
|
+
* @defaultValue
|
|
8
|
+
* ```ts
|
|
9
|
+
* {
|
|
10
|
+
* basic: { description: 'Simple page with script, style, and template sections' },
|
|
11
|
+
* component: { description: 'Reusable component with props and slots' },
|
|
12
|
+
* layout: { description: 'Layout template with sections and yields' },
|
|
13
|
+
* blog: { description: 'Blog post with frontmatter-style variables' },
|
|
14
|
+
* api: { description: 'API endpoint template with JSON response' },
|
|
15
|
+
* app: { description: 'Full app with stores and components' }
|
|
16
|
+
* }
|
|
17
|
+
* ```
|
|
7
18
|
*/
|
|
8
|
-
export declare const TEMPLATE_PRESETS: {
|
|
9
|
-
basic: {
|
|
10
|
-
description: 'Simple page with script, style, and template sections'
|
|
11
|
-
};
|
|
12
|
-
component: {
|
|
13
|
-
description: 'Reusable component with props and slots'
|
|
14
|
-
};
|
|
15
|
-
layout: {
|
|
16
|
-
description: 'Layout template with sections and yields'
|
|
17
|
-
};
|
|
18
|
-
blog: {
|
|
19
|
-
description: 'Blog post with frontmatter-style variables'
|
|
20
|
-
};
|
|
21
|
-
api: {
|
|
22
|
-
description: 'API endpoint template with JSON response'
|
|
23
|
-
};
|
|
24
|
-
app: {
|
|
25
|
-
description: 'Full app with stores and components'
|
|
26
|
-
}
|
|
27
|
-
};
|
|
19
|
+
export declare const TEMPLATE_PRESETS: Record<TemplatePreset, { description: string }>;
|
|
28
20
|
/**
|
|
29
21
|
* Options for initializing a new stx file
|
|
30
22
|
*/
|
|
@@ -1,15 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Internal markdown utilities to replace ts-md dependency
|
|
3
|
-
* Provides frontmatter parsing and markdown to HTML conversion
|
|
4
|
-
*/
|
|
5
|
-
export interface FrontmatterResult {
|
|
6
|
-
data: Record<string, unknown>;
|
|
7
|
-
content: string;
|
|
8
|
-
}
|
|
9
|
-
export interface MarkdownOptions {
|
|
10
|
-
gfm?: boolean;
|
|
11
|
-
breaks?: boolean;
|
|
12
|
-
}
|
|
13
1
|
/**
|
|
14
2
|
* Parse YAML frontmatter from markdown content
|
|
15
3
|
* Frontmatter is delimited by --- at the start of the file
|
|
@@ -20,3 +8,11 @@ export declare function parseFrontmatter(content: string): FrontmatterResult;
|
|
|
20
8
|
* Simple implementation that handles common markdown patterns
|
|
21
9
|
*/
|
|
22
10
|
export declare function parseMarkdown(content: string, options?: MarkdownOptions): string;
|
|
11
|
+
export declare interface FrontmatterResult {
|
|
12
|
+
data: Record<string, unknown>
|
|
13
|
+
content: string
|
|
14
|
+
}
|
|
15
|
+
export declare interface MarkdownOptions {
|
|
16
|
+
gfm?: boolean
|
|
17
|
+
breaks?: boolean
|
|
18
|
+
}
|
|
@@ -1,16 +1,3 @@
|
|
|
1
|
-
export interface AttributeInterpolationContext {
|
|
2
|
-
kind: 'attribute';
|
|
3
|
-
name: string;
|
|
4
|
-
quote: '"' | "'" | null;
|
|
5
|
-
valuePrefix: string;
|
|
6
|
-
}
|
|
7
|
-
export interface TagInterpolationContext {
|
|
8
|
-
kind: 'tag';
|
|
9
|
-
}
|
|
10
|
-
export interface TagNameInterpolationContext {
|
|
11
|
-
kind: 'tag-name';
|
|
12
|
-
}
|
|
13
|
-
export type HtmlInterpolationContext = AttributeInterpolationContext | TagInterpolationContext | TagNameInterpolationContext | null;
|
|
14
1
|
/**
|
|
15
2
|
* Classify the HTML position occupied by an interpolation.
|
|
16
3
|
*
|
|
@@ -21,7 +8,20 @@ export type HtmlInterpolationContext = AttributeInterpolationContext | TagInterp
|
|
|
21
8
|
* they simply have no leading `<tag` portion.
|
|
22
9
|
*/
|
|
23
10
|
export declare function classifyHtmlInterpolation(source: string, offset: number, attributeFragment?: boolean): HtmlInterpolationContext;
|
|
11
|
+
export declare interface AttributeInterpolationContext {
|
|
12
|
+
kind: 'attribute'
|
|
13
|
+
name: string
|
|
14
|
+
quote: '"' | "'" | null
|
|
15
|
+
valuePrefix: string
|
|
16
|
+
}
|
|
17
|
+
export declare interface TagInterpolationContext {
|
|
18
|
+
kind: 'tag'
|
|
19
|
+
}
|
|
20
|
+
export declare interface TagNameInterpolationContext {
|
|
21
|
+
kind: 'tag-name'
|
|
22
|
+
}
|
|
23
|
+
export type HtmlInterpolationContext = AttributeInterpolationContext | TagInterpolationContext | TagNameInterpolationContext | null;
|
|
24
24
|
export declare class UnsafeInterpolationContextError extends Error {
|
|
25
|
-
|
|
26
|
-
|
|
25
|
+
readonly attribute: string;
|
|
26
|
+
constructor(attribute: string, reason: string);
|
|
27
27
|
}
|