@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
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import type { ImageDeliveryManifest } from 'ts-images/delivery';
|
|
2
1
|
import { webpHeaderHasAlpha } from './image-alpha';
|
|
3
|
-
|
|
2
|
+
import type { ImageDeliveryManifest } from 'ts-images/delivery';
|
|
4
3
|
/**
|
|
5
4
|
* Which encoders this process writes variants with, e.g.
|
|
6
5
|
* `ts-webp@0.1.6+ts-avif@0.1.4`. Resolved the way ts-images resolves them,
|
|
@@ -15,6 +14,7 @@ export { webpHeaderHasAlpha };
|
|
|
15
14
|
*/
|
|
16
15
|
export declare function setImageEncoderIdentity(identity?: string): void;
|
|
17
16
|
export declare function imageEncoderIdentity(): string;
|
|
17
|
+
declare function collectRasterImages(root: string, directory?: unknown): Promise<Array<{ absolutePath: string, relativePath: string }>>;
|
|
18
18
|
/** Return build-time delivery metadata for one public image URL. */
|
|
19
19
|
export declare function getImageDelivery(src: string): ImageDeliveryManifest | undefined;
|
|
20
20
|
/**
|
|
@@ -32,26 +32,7 @@ export declare function isTransparentImage(src: string): boolean;
|
|
|
32
32
|
* first supported `<source>`, so any family that costs at least as much as the
|
|
33
33
|
* fallback is left out.
|
|
34
34
|
*/
|
|
35
|
-
export declare function efficientDeliverySources(delivery: ImageDeliveryManifest): Array<{
|
|
36
|
-
format: 'avif' | 'webp';
|
|
37
|
-
srcset: string;
|
|
38
|
-
}>;
|
|
39
|
-
/** What a component needs to render one delivered image. */
|
|
40
|
-
export interface DeliveredImage {
|
|
41
|
-
/** The fallback variant's URL, for `<img src>`. */
|
|
42
|
-
src: string;
|
|
43
|
-
/** The fallback format at every width, for `<img srcset>`. */
|
|
44
|
-
srcset: string;
|
|
45
|
-
/** `<source>` elements to put ahead of the `<img>`, smallest family first. */
|
|
46
|
-
sources: Array<{
|
|
47
|
-
type: string;
|
|
48
|
-
srcset: string;
|
|
49
|
-
}>;
|
|
50
|
-
width: number;
|
|
51
|
-
height: number;
|
|
52
|
-
/** A data URL of the image's own preview, absent for a transparent image. */
|
|
53
|
-
placeholder?: string;
|
|
54
|
-
}
|
|
35
|
+
export declare function efficientDeliverySources(delivery: ImageDeliveryManifest): Array<{ format: 'avif' | 'webp', srcset: string }>;
|
|
55
36
|
/**
|
|
56
37
|
* The optimized variants of a public image, ready for markup.
|
|
57
38
|
*
|
|
@@ -64,24 +45,10 @@ export interface DeliveredImage {
|
|
|
64
45
|
export declare function deliveredImage(src: string): DeliveredImage | undefined;
|
|
65
46
|
/** Clear process-global delivery state between builds and tests. */
|
|
66
47
|
export declare function clearImageDeliveryCatalog(): void;
|
|
67
|
-
/** The catalog as plain data, for a worker to post back to the thread that serves. */
|
|
68
|
-
export interface ImageDeliverySnapshot {
|
|
69
|
-
entries: Array<[string, ImageDeliveryManifest]>;
|
|
70
|
-
transparent: string[];
|
|
71
|
-
}
|
|
72
48
|
/** What this thread's catalog holds, in a form `postMessage` can carry. */
|
|
73
49
|
export declare function snapshotImageDelivery(): ImageDeliverySnapshot;
|
|
74
50
|
/** Swap in a catalog built elsewhere, whole, as the in-thread pass does. */
|
|
75
51
|
export declare function installImageDelivery(snapshot: ImageDeliverySnapshot): void;
|
|
76
|
-
export interface PrepareImageDeliveryOptions {
|
|
77
|
-
/**
|
|
78
|
-
* Decode and encode on a worker thread, and install the finished catalog
|
|
79
|
-
* here. For a long-lived server, whose event loop has requests to answer
|
|
80
|
-
* while a cold cache re-encodes every raster. Same files, same names, same
|
|
81
|
-
* catalog; falls back to running in-thread where no worker can start.
|
|
82
|
-
*/
|
|
83
|
-
offThread?: boolean;
|
|
84
|
-
}
|
|
85
52
|
/**
|
|
86
53
|
* Optimize every raster in the public directory before templates render.
|
|
87
54
|
*
|
|
@@ -89,7 +56,38 @@ export interface PrepareImageDeliveryOptions {
|
|
|
89
56
|
* catalog. Its content fingerprint is folded into the SSG cache key to ensure
|
|
90
57
|
* changing image bytes can never reuse HTML pointing at an older asset hash.
|
|
91
58
|
*/
|
|
92
|
-
export declare function prepareImageDelivery(publicDir: string, outputDir: string, options?: PrepareImageDeliveryOptions): Promise<{
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
59
|
+
export declare function prepareImageDelivery(publicDir: string, outputDir: string, options?: PrepareImageDeliveryOptions): Promise<{ count: number, fingerprint: string }>;
|
|
60
|
+
/**
|
|
61
|
+
* Rasters that could not be decoded last time, by path and stat identity.
|
|
62
|
+
*
|
|
63
|
+
* A single corrupt file makes `createImageDeliveryCatalog` reject the whole
|
|
64
|
+
* batch, and the recovery below costs a full decode of every file plus a
|
|
65
|
+
* second catalog build. Nothing about that changes on the next boot — the file
|
|
66
|
+
* is still corrupt — so without a record the server pays it forever. This is
|
|
67
|
+
* that record: the next boot filters the known-bad out before the first
|
|
68
|
+
* attempt and takes the single-pass path.
|
|
69
|
+
*
|
|
70
|
+
* Keyed by mtime and size like the placeholder cache, so replacing a bad file
|
|
71
|
+
* with a good one retries it.
|
|
72
|
+
*/
|
|
73
|
+
declare interface UndecodableRecord { mtimeMs: number, size: number }
|
|
74
|
+
/** What a component needs to render one delivered image. */
|
|
75
|
+
export declare interface DeliveredImage {
|
|
76
|
+
src: string
|
|
77
|
+
srcset: string
|
|
78
|
+
sources: Array<{ type: string, srcset: string }>
|
|
79
|
+
width: number
|
|
80
|
+
height: number
|
|
81
|
+
placeholder?: string
|
|
82
|
+
}
|
|
83
|
+
/** The catalog as plain data, for a worker to post back to the thread that serves. */
|
|
84
|
+
export declare interface ImageDeliverySnapshot {
|
|
85
|
+
entries: Array<[string, ImageDeliveryManifest]>
|
|
86
|
+
transparent: string[]
|
|
87
|
+
}
|
|
88
|
+
export declare interface PrepareImageDeliveryOptions {
|
|
89
|
+
offThread?: boolean
|
|
90
|
+
}
|
|
91
|
+
declare type RasterFile = Awaited<ReturnType<typeof collectRasterImages>>[number];
|
|
92
|
+
declare type UndecodableCache = Record<string, UndecodableRecord>;
|
|
93
|
+
export { webpHeaderHasAlpha };
|
|
@@ -1,38 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Real placeholders for `<StxImage>`, derived from the image's own pixels.
|
|
3
|
-
*
|
|
4
|
-
* `placeholder="blur"` used to render a flat grey rectangle — the same one for
|
|
5
|
-
* every image on the page, because the component had no way to look at the file
|
|
6
|
-
* it was pointing at. It renders synchronously; reading and decoding a JPEG does
|
|
7
|
-
* not. So the work moves earlier: the build warms a cache from disk, and the
|
|
8
|
-
* component reads it with a synchronous lookup.
|
|
9
|
-
*
|
|
10
|
-
* What lands in the HTML is a thumbhash (evanw/thumbhash) rendered as a blurred
|
|
11
|
-
* SVG mesh, with the image's average colour painted underneath it. Both are
|
|
12
|
-
* inline, so there is no second request and nothing to wait for — and no
|
|
13
|
-
* JavaScript, which is the point. A placeholder that needs a script has already
|
|
14
|
-
* lost to the image it was supposed to cover for.
|
|
15
|
-
*
|
|
16
|
-
* Size was the deciding constraint. thumbhash's own 32×32 PNG is ~4.2KB per
|
|
17
|
-
* image; nine of those roughly doubles a page here. The mesh below carries the
|
|
18
|
-
* same information as twelve colours and gzips against its neighbours, because
|
|
19
|
-
* every one of them is the same markup with different hex — about 480 bytes for
|
|
20
|
-
* nine images, against 3.3KB for the PNGs.
|
|
21
|
-
*
|
|
22
|
-
* @module builtins/image-placeholder
|
|
23
|
-
*/
|
|
24
|
-
/** A placeholder ready to be dropped into markup. */
|
|
25
|
-
export interface ImagePlaceholder {
|
|
26
|
-
/** `data:image/svg+xml;base64,…` — the blurred mesh. */
|
|
27
|
-
dataUrl: string;
|
|
28
|
-
/** `#rrggbb` average, painted under the mesh and used alone as a fallback. */
|
|
29
|
-
color: string;
|
|
30
|
-
/**
|
|
31
|
-
* The image has transparent pixels. A placeholder painted behind it would
|
|
32
|
-
* show through for as long as it stayed, so the component renders none.
|
|
33
|
-
*/
|
|
34
|
-
transparent?: boolean;
|
|
35
|
-
}
|
|
36
1
|
/**
|
|
37
2
|
* The placeholder for `src`, or undefined when there is none.
|
|
38
3
|
*
|
|
@@ -64,21 +29,6 @@ export declare function setImagePlaceholder(urlPath: string, placeholder: ImageP
|
|
|
64
29
|
export declare function meshSvg(rgba: Uint8Array | Uint8ClampedArray | number[], width: number, height: number, cols?: number, rows?: number): string;
|
|
65
30
|
/** Base64 rather than percent-encoding: the same SVG, roughly 400 bytes shorter. */
|
|
66
31
|
export declare function svgDataUrl(svg: string): string;
|
|
67
|
-
export interface WarmOptions {
|
|
68
|
-
/** Where the on-disk cache lives. Omit to recompute every build. */
|
|
69
|
-
cachePath?: string;
|
|
70
|
-
/** Skip files larger than this. Decoding a 40MB source costs more than it returns. */
|
|
71
|
-
maxBytes?: number;
|
|
72
|
-
/** Stop after this many images, so an enormous asset tree cannot stall a build. */
|
|
73
|
-
limit?: number;
|
|
74
|
-
/**
|
|
75
|
-
* Decode on a worker thread and merge the results here. For a long-lived
|
|
76
|
-
* server, whose event loop has requests to answer while a cold cache
|
|
77
|
-
* decodes every image. Same placeholders, same cache file; falls back to
|
|
78
|
-
* running in-thread where no worker can start.
|
|
79
|
-
*/
|
|
80
|
-
offThread?: boolean;
|
|
81
|
-
}
|
|
82
32
|
/**
|
|
83
33
|
* Derive placeholders for every image under `publicDir` and hold them for
|
|
84
34
|
* {@link getImagePlaceholder}.
|
|
@@ -90,3 +40,15 @@ export interface WarmOptions {
|
|
|
90
40
|
* Returns how many placeholders are available afterwards.
|
|
91
41
|
*/
|
|
92
42
|
export declare function warmImagePlaceholders(publicDir: string, options?: WarmOptions): Promise<number>;
|
|
43
|
+
/** A placeholder ready to be dropped into markup. */
|
|
44
|
+
export declare interface ImagePlaceholder {
|
|
45
|
+
dataUrl: string
|
|
46
|
+
color: string
|
|
47
|
+
transparent?: boolean
|
|
48
|
+
}
|
|
49
|
+
export declare interface WarmOptions {
|
|
50
|
+
cachePath?: string
|
|
51
|
+
maxBytes?: number
|
|
52
|
+
limit?: number
|
|
53
|
+
offThread?: boolean
|
|
54
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
export {};
|
|
@@ -1,33 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Runs the image pass on a worker thread.
|
|
3
|
-
*
|
|
4
|
-
* Decoding and encoding (AVIF, WebP, thumbhash) is pure TypeScript and fully
|
|
5
|
-
* synchronous per image. On the thread that also answers requests, a cold pass
|
|
6
|
-
* over a photo-heavy `public/` held the event loop for most of its minutes:
|
|
7
|
-
* every `await` a render made queued behind the next encode, so a first page
|
|
8
|
-
* took 14-18s and a proxy in front of the server saw empty responses. On a
|
|
9
|
-
* worker the same code runs to the same results, and the serving thread only
|
|
10
|
-
* receives the finished catalog.
|
|
11
|
-
*
|
|
12
|
-
* The worker is the mechanism, not a requirement. Where one cannot start (no
|
|
13
|
-
* entry file beside a bundled copy and no installed one to fall back on, or a
|
|
14
|
-
* worker that dies before it is ready), {@link runImageTask} reports that, the
|
|
15
|
-
* caller runs the pass in-thread exactly as before, and one warning says why.
|
|
16
|
-
*
|
|
17
|
-
* The thread comes from `node:worker_threads`, never the global `Worker`. The
|
|
18
|
-
* global is whatever the app left on `globalThis`, and a Stacks app's preloader
|
|
19
|
-
* copies `@stacksjs/queue`'s exports there, including a queue `Worker` class.
|
|
20
|
-
* `new Worker(entry)` then built a queue worker, the first `addEventListener`
|
|
21
|
-
* threw, and the pass failed before a single image was touched. A module
|
|
22
|
-
* import cannot be replaced that way. In Bun both constructors start the same
|
|
23
|
-
* thread with the same structured clone, so the results are unchanged.
|
|
24
|
-
*
|
|
25
|
-
* @module builtins/image-worker
|
|
26
|
-
*/
|
|
27
|
-
/** Tasks the worker entry knows how to run. */
|
|
28
|
-
export type ImageTask = 'delivery' | 'placeholders';
|
|
29
|
-
/** Returned instead of a result when no worker could be started. */
|
|
30
|
-
export declare const WORKER_UNAVAILABLE: unique symbol;
|
|
31
1
|
/**
|
|
32
2
|
* How many image workers may run at once.
|
|
33
3
|
*
|
|
@@ -36,7 +6,7 @@ export declare const WORKER_UNAVAILABLE: unique symbol;
|
|
|
36
6
|
* Two at most: the passes are the only callers, and a third would have
|
|
37
7
|
* nothing to do.
|
|
38
8
|
*/
|
|
39
|
-
export declare function imageWorkerSlots(cores?:
|
|
9
|
+
export declare function imageWorkerSlots(cores?: unknown): number;
|
|
40
10
|
/**
|
|
41
11
|
* The worker entry to start.
|
|
42
12
|
*
|
|
@@ -50,7 +20,7 @@ export declare function imageWorkerSlots(cores?: number): number;
|
|
|
50
20
|
* install the bundle was built from is still on disk, though, so the entry is
|
|
51
21
|
* resolved from the app's root.
|
|
52
22
|
*/
|
|
53
|
-
export declare function imageWorkerEntry(root?:
|
|
23
|
+
export declare function imageWorkerEntry(root?: unknown): string | undefined;
|
|
54
24
|
/**
|
|
55
25
|
* Whether a resolved entry is the app's own install rather than a copy in
|
|
56
26
|
* Bun's global package cache.
|
|
@@ -79,3 +49,7 @@ export declare function resetImageWorkerWarning(): void;
|
|
|
79
49
|
* mid-pass is never silently re-run on the serving thread.
|
|
80
50
|
*/
|
|
81
51
|
export declare function runImageTask<T>(task: ImageTask, args: unknown): Promise<T | typeof WORKER_UNAVAILABLE>;
|
|
52
|
+
/** Returned instead of a result when no worker could be started. */
|
|
53
|
+
export declare const WORKER_UNAVAILABLE: unique symbol;
|
|
54
|
+
/** Tasks the worker entry knows how to run. */
|
|
55
|
+
export type ImageTask = 'delivery' | 'placeholders';
|
package/dist/builtins/index.d.ts
CHANGED
|
@@ -1,3 +1,19 @@
|
|
|
1
|
+
import { IconBuiltin } from './icon';
|
|
2
|
+
import { SafeImageBuiltin } from './safe-image';
|
|
3
|
+
import { StxDrawerBuiltin } from './drawer';
|
|
4
|
+
import { StxImageBuiltin } from './stx-image';
|
|
5
|
+
import { StxLinkBuiltin } from './stx-link';
|
|
6
|
+
import { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
|
|
7
|
+
import { StxModalBuiltin } from './modal';
|
|
8
|
+
import { StxToastBuiltin } from './toast';
|
|
9
|
+
import { SuspenseBuiltin } from './suspense';
|
|
10
|
+
import { TransitionGroupBuiltin } from './transition-group';
|
|
11
|
+
import type { ComponentRegistry } from '../component-registry';
|
|
12
|
+
/**
|
|
13
|
+
* Register all builtin components with the supplied registry, or with the
|
|
14
|
+
* package singleton when no target is supplied.
|
|
15
|
+
*/
|
|
16
|
+
export declare function registerBuiltins(target?: ComponentRegistry): void;
|
|
1
17
|
/**
|
|
2
18
|
* Builtin Components Barrel
|
|
3
19
|
*
|
|
@@ -18,9 +34,3 @@ export { IconBuiltin, preloadIconCollection } from './icon';
|
|
|
18
34
|
export { getTooltipRuntime } from './tooltip';
|
|
19
35
|
export { SuspenseBuiltin } from './suspense';
|
|
20
36
|
export { TransitionGroupBuiltin } from './transition-group';
|
|
21
|
-
import type { ComponentRegistry } from '../component-registry';
|
|
22
|
-
/**
|
|
23
|
-
* Register all builtin components with the supplied registry, or with the
|
|
24
|
-
* package singleton when no target is supplied.
|
|
25
|
-
*/
|
|
26
|
-
export declare function registerBuiltins(target?: ComponentRegistry): void;
|
package/dist/builtins/modal.d.ts
CHANGED
|
@@ -1,26 +1,16 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
1
3
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* <StxModal id="delete-confirm" size="sm" closeOnBackdrop="false">
|
|
14
|
-
* <h3>Are you sure?</h3>
|
|
15
|
-
* </StxModal>
|
|
16
|
-
*
|
|
17
|
-
* Props:
|
|
18
|
-
* - id (required) — unique modal identifier
|
|
19
|
-
* - size — 'sm' | 'md' | 'lg' | 'xl' | 'full' (default: 'md')
|
|
20
|
-
* - closeOnBackdrop — whether clicking backdrop closes modal (default: true)
|
|
21
|
-
* - closeOnEscape — whether Escape key closes modal (default: true)
|
|
22
|
-
*
|
|
23
|
-
* @module builtins/modal
|
|
4
|
+
* @defaultValue
|
|
5
|
+
* ```ts
|
|
6
|
+
* {
|
|
7
|
+
* sm: 'max-width:24rem',
|
|
8
|
+
* md: 'max-width:32rem',
|
|
9
|
+
* lg: 'max-width:42rem',
|
|
10
|
+
* xl: 'max-width:56rem',
|
|
11
|
+
* full: 'max-width:calc(100vw - 2rem);max-height:calc(100vh - 2rem)'
|
|
12
|
+
* }
|
|
13
|
+
* ```
|
|
24
14
|
*/
|
|
25
|
-
|
|
15
|
+
declare const SIZE_WIDTHS: Record<string, string>;
|
|
26
16
|
export declare const StxModalBuiltin: BuiltinComponentDef;
|
|
@@ -1,44 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* SafeImage Builtin Component
|
|
3
|
-
*
|
|
4
|
-
* Drop-in `<img>` replacement with a declarative broken-image fallback.
|
|
5
|
-
* Third-party image URLs (external-CDN avatars, user content that gets
|
|
6
|
-
* deleted, seed data pointing at links that 404) fail frequently in
|
|
7
|
-
* production; without intervention the browser draws the alt text inside
|
|
8
|
-
* whatever layout frame the `<img>` had — round avatar frames in
|
|
9
|
-
* particular look broken.
|
|
10
|
-
*
|
|
11
|
-
* SafeImage wires an inline `onerror=` handler that swaps to a fallback
|
|
12
|
-
* image (and optionally swaps the class string) when the primary src
|
|
13
|
-
* fails to load.
|
|
14
|
-
*
|
|
15
|
-
* Usage:
|
|
16
|
-
* <SafeImage src="/avatars/u.png" alt="User" fallback="/avatars/default.svg" />
|
|
17
|
-
* <SafeImage :src="judge.photo" :alt="judge.name"
|
|
18
|
-
* className="h-12 w-12 rounded-full grayscale filter"
|
|
19
|
-
* fallbackClassName="h-12 w-12 rounded-full"
|
|
20
|
-
* fallback="/images/avatars/default-judge.svg" />
|
|
21
|
-
*
|
|
22
|
-
* Why inline `onerror=` rather than a delegated capture-phase listener:
|
|
23
|
-
* `error` events don't bubble, so a listener attached by a component's
|
|
24
|
-
* `<script client>` IIFE runs AFTER the element's first load attempt —
|
|
25
|
-
* cached 404s and offline first paint slip past it. The inline HTML
|
|
26
|
-
* `onerror=` attribute is parsed-and-attached synchronously with the
|
|
27
|
-
* element by the browser's HTML parser, before the image request fires.
|
|
28
|
-
* That's the only race-free option for the error path.
|
|
29
|
-
*
|
|
30
|
-
* Why a single window-level handler rather than per-instance inline
|
|
31
|
-
* closures: keeps rendered HTML small (a ~35-byte attribute vs. a
|
|
32
|
-
* ~120-byte inline function body per `<img>`). The handler is emitted
|
|
33
|
-
* once per page render (gated on a render-context flag) and registered
|
|
34
|
-
* once per browser session (gated on the `window.__stxSafeImageHandler`
|
|
35
|
-
* existence check, so it's also idempotent across SPA navigation).
|
|
36
|
-
* Per-instance config travels via `data-*` attributes, so the handler
|
|
37
|
-
* stays stateless.
|
|
38
|
-
*
|
|
39
|
-
* Resolves stacksjs/stx#1732.
|
|
40
|
-
*
|
|
41
|
-
* @module builtins/safe-image
|
|
42
|
-
*/
|
|
43
1
|
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
3
|
+
declare const DEFAULT_FALLBACK: '/images/safe-image-default.svg';
|
|
44
4
|
export declare const SafeImageBuiltin: BuiltinComponentDef;
|
|
@@ -1,29 +1,49 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
3
|
+
declare function resolveBoolProp(props: ResolvedProps, key: string, defaultVal?: boolean): boolean;
|
|
1
4
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
*
|
|
5
|
+
* Parse sizes prop: "sm:100vw md:50vw lg:33vw" → proper sizes attribute
|
|
6
|
+
* Also accepts raw sizes string: "(max-width: 768px) 100vw, 50vw"
|
|
7
|
+
*/
|
|
8
|
+
declare function parseSizes(sizesStr: string): string;
|
|
9
|
+
/**
|
|
10
|
+
* Generate srcset from widths: "/img.jpg 320w, /img.jpg 640w, ..."
|
|
11
|
+
* For local images, just generates width descriptors.
|
|
12
|
+
* For CDN providers, generates resized URLs.
|
|
13
|
+
*/
|
|
14
|
+
declare function generateSrcset(src: string, widths: number[], provider?: string, format?: string): string;
|
|
15
|
+
/**
|
|
16
|
+
* Generate density srcset: "/img.jpg 1x, /img@2x.jpg 2x"
|
|
17
|
+
*/
|
|
18
|
+
declare function generateDensitySrcset(src: string, densities: number[], width: number | undefined, provider?: string, format?: string): string;
|
|
19
|
+
/**
|
|
20
|
+
* Transform src URL based on provider.
|
|
21
|
+
* For local images, returns as-is (optimization happens at build time via stx's image pipeline).
|
|
22
|
+
* For CDN providers, generates the appropriate URL.
|
|
23
|
+
*/
|
|
24
|
+
declare function transformSrc(src: string, width?: number, height?: number, provider?: string, format?: string): string;
|
|
25
|
+
/**
|
|
26
|
+
* The `onload` handler that takes a placeholder away once the image is there.
|
|
14
27
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
21
|
-
* <StxImage src="/images/hero.jpg" alt="Hero" placeholder="blur" />
|
|
22
|
-
* <StxImage src="/images/hero.jpg" alt="Hero" placeholder="thumbhash" />
|
|
23
|
-
* <StxImage src="/images/hero.jpg" alt="Hero" preload />
|
|
24
|
-
* <StxImage src="/images/hero.jpg" alt="Hero" provider="cloudinary" />
|
|
28
|
+
* Only the longhands the placeholder set are cleared, so a background the
|
|
29
|
+
* author wrote into `style` for their own reasons survives. An inline handler
|
|
30
|
+
* rather than a listener for the same reason `<SafeImage>` uses one: the
|
|
31
|
+
* parser attaches it with the element, before the request goes out, so an
|
|
32
|
+
* image that is already cached (or decoded before any script runs) still
|
|
33
|
+
* fires it. A listener added at hydration misses exactly those.
|
|
25
34
|
*
|
|
26
|
-
*
|
|
35
|
+
* Opaque images covered their placeholder anyway, but not every image fills
|
|
36
|
+
* its box (`object-fit: contain`, a filter, a rounded frame), and a
|
|
37
|
+
* placeholder that outlives its image is simply wrong.
|
|
27
38
|
*/
|
|
28
|
-
|
|
39
|
+
declare function placeholderCleanup(properties: string[]): string;
|
|
40
|
+
/**
|
|
41
|
+
* Generate a tiny SVG placeholder for blur-up effect
|
|
42
|
+
*/
|
|
43
|
+
declare function generateBlurPlaceholder(width: number, height: number, color?: string): string;
|
|
44
|
+
/**
|
|
45
|
+
* Default widths for srcset generation
|
|
46
|
+
* @defaultValue `[320, 640, 768, 1024, 1280, 1536, 1920]`
|
|
47
|
+
*/
|
|
48
|
+
declare const DEFAULT_SRCSET_WIDTHS: number[];
|
|
29
49
|
export declare const StxImageBuiltin: BuiltinComponentDef;
|
|
@@ -1,11 +1,8 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
1
2
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* active class management, prefetching, and reactive href bindings.
|
|
6
|
-
* Produces plain HTML — no wrapper component or custom element overhead.
|
|
7
|
-
*
|
|
8
|
-
* @module builtins/stx-link
|
|
3
|
+
* Resolve the `to` prop from any binding category.
|
|
4
|
+
* Returns an object indicating whether the value is a static string
|
|
5
|
+
* or a client-reactive expression.
|
|
9
6
|
*/
|
|
10
|
-
|
|
7
|
+
declare function resolveTo(props: ResolvedProps): { value: string, reactive: boolean };
|
|
11
8
|
export declare const StxLinkBuiltin: BuiltinComponentDef;
|
|
@@ -1,13 +1,14 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
1
2
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
* Renders a fixed-position progress bar at the top of the viewport that
|
|
5
|
-
* activates on navigation. Includes shimmer animation, automatic
|
|
6
|
-
* link-click interception, and a global `window.stxLoading` API.
|
|
7
|
-
*
|
|
8
|
-
* Ported from the inline implementation in component-processing.ts.
|
|
9
|
-
*
|
|
10
|
-
* @module builtins/stx-loading-indicator
|
|
3
|
+
* Sanitize a CSS value to prevent injection (strips semicolons, braces, url()).
|
|
11
4
|
*/
|
|
12
|
-
|
|
5
|
+
declare function sanitizeCss(value: string): string;
|
|
6
|
+
/**
|
|
7
|
+
* Resolve a string prop from static or server-dynamic bindings.
|
|
8
|
+
*/
|
|
9
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
10
|
+
/**
|
|
11
|
+
* Resolve a numeric prop, returning the default if not provided or not a valid number.
|
|
12
|
+
*/
|
|
13
|
+
declare function resolveNumericProp(props: ResolvedProps, key: string, defaultValue: number): number;
|
|
13
14
|
export declare const StxLoadingIndicatorBuiltin: BuiltinComponentDef;
|
|
@@ -1,30 +1,9 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
/** Resolve a string prop from static or server-dynamic bindings. */
|
|
3
|
+
declare function resolveProp(props: ResolvedProps, ...keys: string[]): string | undefined;
|
|
1
4
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
* A client loading boundary. Renders three regions that the signals runtime
|
|
5
|
-
* (`bindSuspense`) toggles based on the aggregated state of descendant suspense
|
|
6
|
-
* queries (`useQuery` / `useFetch` with `{ suspense: true }`):
|
|
7
|
-
*
|
|
8
|
-
* - `[data-stx-suspense-fallback]` — shown while any descendant query loads
|
|
9
|
-
* - `[data-stx-suspense-error]` — shown when a descendant query errors
|
|
10
|
-
* - `[data-stx-suspense-content]` — shown once all descendant queries resolve
|
|
11
|
-
*
|
|
12
|
-
* The default slot is the content; `fallback` / `errorFallback` come from props
|
|
13
|
-
* or from `slot="fallback"` / `slot="error"` elements in the slot content.
|
|
14
|
-
*
|
|
15
|
-
* ```stx
|
|
16
|
-
* <Suspense fallback="Loading…">
|
|
17
|
-
* <CommentsList /> <!-- uses useQuery(url, { suspense: true }) -->
|
|
18
|
-
* </Suspense>
|
|
19
|
-
*
|
|
20
|
-
* <Suspense>
|
|
21
|
-
* <template slot="fallback"><Skeleton count="2" /></template>
|
|
22
|
-
* <template slot="error">Couldn't load comments.</template>
|
|
23
|
-
* <CommentsList />
|
|
24
|
-
* </Suspense>
|
|
25
|
-
* ```
|
|
26
|
-
*
|
|
27
|
-
* @module builtins/suspense
|
|
5
|
+
* Extract a `slot="name"` / `<template slot="name">` region from slot content,
|
|
6
|
+
* returning the region's inner HTML and the content with that region removed.
|
|
28
7
|
*/
|
|
29
|
-
|
|
8
|
+
declare function extractSlot(content: string, name: string): { region: string | null, rest: string };
|
|
30
9
|
export declare const SuspenseBuiltin: BuiltinComponentDef;
|
package/dist/builtins/toast.d.ts
CHANGED
|
@@ -1,19 +1,18 @@
|
|
|
1
|
+
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
3
|
+
declare function resolveNumericProp(props: ResolvedProps, key: string, defaultValue: number): number;
|
|
1
4
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* Positions: top-right (default), top-left, top-center,
|
|
14
|
-
* bottom-right, bottom-left, bottom-center
|
|
15
|
-
*
|
|
16
|
-
* @module builtins/toast
|
|
5
|
+
* @defaultValue
|
|
6
|
+
* ```ts
|
|
7
|
+
* {
|
|
8
|
+
* 'top-right': 'top:1rem;right:1rem',
|
|
9
|
+
* 'top-left': 'top:1rem;left:1rem',
|
|
10
|
+
* 'top-center': 'top:1rem;left:50%;transform:translateX(-50%)',
|
|
11
|
+
* 'bottom-right': 'bottom:1rem;right:1rem',
|
|
12
|
+
* 'bottom-left': 'bottom:1rem;left:1rem',
|
|
13
|
+
* 'bottom-center': 'bottom:1rem;left:50%;transform:translateX(-50%)'
|
|
14
|
+
* }
|
|
15
|
+
* ```
|
|
17
16
|
*/
|
|
18
|
-
|
|
17
|
+
declare const POSITION_STYLES: Record<string, string>;
|
|
19
18
|
export declare const StxToastBuiltin: BuiltinComponentDef;
|
|
@@ -1,27 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* TransitionGroup Builtin Component (stacksjs/stx#1742)
|
|
3
|
-
*
|
|
4
|
-
* Class-driven enter/leave + FLIP move animations for a keyed list. Renders a
|
|
5
|
-
* single wrapper element marked `data-stx-transition-group="<name>"`; the
|
|
6
|
-
* signals runtime's `bindFor` animates the list items inside it when they are
|
|
7
|
-
* added, removed, or reordered.
|
|
8
|
-
*
|
|
9
|
-
* The default slot must contain a single `:for` (or `x-for`) element whose
|
|
10
|
-
* rendered items become the wrapper's direct children:
|
|
11
|
-
*
|
|
12
|
-
* ```stx
|
|
13
|
-
* <TransitionGroup name="card" tag="ul" class="space-y-2">
|
|
14
|
-
* <li :for="r in reviews()" :key="r.id" class="card">{{ r.title }}</li>
|
|
15
|
-
* </TransitionGroup>
|
|
16
|
-
* ```
|
|
17
|
-
*
|
|
18
|
-
* With `name="card"`, supply the transition classes (e.g. via css/CSS):
|
|
19
|
-
* `card-enter-from` / `card-enter-active` / `card-enter-to`,
|
|
20
|
-
* `card-leave-from` / `card-leave-active` / `card-leave-to`, and `card-move`
|
|
21
|
-
* (applied to elements that shift position during a reorder). The first render
|
|
22
|
-
* does not animate; subsequent list changes do.
|
|
23
|
-
*
|
|
24
|
-
* @module builtins/transition-group
|
|
25
|
-
*/
|
|
26
1
|
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, ...keys: string[]): string | undefined;
|
|
27
3
|
export declare const TransitionGroupBuiltin: BuiltinComponentDef;
|