@stacksjs/stx 0.2.571 → 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-4ssg5xpq.js → chunk-fynh3bkq.js} +12 -2
- 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/bundle.js +11 -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/server-api.d.ts
CHANGED
|
@@ -1,22 +1,11 @@
|
|
|
1
1
|
import type { ApiHandlerContext } from './api-handler';
|
|
2
2
|
import type { ApiMethod } from './api-client';
|
|
3
|
-
export interface ServerApiOptions {
|
|
4
|
-
/** Relative to the project/config directory, not the template root. */
|
|
5
|
-
dir?: string;
|
|
6
|
-
}
|
|
7
|
-
export interface ServerApiRoute {
|
|
8
|
-
pattern: string;
|
|
9
|
-
method: ApiMethod;
|
|
10
|
-
/** Source file in dev; bundled file relative to outputDir in the manifest. */
|
|
11
|
-
filePath: string;
|
|
12
|
-
}
|
|
13
3
|
/** Only explicitly enabled callers scan server/api; discovery never executes user code. */
|
|
14
4
|
export declare function discoverServerApi(root: string, options?: ServerApiOptions): ServerApiRoute[];
|
|
15
5
|
/** The only generated imports are in a declaration file: no implementation enters a client graph. */
|
|
16
6
|
export declare function generateApiTypes(root: string, routes: ServerApiRoute[]): Promise<string>;
|
|
17
7
|
/** Bun bundles server code only, outside public/. Imported helpers are included. */
|
|
18
8
|
export declare function buildServerApi(root: string, outputDir: string, options?: ServerApiOptions): Promise<ServerApiRoute[]>;
|
|
19
|
-
type Handler = (request: Request, context: ApiHandlerContext) => unknown;
|
|
20
9
|
/** Shared dispatcher used by development, production and embedded hosts. */
|
|
21
10
|
export declare function createApiDispatcher(routes: ServerApiRoute[], load: (route: ServerApiRoute) => Promise<Handler>): (request: Request) => Promise<Response | null>;
|
|
22
11
|
export declare function productionApiDispatcher(outputDir: string, routes: ServerApiRoute[]): (request: Request) => Promise<Response | null>;
|
|
@@ -24,4 +13,12 @@ export declare function productionApiDispatcher(outputDir: string, routes: Serve
|
|
|
24
13
|
export declare function createServerApi(root: string, enabled: boolean | ServerApiOptions | undefined): Promise<(request: Request) => Promise<Response | null>>;
|
|
25
14
|
/** Never expose endpoint source through a server that also serves the project root. */
|
|
26
15
|
export declare function isServerApiSource(filePath: string, root: string, enabled: boolean | ServerApiOptions | undefined): boolean;
|
|
27
|
-
export {
|
|
16
|
+
export declare interface ServerApiOptions {
|
|
17
|
+
dir?: string
|
|
18
|
+
}
|
|
19
|
+
export declare interface ServerApiRoute {
|
|
20
|
+
pattern: string
|
|
21
|
+
method: ApiMethod
|
|
22
|
+
filePath: string
|
|
23
|
+
}
|
|
24
|
+
declare type Handler = (request: Request, context: ApiHandlerContext) => unknown;
|
|
@@ -1,24 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Server-Side Attribute Binding Resolution
|
|
3
|
-
*
|
|
4
|
-
* Resolves `:attr="expr"` bindings server-side when the expression can be
|
|
5
|
-
* evaluated in the server context. This allows Vue-style shorthand binding
|
|
6
|
-
* syntax to work in server-rendered templates without client-side JS.
|
|
7
|
-
*
|
|
8
|
-
* Supported patterns:
|
|
9
|
-
* - `:src="imageUrl"` → `src="https://example.com/image.png"`
|
|
10
|
-
* - `:href="link.url"` → `href="/about"`
|
|
11
|
-
* - `:class="isActive ? 'active' : ''"` → `class="active"`
|
|
12
|
-
* - `:class="{ active: isActive, hidden: !show }"` → `class="active"`
|
|
13
|
-
* - `:class="[baseClass, isActive && 'active']"` → `class="btn active"`
|
|
14
|
-
* - `:disabled="isLoading"` → `disabled` (boolean attributes)
|
|
15
|
-
* - `:id="'item-' + item.id"` → `id="item-42"`
|
|
16
|
-
*
|
|
17
|
-
* Bindings that can't be resolved server-side (e.g., referencing signals or
|
|
18
|
-
* undefined variables) are left intact for client-side processing.
|
|
19
|
-
*
|
|
20
|
-
* @module server-bindings
|
|
21
|
-
*/
|
|
22
1
|
/**
|
|
23
2
|
* Find reactive loop regions whose bindings belong to the browser scope.
|
|
24
3
|
*
|
|
@@ -36,11 +15,7 @@ export declare function reactiveLoopRanges(template: string): Array<[number, num
|
|
|
36
15
|
* A component tag inside one of these renders its slot in a separate pass,
|
|
37
16
|
* which needs the names to keep treating them as the loop's.
|
|
38
17
|
*/
|
|
39
|
-
export declare function reactiveLoopScopes(template: string): Array<{
|
|
40
|
-
start: number;
|
|
41
|
-
end: number;
|
|
42
|
-
names: string[];
|
|
43
|
-
}>;
|
|
18
|
+
export declare function reactiveLoopScopes(template: string): Array<{ start: number, end: number, names: string[] }>;
|
|
44
19
|
/**
|
|
45
20
|
* Process server-side `:attr="expr"` bindings in a template.
|
|
46
21
|
*
|
package/dist/server-data.d.ts
CHANGED
|
@@ -1,7 +1,3 @@
|
|
|
1
|
-
interface ServerDataScope {
|
|
2
|
-
pending: Map<string, Promise<unknown>>;
|
|
3
|
-
values: Map<string, unknown>;
|
|
4
|
-
}
|
|
5
1
|
/** @internal Shared by nested contexts, never by separate render requests. */
|
|
6
2
|
export declare function serverDataScope(context: Record<string, any>): ServerDataScope;
|
|
7
3
|
/** @internal Run server scripts with their render's data scope, including imports. */
|
|
@@ -14,4 +10,7 @@ export declare function withServerData<T>(context: Record<string, any>, run: ()
|
|
|
14
10
|
export declare function useServerData<T>(key: string, loader: () => T | Promise<T>): Promise<T>;
|
|
15
11
|
/** @internal Data-only tag: no executable serialization or script-breakout. */
|
|
16
12
|
export declare function serverDataTag(context: Record<string, any>): string;
|
|
17
|
-
|
|
13
|
+
declare interface ServerDataScope {
|
|
14
|
+
pending: Map<string, Promise<unknown>>
|
|
15
|
+
values: Map<string, unknown>
|
|
16
|
+
}
|
package/dist/sfc-template.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
export declare function isClientTemplateTag(openingTag: string): boolean;
|
|
2
|
+
export declare function findSfcTemplateBlock(source: string): SfcTemplateBlock | null;
|
|
1
3
|
/**
|
|
2
4
|
* Locate the explicit wrapper `<template>` in an STX single-file component.
|
|
3
5
|
*
|
|
@@ -6,12 +8,10 @@
|
|
|
6
8
|
* and must stay in the rendered body. Keeping this distinction in one scanner
|
|
7
9
|
* avoids subtle regex boundary bugs for punctuation-prefixed attributes.
|
|
8
10
|
*/
|
|
9
|
-
export interface SfcTemplateBlock {
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
11
|
+
export declare interface SfcTemplateBlock {
|
|
12
|
+
start: number
|
|
13
|
+
openEnd: number
|
|
14
|
+
closeStart: number
|
|
15
|
+
end: number
|
|
16
|
+
content: string
|
|
15
17
|
}
|
|
16
|
-
export declare function isClientTemplateTag(openingTag: string): boolean;
|
|
17
|
-
export declare function findSfcTemplateBlock(source: string): SfcTemplateBlock | null;
|
|
@@ -1,35 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Signal Processing Module
|
|
3
|
-
*
|
|
4
|
-
* Handles detection, conversion, and setup of STX signals in templates.
|
|
5
|
-
* Converts directive-style syntax (@if, @for) to attribute-style for the
|
|
6
|
-
* client-side signals runtime, and wraps signal scripts in setup functions.
|
|
7
|
-
*
|
|
8
|
-
* @module signal-processing
|
|
9
|
-
*/
|
|
10
1
|
import type { StxOptions } from './types';
|
|
11
|
-
/**
|
|
12
|
-
* Scan a template for `<script>` tags in browser order: each opening tag is
|
|
13
|
-
* closed by the **first** subsequent `</script>` (case-insensitive), and the
|
|
14
|
-
* scanner then continues from after that close tag. This matches how HTML
|
|
15
|
-
* parsers tokenize `<script>` as a RAWTEXT element — they don't re-scan the
|
|
16
|
-
* body for more `<script` openings.
|
|
17
|
-
*
|
|
18
|
-
* A plain regex like `/<script[^>]*>([\s\S]*?)<\/script>/g` doesn't give you
|
|
19
|
-
* this property: if a script body contains the literal text `<script client>`
|
|
20
|
-
* (e.g. inside a JS comment), the regex matches it as a fresh script tag,
|
|
21
|
-
* which breaks downstream TypeScript transpilation and directive parsing.
|
|
22
|
-
*
|
|
23
|
-
* `skipAttrs` lets callers drop tags whose attribute string contains certain
|
|
24
|
-
* patterns (e.g. `server`, `src=`, `data-stx-scoped`).
|
|
25
|
-
*/
|
|
26
|
-
export interface ScannedScriptTag {
|
|
27
|
-
readonly fullMatch: string;
|
|
28
|
-
readonly attrs: string;
|
|
29
|
-
readonly body: string;
|
|
30
|
-
readonly start: number;
|
|
31
|
-
readonly end: number;
|
|
32
|
-
}
|
|
33
2
|
/**
|
|
34
3
|
* Drop cached script scans.
|
|
35
4
|
*
|
|
@@ -39,22 +8,7 @@ export interface ScannedScriptTag {
|
|
|
39
8
|
* perform. It exists for callers that want a cold cache, such as tests.
|
|
40
9
|
*/
|
|
41
10
|
export declare function clearScriptScanCache(): void;
|
|
42
|
-
export declare function scanScriptTags(html: string, opts?: {
|
|
43
|
-
skipAttrs?: RegExp;
|
|
44
|
-
}): ScannedScriptTag[];
|
|
45
|
-
/**
|
|
46
|
-
* Parsed form of a loop expression (`@for` / `@foreach` argument).
|
|
47
|
-
*
|
|
48
|
-
* `style: 'as'` — "iterable as item" / "iterable as idx => item" / "iterable as (item, idx)"
|
|
49
|
-
* `style: 'in'` — "item in iterable" / "(item, idx) in iterable" / "item of iterable"
|
|
50
|
-
* `style: 'unknown'` — fell through all parsers; iterable is `null`
|
|
51
|
-
*/
|
|
52
|
-
export interface ParsedLoopExpression {
|
|
53
|
-
style: 'as' | 'in' | 'unknown';
|
|
54
|
-
iterable: string | null;
|
|
55
|
-
itemVar: string | null;
|
|
56
|
-
indexVar: string | null;
|
|
57
|
-
}
|
|
11
|
+
export declare function scanScriptTags(html: string, opts?: { skipAttrs?: RegExp }): ScannedScriptTag[];
|
|
58
12
|
/**
|
|
59
13
|
* Parse a loop argument — accepts every syntax stx supports at runtime.
|
|
60
14
|
*
|
|
@@ -176,12 +130,7 @@ export declare function preEvalLiteralReactiveIfs(template: string): string;
|
|
|
176
130
|
*/
|
|
177
131
|
export declare function convertServerLoopAttributesToDirectives(template: string, context?: Record<string, any>): string;
|
|
178
132
|
export declare function convertSignalLoopsToAttributes(template: string, context?: Record<string, any>): string;
|
|
179
|
-
export declare function processScriptSetup(template: string, filePath?: string, serverData?: Record<string, unknown>, options?: {
|
|
180
|
-
forceClientSetup?: boolean;
|
|
181
|
-
}): Promise<{
|
|
182
|
-
output: string;
|
|
183
|
-
setupCode: string | null;
|
|
184
|
-
}>;
|
|
133
|
+
export declare function processScriptSetup(template: string, filePath?: string, serverData?: Record<string, unknown>, options?: { forceClientSetup?: boolean }): Promise<{ output: string, setupCode: string | null }>;
|
|
185
134
|
/**
|
|
186
135
|
* Extract exported variable names from setup script.
|
|
187
136
|
* Returns variables that should be exposed to the template.
|
|
@@ -240,3 +189,38 @@ export declare function rewriteStxImportSpecifiers(specifiers: string): string;
|
|
|
240
189
|
* that scope's hydration on every page the partial appeared on.
|
|
241
190
|
*/
|
|
242
191
|
export declare function stripStxRuntimeImports(code: string): string;
|
|
192
|
+
/**
|
|
193
|
+
* Scan a template for `<script>` tags in browser order: each opening tag is
|
|
194
|
+
* closed by the **first** subsequent `</script>` (case-insensitive), and the
|
|
195
|
+
* scanner then continues from after that close tag. This matches how HTML
|
|
196
|
+
* parsers tokenize `<script>` as a RAWTEXT element — they don't re-scan the
|
|
197
|
+
* body for more `<script` openings.
|
|
198
|
+
*
|
|
199
|
+
* A plain regex like `/<script[^>]*>([\s\S]*?)<\/script>/g` doesn't give you
|
|
200
|
+
* this property: if a script body contains the literal text `<script client>`
|
|
201
|
+
* (e.g. inside a JS comment), the regex matches it as a fresh script tag,
|
|
202
|
+
* which breaks downstream TypeScript transpilation and directive parsing.
|
|
203
|
+
*
|
|
204
|
+
* `skipAttrs` lets callers drop tags whose attribute string contains certain
|
|
205
|
+
* patterns (e.g. `server`, `src=`, `data-stx-scoped`).
|
|
206
|
+
*/
|
|
207
|
+
export declare interface ScannedScriptTag {
|
|
208
|
+
readonly fullMatch: string
|
|
209
|
+
readonly attrs: string
|
|
210
|
+
readonly body: string
|
|
211
|
+
readonly start: number
|
|
212
|
+
readonly end: number
|
|
213
|
+
}
|
|
214
|
+
/**
|
|
215
|
+
* Parsed form of a loop expression (`@for` / `@foreach` argument).
|
|
216
|
+
*
|
|
217
|
+
* `style: 'as'` — "iterable as item" / "iterable as idx => item" / "iterable as (item, idx)"
|
|
218
|
+
* `style: 'in'` — "item in iterable" / "(item, idx) in iterable" / "item of iterable"
|
|
219
|
+
* `style: 'unknown'` — fell through all parsers; iterable is `null`
|
|
220
|
+
*/
|
|
221
|
+
export declare interface ParsedLoopExpression {
|
|
222
|
+
style: 'as' | 'in' | 'unknown'
|
|
223
|
+
iterable: string | null
|
|
224
|
+
itemVar: string | null
|
|
225
|
+
indexVar: string | null
|
|
226
|
+
}
|
package/dist/signals-api.d.ts
CHANGED
|
@@ -1,127 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Signals API — module-import path for reactive primitives.
|
|
3
|
-
* =============================================================
|
|
4
|
-
*
|
|
5
|
-
* This module exports `state`, `derived`, `effect`, `batch`, `untrack`,
|
|
6
|
-
* `peek`, `isSignal`, `isDerived`, `onMount`, `onDestroy` as standalone
|
|
7
|
-
* TypeScript functions. They have their own subscriber sets, effect
|
|
8
|
-
* tracking, and batching — fully self-contained reactivity.
|
|
9
|
-
*
|
|
10
|
-
* ## Why this exists alongside `signals.ts`
|
|
11
|
-
*
|
|
12
|
-
* stx ships TWO independent reactive implementations:
|
|
13
|
-
*
|
|
14
|
-
* 1. **This file (`signals-api.ts`)** — module-import path. Used by
|
|
15
|
-
* composables, stores, SSR/server code, and tests that import
|
|
16
|
-
* from `'@stacksjs/stx'` and run in Node (or browser) without
|
|
17
|
-
* going through the stx bundler.
|
|
18
|
-
*
|
|
19
|
-
* 2. **The runtime template literal in `signals.ts`** — generated as
|
|
20
|
-
* a JS string and injected into client pages. Owns its own
|
|
21
|
-
* subscribers; populates `window.stx.{state, derived, …}`.
|
|
22
|
-
*
|
|
23
|
-
* The stx bundler rewrites `<script client>` imports of these symbols
|
|
24
|
-
* to destructure from `window.stx`. So a `const count = state(0)` in a
|
|
25
|
-
* client script ends up using the runtime version (#2). The same call
|
|
26
|
-
* in an unbundled context — a composable test, an SSR helper — uses
|
|
27
|
-
* this file (#1).
|
|
28
|
-
*
|
|
29
|
-
* **Important**: signals created in one impl are invisible to the other.
|
|
30
|
-
* A `state()` returned by this module cannot be `.set()`-ed from inside
|
|
31
|
-
* a client page's `<script>` block (and vice versa). The two reactive
|
|
32
|
-
* worlds are disjoint by design — they exist because bundled and
|
|
33
|
-
* non-bundled contexts need different code-generation strategies.
|
|
34
|
-
*
|
|
35
|
-
* ## Parity contract
|
|
36
|
-
*
|
|
37
|
-
* Both implementations expose the same public surface and must behave
|
|
38
|
-
* equivalently. Pinned by `test/reactivity/dual-impl-parity.test.ts`,
|
|
39
|
-
* which executes the same suite against both. When parity drifts, fix
|
|
40
|
-
* the lagging side — don't update only one.
|
|
41
|
-
*
|
|
42
|
-
* See stacksjs/stx#1712 for the architectural rationale.
|
|
43
|
-
*
|
|
44
|
-
* @module signals-api
|
|
45
|
-
*/
|
|
46
|
-
/**
|
|
47
|
-
* ## The canonical set (stacksjs/stx#1885 asks 3 and 4)
|
|
48
|
-
*
|
|
49
|
-
* `state` / `derived` / `effect`, exported here, are the primitives to reach
|
|
50
|
-
* for. They are what the client runtime puts on `window.stx`, what a
|
|
51
|
-
* `<script client>` block sees as bare identifiers, and what stx's own
|
|
52
|
-
* composables and stores are written against — the only set that reads the
|
|
53
|
-
* same in a module, in a component, and in a template.
|
|
54
|
-
*
|
|
55
|
-
* `reactivity.ts` exports a Vue-shaped family beside them — `ref`, `reactive`,
|
|
56
|
-
* `computed`, `watch`, `watchEffect` — from the same package entry. Both are
|
|
57
|
-
* backed by one dependency tracker now (`reactive-tracking.ts`), so mixing
|
|
58
|
-
* them works; four of the six pairings used to be silently inert. They are
|
|
59
|
-
* kept for code ported from Vue, not recommended for new code.
|
|
60
|
-
*
|
|
61
|
-
* Note `ref()` returns a `.value` object while `state()` returns a callable
|
|
62
|
-
* signal, so the two are not interchangeable at the call site.
|
|
63
|
-
*/
|
|
64
|
-
/**
|
|
65
|
-
* A reactive state signal.
|
|
66
|
-
*
|
|
67
|
-
* Call it to read the value, use `.set()` to write, or `.update()` to transform.
|
|
68
|
-
*
|
|
69
|
-
* @example
|
|
70
|
-
* ```typescript
|
|
71
|
-
* const count = state(0)
|
|
72
|
-
* count() // Read: 0
|
|
73
|
-
* count.set(5) // Write: 5
|
|
74
|
-
* count.update(n => n + 1) // Update: 6
|
|
75
|
-
* ```
|
|
76
|
-
*/
|
|
77
|
-
export interface Signal<T> {
|
|
78
|
-
/** Read the current value */
|
|
79
|
-
(): T;
|
|
80
|
-
/** Vue-compatible value accessor */
|
|
81
|
-
value: T;
|
|
82
|
-
/** Set a new value */
|
|
83
|
-
set(value: T): void;
|
|
84
|
-
/** Update the value using a function */
|
|
85
|
-
update(fn: (current: T) => T): void;
|
|
86
|
-
/** Subscribe to changes (returns unsubscribe function) */
|
|
87
|
-
subscribe(callback: (value: T, prev: T) => void): () => void;
|
|
88
|
-
/** Internal marker */
|
|
89
|
-
readonly _isSignal: true;
|
|
90
|
-
}
|
|
91
|
-
/**
|
|
92
|
-
* A derived (computed) signal that automatically updates when dependencies change.
|
|
93
|
-
*
|
|
94
|
-
* @example
|
|
95
|
-
* ```typescript
|
|
96
|
-
* const doubled = derived(() => count() * 2)
|
|
97
|
-
* doubled() // Read the computed value
|
|
98
|
-
* ```
|
|
99
|
-
*/
|
|
100
|
-
export interface DerivedSignal<T> {
|
|
101
|
-
/** Read the current computed value */
|
|
102
|
-
(): T;
|
|
103
|
-
/** Vue-compatible read-only value accessor */
|
|
104
|
-
readonly value: T;
|
|
105
|
-
/** Internal marker */
|
|
106
|
-
readonly _isDerived: true;
|
|
107
|
-
}
|
|
108
|
-
/**
|
|
109
|
-
* Options for creating effects.
|
|
110
|
-
*/
|
|
111
|
-
export interface EffectOptions {
|
|
112
|
-
/** Run the effect immediately (default: true) */
|
|
113
|
-
immediate?: boolean;
|
|
114
|
-
/** Name for debugging */
|
|
115
|
-
name?: string;
|
|
116
|
-
}
|
|
117
|
-
/**
|
|
118
|
-
* Cleanup function returned by effects.
|
|
119
|
-
*/
|
|
120
|
-
export type CleanupFn = () => void;
|
|
121
|
-
/**
|
|
122
|
-
* Lifecycle hook callback.
|
|
123
|
-
*/
|
|
124
|
-
export type LifecycleCallback = () => void | CleanupFn | Promise<void>;
|
|
125
1
|
/**
|
|
126
2
|
* Creates a reactive state signal.
|
|
127
3
|
*
|
|
@@ -352,10 +228,7 @@ export declare function runDestroyCallbacks(): void;
|
|
|
352
228
|
* How many callbacks are queued. Exposed for tests and diagnostics — a queue
|
|
353
229
|
* that only ever grows is the shape of the defect above.
|
|
354
230
|
*/
|
|
355
|
-
export declare function pendingLifecycleCounts(): {
|
|
356
|
-
mount: number;
|
|
357
|
-
destroy: number;
|
|
358
|
-
};
|
|
231
|
+
export declare function pendingLifecycleCounts(): { mount: number, destroy: number };
|
|
359
232
|
/**
|
|
360
233
|
* Checks if a value is a signal.
|
|
361
234
|
*
|
|
@@ -416,13 +289,6 @@ export declare function untrack<T>(value: T | Signal<T> | DerivedSignal<T>): T;
|
|
|
416
289
|
* ```
|
|
417
290
|
*/
|
|
418
291
|
export declare function peek<T>(fn: () => T): T;
|
|
419
|
-
/**
|
|
420
|
-
* The function returned by {@link useOptimistic} to apply an optimistic update.
|
|
421
|
-
* Returns a `settle` function that removes this specific optimistic entry (call
|
|
422
|
-
* it to roll back, e.g. in a `catch`). If a `settleWhen` promise is passed, the
|
|
423
|
-
* entry is removed automatically when that promise settles (success or error).
|
|
424
|
-
*/
|
|
425
|
-
export type AddOptimistic<A> = (action: A, settleWhen?: PromiseLike<unknown>) => () => void;
|
|
426
292
|
/**
|
|
427
293
|
* React-19-style optimistic state, adapted to signals.
|
|
428
294
|
*
|
|
@@ -457,3 +323,60 @@ export type AddOptimistic<A> = (action: A, settleWhen?: PromiseLike<unknown>) =>
|
|
|
457
323
|
* @see stacksjs/stx#1742
|
|
458
324
|
*/
|
|
459
325
|
export declare function useOptimistic<T, A>(base: Signal<T> | DerivedSignal<T> | (() => T) | T, reducer: (current: T, action: A) => T): [DerivedSignal<T>, AddOptimistic<A>];
|
|
326
|
+
/**
|
|
327
|
+
* A reactive state signal.
|
|
328
|
+
*
|
|
329
|
+
* Call it to read the value, use `.set()` to write, or `.update()` to transform.
|
|
330
|
+
*
|
|
331
|
+
* @example
|
|
332
|
+
* ```typescript
|
|
333
|
+
* const count = state(0)
|
|
334
|
+
* count() // Read: 0
|
|
335
|
+
* count.set(5) // Write: 5
|
|
336
|
+
* count.update(n => n + 1) // Update: 6
|
|
337
|
+
* ```
|
|
338
|
+
*/
|
|
339
|
+
export declare interface Signal<T> {
|
|
340
|
+
(): T
|
|
341
|
+
value: T
|
|
342
|
+
set(value: T): void
|
|
343
|
+
update(fn: (current: T) => T): void
|
|
344
|
+
subscribe(callback: (value: T, prev: T) => void): () => void
|
|
345
|
+
readonly _isSignal: true
|
|
346
|
+
}
|
|
347
|
+
/**
|
|
348
|
+
* A derived (computed) signal that automatically updates when dependencies change.
|
|
349
|
+
*
|
|
350
|
+
* @example
|
|
351
|
+
* ```typescript
|
|
352
|
+
* const doubled = derived(() => count() * 2)
|
|
353
|
+
* doubled() // Read the computed value
|
|
354
|
+
* ```
|
|
355
|
+
*/
|
|
356
|
+
export declare interface DerivedSignal<T> {
|
|
357
|
+
(): T
|
|
358
|
+
readonly value: T
|
|
359
|
+
readonly _isDerived: true
|
|
360
|
+
}
|
|
361
|
+
/**
|
|
362
|
+
* Options for creating effects.
|
|
363
|
+
*/
|
|
364
|
+
export declare interface EffectOptions {
|
|
365
|
+
immediate?: boolean
|
|
366
|
+
name?: string
|
|
367
|
+
}
|
|
368
|
+
/**
|
|
369
|
+
* Cleanup function returned by effects.
|
|
370
|
+
*/
|
|
371
|
+
export type CleanupFn = () => void;
|
|
372
|
+
/**
|
|
373
|
+
* Lifecycle hook callback.
|
|
374
|
+
*/
|
|
375
|
+
export type LifecycleCallback = () => void | CleanupFn | Promise<void>;
|
|
376
|
+
/**
|
|
377
|
+
* The function returned by {@link useOptimistic} to apply an optimistic update.
|
|
378
|
+
* Returns a `settle` function that removes this specific optimistic entry (call
|
|
379
|
+
* it to roll back, e.g. in a `catch`). If a `settleWhen` promise is passed, the
|
|
380
|
+
* entry is removed automatically when that promise settles (success or error).
|
|
381
|
+
*/
|
|
382
|
+
export type AddOptimistic<A> = (action: A, settleWhen?: PromiseLike<unknown>) => () => void;
|
package/dist/signals.d.ts
CHANGED
|
@@ -1,14 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Signals - Reactive State Management
|
|
3
|
-
* =========================================
|
|
4
|
-
*
|
|
5
|
-
* This module re-exports the build-time signals API from signals-api.ts
|
|
6
|
-
* and provides the client runtime string generators.
|
|
7
|
-
*
|
|
8
|
-
* @module signals
|
|
9
|
-
*/
|
|
10
1
|
import { state, derived, effect, batch, onMount, onDestroy, isSignal, isDerived, untrack, peek } from './signals-api';
|
|
11
|
-
export * from './signals-api';
|
|
12
2
|
/**
|
|
13
3
|
* Generates the browser runtime for STX signals.
|
|
14
4
|
*
|
|
@@ -24,18 +14,22 @@ export declare function generateSignalsRuntime(): string;
|
|
|
24
14
|
* @returns Human-readable JavaScript runtime code
|
|
25
15
|
*/
|
|
26
16
|
export declare function generateSignalsRuntimeDev(): string;
|
|
27
|
-
declare const
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
17
|
+
declare const __dtsx_default_export__: {
|
|
18
|
+
state: typeof state;
|
|
19
|
+
derived: typeof derived;
|
|
20
|
+
effect: typeof effect;
|
|
21
|
+
batch: typeof batch;
|
|
22
|
+
onMount: typeof onMount;
|
|
23
|
+
onDestroy: typeof onDestroy;
|
|
24
|
+
isSignal: typeof isSignal;
|
|
25
|
+
isDerived: typeof isDerived;
|
|
26
|
+
untrack: typeof untrack;
|
|
27
|
+
peek: typeof peek;
|
|
28
|
+
generateSignalsRuntime: typeof generateSignalsRuntime;
|
|
29
|
+
generateSignalsRuntimeDev: typeof generateSignalsRuntimeDev
|
|
40
30
|
};
|
|
41
|
-
export
|
|
31
|
+
export * from './signals-api';
|
|
32
|
+
// =============================================================================
|
|
33
|
+
// Default Export
|
|
34
|
+
// =============================================================================
|
|
35
|
+
export default __dtsx_default_export__;
|
package/dist/site-url.d.ts
CHANGED
|
@@ -1,3 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Resolve the canonical site URL, reporting where it came from so the caller
|
|
3
|
+
* can warn when it had to fall back.
|
|
4
|
+
*
|
|
5
|
+
* Order is explicit-option, then app config, then deploy env, then localhost.
|
|
6
|
+
*/
|
|
7
|
+
export declare function resolveSiteUrl(options?: {
|
|
8
|
+
explicit?: string
|
|
9
|
+
stxConfig?: unknown
|
|
10
|
+
cwd?: string
|
|
11
|
+
env?: Record<string, string | undefined>
|
|
12
|
+
}): Promise<ResolvedSiteUrl>;
|
|
13
|
+
/**
|
|
14
|
+
* The warning shown when a build produced localhost URLs.
|
|
15
|
+
*
|
|
16
|
+
* Loud, and it names the fix — a sitemap full of `http://localhost` is not
|
|
17
|
+
* something anyone notices by reading build output.
|
|
18
|
+
*/
|
|
19
|
+
export declare function siteUrlFallbackWarning(): string;
|
|
20
|
+
/** Last resort. Deliberately not a real domain, so it is obvious in output. */
|
|
21
|
+
export declare const SITE_URL_FALLBACK: 'http://localhost';
|
|
22
|
+
export declare interface ResolvedSiteUrl {
|
|
23
|
+
url: string
|
|
24
|
+
source: SiteUrlSource
|
|
25
|
+
via?: string
|
|
26
|
+
}
|
|
1
27
|
/**
|
|
2
28
|
* Where the canonical site URL comes from.
|
|
3
29
|
*
|
|
@@ -16,31 +42,8 @@
|
|
|
16
42
|
* @module site-url
|
|
17
43
|
*/
|
|
18
44
|
/** Where a resolved URL came from, for diagnostics. */
|
|
19
|
-
export type SiteUrlSource =
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
via?: string;
|
|
25
|
-
}
|
|
26
|
-
/** Last resort. Deliberately not a real domain, so it is obvious in output. */
|
|
27
|
-
export declare const SITE_URL_FALLBACK = "http://localhost";
|
|
28
|
-
/**
|
|
29
|
-
* Resolve the canonical site URL, reporting where it came from so the caller
|
|
30
|
-
* can warn when it had to fall back.
|
|
31
|
-
*
|
|
32
|
-
* Order is explicit-option, then app config, then deploy env, then localhost.
|
|
33
|
-
*/
|
|
34
|
-
export declare function resolveSiteUrl(options?: {
|
|
35
|
-
explicit?: string;
|
|
36
|
-
stxConfig?: unknown;
|
|
37
|
-
cwd?: string;
|
|
38
|
-
env?: Record<string, string | undefined>;
|
|
39
|
-
}): Promise<ResolvedSiteUrl>;
|
|
40
|
-
/**
|
|
41
|
-
* The warning shown when a build produced localhost URLs.
|
|
42
|
-
*
|
|
43
|
-
* Loud, and it names the fix — a sitemap full of `http://localhost` is not
|
|
44
|
-
* something anyone notices by reading build output.
|
|
45
|
-
*/
|
|
46
|
-
export declare function siteUrlFallbackWarning(): string;
|
|
45
|
+
export type SiteUrlSource = | 'option'
|
|
46
|
+
| 'stx.config'
|
|
47
|
+
| 'site.config'
|
|
48
|
+
| 'env'
|
|
49
|
+
| 'fallback';
|
package/dist/slots.d.ts
CHANGED
|
@@ -1,84 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Slots Module
|
|
3
|
-
*
|
|
4
|
-
* Provides Vue-style named slots and scoped slots support.
|
|
5
|
-
*
|
|
6
|
-
* @module slots
|
|
7
|
-
*
|
|
8
|
-
* ## Named Slots
|
|
9
|
-
*
|
|
10
|
-
* Parent component:
|
|
11
|
-
* ```html
|
|
12
|
-
* <Card>
|
|
13
|
-
* <template #header>
|
|
14
|
-
* <h1>Title</h1>
|
|
15
|
-
* </template>
|
|
16
|
-
*
|
|
17
|
-
* <p>Default slot content</p>
|
|
18
|
-
*
|
|
19
|
-
* <template #footer>
|
|
20
|
-
* <button>Submit</button>
|
|
21
|
-
* </template>
|
|
22
|
-
* </Card>
|
|
23
|
-
* ```
|
|
24
|
-
*
|
|
25
|
-
* Child component (Card.stx):
|
|
26
|
-
* ```html
|
|
27
|
-
* <div class="card">
|
|
28
|
-
* <header>
|
|
29
|
-
* <slot name="header">Default Header</slot>
|
|
30
|
-
* </header>
|
|
31
|
-
* <main>
|
|
32
|
-
* <slot />
|
|
33
|
-
* </main>
|
|
34
|
-
* <footer>
|
|
35
|
-
* <slot name="footer" />
|
|
36
|
-
* </footer>
|
|
37
|
-
* </div>
|
|
38
|
-
* ```
|
|
39
|
-
*
|
|
40
|
-
* ## Scoped Slots
|
|
41
|
-
*
|
|
42
|
-
* Parent component:
|
|
43
|
-
* ```html
|
|
44
|
-
* <DataTable :items="users">
|
|
45
|
-
* <template #row="{ item, index }">
|
|
46
|
-
* <td>{{ index + 1 }}</td>
|
|
47
|
-
* <td>{{ item.name }}</td>
|
|
48
|
-
* </template>
|
|
49
|
-
* </DataTable>
|
|
50
|
-
* ```
|
|
51
|
-
*
|
|
52
|
-
* Child component (DataTable.stx):
|
|
53
|
-
* ```html
|
|
54
|
-
* <table>
|
|
55
|
-
* @foreach (items as item, index)
|
|
56
|
-
* <tr>
|
|
57
|
-
* <slot name="row" :item="item" :index="index">
|
|
58
|
-
* <td>{{ item }}</td>
|
|
59
|
-
* </slot>
|
|
60
|
-
* </tr>
|
|
61
|
-
* @endforeach
|
|
62
|
-
* </table>
|
|
63
|
-
* ```
|
|
64
|
-
*/
|
|
65
|
-
export interface SlotDefinition {
|
|
66
|
-
/** Slot name (empty string for default slot) */
|
|
67
|
-
name: string;
|
|
68
|
-
/** Slot content (the template) */
|
|
69
|
-
content: string;
|
|
70
|
-
/** Scoped slot props binding (e.g., "{ item, index }") */
|
|
71
|
-
propsBinding?: string;
|
|
72
|
-
}
|
|
73
|
-
export interface SlotProps {
|
|
74
|
-
[key: string]: unknown;
|
|
75
|
-
}
|
|
76
|
-
export interface ParsedSlots {
|
|
77
|
-
/** Default slot content */
|
|
78
|
-
default: string;
|
|
79
|
-
/** Named slots */
|
|
80
|
-
named: Map<string, SlotDefinition>;
|
|
81
|
-
}
|
|
82
1
|
/**
|
|
83
2
|
* Parse slot content from component children.
|
|
84
3
|
*
|
|
@@ -95,9 +14,9 @@ export declare function parseSlots(childContent: string): ParsedSlots;
|
|
|
95
14
|
* Returns: { name: 'row', props: { item: 'item', index: 'index' } }
|
|
96
15
|
*/
|
|
97
16
|
export declare function parseSlotElement(slotTag: string): {
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
17
|
+
name: string
|
|
18
|
+
props: Record<string, string>
|
|
19
|
+
defaultContent: string
|
|
101
20
|
};
|
|
102
21
|
/**
|
|
103
22
|
* Render a slot with its content and props.
|
|
@@ -119,11 +38,26 @@ export declare function processSlots(template: string, parsedSlots: ParsedSlots,
|
|
|
119
38
|
* This is called when processing a component to separate slot content.
|
|
120
39
|
*/
|
|
121
40
|
export declare function extractSlotContent(childContent: string): {
|
|
122
|
-
|
|
123
|
-
|
|
41
|
+
defaultSlot: string
|
|
42
|
+
namedSlots: Map<string, SlotDefinition>
|
|
124
43
|
};
|
|
125
44
|
/**
|
|
126
45
|
* Apply slots to a component template.
|
|
127
46
|
* This replaces <slot> elements with the provided slot content.
|
|
128
47
|
*/
|
|
129
48
|
export declare function applySlots(componentTemplate: string, defaultSlotContent: string, namedSlots: Map<string, SlotDefinition>, context: Record<string, unknown>): Promise<string>;
|
|
49
|
+
// =============================================================================
|
|
50
|
+
// Types
|
|
51
|
+
// =============================================================================
|
|
52
|
+
export declare interface SlotDefinition {
|
|
53
|
+
name: string
|
|
54
|
+
content: string
|
|
55
|
+
propsBinding?: string
|
|
56
|
+
}
|
|
57
|
+
export declare interface SlotProps {
|
|
58
|
+
[key: string]: unknown
|
|
59
|
+
}
|
|
60
|
+
export declare interface ParsedSlots {
|
|
61
|
+
default: string
|
|
62
|
+
named: Map<string, SlotDefinition>
|
|
63
|
+
}
|