@stacksjs/stx 0.2.572 → 0.2.573
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/a11y.d.ts +51 -111
- package/dist/animation.d.ts +131 -74
- package/dist/api-client.d.ts +11 -21
- package/dist/api-handler.d.ts +4 -4
- package/dist/appearance-bootstrap.d.ts +16 -77
- package/dist/application-layers.d.ts +11 -20
- package/dist/asset-roots.d.ts +7 -27
- package/dist/assets.d.ts +7 -9
- package/dist/async-components.d.ts +56 -78
- package/dist/auth.d.ts +0 -3
- package/dist/browser-core-imports.d.ts +2 -2
- package/dist/build-externalize-repeated.d.ts +0 -25
- package/dist/build-externalize.d.ts +18 -53
- package/dist/build-id.d.ts +40 -28
- package/dist/build-message.d.ts +20 -44
- package/dist/builtins/attrs.d.ts +0 -14
- package/dist/builtins/drawer.d.ts +3 -22
- package/dist/builtins/icon.d.ts +17 -19
- package/dist/builtins/image-alpha.d.ts +8 -8
- package/dist/builtins/image-delivery.d.ts +38 -40
- package/dist/builtins/image-placeholder.d.ts +12 -50
- package/dist/builtins/image-warmup-worker.d.ts +1 -1
- package/dist/builtins/image-worker.d.ts +6 -32
- package/dist/builtins/index.d.ts +16 -6
- package/dist/builtins/modal.d.ts +13 -23
- package/dist/builtins/safe-image.d.ts +2 -42
- package/dist/builtins/stx-image.d.ts +44 -24
- package/dist/builtins/stx-link.d.ts +5 -8
- package/dist/builtins/stx-loading-indicator.d.ts +11 -10
- package/dist/builtins/suspense.d.ts +6 -27
- package/dist/builtins/toast.d.ts +15 -16
- package/dist/builtins/transition-group.d.ts +1 -25
- package/dist/caching.d.ts +24 -21
- package/dist/{chunk-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
- package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
- package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
- package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
- package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
- package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
- package/dist/chunk-557wtdps.js +2 -0
- package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
- package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
- package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
- package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
- package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
- package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
- package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
- package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
- package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
- package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
- package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
- package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
- package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
- package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
- package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
- package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
- package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
- package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
- package/dist/{chunk-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
- package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
- package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
- package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
- package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
- package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
- package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
- package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
- package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
- package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
- package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
- package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
- package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
- package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
- package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
- package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
- package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
- package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
- package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
- package/dist/chunk-zpz6q2fh.js +2 -0
- package/dist/chunk-zxt94g45.js +2 -0
- package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
- package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
- package/dist/cli.js +7 -7
- package/dist/client/directive.d.ts +0 -7
- package/dist/client/index.d.ts +1 -0
- package/dist/client/signals-appearance-runtime.d.ts +1 -1
- package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
- package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
- package/dist/client/signals-class-runtime.d.ts +1 -1
- package/dist/client/signals-component-api-runtime.d.ts +1 -1
- package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-component-props-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
- package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
- package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
- package/dist/client/signals-context-runtime.d.ts +1 -1
- package/dist/client/signals-cookie-runtime.d.ts +1 -1
- package/dist/client/signals-devtools-runtime.d.ts +1 -1
- package/dist/client/signals-dialog-runtime.d.ts +1 -1
- package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
- package/dist/client/signals-drawer-runtime.d.ts +1 -1
- package/dist/client/signals-effect-runtime.d.ts +1 -1
- package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
- package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
- package/dist/client/signals-expression-runtime.d.ts +1 -1
- package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
- package/dist/client/signals-for-runtime.d.ts +1 -1
- package/dist/client/signals-globals-runtime.d.ts +1 -1
- package/dist/client/signals-handler-runtime.d.ts +1 -1
- package/dist/client/signals-head-runtime.d.ts +1 -1
- package/dist/client/signals-helpers-runtime.d.ts +1 -1
- package/dist/client/signals-host-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
- package/dist/client/signals-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-if-chain-runtime.d.ts +1 -1
- package/dist/client/signals-if-runtime.d.ts +1 -1
- package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
- package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
- package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
- package/dist/client/signals-loop-row-runtime.d.ts +1 -1
- package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
- package/dist/client/signals-model-runtime.d.ts +1 -1
- package/dist/client/signals-mount-runtime.d.ts +1 -1
- package/dist/client/signals-navigation-runtime.d.ts +1 -1
- package/dist/client/signals-notify-runtime.d.ts +1 -1
- package/dist/client/signals-optimistic-runtime.d.ts +1 -1
- package/dist/client/signals-overlay-runtime.d.ts +1 -1
- package/dist/client/signals-pipe-runtime.d.ts +1 -1
- package/dist/client/signals-proxy-runtime.d.ts +1 -1
- package/dist/client/signals-query-runtime.d.ts +1 -1
- package/dist/client/signals-reactive-runtime.d.ts +1 -1
- package/dist/client/signals-ref-runtime.d.ts +1 -1
- package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
- package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
- package/dist/client/signals-show-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
- package/dist/client/signals-spa-load-runtime.d.ts +1 -1
- package/dist/client/signals-state-runtime.d.ts +1 -1
- package/dist/client/signals-storage-runtime.d.ts +1 -1
- package/dist/client/signals-store-registry-runtime.d.ts +1 -1
- package/dist/client/signals-style-runtime.d.ts +1 -1
- package/dist/client/signals-suspense-runtime.d.ts +1 -1
- package/dist/client/signals-timer-runtime.d.ts +1 -1
- package/dist/client/signals-toast-runtime.d.ts +1 -1
- package/dist/client/signals-tooltip-runtime.d.ts +1 -1
- package/dist/client/signals-transition-group-runtime.d.ts +1 -1
- package/dist/client/signals-websocket-runtime.d.ts +1 -1
- package/dist/client-helpers.d.ts +1 -312
- package/dist/client-module-registry.d.ts +4 -27
- package/dist/client-parameter-bindings.d.ts +1 -4
- package/dist/client-script-bundler.d.ts +55 -103
- package/dist/client-script.d.ts +69 -127
- package/dist/color-mode-boot.d.ts +21 -58
- package/dist/component-client-factories.d.ts +8 -9
- package/dist/component-contract-checks.d.ts +15 -18
- package/dist/component-contract.d.ts +6 -6
- package/dist/component-hmr.d.ts +8 -7
- package/dist/component-model.d.ts +14 -20
- package/dist/component-processing.d.ts +51 -59
- package/dist/component-registry.d.ts +28 -99
- package/dist/component-renderer.d.ts +19 -16
- package/dist/component-resolution.d.ts +8 -8
- package/dist/component-tags.d.ts +1 -1
- package/dist/composable-loader.d.ts +6 -41
- package/dist/composables/use-fetch.d.ts +45 -114
- package/dist/composables/use-form.d.ts +2 -56
- package/dist/composables/use-intersection-observer.d.ts +1 -1
- package/dist/composables.d.ts +75 -74
- package/dist/composition-api.d.ts +19 -43
- package/dist/computed.d.ts +93 -86
- package/dist/conditionals.d.ts +0 -24
- package/dist/config.d.ts +30 -24
- package/dist/config.js +3 -0
- package/dist/craft-bridge.d.ts +1 -467
- package/dist/craft-components.d.ts +234 -680
- package/dist/craft-entry.js +1 -1
- package/dist/craft.js +1 -1
- package/dist/csp.d.ts +41 -107
- package/dist/database.d.ts +1 -1
- package/dist/defer.d.ts +0 -24
- package/dist/dev-server/terminal-colors.d.ts +32 -32
- package/dist/dev-server/ts-css.d.ts +26 -35
- package/dist/dev-server/types.d.ts +33 -29
- package/dist/directive-api.d.ts +42 -85
- package/dist/directive-arguments.d.ts +14 -39
- package/dist/document-shell.d.ts +49 -81
- package/dist/dynamic-components.d.ts +0 -9
- package/dist/engine-bindings.d.ts +1 -1
- package/dist/env.d.ts +26 -0
- package/dist/error-boundaries.d.ts +36 -43
- package/dist/error-handling.d.ts +1 -1
- package/dist/errors/codes.d.ts +43 -51
- package/dist/errors/formatter.d.ts +38 -58
- package/dist/errors/index.d.ts +61 -5
- package/dist/errors/logger.d.ts +40 -114
- package/dist/errors/sanitizer.d.ts +28 -53
- package/dist/errors/types.d.ts +31 -44
- package/dist/events.d.ts +32 -94
- package/dist/expressions.d.ts +57 -62
- package/dist/find-body-tag.d.ts +5 -34
- package/dist/first-script-tag.d.ts +0 -23
- package/dist/forms-validation.d.ts +117 -149
- package/dist/forms.d.ts +161 -120
- package/dist/framework-composables.d.ts +0 -32
- package/dist/head-injection.d.ts +30 -32
- package/dist/head-keys.d.ts +12 -15
- package/dist/head.d.ts +110 -139
- package/dist/heatmap.d.ts +76 -152
- package/dist/html-masking.d.ts +38 -62
- package/dist/hydration-runtime.d.ts +24 -20
- package/dist/hydration.d.ts +11 -10
- package/dist/i18n.d.ts +34 -95
- package/dist/image-optimization/auto-sibling.d.ts +4 -32
- package/dist/imported-signals.d.ts +0 -36
- package/dist/includes.d.ts +6 -69
- package/dist/index.d.ts +2 -1
- package/dist/init.d.ts +12 -20
- package/dist/internal-markdown.d.ts +8 -12
- package/dist/interpolation-context.d.ts +15 -15
- package/dist/island-chunking.d.ts +13 -30
- package/dist/keep-alive.d.ts +52 -72
- package/dist/layout-types.d.ts +2 -27
- package/dist/lazy-module.d.ts +0 -10
- package/dist/loading-indicator.d.ts +8 -5
- package/dist/loop-binding.d.ts +4 -7
- package/dist/loops.d.ts +25 -67
- package/dist/markdown.d.ts +1 -0
- package/dist/media/image/component.d.ts +9 -25
- package/dist/media/image/directive.d.ts +1 -15
- package/dist/media/image/placeholder.d.ts +9 -20
- package/dist/media/image/processor/cache.d.ts +18 -40
- package/dist/media/image/processor/index.d.ts +10 -1
- package/dist/media/image/processor/optimizer.d.ts +1 -12
- package/dist/media/image/processor/responsive.d.ts +6 -16
- package/dist/media/image/srcset.d.ts +49 -47
- package/dist/media/shared/cache.d.ts +31 -51
- package/dist/media/shared/hash.d.ts +0 -7
- package/dist/media/types.d.ts +754 -1235
- package/dist/media/video/directive.d.ts +1 -15
- package/dist/media/video/index.d.ts +17 -39
- package/dist/media/video/processor/cache.d.ts +19 -42
- package/dist/media/video/processor/index.d.ts +18 -1
- package/dist/media/video/processor/streaming.d.ts +10 -17
- package/dist/media/video/processor/thumbnail.d.ts +15 -21
- package/dist/media/video/processor/transcoder.d.ts +1 -11
- package/dist/meta-arguments.d.ts +14 -39
- package/dist/method-spoofing.d.ts +0 -7
- package/dist/middleware.d.ts +0 -60
- package/dist/native/bridge/protocol.d.ts +2 -1
- package/dist/native/compiler/headwind-to-style.d.ts +383 -359
- package/dist/native/compiler/icons.d.ts +249 -243
- package/dist/native/compiler/svg.d.ts +35 -24
- package/dist/native/runtime/jsc-globals.d.ts +1 -1
- package/dist/native/runtime/native-host.d.ts +1 -1
- package/dist/native/runtime/native-host.js +3 -0
- package/dist/offline/app-service-worker.d.ts +50 -114
- package/dist/offline/kept-store.d.ts +23 -37
- package/dist/offline/query-cache.d.ts +55 -126
- package/dist/owned-routes.d.ts +0 -31
- package/dist/page-response.d.ts +8 -39
- package/dist/parser/directive-parser.d.ts +45 -57
- package/dist/parser/expression-parser.d.ts +35 -33
- package/dist/parser/index.d.ts +39 -4
- package/dist/parser/tokenizer.d.ts +49 -61
- package/dist/partial-hydration.d.ts +51 -82
- package/dist/performance-utils.d.ts +115 -255
- package/dist/placeholder.d.ts +9 -18
- package/dist/plugin-system.d.ts +115 -264
- package/dist/process.d.ts +4 -9
- package/dist/process.js +6 -4
- package/dist/prop-sentinels.d.ts +11 -11
- package/dist/public-env.d.ts +0 -14
- package/dist/pwa/directives.d.ts +20 -12
- package/dist/pwa/inject.d.ts +0 -10
- package/dist/pwa/precache.d.ts +16 -22
- package/dist/pwa/service-worker.d.ts +0 -12
- package/dist/pwa.js +1 -1
- package/dist/reactive-bindings.d.ts +11 -34
- package/dist/reactive-tracking.d.ts +0 -36
- package/dist/reactive.d.ts +41 -58
- package/dist/render-memo.d.ts +5 -23
- package/dist/resolve-stx-targets.d.ts +6 -44
- package/dist/route-middleware.d.ts +35 -2
- package/dist/route-rules.d.ts +10 -13
- package/dist/router.d.ts +9 -8
- package/dist/routes.d.ts +3 -1
- package/dist/runtime-config-server.d.ts +14 -17
- package/dist/runtime-config.d.ts +2 -3
- package/dist/runtime-globals.d.ts +90 -122
- package/dist/runtime-injection.d.ts +0 -8
- package/dist/scaffolding.d.ts +30 -26
- package/dist/script-emit.d.ts +0 -30
- package/dist/script-validation.d.ts +6 -12
- package/dist/seo.d.ts +75 -153
- package/dist/server-api.d.ts +9 -12
- package/dist/server-bindings.d.ts +1 -26
- package/dist/server-data.d.ts +4 -5
- package/dist/sfc-template.d.ts +8 -8
- package/dist/signal-processing.d.ts +37 -53
- package/dist/signals-api.d.ts +58 -135
- package/dist/signals.d.ts +18 -24
- package/dist/site-url.d.ts +31 -28
- package/dist/slots.d.ts +20 -86
- package/dist/source-signature.d.ts +5 -28
- package/dist/ssg.d.ts +158 -337
- package/dist/ssg.js +2 -2
- package/dist/state-dir.d.ts +4 -4
- package/dist/store-loader.d.ts +0 -10
- package/dist/story/analytics.d.ts +60 -138
- package/dist/story/bookmarks.d.ts +34 -87
- package/dist/story/cli.d.ts +69 -123
- package/dist/story/collect/scanner.d.ts +0 -4
- package/dist/story/collect/tree.d.ts +1 -8
- package/dist/story/commands/build.d.ts +6 -11
- package/dist/story/commands/dev.d.ts +8 -15
- package/dist/story/commands/preview.d.ts +7 -13
- package/dist/story/config-watcher.d.ts +13 -20
- package/dist/story/config.d.ts +8 -11
- package/dist/story/context.d.ts +8 -14
- package/dist/story/hmr.d.ts +26 -24
- package/dist/story/hot-swap.d.ts +23 -34
- package/dist/story/keyboard-shortcuts.d.ts +18 -23
- package/dist/story/output.d.ts +44 -46
- package/dist/story/performance.d.ts +45 -107
- package/dist/story/presets.d.ts +41 -107
- package/dist/story/renderer.d.ts +27 -41
- package/dist/story/search.d.ts +12 -23
- package/dist/story/server.d.ts +11 -21
- package/dist/story/setup.d.ts +15 -23
- package/dist/story/testing.d.ts +40 -65
- package/dist/story/types.d.ts +160 -262
- package/dist/streaming.d.ts +57 -119
- package/dist/strip-literals.d.ts +1 -25
- package/dist/stx-module-imports.d.ts +7 -0
- package/dist/stx-virtual-ts.d.ts +102 -253
- package/dist/style-scoping.d.ts +8 -21
- package/dist/suspense.d.ts +52 -67
- package/dist/teleport.d.ts +0 -22
- package/dist/template-syntax-escape.d.ts +8 -8
- package/dist/template-tag-balance.d.ts +6 -22
- package/dist/testing.d.ts +26 -11
- package/dist/theme-tokens.d.ts +388 -134
- package/dist/transitions.d.ts +55 -66
- package/dist/ts-css-config.d.ts +12 -70
- package/dist/types/component-types.d.ts +122 -187
- package/dist/types/config-types.d.ts +341 -956
- package/dist/types/context-types.d.ts +24 -46
- package/dist/types/csp-types.d.ts +66 -70
- package/dist/types/directive-types.d.ts +156 -223
- package/dist/types/index.d.ts +110 -6
- package/dist/types/pwa-types.d.ts +148 -273
- package/dist/types.d.ts +1 -0
- package/dist/unresolved-identifiers.d.ts +22 -24
- package/dist/url-safety.d.ts +32 -32
- package/dist/utils.d.ts +21 -36
- package/dist/validator.d.ts +26 -28
- package/dist/variable-extractor.d.ts +19 -49
- package/dist/view-composers.d.ts +81 -80
- package/dist/virtual-scrolling.d.ts +82 -101
- package/dist/visual-testing.d.ts +10 -9
- package/dist/vue-template.d.ts +0 -23
- package/dist/web-components/css-scoping.d.ts +11 -21
- package/dist/web-components.d.ts +58 -81
- package/dist/x-element.d.ts +1 -0
- package/package.json +6 -6
- package/stx.d.ts +2 -2
- package/dist/app-service-worker.d.ts +0 -165
- package/dist/chunk-49gwmcrn.js +0 -2
- package/dist/chunk-6va5pe2m.js +0 -2
- package/dist/chunk-bm2q1srp.js +0 -2
- package/dist/signals-context-runtime.d.ts +0 -2
- package/dist/signals-drawer-runtime.d.ts +0 -2
- package/dist/signals-host-runtime.d.ts +0 -9
- package/dist/signals-loop-conditional-runtime.d.ts +0 -2
- package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
- package/dist/signals-notify-runtime.d.ts +0 -2
- package/dist/signals-optimistic-runtime.d.ts +0 -2
- package/dist/signals-overlay-runtime.d.ts +0 -2
- package/dist/signals-scope-disposal-runtime.d.ts +0 -2
- package/dist/signals-spa-load-control-runtime.d.ts +0 -2
- package/dist/signals-storage-runtime.d.ts +0 -2
package/dist/assets.d.ts
CHANGED
|
@@ -1,21 +1,19 @@
|
|
|
1
1
|
import type { StxOptions } from './types';
|
|
2
|
-
export declare const markdownCache: Map<string, {
|
|
3
|
-
content: string;
|
|
4
|
-
data: Record<string, any>;
|
|
5
|
-
updatedAt: number;
|
|
6
|
-
}>;
|
|
7
2
|
/**
|
|
8
3
|
* Read and parse a markdown file with frontmatter
|
|
9
4
|
* @param filePath Path to the markdown file
|
|
10
5
|
* @param options stx options
|
|
11
6
|
* @returns Object containing parsed content and frontmatter data
|
|
12
7
|
*/
|
|
13
|
-
export declare function readMarkdownFile(filePath: string, options?: StxOptions): Promise<{
|
|
14
|
-
content: string;
|
|
15
|
-
data: Record<string, any>;
|
|
16
|
-
}>;
|
|
8
|
+
export declare function readMarkdownFile(filePath: string, options?: StxOptions): Promise<{ content: string, data: Record<string, any> }>;
|
|
17
9
|
/**
|
|
18
10
|
* Process @markdown-file directive
|
|
19
11
|
* This directive includes markdown files in templates
|
|
20
12
|
*/
|
|
21
13
|
export declare function processMarkdownFileDirectives(template: string, context: Record<string, any>, filePath?: string, options?: StxOptions): Promise<string>;
|
|
14
|
+
// Define a cache for markdown files to avoid repeated file reads
|
|
15
|
+
export declare const markdownCache: Map<string, {
|
|
16
|
+
content: string
|
|
17
|
+
data: Record<string, any>
|
|
18
|
+
updatedAt: number
|
|
19
|
+
}>;
|
|
@@ -1,3 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Process @async directives in templates.
|
|
3
|
+
*
|
|
4
|
+
* Syntax:
|
|
5
|
+
* @async(component: 'ComponentName', timeout: 5000)
|
|
6
|
+
* <loading content>
|
|
7
|
+
* @error
|
|
8
|
+
* <error content>
|
|
9
|
+
* @endasync
|
|
10
|
+
*/
|
|
11
|
+
export declare function processAsyncDirectives(template: string, _context?: Record<string, unknown>, _filePath?: string): string;
|
|
12
|
+
/**
|
|
13
|
+
* Define an async component.
|
|
14
|
+
*/
|
|
15
|
+
export declare function defineAsyncComponent(options: DefineAsyncComponentOptions | (() => Promise<{ default: string } | string>)): AsyncComponentDefinition;
|
|
16
|
+
/**
|
|
17
|
+
* Check if a value is an async component definition.
|
|
18
|
+
*/
|
|
19
|
+
export declare function isAsyncComponent(value: unknown): value is AsyncComponentDefinition;
|
|
20
|
+
/**
|
|
21
|
+
* Generate CSS for async component styling.
|
|
22
|
+
*/
|
|
23
|
+
export declare function generateAsyncComponentCSS(): string;
|
|
24
|
+
/**
|
|
25
|
+
* Generate client-side runtime for async components.
|
|
26
|
+
*/
|
|
27
|
+
export declare function generateAsyncComponentRuntime(): string;
|
|
1
28
|
/**
|
|
2
29
|
* STX Async Components
|
|
3
30
|
*
|
|
@@ -25,45 +52,25 @@
|
|
|
25
52
|
* </AsyncComponent>
|
|
26
53
|
* ```
|
|
27
54
|
*/
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
errorComponent?: string;
|
|
41
|
-
/** Retry attempts on failure (default: 0) */
|
|
42
|
-
retries?: number;
|
|
43
|
-
/** Props to pass to the loaded component */
|
|
44
|
-
props?: Record<string, unknown>;
|
|
55
|
+
// =============================================================================
|
|
56
|
+
// Types
|
|
57
|
+
// =============================================================================
|
|
58
|
+
export declare interface AsyncComponentOptions {
|
|
59
|
+
component: string
|
|
60
|
+
timeout?: number
|
|
61
|
+
delay?: number
|
|
62
|
+
suspensible?: boolean
|
|
63
|
+
loadingComponent?: string
|
|
64
|
+
errorComponent?: string
|
|
65
|
+
retries?: number
|
|
66
|
+
props?: Record<string, unknown>
|
|
45
67
|
}
|
|
46
|
-
export interface AsyncComponentState {
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
/** Error if loading failed */
|
|
52
|
-
error: Error | null;
|
|
53
|
-
/** Number of retry attempts made */
|
|
54
|
-
attempts: number;
|
|
68
|
+
export declare interface AsyncComponentState {
|
|
69
|
+
status: 'pending' | 'loading' | 'resolved' | 'rejected'
|
|
70
|
+
component: string | null
|
|
71
|
+
error: Error | null
|
|
72
|
+
attempts: number
|
|
55
73
|
}
|
|
56
|
-
/**
|
|
57
|
-
* Process @async directives in templates.
|
|
58
|
-
*
|
|
59
|
-
* Syntax:
|
|
60
|
-
* @async(component: 'ComponentName', timeout: 5000)
|
|
61
|
-
* <loading content>
|
|
62
|
-
* @error
|
|
63
|
-
* <error content>
|
|
64
|
-
* @endasync
|
|
65
|
-
*/
|
|
66
|
-
export declare function processAsyncDirectives(template: string, _context?: Record<string, unknown>, _filePath?: string): string;
|
|
67
74
|
/**
|
|
68
75
|
* Define an async component for programmatic use.
|
|
69
76
|
*
|
|
@@ -78,46 +85,17 @@ export declare function processAsyncDirectives(template: string, _context?: Reco
|
|
|
78
85
|
* })
|
|
79
86
|
* ```
|
|
80
87
|
*/
|
|
81
|
-
export interface DefineAsyncComponentOptions {
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
delay?: number;
|
|
92
|
-
/** Timeout before showing error (ms) */
|
|
93
|
-
timeout?: number;
|
|
94
|
-
/** Whether to suspend parent Suspense */
|
|
95
|
-
suspensible?: boolean;
|
|
96
|
-
/** Called when loading starts */
|
|
97
|
-
onLoadStart?: () => void;
|
|
98
|
-
/** Called when component is loaded */
|
|
99
|
-
onLoadEnd?: () => void;
|
|
100
|
-
/** Called on error */
|
|
101
|
-
onError?: (error: Error, retry: () => void, fail: () => void, attempts: number) => void;
|
|
88
|
+
export declare interface DefineAsyncComponentOptions {
|
|
89
|
+
loader: () => Promise<{ default: string } | string>
|
|
90
|
+
loadingComponent?: string
|
|
91
|
+
errorComponent?: string
|
|
92
|
+
delay?: number
|
|
93
|
+
timeout?: number
|
|
94
|
+
suspensible?: boolean
|
|
95
|
+
onLoadStart?: () => void
|
|
96
|
+
onLoadEnd?: () => void
|
|
97
|
+
onError?: (error: Error, retry: () => void, fail: () => void, attempts: number) => void
|
|
102
98
|
}
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
*/
|
|
106
|
-
export declare function defineAsyncComponent(options: DefineAsyncComponentOptions | (() => Promise<{
|
|
107
|
-
default: string;
|
|
108
|
-
} | string>)): AsyncComponentDefinition;
|
|
109
|
-
export interface AsyncComponentDefinition extends DefineAsyncComponentOptions {
|
|
110
|
-
__asyncComponent: true;
|
|
99
|
+
export declare interface AsyncComponentDefinition extends DefineAsyncComponentOptions {
|
|
100
|
+
__asyncComponent: true
|
|
111
101
|
}
|
|
112
|
-
/**
|
|
113
|
-
* Check if a value is an async component definition.
|
|
114
|
-
*/
|
|
115
|
-
export declare function isAsyncComponent(value: unknown): value is AsyncComponentDefinition;
|
|
116
|
-
/**
|
|
117
|
-
* Generate CSS for async component styling.
|
|
118
|
-
*/
|
|
119
|
-
export declare function generateAsyncComponentCSS(): string;
|
|
120
|
-
/**
|
|
121
|
-
* Generate client-side runtime for async components.
|
|
122
|
-
*/
|
|
123
|
-
export declare function generateAsyncComponentRuntime(): string;
|
package/dist/auth.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
/** The shipped ambient declarations for the same browser auto-import manifest. */
|
|
2
|
+
export declare function generateBrowserAutoImportsDts(): string;
|
|
1
3
|
/**
|
|
2
4
|
* The names stx auto-imports into a client script from `@stacksjs/browser`.
|
|
3
5
|
*
|
|
@@ -10,5 +12,3 @@
|
|
|
10
12
|
* wrong.
|
|
11
13
|
*/
|
|
12
14
|
export declare const BROWSER_CORE_IMPORTS: readonly string[];
|
|
13
|
-
/** The shipped ambient declarations for the same browser auto-import manifest. */
|
|
14
|
-
export declare function generateBrowserAutoImportsDts(): string;
|
|
@@ -1,28 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Lift inline blobs that repeat across pages, whatever they are.
|
|
3
|
-
*
|
|
4
|
-
* `build-externalize` handles the three blobs stx knows by name — the signals
|
|
5
|
-
* runtime, the router, and the generated stylesheet. Everything else it emits
|
|
6
|
-
* inline stays inline, and on a real multi-page site that is where the bytes
|
|
7
|
-
* actually are: the ts-cloud dashboard ships 54 pages at 12.5MB, of which
|
|
8
|
-
* 10.3MB is byte-identical `<script data-stx-scoped>` and unattributed
|
|
9
|
-
* `<style>` blocks repeated page after page. None of it is cacheable across a
|
|
10
|
-
* navigation, and it is 4x the size of the three named blobs combined.
|
|
11
|
-
*
|
|
12
|
-
* The rule here needs no allowlist: a blob that appears byte-for-byte on two
|
|
13
|
-
* or more pages is shared by construction, so hoisting it into one
|
|
14
|
-
* content-addressed file is a pure win — every page that referenced it now
|
|
15
|
-
* downloads it once for the whole site instead of once per page. A blob that
|
|
16
|
-
* appears on exactly one page is left alone, because turning it into a second
|
|
17
|
-
* request would make that page slower, not smaller.
|
|
18
|
-
*
|
|
19
|
-
* Requires the whole output directory, which is why it is a separate pass from
|
|
20
|
-
* the pure per-document `externalizeHtml`: "does this appear elsewhere" is not
|
|
21
|
-
* a question one document can answer, and SSR (which shares that function) has
|
|
22
|
-
* no elsewhere to look at.
|
|
23
|
-
*
|
|
24
|
-
* @module build-externalize-repeated
|
|
25
|
-
*/
|
|
26
1
|
import { type ExternalizeResult } from './build-externalize';
|
|
27
2
|
/**
|
|
28
3
|
* Hoist every inline script/style body that appears on more than one page.
|
|
@@ -1,56 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Lift shared inline blobs out of built HTML into content-hashed assets.
|
|
3
|
-
*
|
|
4
|
-
* The static build inlines the whole signals runtime and the whole generated
|
|
5
|
-
* stylesheet into every page. On a 35-page site that is ~118KB of
|
|
6
|
-
* byte-identical runtime per page and a separate copy of the reset in each one,
|
|
7
|
-
* none of it cacheable across a navigation, and `find dist -name '*.js'`
|
|
8
|
-
* returns nothing at all (stacksjs/stx#1865, #1878).
|
|
9
|
-
*
|
|
10
|
-
* Done as a post-pass over the emitted HTML rather than by threading
|
|
11
|
-
* `buildMode` through the renderer, deliberately. The existing `compile` branch
|
|
12
|
-
* emits `/__stx/runtime.__STX_HASH__.js`, a placeholder only the production
|
|
13
|
-
* builder knows how to rewrite, and setting that mode also suppresses the
|
|
14
|
-
* document shell — so reusing it on the SSG path produces pages that reference
|
|
15
|
-
* a 404 and lose their `<html>` wrapper. A post-pass needs neither.
|
|
16
|
-
*
|
|
17
|
-
* Content-addressed, so identical blobs across pages collapse to one file: the
|
|
18
|
-
* runtime is byte-identical everywhere and becomes a single asset, while
|
|
19
|
-
* per-page CSS dedupes only where pages genuinely share a stylesheet.
|
|
20
|
-
*
|
|
21
|
-
* The rewrite itself is `externalizeHtml`, which touches no filesystem. SSR has
|
|
22
|
-
* the same problem in a worse form — a static build inlines the runtime once
|
|
23
|
-
* per page, a server inlines it once per *request* — and it cannot use a
|
|
24
|
-
* post-pass over a directory because there are no files. Sharing the pure
|
|
25
|
-
* function means the two paths cannot drift into rewriting HTML differently.
|
|
26
|
-
*
|
|
27
|
-
* @module build-externalize
|
|
28
|
-
*/
|
|
29
|
-
/** Where externalized assets are written, relative to the output directory. */
|
|
30
|
-
export declare const EXTERNALIZED_ASSET_DIR = "_stx";
|
|
31
|
-
export interface ExternalizeResult {
|
|
32
|
-
/** HTML files rewritten. */
|
|
33
|
-
pages: number;
|
|
34
|
-
/** Distinct asset files written. */
|
|
35
|
-
assets: number;
|
|
36
|
-
/** Bytes removed from HTML (before any compression). */
|
|
37
|
-
bytesInlined: number;
|
|
38
|
-
}
|
|
39
|
-
/** A blob lifted out of the HTML, ready to be written or served. */
|
|
40
|
-
export interface ExternalizedAsset {
|
|
41
|
-
/** Content-addressed filename, e.g. `runtime.1a2b3c4d.js`. */
|
|
42
|
-
filename: string;
|
|
43
|
-
contents: string;
|
|
44
|
-
/** MIME type, so a server can respond without re-deriving it from the name. */
|
|
45
|
-
contentType: string;
|
|
46
|
-
}
|
|
47
|
-
export interface ExternalizeHtmlResult {
|
|
48
|
-
html: string;
|
|
49
|
-
/** Distinct assets this page referenced. Deduped within the page. */
|
|
50
|
-
assets: ExternalizedAsset[];
|
|
51
|
-
/** Bytes removed from the HTML, before any compression. */
|
|
52
|
-
bytesInlined: number;
|
|
53
|
-
}
|
|
54
1
|
/**
|
|
55
2
|
* Lift the shared blobs out of one HTML document.
|
|
56
3
|
*
|
|
@@ -71,3 +18,21 @@ export declare function externalizeHtml(html: string, basePath?: string): Extern
|
|
|
71
18
|
* inline body to match, so a second pass is a no-op.
|
|
72
19
|
*/
|
|
73
20
|
export declare function externalizeSharedAssets(outDir: string): ExternalizeResult;
|
|
21
|
+
/** Where externalized assets are written, relative to the output directory. */
|
|
22
|
+
export declare const EXTERNALIZED_ASSET_DIR: '_stx';
|
|
23
|
+
export declare interface ExternalizeResult {
|
|
24
|
+
pages: number
|
|
25
|
+
assets: number
|
|
26
|
+
bytesInlined: number
|
|
27
|
+
}
|
|
28
|
+
/** A blob lifted out of the HTML, ready to be written or served. */
|
|
29
|
+
export declare interface ExternalizedAsset {
|
|
30
|
+
filename: string
|
|
31
|
+
contents: string
|
|
32
|
+
contentType: string
|
|
33
|
+
}
|
|
34
|
+
export declare interface ExternalizeHtmlResult {
|
|
35
|
+
html: string
|
|
36
|
+
assets: ExternalizedAsset[]
|
|
37
|
+
bytesInlined: number
|
|
38
|
+
}
|
package/dist/build-id.d.ts
CHANGED
|
@@ -1,3 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The current process's build id.
|
|
3
|
+
*
|
|
4
|
+
* Stable for the lifetime of the process, which is the unit that matters: a
|
|
5
|
+
* `bun --watch` restart produces a new process and therefore a new id, while a
|
|
6
|
+
* production build stamps every page it renders with one value. Every copy of
|
|
7
|
+
* this module loaded into the process returns the same id.
|
|
8
|
+
*
|
|
9
|
+
* `STX_BUILD_ID` overrides it, for deployments that render across several
|
|
10
|
+
* processes and need them to agree.
|
|
11
|
+
*/
|
|
12
|
+
export declare function getBuildId(): string;
|
|
13
|
+
/** @internal test-only — force the id, or with `null` restore generation. */
|
|
14
|
+
export declare function __setBuildIdForTest(id: string | null): void;
|
|
15
|
+
/**
|
|
16
|
+
* Add `<meta name="stx-build">` to `<head>` if it isn't already there.
|
|
17
|
+
*
|
|
18
|
+
* Idempotent, and a no-op for output with no `<head>` — SPA fragments carry the
|
|
19
|
+
* id in a response header instead, since they have nowhere to put a meta.
|
|
20
|
+
*/
|
|
21
|
+
export declare function injectBuildId(html: string, buildId?: string): string;
|
|
22
|
+
/**
|
|
23
|
+
* The same decision as `injectBuildId`, without the splice (stacksjs/stx#1945).
|
|
24
|
+
*
|
|
25
|
+
* Returns what belongs immediately after the `<head>` open tag, or null when
|
|
26
|
+
* the id is already stamped or the document has no head -- an SPA fragment
|
|
27
|
+
* carries it in a response header instead, having nowhere to put a meta.
|
|
28
|
+
*/
|
|
29
|
+
export declare function buildIdFragment(html: string, buildId?: string): string | null;
|
|
1
30
|
/**
|
|
2
31
|
* Per-process build identity, used to detect runtime/fragment skew
|
|
3
32
|
* (stacksjs/stx#1772).
|
|
@@ -24,35 +53,18 @@
|
|
|
24
53
|
* @module build-id
|
|
25
54
|
*/
|
|
26
55
|
/** `<meta name="stx-build">` on every rendered page. */
|
|
27
|
-
export declare const BUILD_ID_META
|
|
56
|
+
export declare const BUILD_ID_META: 'stx-build';
|
|
28
57
|
/** Response header carrying the id that rendered an SPA fragment. */
|
|
29
|
-
export declare const BUILD_ID_HEADER
|
|
58
|
+
export declare const BUILD_ID_HEADER: 'X-STX-Build';
|
|
30
59
|
/**
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
* Stable for the lifetime of the process, which is the unit that matters: a
|
|
34
|
-
* `bun --watch` restart produces a new process and therefore a new id, while a
|
|
35
|
-
* production build stamps every page it renders with one value. Every copy of
|
|
36
|
-
* this module loaded into the process returns the same id.
|
|
60
|
+
* Where the id lives: one slot per process, not one per module instance.
|
|
37
61
|
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
62
|
+
* An app can load stx twice. chrisbreuer.me had @stacksjs/stx 0.2.302 at the
|
|
63
|
+
* top level, rendering pages and stamping the meta, and 0.2.307 nested under
|
|
64
|
+
* bun-plugin-stx, answering SPA fragments with the header. A module-level
|
|
65
|
+
* variable gave each copy its own random id, so the router saw every fragment
|
|
66
|
+
* as coming from another build and turned every navigation into a full page
|
|
67
|
+
* load. A registered symbol on globalThis is shared by every copy.
|
|
40
68
|
*/
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
export declare function __setBuildIdForTest(id: string | null): void;
|
|
44
|
-
/**
|
|
45
|
-
* Add `<meta name="stx-build">` to `<head>` if it isn't already there.
|
|
46
|
-
*
|
|
47
|
-
* Idempotent, and a no-op for output with no `<head>` — SPA fragments carry the
|
|
48
|
-
* id in a response header instead, since they have nowhere to put a meta.
|
|
49
|
-
*/
|
|
50
|
-
export declare function injectBuildId(html: string, buildId?: string): string;
|
|
51
|
-
/**
|
|
52
|
-
* The same decision as `injectBuildId`, without the splice (stacksjs/stx#1945).
|
|
53
|
-
*
|
|
54
|
-
* Returns what belongs immediately after the `<head>` open tag, or null when
|
|
55
|
-
* the id is already stamped or the document has no head -- an SPA fragment
|
|
56
|
-
* carries it in a response header instead, having nowhere to put a meta.
|
|
57
|
-
*/
|
|
58
|
-
export declare function buildIdFragment(html: string, buildId?: string): string | null;
|
|
69
|
+
declare const BUILD_ID_SLOT: symbol;
|
|
70
|
+
declare type BuildIdHolder = { [BUILD_ID_SLOT]?: string }
|
package/dist/build-message.d.ts
CHANGED
|
@@ -1,40 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Make a Bun build failure say where it happened (stacksjs/stx#1810).
|
|
3
|
-
*
|
|
4
|
-
* A single unparseable view produced `BuildMessage: Unexpected ===` and nothing
|
|
5
|
-
* else — no path, no line — leaving the reporter to binary-search the scanned
|
|
6
|
-
* views by hand.
|
|
7
|
-
*
|
|
8
|
-
* The location was never missing. Bun computes it and puts it on
|
|
9
|
-
* `BuildMessage.position`; it is `.message` and `.toString()` that omit it. And
|
|
10
|
-
* because `BuildMessage` is not an `instanceof Error` and carries no `.stack`,
|
|
11
|
-
* the usual `error instanceof Error ? error.message : String(error)` idiom —
|
|
12
|
-
* which this codebase uses in a dozen places — reduces it to exactly that bare
|
|
13
|
-
* string.
|
|
14
|
-
*
|
|
15
|
-
* Two further wrinkles this handles:
|
|
16
|
-
*
|
|
17
|
-
* - `Bun.build()` does not throw a BuildMessage. It throws an AggregateError
|
|
18
|
-
* whose `.errors` holds them, so the useful detail is one level down.
|
|
19
|
-
* - `Bun.Transpiler.transformSync()` reports `position.file` as its synthetic
|
|
20
|
-
* entry name, never the real path. The caller knows the real one, so it is
|
|
21
|
-
* threaded in rather than trusted from the message.
|
|
22
|
-
*/
|
|
23
|
-
/**
|
|
24
|
-
* One failure, with its position kept separate rather than baked into a string.
|
|
25
|
-
*
|
|
26
|
-
* A terminal wants `path:line:col: message`; a dev-server overlay wants to draw
|
|
27
|
-
* a code frame and put a caret under the column. Both are rendered from this,
|
|
28
|
-
* so the two cannot drift into disagreeing about where the error is (#1884).
|
|
29
|
-
*/
|
|
30
|
-
export interface BuildFailureDetail {
|
|
31
|
-
file?: string;
|
|
32
|
-
line?: number;
|
|
33
|
-
column?: number;
|
|
34
|
-
message: string;
|
|
35
|
-
/** The offending source line, when Bun reported one. */
|
|
36
|
-
lineText?: string;
|
|
37
|
-
}
|
|
38
1
|
/**
|
|
39
2
|
* Pull every failure out of whatever was thrown, with positions intact.
|
|
40
3
|
*
|
|
@@ -64,13 +27,6 @@ export declare function formatBuildFailure(error: unknown, sourcePath?: string):
|
|
|
64
27
|
* caller renders as a message with no frame.
|
|
65
28
|
*/
|
|
66
29
|
export declare function locateFailureLine(source: string, lineText?: string): number | undefined;
|
|
67
|
-
/** One line of a code frame. */
|
|
68
|
-
export interface CodeFrameLine {
|
|
69
|
-
number: number;
|
|
70
|
-
text: string;
|
|
71
|
-
/** The line the error is on. */
|
|
72
|
-
isError: boolean;
|
|
73
|
-
}
|
|
74
30
|
/**
|
|
75
31
|
* The lines around a failure, for an overlay to draw.
|
|
76
32
|
*
|
|
@@ -79,3 +35,23 @@ export interface CodeFrameLine {
|
|
|
79
35
|
* the file. Empty when there is no line to centre on.
|
|
80
36
|
*/
|
|
81
37
|
export declare function buildCodeFrame(source: string, line?: number, context?: number): CodeFrameLine[];
|
|
38
|
+
/**
|
|
39
|
+
* One failure, with its position kept separate rather than baked into a string.
|
|
40
|
+
*
|
|
41
|
+
* A terminal wants `path:line:col: message`; a dev-server overlay wants to draw
|
|
42
|
+
* a code frame and put a caret under the column. Both are rendered from this,
|
|
43
|
+
* so the two cannot drift into disagreeing about where the error is (#1884).
|
|
44
|
+
*/
|
|
45
|
+
export declare interface BuildFailureDetail {
|
|
46
|
+
file?: string
|
|
47
|
+
line?: number
|
|
48
|
+
column?: number
|
|
49
|
+
message: string
|
|
50
|
+
lineText?: string
|
|
51
|
+
}
|
|
52
|
+
/** One line of a code frame. */
|
|
53
|
+
export declare interface CodeFrameLine {
|
|
54
|
+
number: number
|
|
55
|
+
text: string
|
|
56
|
+
isError: boolean
|
|
57
|
+
}
|
package/dist/builtins/attrs.d.ts
CHANGED
|
@@ -1,17 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Attribute pass-through for builtin components.
|
|
3
|
-
*
|
|
4
|
-
* `<StxLink>`, `<StxImage>` and `<SafeImage>` all consume the props they know
|
|
5
|
-
* about and forward whatever is left onto the element they render, so an author
|
|
6
|
-
* can write `<StxLink to="/x" aria-label="Shop" data-testid="nav">` and have the
|
|
7
|
-
* last two land on the `<a>`. Each of them grew its own copy of that loop, which
|
|
8
|
-
* meant each of them independently forwarded the *camelized* prop key — emitting
|
|
9
|
-
* `ariaLabel="Shop"`, an attribute no browser knows.
|
|
10
|
-
*
|
|
11
|
-
* One implementation, so the naming round-trip is right in one place.
|
|
12
|
-
*
|
|
13
|
-
* @module builtins/attrs
|
|
14
|
-
*/
|
|
15
1
|
import type { ResolvedProps } from '../component-registry';
|
|
16
2
|
/** Whether an attribute should be visible on a component's DOM root. */
|
|
17
3
|
export declare function isFallthroughAttribute(name: string): boolean;
|
|
@@ -1,24 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* StxDrawer Builtin Component
|
|
3
|
-
*
|
|
4
|
-
* Renders a hidden slide-in panel with slot content. Opened/closed via
|
|
5
|
-
* the runtime `drawer.open(id)` / `drawer.close(id)` / `drawer.toggle(id)` globals.
|
|
6
|
-
*
|
|
7
|
-
* Usage:
|
|
8
|
-
* <StxDrawer id="settings" side="right" size="md">
|
|
9
|
-
* <h2>Settings</h2>
|
|
10
|
-
* <p>Drawer content here</p>
|
|
11
|
-
* </StxDrawer>
|
|
12
|
-
*
|
|
13
|
-
* Props:
|
|
14
|
-
* - id (required) — unique drawer identifier
|
|
15
|
-
* - side — 'left' | 'right' (default: 'right')
|
|
16
|
-
* - size — 'sm' | 'md' | 'lg' | 'xl' (default: 'md')
|
|
17
|
-
* - closeOnBackdrop — whether clicking backdrop closes drawer (default: true)
|
|
18
|
-
* - closeOnEscape — whether Escape key closes drawer (default: true)
|
|
19
|
-
* - overlay — whether to show backdrop overlay (default: true)
|
|
20
|
-
*
|
|
21
|
-
* @module builtins/drawer
|
|
22
|
-
*/
|
|
23
1
|
import type { BuiltinComponentDef } from '../component-registry';
|
|
2
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
3
|
+
/** @defaultValue `{ sm: '16rem', md: '24rem', lg: '32rem', xl: '40rem' }` */
|
|
4
|
+
declare const SIZE_WIDTHS: Record<string, string>;
|
|
24
5
|
export declare const StxDrawerBuiltin: BuiltinComponentDef;
|
package/dist/builtins/icon.d.ts
CHANGED
|
@@ -1,18 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Icon Builtin Component
|
|
3
|
-
*
|
|
4
|
-
* Renders an inline SVG from the Iconify icon library at template processing
|
|
5
|
-
* time. No client-side runtime needed — the SVG is baked into the HTML.
|
|
6
|
-
*
|
|
7
|
-
* Usage:
|
|
8
|
-
* <Icon name="house" />
|
|
9
|
-
* <Icon name="lucide:house" size="20" class="text-gray-500" />
|
|
10
|
-
* <Icon name="chevron-right" size="16" color="red" />
|
|
11
|
-
*
|
|
12
|
-
* Default collection: lucide. Override with prefix: <Icon name="heroicons:home" />
|
|
13
|
-
*
|
|
14
|
-
* @module builtins/icon
|
|
15
|
-
*/
|
|
16
1
|
import type { BuiltinComponentDef } from '../component-registry';
|
|
17
2
|
/**
|
|
18
3
|
* Resolve the on-disk path of an icon collection JSON.
|
|
@@ -29,7 +14,18 @@ import type { BuiltinComponentDef } from '../component-registry';
|
|
|
29
14
|
* node_modules in apps that vendor there).
|
|
30
15
|
*/
|
|
31
16
|
export declare function resolveCollectionPath(prefix: string): string | null;
|
|
32
|
-
|
|
17
|
+
/**
|
|
18
|
+
* Load an icon collection synchronously. Used inside `render()` so the
|
|
19
|
+
* first hit for a collection doesn't return a placeholder comment that
|
|
20
|
+
* the user then sees as a missing icon — the JSON is small enough
|
|
21
|
+
* (~550KB for lucide, parses in <10ms) that a blocking read on cache
|
|
22
|
+
* miss is the right trade-off for correct SSR output.
|
|
23
|
+
*/
|
|
24
|
+
declare function loadCollectionSync(prefix: string): IconCollection | null;
|
|
25
|
+
/**
|
|
26
|
+
* Resolve a prop value from any binding category.
|
|
27
|
+
*/
|
|
28
|
+
declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
|
|
33
29
|
/**
|
|
34
30
|
* Pre-load icon collections so they're available synchronously during render.
|
|
35
31
|
* Call this before template processing starts.
|
|
@@ -40,6 +36,8 @@ export declare const IconBuiltin: BuiltinComponentDef;
|
|
|
40
36
|
* asks for one that is missing. Pass `speculative: false` when the caller knows
|
|
41
37
|
* the collection is required.
|
|
42
38
|
*/
|
|
43
|
-
export declare function preloadIconCollection(prefix?: string, options?: {
|
|
44
|
-
|
|
45
|
-
|
|
39
|
+
export declare function preloadIconCollection(prefix?: string, options?: { speculative?: boolean }): Promise<void>;
|
|
40
|
+
// Cache loaded icon collections to avoid re-reading JSON files
|
|
41
|
+
declare const collectionCache: Map<string, IconCollection>;
|
|
42
|
+
export declare const IconBuiltin: BuiltinComponentDef;
|
|
43
|
+
declare type IconCollection = Record<string, { body: string, width?: number, height?: number }>;
|
|
@@ -1,11 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* - `none`: the format or header rules transparency out entirely (JPEG, a PNG
|
|
3
|
-
* with no alpha channel and no `tRNS`, a WebP that declares no alpha).
|
|
4
|
-
* - `possible`: the header declares an alpha channel. Every pixel may still be
|
|
5
|
-
* opaque; only a decode can say.
|
|
6
|
-
* - `unknown`: the header does not settle it (AVIF, anything unrecognised).
|
|
7
|
-
*/
|
|
8
|
-
export type SourceAlpha = 'none' | 'possible' | 'unknown';
|
|
9
1
|
export declare function readAt(fd: number, position: number, length: number): Buffer;
|
|
10
2
|
/**
|
|
11
3
|
* Whether a WebP header declares an alpha channel.
|
|
@@ -24,3 +16,11 @@ export declare function webpHeaderHasAlpha(header: Uint8Array): boolean;
|
|
|
24
16
|
* stays `unknown`. JPEG cannot carry alpha at all.
|
|
25
17
|
*/
|
|
26
18
|
export declare function sourceAlpha(file: string): SourceAlpha;
|
|
19
|
+
/**
|
|
20
|
+
* - `none`: the format or header rules transparency out entirely (JPEG, a PNG
|
|
21
|
+
* with no alpha channel and no `tRNS`, a WebP that declares no alpha).
|
|
22
|
+
* - `possible`: the header declares an alpha channel. Every pixel may still be
|
|
23
|
+
* opaque; only a decode can say.
|
|
24
|
+
* - `unknown`: the header does not settle it (AVIF, anything unrecognised).
|
|
25
|
+
*/
|
|
26
|
+
export type SourceAlpha = 'none' | 'possible' | 'unknown';
|