@stacksjs/stx 0.2.572 → 0.2.573
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/a11y.d.ts +51 -111
- package/dist/animation.d.ts +131 -74
- package/dist/api-client.d.ts +11 -21
- package/dist/api-handler.d.ts +4 -4
- package/dist/appearance-bootstrap.d.ts +16 -77
- package/dist/application-layers.d.ts +11 -20
- package/dist/asset-roots.d.ts +7 -27
- package/dist/assets.d.ts +7 -9
- package/dist/async-components.d.ts +56 -78
- package/dist/auth.d.ts +0 -3
- package/dist/browser-core-imports.d.ts +2 -2
- package/dist/build-externalize-repeated.d.ts +0 -25
- package/dist/build-externalize.d.ts +18 -53
- package/dist/build-id.d.ts +40 -28
- package/dist/build-message.d.ts +20 -44
- package/dist/builtins/attrs.d.ts +0 -14
- package/dist/builtins/drawer.d.ts +3 -22
- package/dist/builtins/icon.d.ts +17 -19
- package/dist/builtins/image-alpha.d.ts +8 -8
- package/dist/builtins/image-delivery.d.ts +38 -40
- package/dist/builtins/image-placeholder.d.ts +12 -50
- package/dist/builtins/image-warmup-worker.d.ts +1 -1
- package/dist/builtins/image-worker.d.ts +6 -32
- package/dist/builtins/index.d.ts +16 -6
- package/dist/builtins/modal.d.ts +13 -23
- package/dist/builtins/safe-image.d.ts +2 -42
- package/dist/builtins/stx-image.d.ts +44 -24
- package/dist/builtins/stx-link.d.ts +5 -8
- package/dist/builtins/stx-loading-indicator.d.ts +11 -10
- package/dist/builtins/suspense.d.ts +6 -27
- package/dist/builtins/toast.d.ts +15 -16
- package/dist/builtins/transition-group.d.ts +1 -25
- package/dist/caching.d.ts +24 -21
- package/dist/{chunk-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
- package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
- package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
- package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
- package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
- package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
- package/dist/chunk-557wtdps.js +2 -0
- package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
- package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
- package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
- package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
- package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
- package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
- package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
- package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
- package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
- package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
- package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
- package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
- package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
- package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
- package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
- package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
- package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
- package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
- package/dist/{chunk-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
- package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
- package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
- package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
- package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
- package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
- package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
- package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
- package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
- package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
- package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
- package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
- package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
- package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
- package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
- package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
- package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
- package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
- package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
- package/dist/chunk-zpz6q2fh.js +2 -0
- package/dist/chunk-zxt94g45.js +2 -0
- package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
- package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
- package/dist/cli.js +7 -7
- package/dist/client/directive.d.ts +0 -7
- package/dist/client/index.d.ts +1 -0
- package/dist/client/signals-appearance-runtime.d.ts +1 -1
- package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
- package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
- package/dist/client/signals-class-runtime.d.ts +1 -1
- package/dist/client/signals-component-api-runtime.d.ts +1 -1
- package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-component-props-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
- package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
- package/dist/client/signals-context-runtime.d.ts +1 -1
- package/dist/client/signals-cookie-runtime.d.ts +1 -1
- package/dist/client/signals-devtools-runtime.d.ts +1 -1
- package/dist/client/signals-dialog-runtime.d.ts +1 -1
- package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
- package/dist/client/signals-drawer-runtime.d.ts +1 -1
- package/dist/client/signals-effect-runtime.d.ts +1 -1
- package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
- package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
- package/dist/client/signals-expression-runtime.d.ts +1 -1
- package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
- package/dist/client/signals-for-runtime.d.ts +1 -1
- package/dist/client/signals-globals-runtime.d.ts +1 -1
- package/dist/client/signals-handler-runtime.d.ts +1 -1
- package/dist/client/signals-head-runtime.d.ts +1 -1
- package/dist/client/signals-helpers-runtime.d.ts +1 -1
- package/dist/client/signals-host-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-if-chain-runtime.d.ts +1 -1
- package/dist/client/signals-if-runtime.d.ts +1 -1
- package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
- package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
- package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
- package/dist/client/signals-loop-row-runtime.d.ts +1 -1
- package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-model-runtime.d.ts +1 -1
- package/dist/client/signals-mount-runtime.d.ts +1 -1
- package/dist/client/signals-navigation-runtime.d.ts +1 -1
- package/dist/client/signals-notify-runtime.d.ts +1 -1
- package/dist/client/signals-optimistic-runtime.d.ts +1 -1
- package/dist/client/signals-overlay-runtime.d.ts +1 -1
- package/dist/client/signals-pipe-runtime.d.ts +1 -1
- package/dist/client/signals-proxy-runtime.d.ts +1 -1
- package/dist/client/signals-query-runtime.d.ts +1 -1
- package/dist/client/signals-reactive-runtime.d.ts +1 -1
- package/dist/client/signals-ref-runtime.d.ts +1 -1
- package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
- package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
- package/dist/client/signals-show-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-runtime.d.ts +1 -1
- package/dist/client/signals-state-runtime.d.ts +1 -1
- package/dist/client/signals-storage-runtime.d.ts +1 -1
- package/dist/client/signals-store-registry-runtime.d.ts +1 -1
- package/dist/client/signals-style-runtime.d.ts +1 -1
- package/dist/client/signals-suspense-runtime.d.ts +1 -1
- package/dist/client/signals-timer-runtime.d.ts +1 -1
- package/dist/client/signals-toast-runtime.d.ts +1 -1
- package/dist/client/signals-tooltip-runtime.d.ts +1 -1
- package/dist/client/signals-transition-group-runtime.d.ts +1 -1
- package/dist/client/signals-websocket-runtime.d.ts +1 -1
- package/dist/client-helpers.d.ts +1 -312
- package/dist/client-module-registry.d.ts +4 -27
- package/dist/client-parameter-bindings.d.ts +1 -4
- package/dist/client-script-bundler.d.ts +55 -103
- package/dist/client-script.d.ts +69 -127
- package/dist/color-mode-boot.d.ts +21 -58
- package/dist/component-client-factories.d.ts +8 -9
- package/dist/component-contract-checks.d.ts +15 -18
- package/dist/component-contract.d.ts +6 -6
- package/dist/component-hmr.d.ts +8 -7
- package/dist/component-model.d.ts +14 -20
- package/dist/component-processing.d.ts +51 -59
- package/dist/component-registry.d.ts +28 -99
- package/dist/component-renderer.d.ts +19 -16
- package/dist/component-resolution.d.ts +8 -8
- package/dist/component-tags.d.ts +1 -1
- package/dist/composable-loader.d.ts +6 -41
- package/dist/composables/use-fetch.d.ts +45 -114
- package/dist/composables/use-form.d.ts +2 -56
- package/dist/composables/use-intersection-observer.d.ts +1 -1
- package/dist/composables.d.ts +75 -74
- package/dist/composition-api.d.ts +19 -43
- package/dist/computed.d.ts +93 -86
- package/dist/conditionals.d.ts +0 -24
- package/dist/config.d.ts +30 -24
- package/dist/config.js +3 -0
- package/dist/craft-bridge.d.ts +1 -467
- package/dist/craft-components.d.ts +234 -680
- package/dist/craft-entry.js +1 -1
- package/dist/craft.js +1 -1
- package/dist/csp.d.ts +41 -107
- package/dist/database.d.ts +1 -1
- package/dist/defer.d.ts +0 -24
- package/dist/dev-server/terminal-colors.d.ts +32 -32
- package/dist/dev-server/ts-css.d.ts +26 -35
- package/dist/dev-server/types.d.ts +33 -29
- package/dist/directive-api.d.ts +42 -85
- package/dist/directive-arguments.d.ts +14 -39
- package/dist/document-shell.d.ts +49 -81
- package/dist/dynamic-components.d.ts +0 -9
- package/dist/engine-bindings.d.ts +1 -1
- package/dist/env.d.ts +26 -0
- package/dist/error-boundaries.d.ts +36 -43
- package/dist/error-handling.d.ts +1 -1
- package/dist/errors/codes.d.ts +43 -51
- package/dist/errors/formatter.d.ts +38 -58
- package/dist/errors/index.d.ts +61 -5
- package/dist/errors/logger.d.ts +40 -114
- package/dist/errors/sanitizer.d.ts +28 -53
- package/dist/errors/types.d.ts +31 -44
- package/dist/events.d.ts +32 -94
- package/dist/expressions.d.ts +57 -62
- package/dist/find-body-tag.d.ts +5 -34
- package/dist/first-script-tag.d.ts +0 -23
- package/dist/forms-validation.d.ts +117 -149
- package/dist/forms.d.ts +161 -120
- package/dist/framework-composables.d.ts +0 -32
- package/dist/head-injection.d.ts +30 -32
- package/dist/head-keys.d.ts +12 -15
- package/dist/head.d.ts +110 -139
- package/dist/heatmap.d.ts +76 -152
- package/dist/html-masking.d.ts +38 -62
- package/dist/hydration-runtime.d.ts +24 -20
- package/dist/hydration.d.ts +11 -10
- package/dist/i18n.d.ts +34 -95
- package/dist/image-optimization/auto-sibling.d.ts +4 -32
- package/dist/imported-signals.d.ts +0 -36
- package/dist/includes.d.ts +6 -69
- package/dist/index.d.ts +2 -1
- package/dist/init.d.ts +12 -20
- package/dist/internal-markdown.d.ts +8 -12
- package/dist/interpolation-context.d.ts +15 -15
- package/dist/island-chunking.d.ts +13 -30
- package/dist/keep-alive.d.ts +52 -72
- package/dist/layout-types.d.ts +2 -27
- package/dist/lazy-module.d.ts +0 -10
- package/dist/loading-indicator.d.ts +8 -5
- package/dist/loop-binding.d.ts +4 -7
- package/dist/loops.d.ts +25 -67
- package/dist/markdown.d.ts +1 -0
- package/dist/media/image/component.d.ts +9 -25
- package/dist/media/image/directive.d.ts +1 -15
- package/dist/media/image/placeholder.d.ts +9 -20
- package/dist/media/image/processor/cache.d.ts +18 -40
- package/dist/media/image/processor/index.d.ts +10 -1
- package/dist/media/image/processor/optimizer.d.ts +1 -12
- package/dist/media/image/processor/responsive.d.ts +6 -16
- package/dist/media/image/srcset.d.ts +49 -47
- package/dist/media/shared/cache.d.ts +31 -51
- package/dist/media/shared/hash.d.ts +0 -7
- package/dist/media/types.d.ts +754 -1235
- package/dist/media/video/directive.d.ts +1 -15
- package/dist/media/video/index.d.ts +17 -39
- package/dist/media/video/processor/cache.d.ts +19 -42
- package/dist/media/video/processor/index.d.ts +18 -1
- package/dist/media/video/processor/streaming.d.ts +10 -17
- package/dist/media/video/processor/thumbnail.d.ts +15 -21
- package/dist/media/video/processor/transcoder.d.ts +1 -11
- package/dist/meta-arguments.d.ts +14 -39
- package/dist/method-spoofing.d.ts +0 -7
- package/dist/middleware.d.ts +0 -60
- package/dist/native/bridge/protocol.d.ts +2 -1
- package/dist/native/compiler/headwind-to-style.d.ts +383 -359
- package/dist/native/compiler/icons.d.ts +249 -243
- package/dist/native/compiler/svg.d.ts +35 -24
- package/dist/native/runtime/jsc-globals.d.ts +1 -1
- package/dist/native/runtime/native-host.d.ts +1 -1
- package/dist/native/runtime/native-host.js +3 -0
- package/dist/offline/app-service-worker.d.ts +50 -114
- package/dist/offline/kept-store.d.ts +23 -37
- package/dist/offline/query-cache.d.ts +55 -126
- package/dist/owned-routes.d.ts +0 -31
- package/dist/page-response.d.ts +8 -39
- package/dist/parser/directive-parser.d.ts +45 -57
- package/dist/parser/expression-parser.d.ts +35 -33
- package/dist/parser/index.d.ts +39 -4
- package/dist/parser/tokenizer.d.ts +49 -61
- package/dist/partial-hydration.d.ts +51 -82
- package/dist/performance-utils.d.ts +115 -255
- package/dist/placeholder.d.ts +9 -18
- package/dist/plugin-system.d.ts +115 -264
- package/dist/process.d.ts +4 -9
- package/dist/process.js +6 -4
- package/dist/prop-sentinels.d.ts +11 -11
- package/dist/public-env.d.ts +0 -14
- package/dist/pwa/directives.d.ts +20 -12
- package/dist/pwa/inject.d.ts +0 -10
- package/dist/pwa/precache.d.ts +16 -22
- package/dist/pwa/service-worker.d.ts +0 -12
- package/dist/pwa.js +1 -1
- package/dist/reactive-bindings.d.ts +11 -34
- package/dist/reactive-tracking.d.ts +0 -36
- package/dist/reactive.d.ts +41 -58
- package/dist/render-memo.d.ts +5 -23
- package/dist/resolve-stx-targets.d.ts +6 -44
- package/dist/route-middleware.d.ts +35 -2
- package/dist/route-rules.d.ts +10 -13
- package/dist/router.d.ts +9 -8
- package/dist/routes.d.ts +3 -1
- package/dist/runtime-config-server.d.ts +14 -17
- package/dist/runtime-config.d.ts +2 -3
- package/dist/runtime-globals.d.ts +90 -122
- package/dist/runtime-injection.d.ts +0 -8
- package/dist/scaffolding.d.ts +30 -26
- package/dist/script-emit.d.ts +0 -30
- package/dist/script-validation.d.ts +6 -12
- package/dist/seo.d.ts +75 -153
- package/dist/server-api.d.ts +9 -12
- package/dist/server-bindings.d.ts +1 -26
- package/dist/server-data.d.ts +4 -5
- package/dist/sfc-template.d.ts +8 -8
- package/dist/signal-processing.d.ts +37 -53
- package/dist/signals-api.d.ts +58 -135
- package/dist/signals.d.ts +18 -24
- package/dist/site-url.d.ts +31 -28
- package/dist/slots.d.ts +20 -86
- package/dist/source-signature.d.ts +5 -28
- package/dist/ssg.d.ts +158 -337
- package/dist/ssg.js +2 -2
- package/dist/state-dir.d.ts +4 -4
- package/dist/store-loader.d.ts +0 -10
- package/dist/story/analytics.d.ts +60 -138
- package/dist/story/bookmarks.d.ts +34 -87
- package/dist/story/cli.d.ts +69 -123
- package/dist/story/collect/scanner.d.ts +0 -4
- package/dist/story/collect/tree.d.ts +1 -8
- package/dist/story/commands/build.d.ts +6 -11
- package/dist/story/commands/dev.d.ts +8 -15
- package/dist/story/commands/preview.d.ts +7 -13
- package/dist/story/config-watcher.d.ts +13 -20
- package/dist/story/config.d.ts +8 -11
- package/dist/story/context.d.ts +8 -14
- package/dist/story/hmr.d.ts +26 -24
- package/dist/story/hot-swap.d.ts +23 -34
- package/dist/story/keyboard-shortcuts.d.ts +18 -23
- package/dist/story/output.d.ts +44 -46
- package/dist/story/performance.d.ts +45 -107
- package/dist/story/presets.d.ts +41 -107
- package/dist/story/renderer.d.ts +27 -41
- package/dist/story/search.d.ts +12 -23
- package/dist/story/server.d.ts +11 -21
- package/dist/story/setup.d.ts +15 -23
- package/dist/story/testing.d.ts +40 -65
- package/dist/story/types.d.ts +160 -262
- package/dist/streaming.d.ts +57 -119
- package/dist/strip-literals.d.ts +1 -25
- package/dist/stx-module-imports.d.ts +7 -0
- package/dist/stx-virtual-ts.d.ts +102 -253
- package/dist/style-scoping.d.ts +8 -21
- package/dist/suspense.d.ts +52 -67
- package/dist/teleport.d.ts +0 -22
- package/dist/template-syntax-escape.d.ts +8 -8
- package/dist/template-tag-balance.d.ts +6 -22
- package/dist/testing.d.ts +26 -11
- package/dist/theme-tokens.d.ts +388 -134
- package/dist/transitions.d.ts +55 -66
- package/dist/ts-css-config.d.ts +12 -70
- package/dist/types/component-types.d.ts +122 -187
- package/dist/types/config-types.d.ts +341 -956
- package/dist/types/context-types.d.ts +24 -46
- package/dist/types/csp-types.d.ts +66 -70
- package/dist/types/directive-types.d.ts +156 -223
- package/dist/types/index.d.ts +110 -6
- package/dist/types/pwa-types.d.ts +148 -273
- package/dist/types.d.ts +1 -0
- package/dist/unresolved-identifiers.d.ts +22 -24
- package/dist/url-safety.d.ts +32 -32
- package/dist/utils.d.ts +21 -36
- package/dist/validator.d.ts +26 -28
- package/dist/variable-extractor.d.ts +19 -49
- package/dist/view-composers.d.ts +81 -80
- package/dist/virtual-scrolling.d.ts +82 -101
- package/dist/visual-testing.d.ts +10 -9
- package/dist/vue-template.d.ts +0 -23
- package/dist/web-components/css-scoping.d.ts +11 -21
- package/dist/web-components.d.ts +58 -81
- package/dist/x-element.d.ts +1 -0
- package/package.json +6 -6
- package/stx.d.ts +2 -2
- package/dist/app-service-worker.d.ts +0 -165
- package/dist/chunk-49gwmcrn.js +0 -2
- package/dist/chunk-6va5pe2m.js +0 -2
- package/dist/chunk-bm2q1srp.js +0 -2
- package/dist/signals-context-runtime.d.ts +0 -2
- package/dist/signals-drawer-runtime.d.ts +0 -2
- package/dist/signals-host-runtime.d.ts +0 -9
- package/dist/signals-loop-conditional-runtime.d.ts +0 -2
- package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
- package/dist/signals-notify-runtime.d.ts +0 -2
- package/dist/signals-optimistic-runtime.d.ts +0 -2
- package/dist/signals-overlay-runtime.d.ts +0 -2
- package/dist/signals-scope-disposal-runtime.d.ts +0 -2
- package/dist/signals-spa-load-control-runtime.d.ts +0 -2
- package/dist/signals-storage-runtime.d.ts +0 -2
|
@@ -1,33 +1,3 @@
|
|
|
1
|
-
/** One extracted island chunk: a content hash and the IIFE it holds. */
|
|
2
|
-
export interface IslandChunk {
|
|
3
|
-
/** Content hash of `code` — the chunk's filename stem (`/_stx/islands/<hash>.js`). */
|
|
4
|
-
hash: string;
|
|
5
|
-
/** The island setup IIFE (trimmed) to write to the chunk file. */
|
|
6
|
-
code: string;
|
|
7
|
-
}
|
|
8
|
-
export interface ExtractIslandChunksResult {
|
|
9
|
-
/** HTML with each inline island IIFE replaced by a `data-stx-src` reference. */
|
|
10
|
-
html: string;
|
|
11
|
-
/** The unique chunks to write (deduped by content hash within the page). */
|
|
12
|
-
chunks: IslandChunk[];
|
|
13
|
-
}
|
|
14
|
-
export interface ExtractIslandChunksOptions {
|
|
15
|
-
/**
|
|
16
|
-
* Stamp `data-stx-integrity="sha384-…"` (Subresource Integrity) on each
|
|
17
|
-
* chunked tag so the runtime can pin the chunk against tampering and a strict
|
|
18
|
-
* CSP can require SRI. Default `false` — only enable when chunks are served
|
|
19
|
-
* byte-for-byte unchanged (no CDN/proxy transform), else the hash won't match
|
|
20
|
-
* and the island silently won't hydrate.
|
|
21
|
-
*/
|
|
22
|
-
integrity?: boolean;
|
|
23
|
-
/**
|
|
24
|
-
* Minify each chunk's JS (whitespace only) before hashing/writing, so the
|
|
25
|
-
* lazily-loaded bytes aren't padded with source whitespace. Default `false`;
|
|
26
|
-
* the SSG passes its `minify` flag. Hashing happens over the minified bytes,
|
|
27
|
-
* so the content hash + SRI always match what's served.
|
|
28
|
-
*/
|
|
29
|
-
minify?: boolean;
|
|
30
|
-
}
|
|
31
1
|
/**
|
|
32
2
|
* Lift inline island IIFEs into content-hashed chunks. Pure: no filesystem
|
|
33
3
|
* access — the caller writes `result.chunks` and `result.html`.
|
|
@@ -46,3 +16,16 @@ export declare function extractIslandChunks(html: string, options?: ExtractIslan
|
|
|
46
16
|
* not used within N seconds" console warning for below-the-fold islands.
|
|
47
17
|
*/
|
|
48
18
|
export declare function injectIslandChunkPrefetch(html: string): string;
|
|
19
|
+
/** One extracted island chunk: a content hash and the IIFE it holds. */
|
|
20
|
+
export declare interface IslandChunk {
|
|
21
|
+
hash: string
|
|
22
|
+
code: string
|
|
23
|
+
}
|
|
24
|
+
export declare interface ExtractIslandChunksResult {
|
|
25
|
+
html: string
|
|
26
|
+
chunks: IslandChunk[]
|
|
27
|
+
}
|
|
28
|
+
export declare interface ExtractIslandChunksOptions {
|
|
29
|
+
integrity?: boolean
|
|
30
|
+
minify?: boolean
|
|
31
|
+
}
|
package/dist/keep-alive.d.ts
CHANGED
|
@@ -1,66 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Keep-Alive
|
|
3
|
-
*
|
|
4
|
-
* Caches component instances to preserve state when toggling visibility.
|
|
5
|
-
* Similar to Vue's <KeepAlive> component.
|
|
6
|
-
*
|
|
7
|
-
* @module keep-alive
|
|
8
|
-
*
|
|
9
|
-
* @example
|
|
10
|
-
* ```html
|
|
11
|
-
* @keepAlive
|
|
12
|
-
* @if (currentTab === 'settings')
|
|
13
|
-
* <SettingsPanel />
|
|
14
|
-
* @elseif (currentTab === 'profile')
|
|
15
|
-
* <ProfilePanel />
|
|
16
|
-
* @endif
|
|
17
|
-
* @endkeepAlive
|
|
18
|
-
* ```
|
|
19
|
-
*
|
|
20
|
-
* With options:
|
|
21
|
-
* ```html
|
|
22
|
-
* @keepAlive(max: 10, include: 'Settings,Profile', exclude: 'Debug')
|
|
23
|
-
* <component :is="currentComponent" />
|
|
24
|
-
* @endkeepAlive
|
|
25
|
-
* ```
|
|
26
|
-
*/
|
|
27
|
-
export interface KeepAliveOptions {
|
|
28
|
-
/** Maximum number of component instances to cache */
|
|
29
|
-
max?: number;
|
|
30
|
-
/** Comma-separated list of component names to include */
|
|
31
|
-
include?: string;
|
|
32
|
-
/** Comma-separated list of component names to exclude */
|
|
33
|
-
exclude?: string;
|
|
34
|
-
/** Custom cache key */
|
|
35
|
-
id?: string;
|
|
36
|
-
}
|
|
37
|
-
export interface CachedComponent {
|
|
38
|
-
/** Component identifier */
|
|
39
|
-
key: string;
|
|
40
|
-
/** Cached HTML content */
|
|
41
|
-
html: string;
|
|
42
|
-
/** Cached state data */
|
|
43
|
-
state: Record<string, unknown>;
|
|
44
|
-
/** Timestamp when cached */
|
|
45
|
-
cachedAt: number;
|
|
46
|
-
/** Scroll positions */
|
|
47
|
-
scrollPositions: Map<string, {
|
|
48
|
-
top: number;
|
|
49
|
-
left: number;
|
|
50
|
-
}>;
|
|
51
|
-
}
|
|
52
|
-
export interface KeepAliveCache {
|
|
53
|
-
/** Unique cache ID */
|
|
54
|
-
id: string;
|
|
55
|
-
/** Cached components (LRU order) */
|
|
56
|
-
cache: Map<string, CachedComponent>;
|
|
57
|
-
/** Maximum cache size */
|
|
58
|
-
max: number;
|
|
59
|
-
/** Include filter */
|
|
60
|
-
include: string[] | null;
|
|
61
|
-
/** Exclude filter */
|
|
62
|
-
exclude: string[] | null;
|
|
63
|
-
}
|
|
64
1
|
/**
|
|
65
2
|
* Process @keepAlive directives in templates.
|
|
66
3
|
*
|
|
@@ -93,16 +30,59 @@ export declare function generateKeepAliveRuntime(): string;
|
|
|
93
30
|
* Hook called when a component is activated from cache.
|
|
94
31
|
* Use in client-side scripts.
|
|
95
32
|
*/
|
|
96
|
-
export declare function onActivated(callback: (detail: {
|
|
97
|
-
key: string;
|
|
98
|
-
keepAliveId: string;
|
|
99
|
-
cachedAt: number;
|
|
100
|
-
}) => void): void;
|
|
33
|
+
export declare function onActivated(callback: (detail: { key: string; keepAliveId: string; cachedAt: number }) => void): void;
|
|
101
34
|
/**
|
|
102
35
|
* Hook called when a component is deactivated and cached.
|
|
103
36
|
* Use in client-side scripts.
|
|
104
37
|
*/
|
|
105
|
-
export declare function onDeactivated(callback: (detail: {
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
38
|
+
export declare function onDeactivated(callback: (detail: { key: string; keepAliveId: string }) => void): void;
|
|
39
|
+
/* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
|
|
40
|
+
/**
|
|
41
|
+
* STX Keep-Alive
|
|
42
|
+
*
|
|
43
|
+
* Caches component instances to preserve state when toggling visibility.
|
|
44
|
+
* Similar to Vue's <KeepAlive> component.
|
|
45
|
+
*
|
|
46
|
+
* @module keep-alive
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* ```html
|
|
50
|
+
* @keepAlive
|
|
51
|
+
* @if (currentTab === 'settings')
|
|
52
|
+
* <SettingsPanel />
|
|
53
|
+
* @elseif (currentTab === 'profile')
|
|
54
|
+
* <ProfilePanel />
|
|
55
|
+
* @endif
|
|
56
|
+
* @endkeepAlive
|
|
57
|
+
* ```
|
|
58
|
+
*
|
|
59
|
+
* With options:
|
|
60
|
+
* ```html
|
|
61
|
+
* @keepAlive(max: 10, include: 'Settings,Profile', exclude: 'Debug')
|
|
62
|
+
* <component :is="currentComponent" />
|
|
63
|
+
* @endkeepAlive
|
|
64
|
+
* ```
|
|
65
|
+
*/
|
|
66
|
+
// =============================================================================
|
|
67
|
+
// Types
|
|
68
|
+
// =============================================================================
|
|
69
|
+
export declare interface KeepAliveOptions {
|
|
70
|
+
max?: number
|
|
71
|
+
include?: string
|
|
72
|
+
exclude?: string
|
|
73
|
+
id?: string
|
|
74
|
+
}
|
|
75
|
+
export declare interface CachedComponent {
|
|
76
|
+
key: string
|
|
77
|
+
html: string
|
|
78
|
+
state: Record<string, unknown>
|
|
79
|
+
cachedAt: number
|
|
80
|
+
scrollPositions: Map<string, { top: number; left: number }>
|
|
81
|
+
}
|
|
82
|
+
export declare interface KeepAliveCache {
|
|
83
|
+
id: string
|
|
84
|
+
cache: Map<string, CachedComponent>
|
|
85
|
+
max: number
|
|
86
|
+
include: string[] | null
|
|
87
|
+
exclude: string[] | null
|
|
88
|
+
}
|
package/dist/layout-types.d.ts
CHANGED
|
@@ -1,30 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Generate a union of the layouts that exist on disk, so naming one wrong is a
|
|
3
|
-
* type error rather than an unlayouted page (stacksjs/stx#1879 ask 3).
|
|
4
|
-
*
|
|
5
|
-
* `definePageMeta({ layout: 'app' })` now selects a layout, which makes the
|
|
6
|
-
* name a load-bearing string — and a typo produces exactly the same render as a
|
|
7
|
-
* correct name pointing at a missing file. Nuxt types `layout` as a union of
|
|
8
|
-
* the files on disk for this reason; the failure is caught before the build,
|
|
9
|
-
* not by reading the console afterwards.
|
|
10
|
-
*
|
|
11
|
-
* ## Why this augments the real package, not a synthetic specifier
|
|
12
|
-
*
|
|
13
|
-
* The augmentation targets `@stacksjs/stx`, where `KnownLayouts` is really
|
|
14
|
-
* declared and really referenced by `PageMeta['layout']`.
|
|
15
|
-
*
|
|
16
|
-
* That mattered because the route-type generator used to emit
|
|
17
|
-
* `declare module "stx/routes"` — a specifier nothing in the source tree
|
|
18
|
-
* declares or imports, which TypeScript reads as an ambient module declaration
|
|
19
|
-
* rather than an augmentation. It parsed, shipped, and constrained nothing: the
|
|
20
|
-
* same "typed and never read" shape #1879 is about, one level up. Routes now
|
|
21
|
-
* use this same target (#1887); the reasoning below is what kept this file from
|
|
22
|
-
* repeating it.
|
|
23
|
-
*
|
|
24
|
-
* @module layout-types
|
|
25
|
-
*/
|
|
26
|
-
/** The name of the generated declaration file, inside the state directory. */
|
|
27
|
-
export declare const LAYOUT_TYPES_FILE = "layout-types.d.ts";
|
|
28
1
|
/**
|
|
29
2
|
* Layout names in `layoutsDir`, without the `.stx` extension.
|
|
30
3
|
*
|
|
@@ -43,3 +16,5 @@ export declare function renderLayoutTypes(names: readonly string[]): string;
|
|
|
43
16
|
* on every render.
|
|
44
17
|
*/
|
|
45
18
|
export declare function generateLayoutTypes(layoutsDir: string | undefined, outputDir: string): string[];
|
|
19
|
+
/** The name of the generated declaration file, inside the state directory. */
|
|
20
|
+
export declare const LAYOUT_TYPES_FILE: 'layout-types.d.ts';
|
package/dist/lazy-module.d.ts
CHANGED
|
@@ -1,11 +1 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Deduplicate cold dynamic imports across concurrent template renders.
|
|
3
|
-
*
|
|
4
|
-
* Bun normally caches evaluated modules, but separate first-use import()
|
|
5
|
-
* calls can still enter its TypeScript compilation path concurrently. A dev
|
|
6
|
-
* server prewarming several routes exposed that race as partial module builds
|
|
7
|
-
* such as "Unexpected end of file" from forms-validation.ts. Keeping the
|
|
8
|
-
* pending promise makes first compilation single-flight while preserving lazy
|
|
9
|
-
* loading and the circular-dependency boundaries that require import().
|
|
10
|
-
*/
|
|
11
1
|
export declare function importOnce<T>(key: string, importer: () => Promise<T>): Promise<T>;
|
|
@@ -21,6 +21,13 @@ export declare function cleanupLoadingIndicator(): void;
|
|
|
21
21
|
* This is used by the STX compiler for <stx-loading-indicator />
|
|
22
22
|
*/
|
|
23
23
|
export declare function generateLoadingIndicatorHtml(options?: LoadingIndicatorOptions): string;
|
|
24
|
+
/** @defaultValue false */
|
|
25
|
+
declare let isLoading: boolean;
|
|
26
|
+
declare const __dtsx_default_export__: {
|
|
27
|
+
useLoadingIndicator: typeof useLoadingIndicator;
|
|
28
|
+
initLoadingIndicator: typeof initLoadingIndicator;
|
|
29
|
+
generateLoadingIndicatorHtml: typeof generateLoadingIndicatorHtml
|
|
30
|
+
};
|
|
24
31
|
export declare interface LoadingIndicatorOptions {
|
|
25
32
|
color?: string
|
|
26
33
|
initialColor?: string
|
|
@@ -43,8 +50,4 @@ export declare interface LoadingIndicatorInstance {
|
|
|
43
50
|
state: LoadingIndicatorState
|
|
44
51
|
}
|
|
45
52
|
// Export for use in STX templates
|
|
46
|
-
export default
|
|
47
|
-
useLoadingIndicator,
|
|
48
|
-
initLoadingIndicator,
|
|
49
|
-
generateLoadingIndicatorHtml,
|
|
50
|
-
};
|
|
53
|
+
export default __dtsx_default_export__;
|
package/dist/loop-binding.d.ts
CHANGED
|
@@ -17,10 +17,7 @@
|
|
|
17
17
|
* parenthesised `(item, index)` maps onto the comma form the item parser
|
|
18
18
|
* already understands.
|
|
19
19
|
*/
|
|
20
|
-
export declare function parseLoopBinding(params: string): {
|
|
21
|
-
arrayExpr: string;
|
|
22
|
-
itemVar: string;
|
|
23
|
-
} | null;
|
|
20
|
+
export declare function parseLoopBinding(params: string): { arrayExpr: string, itemVar: string } | null;
|
|
24
21
|
/**
|
|
25
22
|
* Every name a client loop expression binds for its body.
|
|
26
23
|
*
|
|
@@ -44,6 +41,8 @@ export declare function loopBoundNames(expression: string): string[];
|
|
|
44
41
|
* after `.`, not as an object-literal key and not inside a string literal.
|
|
45
42
|
*/
|
|
46
43
|
export declare function readsAnyName(expression: string, names: Iterable<string>): boolean;
|
|
44
|
+
/** The client loop names `context` carries for its markup (see {@link CLIENT_LOOP_NAMES_KEY}). */
|
|
45
|
+
export declare function inheritedClientLoopNames(context: Record<string, unknown> | undefined): string[];
|
|
47
46
|
/**
|
|
48
47
|
* The context key naming the client loop variables in scope for markup that
|
|
49
48
|
* was cut out of its loop to be rendered on its own.
|
|
@@ -57,6 +56,4 @@ export declare function readsAnyName(expression: string, names: Iterable<string>
|
|
|
57
56
|
* look resolvable: it was evaluated, came back undefined, and the binding was
|
|
58
57
|
* dropped from the output.
|
|
59
58
|
*/
|
|
60
|
-
export declare const CLIENT_LOOP_NAMES_KEY
|
|
61
|
-
/** The client loop names `context` carries for its markup (see {@link CLIENT_LOOP_NAMES_KEY}). */
|
|
62
|
-
export declare function inheritedClientLoopNames(context: Record<string, unknown> | undefined): string[];
|
|
59
|
+
export declare const CLIENT_LOOP_NAMES_KEY: '__stx_client_loop_names';
|
package/dist/loops.d.ts
CHANGED
|
@@ -1,71 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
* Module for processing loop directives (@foreach, @for, @while, @forelse)
|
|
3
|
-
*
|
|
4
|
-
* Supports loop control directives:
|
|
5
|
-
* - `@break` - Exit the loop immediately
|
|
6
|
-
* - `@break(condition)` - Exit if condition is true
|
|
7
|
-
* - `@continue` - Skip to next iteration
|
|
8
|
-
* - `@continue(condition)` - Skip if condition is true
|
|
9
|
-
*
|
|
10
|
-
* @foreach syntax variants:
|
|
11
|
-
* - `@foreach(items as item)` - Basic iteration
|
|
12
|
-
* - `@foreach(items as index => item)` - With index variable
|
|
13
|
-
*
|
|
14
|
-
* @example Basic iteration
|
|
15
|
-
* ```html
|
|
16
|
-
* @foreach(items as item)
|
|
17
|
-
* {{ item.name }}
|
|
18
|
-
* @endforeach
|
|
19
|
-
* ```
|
|
20
|
-
*
|
|
21
|
-
* @example With index variable
|
|
22
|
-
* ```html
|
|
23
|
-
* @foreach(items as index => item)
|
|
24
|
-
* {{ index }}: {{ item.name }}
|
|
25
|
-
* @if(index === 0)
|
|
26
|
-
* (first item)
|
|
27
|
-
* @endif
|
|
28
|
-
* @endforeach
|
|
29
|
-
* ```
|
|
30
|
-
*
|
|
31
|
-
* @example With loop control
|
|
32
|
-
* ```html
|
|
33
|
-
* @foreach(items as item)
|
|
34
|
-
* @if(item.skip)
|
|
35
|
-
* @continue
|
|
36
|
-
* @endif
|
|
37
|
-
* @if(item.stop)
|
|
38
|
-
* @break
|
|
39
|
-
* @endif
|
|
40
|
-
* {{ item.name }}
|
|
41
|
-
* @endforeach
|
|
42
|
-
* ```
|
|
43
|
-
*/
|
|
1
|
+
import { parseLoopBinding } from './loop-binding';
|
|
44
2
|
import type { StxOptions } from './types';
|
|
45
|
-
/**
|
|
46
|
-
* Process loops (@foreach, @for, @while, @forelse)
|
|
47
|
-
*
|
|
48
|
-
* Loop Configuration (via options.loops):
|
|
49
|
-
* - maxWhileIterations: Safety limit for @while loops (default: 1000)
|
|
50
|
-
* - useAltLoopVariable: Use $loop instead of loop (default: false)
|
|
51
|
-
*
|
|
52
|
-
* Loop Context Variables:
|
|
53
|
-
* Within @foreach loops, a loop context object is available:
|
|
54
|
-
* - loop.index: Current zero-based index
|
|
55
|
-
* - loop.iteration: Current one-based iteration count
|
|
56
|
-
* - loop.first: Boolean, true if first iteration
|
|
57
|
-
* - loop.last: Boolean, true if last iteration
|
|
58
|
-
* - loop.count: Total number of items
|
|
59
|
-
*
|
|
60
|
-
* If options.loops.useAltLoopVariable is true, use $loop instead of loop
|
|
61
|
-
* to avoid conflicts with user variables named 'loop'.
|
|
62
|
-
*
|
|
63
|
-
* @param template - Template string to process
|
|
64
|
-
* @param context - Template context with variables
|
|
65
|
-
* @param filePath - Path to template file for error messages
|
|
66
|
-
* @param options - Optional stx configuration
|
|
67
|
-
*/
|
|
68
|
-
export { parseLoopBinding } from './loop-binding';
|
|
69
3
|
/**
|
|
70
4
|
* Print the "not iterable" warning for every loop still in `html`, and strip
|
|
71
5
|
* the markers. Call it after the conditionals around the loops are decided.
|
|
@@ -100,3 +34,27 @@ export declare function processLoops(template: string, context: Record<string, a
|
|
|
100
34
|
* (`i = 0; …`) re-uses a variable on purpose and is left alone.
|
|
101
35
|
*/
|
|
102
36
|
export declare function declareBareLoopHead(expr: string): string;
|
|
37
|
+
/**
|
|
38
|
+
* Process loops (@foreach, @for, @while, @forelse)
|
|
39
|
+
*
|
|
40
|
+
* Loop Configuration (via options.loops):
|
|
41
|
+
* - maxWhileIterations: Safety limit for @while loops (default: 1000)
|
|
42
|
+
* - useAltLoopVariable: Use $loop instead of loop (default: false)
|
|
43
|
+
*
|
|
44
|
+
* Loop Context Variables:
|
|
45
|
+
* Within @foreach loops, a loop context object is available:
|
|
46
|
+
* - loop.index: Current zero-based index
|
|
47
|
+
* - loop.iteration: Current one-based iteration count
|
|
48
|
+
* - loop.first: Boolean, true if first iteration
|
|
49
|
+
* - loop.last: Boolean, true if last iteration
|
|
50
|
+
* - loop.count: Total number of items
|
|
51
|
+
*
|
|
52
|
+
* If options.loops.useAltLoopVariable is true, use $loop instead of loop
|
|
53
|
+
* to avoid conflicts with user variables named 'loop'.
|
|
54
|
+
*
|
|
55
|
+
* @param template - Template string to process
|
|
56
|
+
* @param context - Template context with variables
|
|
57
|
+
* @param filePath - Path to template file for error messages
|
|
58
|
+
* @param options - Optional stx configuration
|
|
59
|
+
*/
|
|
60
|
+
export { parseLoopBinding } from './loop-binding';
|
package/dist/markdown.d.ts
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
* Process markdown directives in templates
|
|
3
3
|
* Converts markdown content to HTML
|
|
4
4
|
*/
|
|
5
|
+
// eslint-disable-next-line pickier/no-unused-vars
|
|
5
6
|
export declare function processMarkdownDirectives(template: string, context: Record<string, any>, filePath?: string): Promise<string>;
|
|
6
7
|
/**
|
|
7
8
|
* Custom directive handler for markdown
|
|
@@ -1,23 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Image Component
|
|
3
|
-
*
|
|
4
|
-
* Render optimized responsive images with srcset, lazy loading,
|
|
5
|
-
* and blur-up placeholder effects.
|
|
6
|
-
*
|
|
7
|
-
* @module media/image/component
|
|
8
|
-
*/
|
|
9
1
|
import type { ImageRenderContext, ImageRenderResult, ImgProps, EnhancedImgProps, TsImagesConfig, ProcessedImageResult, ResponsiveVariantSet } from '../types';
|
|
10
|
-
/**
|
|
11
|
-
* Extended image render context with ts-images config
|
|
12
|
-
*/
|
|
13
|
-
export interface ExtendedImageRenderContext extends ImageRenderContext {
|
|
14
|
-
/** ts-images configuration */
|
|
15
|
-
tsImagesConfig?: TsImagesConfig;
|
|
16
|
-
/** Processed image result (pre-computed) */
|
|
17
|
-
processedResult?: ProcessedImageResult;
|
|
18
|
-
/** Responsive variants (pre-computed) */
|
|
19
|
-
responsiveVariants?: ResponsiveVariantSet;
|
|
20
|
-
}
|
|
21
2
|
/**
|
|
22
3
|
* Render an optimized <Img> component
|
|
23
4
|
*
|
|
@@ -52,9 +33,12 @@ export declare function parseImgComponent(content: string): ImgProps | null;
|
|
|
52
33
|
/**
|
|
53
34
|
* Process all <Img> components in template content
|
|
54
35
|
*/
|
|
55
|
-
export declare function processImgComponents(content: string, context?: ImageRenderContext): Promise<{
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
36
|
+
export declare function processImgComponents(content: string, context?: ImageRenderContext): Promise<{ html: string; preloadLinks: string[]; styles: string[]; scripts: string[] }>;
|
|
37
|
+
/**
|
|
38
|
+
* Extended image render context with ts-images config
|
|
39
|
+
*/
|
|
40
|
+
export declare interface ExtendedImageRenderContext extends ImageRenderContext {
|
|
41
|
+
tsImagesConfig?: TsImagesConfig
|
|
42
|
+
processedResult?: ProcessedImageResult
|
|
43
|
+
responsiveVariants?: ResponsiveVariantSet
|
|
44
|
+
}
|
|
@@ -1,17 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Image Directive
|
|
3
|
-
*
|
|
4
|
-
* @img directive for declarative responsive image rendering.
|
|
5
|
-
*
|
|
6
|
-
* @module media/image/directive
|
|
7
|
-
*
|
|
8
|
-
* @example
|
|
9
|
-
* ```html
|
|
10
|
-
* @img('/images/hero.jpg', 'Hero image', { sizes: '100vw', placeholder: 'thumbhash' })
|
|
11
|
-
* @img('/images/photo.jpg', 'Photo')
|
|
12
|
-
* @img(dynamicSrc, dynamicAlt, { lazy: true })
|
|
13
|
-
* ```
|
|
14
|
-
*/
|
|
15
1
|
import type { CustomDirective } from '../../types';
|
|
16
2
|
/**
|
|
17
3
|
* Create the @img directive
|
|
@@ -20,4 +6,4 @@ export declare function createImgDirective(): CustomDirective;
|
|
|
20
6
|
/**
|
|
21
7
|
* The @img directive instance
|
|
22
8
|
*/
|
|
23
|
-
export declare const imgDirective:
|
|
9
|
+
export declare const imgDirective: unknown;
|
|
@@ -1,20 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Placeholder Generation
|
|
3
|
-
*
|
|
4
|
-
* Generate low-quality image placeholders (LQIP) for blur-up lazy loading effects.
|
|
5
|
-
* Supports multiple strategies: blur, thumbhash, blurhash, pixelate, dominant-color.
|
|
6
|
-
*
|
|
7
|
-
* @module media/image/placeholder
|
|
8
|
-
*/
|
|
9
1
|
import type { PlaceholderOptions, PlaceholderResult } from '../types';
|
|
10
|
-
/**
|
|
11
|
-
* Default placeholder options
|
|
12
|
-
*/
|
|
13
|
-
export declare const DEFAULT_PLACEHOLDER_OPTIONS: PlaceholderOptions;
|
|
14
|
-
/**
|
|
15
|
-
* CSS for blur-up transition
|
|
16
|
-
*/
|
|
17
|
-
export declare const BLUR_UP_CSS: string;
|
|
18
2
|
/**
|
|
19
3
|
* Generate a placeholder for an image using the specified strategy
|
|
20
4
|
*
|
|
@@ -83,7 +67,12 @@ export declare function clearPlaceholderCache(): void;
|
|
|
83
67
|
/**
|
|
84
68
|
* Get cache statistics
|
|
85
69
|
*/
|
|
86
|
-
export declare function getPlaceholderCacheStats(): {
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
70
|
+
export declare function getPlaceholderCacheStats(): { size: number; keys: string[] };
|
|
71
|
+
/**
|
|
72
|
+
* Default placeholder options
|
|
73
|
+
*/
|
|
74
|
+
export declare const DEFAULT_PLACEHOLDER_OPTIONS: PlaceholderOptions;
|
|
75
|
+
/**
|
|
76
|
+
* CSS for blur-up transition
|
|
77
|
+
*/
|
|
78
|
+
export declare const BLUR_UP_CSS: unknown;
|
|
@@ -1,44 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Image Processing Cache
|
|
3
|
-
*
|
|
4
|
-
* Specialized cache for image processing results.
|
|
5
|
-
*
|
|
6
|
-
* @module media/image/processor/cache
|
|
7
|
-
*/
|
|
8
|
-
import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig } from '../../types';
|
|
9
1
|
import { type CacheConfig } from '../../shared/cache';
|
|
10
|
-
|
|
11
|
-
* Image processor cache configuration
|
|
12
|
-
*/
|
|
13
|
-
export interface ImageCacheConfig extends CacheConfig {
|
|
14
|
-
/** Cache variants separately */
|
|
15
|
-
cacheVariants?: boolean;
|
|
16
|
-
/** Cache placeholders separately */
|
|
17
|
-
cachePlaceholders?: boolean;
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Image processor cache class
|
|
21
|
-
*/
|
|
22
|
-
export declare class ImageProcessorCache {
|
|
23
|
-
private config;
|
|
24
|
-
constructor(config?: Partial<ImageCacheConfig>);
|
|
25
|
-
/**
|
|
26
|
-
* Get cached processing result
|
|
27
|
-
*/
|
|
28
|
-
get(src: string, options: Partial<EnhancedImgProps>): Promise<ProcessedImageResult | null>;
|
|
29
|
-
/**
|
|
30
|
-
* Set cached processing result
|
|
31
|
-
*/
|
|
32
|
-
set(src: string, options: Partial<EnhancedImgProps>, result: ProcessedImageResult): Promise<void>;
|
|
33
|
-
/**
|
|
34
|
-
* Clear the entire image cache
|
|
35
|
-
*/
|
|
36
|
-
clear(): Promise<void>;
|
|
37
|
-
/**
|
|
38
|
-
* Update cache configuration
|
|
39
|
-
*/
|
|
40
|
-
updateConfig(config: Partial<ImageCacheConfig>): void;
|
|
41
|
-
}
|
|
2
|
+
import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig } from '../../types';
|
|
42
3
|
/**
|
|
43
4
|
* Get cached image processing result
|
|
44
5
|
*/
|
|
@@ -51,3 +12,20 @@ export declare function setCachedImageResult(src: string, options: Partial<Enhan
|
|
|
51
12
|
* Clear image processing cache
|
|
52
13
|
*/
|
|
53
14
|
export declare function clearImageCache(): Promise<void>;
|
|
15
|
+
/**
|
|
16
|
+
* Image processor cache configuration
|
|
17
|
+
*/
|
|
18
|
+
export declare interface ImageCacheConfig extends CacheConfig {
|
|
19
|
+
cacheVariants?: boolean
|
|
20
|
+
cachePlaceholders?: boolean
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Image processor cache class
|
|
24
|
+
*/
|
|
25
|
+
export declare class ImageProcessorCache {
|
|
26
|
+
constructor(config?: Partial<ImageCacheConfig>);
|
|
27
|
+
get(src: string, options: Partial<EnhancedImgProps>): Promise<ProcessedImageResult | null>;
|
|
28
|
+
set(src: string, options: Partial<EnhancedImgProps>, result: ProcessedImageResult): Promise<void>;
|
|
29
|
+
clear(): Promise<void>;
|
|
30
|
+
updateConfig(config: Partial<ImageCacheConfig>): void;
|
|
31
|
+
}
|
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
// Re-export types for convenience
|
|
2
|
+
export type {
|
|
3
|
+
EnhancedImgProps,
|
|
4
|
+
ProcessedImageResult,
|
|
5
|
+
ResponsiveVariantSet,
|
|
6
|
+
TsImagesConfig,
|
|
7
|
+
ImageOptimizationPreset,
|
|
8
|
+
ImageTransformationConfig,
|
|
9
|
+
FormatQualitySettings,
|
|
10
|
+
} from '../../types';
|
|
1
11
|
/**
|
|
2
12
|
* STX Media - Image Processor
|
|
3
13
|
*
|
|
@@ -8,4 +18,3 @@
|
|
|
8
18
|
export { processImage, optimizeImage, applyTransformations } from './optimizer';
|
|
9
19
|
export { generateResponsiveVariants, generateSrcset } from './responsive';
|
|
10
20
|
export { getCachedImageResult, setCachedImageResult, clearImageCache, ImageProcessorCache } from './cache';
|
|
11
|
-
export type { EnhancedImgProps, ProcessedImageResult, ResponsiveVariantSet, TsImagesConfig, ImageOptimizationPreset, ImageTransformationConfig, FormatQualitySettings, } from '../../types';
|
|
@@ -1,10 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Image Optimizer
|
|
3
|
-
*
|
|
4
|
-
* Wraps ts-images for image optimization and transformation.
|
|
5
|
-
*
|
|
6
|
-
* @module media/image/processor/optimizer
|
|
7
|
-
*/
|
|
8
1
|
import type { EnhancedImgProps, ProcessedImageResult, TsImagesConfig, ImageFormat, ImageTransformationConfig } from '../../types';
|
|
9
2
|
/**
|
|
10
3
|
* Process a single image with ts-images
|
|
@@ -13,11 +6,7 @@ export declare function processImage(src: string, options: Partial<EnhancedImgPr
|
|
|
13
6
|
/**
|
|
14
7
|
* Optimize a single image without responsive variants
|
|
15
8
|
*/
|
|
16
|
-
export declare function optimizeImage(src: string, format: ImageFormat, quality: number, outputPath: string): Promise<{
|
|
17
|
-
success: boolean;
|
|
18
|
-
size?: number;
|
|
19
|
-
error?: string;
|
|
20
|
-
}>;
|
|
9
|
+
export declare function optimizeImage(src: string, format: ImageFormat, quality: number, outputPath: string): Promise<{ success: boolean; size?: number; error?: string }>;
|
|
21
10
|
/**
|
|
22
11
|
* Apply transformations to an image
|
|
23
12
|
*/
|
|
@@ -1,15 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* STX Media - Responsive Image Generation
|
|
3
|
-
*
|
|
4
|
-
* Generates responsive image variants at multiple widths and formats.
|
|
5
|
-
*
|
|
6
|
-
* @module media/image/processor/responsive
|
|
7
|
-
*/
|
|
8
1
|
import type { EnhancedImgProps, ResponsiveVariantSet, TsImagesConfig, ProcessedImageResult } from '../../types';
|
|
9
|
-
/**
|
|
10
|
-
* Default responsive breakpoints
|
|
11
|
-
*/
|
|
12
|
-
export declare const DEFAULT_RESPONSIVE_WIDTHS: number[];
|
|
13
2
|
/**
|
|
14
3
|
* Generate responsive image variants using ts-images
|
|
15
4
|
*/
|
|
@@ -21,8 +10,9 @@ export declare function generateSrcset(variants: ProcessedImageResult['variants'
|
|
|
21
10
|
/**
|
|
22
11
|
* Generate art direction sources for <picture> element
|
|
23
12
|
*/
|
|
24
|
-
export declare function generateArtDirectionSources(src: string, artDirection: NonNullable<EnhancedImgProps['artDirection']>, config: TsImagesConfig): Promise<Array<{
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
13
|
+
export declare function generateArtDirectionSources(src: string, artDirection: NonNullable<EnhancedImgProps['artDirection']>, config: TsImagesConfig): Promise<Array<{ media: string; srcset: string; type: string }>>;
|
|
14
|
+
/**
|
|
15
|
+
* Default responsive breakpoints
|
|
16
|
+
* @defaultValue `[320, 480, 640, 768, 1024, 1280, 1536, 1920]`
|
|
17
|
+
*/
|
|
18
|
+
export declare const DEFAULT_RESPONSIVE_WIDTHS: number[];
|