@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/plugin-system.d.ts
CHANGED
|
@@ -1,195 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Plugin System for stx
|
|
3
|
-
*
|
|
4
|
-
* Provides a robust plugin architecture with lifecycle hooks for extending
|
|
5
|
-
* the template processing pipeline.
|
|
6
|
-
*
|
|
7
|
-
* ## Plugin Lifecycle
|
|
8
|
-
*
|
|
9
|
-
* Plugins can hook into various stages of template processing:
|
|
10
|
-
*
|
|
11
|
-
* 1. **beforeProcess** - Before any directive processing begins
|
|
12
|
-
* 2. **afterParse** - After template is parsed but before directives run
|
|
13
|
-
* 3. **beforeDirective** - Before each directive type is processed
|
|
14
|
-
* 4. **afterDirective** - After each directive type is processed
|
|
15
|
-
* 5. **beforeRender** - Before final output is generated
|
|
16
|
-
* 6. **afterRender** - After final output is generated
|
|
17
|
-
* 7. **onError** - When an error occurs during processing
|
|
18
|
-
*
|
|
19
|
-
* ## Example Plugin
|
|
20
|
-
*
|
|
21
|
-
* ```typescript
|
|
22
|
-
* const myPlugin: StxPlugin = {
|
|
23
|
-
* name: 'my-plugin',
|
|
24
|
-
* version: '1.0.0',
|
|
25
|
-
*
|
|
26
|
-
* beforeProcess({ template, context }) {
|
|
27
|
-
* // Add global variables
|
|
28
|
-
* context.myPluginData = { initialized: true }
|
|
29
|
-
* return { template, context }
|
|
30
|
-
* },
|
|
31
|
-
*
|
|
32
|
-
* registerDirectives() {
|
|
33
|
-
* return [{
|
|
34
|
-
* name: 'myDirective',
|
|
35
|
-
* handler: (content, params) => content.toUpperCase(),
|
|
36
|
-
* hasEndTag: true
|
|
37
|
-
* }]
|
|
38
|
-
* }
|
|
39
|
-
* }
|
|
40
|
-
* ```
|
|
41
|
-
*
|
|
42
|
-
* @module plugin-system
|
|
43
|
-
*/
|
|
44
1
|
import type { CustomDirective, StxOptions } from './types';
|
|
45
|
-
/**
|
|
46
|
-
* Context passed to lifecycle hooks
|
|
47
|
-
*/
|
|
48
|
-
export interface PluginContext {
|
|
49
|
-
/** Current template content */
|
|
50
|
-
template: string;
|
|
51
|
-
/** Template context/variables */
|
|
52
|
-
context: Record<string, unknown>;
|
|
53
|
-
/** Source file path */
|
|
54
|
-
filePath: string;
|
|
55
|
-
/** Stx options */
|
|
56
|
-
options: StxOptions;
|
|
57
|
-
/** Dependencies tracked during processing */
|
|
58
|
-
dependencies: Set<string>;
|
|
59
|
-
/** Metadata for plugin communication */
|
|
60
|
-
metadata: Record<string, unknown>;
|
|
61
|
-
}
|
|
62
|
-
/**
|
|
63
|
-
* Result from a lifecycle hook
|
|
64
|
-
*/
|
|
65
|
-
export interface PluginHookResult {
|
|
66
|
-
/** Modified template (optional) */
|
|
67
|
-
template?: string;
|
|
68
|
-
/** Modified context (optional) */
|
|
69
|
-
context?: Record<string, unknown>;
|
|
70
|
-
/** Whether to skip further processing (optional) */
|
|
71
|
-
skip?: boolean;
|
|
72
|
-
/** Additional metadata to pass along */
|
|
73
|
-
metadata?: Record<string, unknown>;
|
|
74
|
-
}
|
|
75
|
-
/**
|
|
76
|
-
* Error context passed to onError hook
|
|
77
|
-
*/
|
|
78
|
-
export interface PluginErrorContext extends PluginContext {
|
|
79
|
-
/** The error that occurred */
|
|
80
|
-
error: Error;
|
|
81
|
-
/** Phase where error occurred */
|
|
82
|
-
phase: string;
|
|
83
|
-
/** Directive being processed (if applicable) */
|
|
84
|
-
directive?: string;
|
|
85
|
-
}
|
|
86
|
-
/**
|
|
87
|
-
* Directive type identifier for beforeDirective/afterDirective hooks
|
|
88
|
-
*/
|
|
89
|
-
export type DirectivePhase = 'comments' | 'escaped' | 'stacks' | 'layouts' | 'includes' | 'js' | 'ts' | 'custom' | 'components' | 'animation' | 'routes' | 'auth' | 'csrf' | 'method' | 'loops' | 'conditionals' | 'forms' | 'markdown' | 'i18n' | 'a11y' | 'seo' | 'expressions';
|
|
90
|
-
/**
|
|
91
|
-
* Plugin definition interface
|
|
92
|
-
*/
|
|
93
|
-
export interface StxPlugin {
|
|
94
|
-
/** Unique plugin name */
|
|
95
|
-
name: string;
|
|
96
|
-
/** Plugin version (semver) */
|
|
97
|
-
version?: string;
|
|
98
|
-
/** Plugin description */
|
|
99
|
-
description?: string;
|
|
100
|
-
/** Plugin dependencies (other plugin names) */
|
|
101
|
-
dependencies?: string[];
|
|
102
|
-
/** Order priority (lower runs first, default: 100) */
|
|
103
|
-
priority?: number;
|
|
104
|
-
/**
|
|
105
|
-
* Called before any template processing begins.
|
|
106
|
-
* Use this to initialize plugin state or modify the initial template.
|
|
107
|
-
*/
|
|
108
|
-
beforeProcess?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
109
|
-
/**
|
|
110
|
-
* Called after the template is parsed but before directives are processed.
|
|
111
|
-
* Useful for template analysis or pre-processing.
|
|
112
|
-
*/
|
|
113
|
-
afterParse?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
114
|
-
/**
|
|
115
|
-
* Called before a specific directive type is processed.
|
|
116
|
-
* @param phase - The directive phase being processed
|
|
117
|
-
* @param ctx - Plugin context
|
|
118
|
-
*/
|
|
119
|
-
beforeDirective?: (phase: DirectivePhase, ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
120
|
-
/**
|
|
121
|
-
* Called after a specific directive type is processed.
|
|
122
|
-
* @param phase - The directive phase that was processed
|
|
123
|
-
* @param ctx - Plugin context
|
|
124
|
-
*/
|
|
125
|
-
afterDirective?: (phase: DirectivePhase, ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
126
|
-
/**
|
|
127
|
-
* Called before the final render output is generated.
|
|
128
|
-
*/
|
|
129
|
-
beforeRender?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
130
|
-
/**
|
|
131
|
-
* Called after the final render output is generated.
|
|
132
|
-
*/
|
|
133
|
-
afterRender?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
134
|
-
/**
|
|
135
|
-
* Called when an error occurs during processing.
|
|
136
|
-
* Can return a recovery template or rethrow the error.
|
|
137
|
-
*/
|
|
138
|
-
onError?: (ctx: PluginErrorContext) => PluginHookResult | Promise<PluginHookResult> | void;
|
|
139
|
-
/**
|
|
140
|
-
* Register custom directives provided by this plugin.
|
|
141
|
-
* Called during plugin initialization.
|
|
142
|
-
*/
|
|
143
|
-
registerDirectives?: () => CustomDirective[];
|
|
144
|
-
/**
|
|
145
|
-
* Register custom expression filters.
|
|
146
|
-
* Called during plugin initialization.
|
|
147
|
-
*/
|
|
148
|
-
registerFilters?: () => Record<string, (value: unknown, ...args: unknown[]) => unknown>;
|
|
149
|
-
/**
|
|
150
|
-
* Called when the plugin is registered.
|
|
151
|
-
* Use for one-time initialization.
|
|
152
|
-
*/
|
|
153
|
-
onRegister?: (options: StxOptions) => void | Promise<void>;
|
|
154
|
-
/**
|
|
155
|
-
* Called when the plugin is unregistered.
|
|
156
|
-
* Use for cleanup.
|
|
157
|
-
*/
|
|
158
|
-
onUnregister?: () => void | Promise<void>;
|
|
159
|
-
/** Directory of .stx components — auto-registered, available in all templates */
|
|
160
|
-
/**
|
|
161
|
-
* Component directory, or directories.
|
|
162
|
-
*
|
|
163
|
-
* An array lets one package register several roots — @stacksjs/components
|
|
164
|
-
* ships src/ui and src/components as siblings (#1823).
|
|
165
|
-
*/
|
|
166
|
-
components?: string | string[];
|
|
167
|
-
/** Directory of composable functions — importable via @/functions/ */
|
|
168
|
-
functions?: string;
|
|
169
|
-
/** Directory of store definitions — auto-registered */
|
|
170
|
-
stores?: string;
|
|
171
|
-
/** Directory of page templates — merged into file-based routing */
|
|
172
|
-
pages?: string;
|
|
173
|
-
/** Directory of route middleware */
|
|
174
|
-
middleware?: string;
|
|
175
|
-
/** Setup function called when plugin is loaded — receives options and stx context */
|
|
176
|
-
setup?: (options: Record<string, any>, stx: PluginSetupContext) => void | Promise<void>;
|
|
177
|
-
}
|
|
178
|
-
/**
|
|
179
|
-
* Context passed to plugin setup() function
|
|
180
|
-
*/
|
|
181
|
-
export interface PluginSetupContext {
|
|
182
|
-
/** Register a custom directive */
|
|
183
|
-
addDirective: (directive: CustomDirective) => void;
|
|
184
|
-
/** Register an API route handler */
|
|
185
|
-
addRoute: (path: string, handler: (req: Request) => Response | Promise<Response>) => void;
|
|
186
|
-
/** Register route middleware */
|
|
187
|
-
addMiddleware: (middleware: any) => void;
|
|
188
|
-
/** The resolved plugin directory path */
|
|
189
|
-
pluginDir: string;
|
|
190
|
-
/** The stx config */
|
|
191
|
-
config: StxOptions;
|
|
192
|
-
}
|
|
193
2
|
/**
|
|
194
3
|
* Define an stx plugin with type safety.
|
|
195
4
|
*
|
|
@@ -208,77 +17,6 @@ export interface PluginSetupContext {
|
|
|
208
17
|
* ```
|
|
209
18
|
*/
|
|
210
19
|
export declare function definePlugin(config: StxPlugin): StxPlugin;
|
|
211
|
-
/**
|
|
212
|
-
* Plugin manager that handles registration, lifecycle, and execution
|
|
213
|
-
*/
|
|
214
|
-
export declare class PluginManager {
|
|
215
|
-
private plugins;
|
|
216
|
-
private sortedPlugins;
|
|
217
|
-
private initialized;
|
|
218
|
-
/**
|
|
219
|
-
* Register a plugin
|
|
220
|
-
*/
|
|
221
|
-
register(plugin: StxPlugin, options: StxOptions): Promise<void>;
|
|
222
|
-
/**
|
|
223
|
-
* Unregister a plugin
|
|
224
|
-
*/
|
|
225
|
-
unregister(name: string): Promise<boolean>;
|
|
226
|
-
/**
|
|
227
|
-
* Get a registered plugin by name
|
|
228
|
-
*/
|
|
229
|
-
get(name: string): StxPlugin | undefined;
|
|
230
|
-
/**
|
|
231
|
-
* Check if a plugin is registered
|
|
232
|
-
*/
|
|
233
|
-
has(name: string): boolean;
|
|
234
|
-
/**
|
|
235
|
-
* Get all registered plugins (sorted by priority)
|
|
236
|
-
*/
|
|
237
|
-
getAll(): StxPlugin[];
|
|
238
|
-
/**
|
|
239
|
-
* Get all custom directives from all plugins
|
|
240
|
-
*/
|
|
241
|
-
getAllDirectives(): CustomDirective[];
|
|
242
|
-
/**
|
|
243
|
-
* Get all filters from all plugins
|
|
244
|
-
*/
|
|
245
|
-
getAllFilters(): Record<string, (value: unknown, ...args: unknown[]) => unknown>;
|
|
246
|
-
/**
|
|
247
|
-
* Run beforeProcess hooks on all plugins
|
|
248
|
-
*/
|
|
249
|
-
runBeforeProcess(ctx: PluginContext): Promise<PluginContext>;
|
|
250
|
-
/**
|
|
251
|
-
* Run afterParse hooks on all plugins
|
|
252
|
-
*/
|
|
253
|
-
runAfterParse(ctx: PluginContext): Promise<PluginContext>;
|
|
254
|
-
/**
|
|
255
|
-
* Run beforeDirective hooks on all plugins
|
|
256
|
-
*/
|
|
257
|
-
runBeforeDirective(phase: DirectivePhase, ctx: PluginContext): Promise<PluginContext>;
|
|
258
|
-
/**
|
|
259
|
-
* Run afterDirective hooks on all plugins
|
|
260
|
-
*/
|
|
261
|
-
runAfterDirective(phase: DirectivePhase, ctx: PluginContext): Promise<PluginContext>;
|
|
262
|
-
/**
|
|
263
|
-
* Run beforeRender hooks on all plugins
|
|
264
|
-
*/
|
|
265
|
-
runBeforeRender(ctx: PluginContext): Promise<PluginContext>;
|
|
266
|
-
/**
|
|
267
|
-
* Run afterRender hooks on all plugins
|
|
268
|
-
*/
|
|
269
|
-
runAfterRender(ctx: PluginContext): Promise<PluginContext>;
|
|
270
|
-
/**
|
|
271
|
-
* Run onError hooks on all plugins
|
|
272
|
-
*/
|
|
273
|
-
runOnError(ctx: PluginErrorContext): Promise<PluginContext | null>;
|
|
274
|
-
private sortPlugins;
|
|
275
|
-
private runHooks;
|
|
276
|
-
private runDirectiveHooks;
|
|
277
|
-
}
|
|
278
|
-
/**
|
|
279
|
-
* Global plugin manager instance
|
|
280
|
-
*/
|
|
281
|
-
export declare const pluginManager: PluginManager;
|
|
282
20
|
/**
|
|
283
21
|
* Create a simple directive plugin
|
|
284
22
|
*/
|
|
@@ -287,6 +25,14 @@ export declare function createDirectivePlugin(name: string, directives: CustomDi
|
|
|
287
25
|
* Create a simple filter plugin
|
|
288
26
|
*/
|
|
289
27
|
export declare function createFilterPlugin(name: string, filters: Record<string, (value: unknown, ...args: unknown[]) => unknown>, options?: Partial<Omit<StxPlugin, 'name' | 'registerFilters'>>): StxPlugin;
|
|
28
|
+
/**
|
|
29
|
+
* Variables plugin that adds common variables to context
|
|
30
|
+
*/
|
|
31
|
+
export declare function createVariablesPlugin(variables: Record<string, unknown>): StxPlugin;
|
|
32
|
+
/**
|
|
33
|
+
* Global plugin manager instance
|
|
34
|
+
*/
|
|
35
|
+
export declare const pluginManager: PluginManager;
|
|
290
36
|
/**
|
|
291
37
|
* Debug plugin that logs all lifecycle events
|
|
292
38
|
*/
|
|
@@ -296,6 +42,111 @@ export declare const debugPlugin: StxPlugin;
|
|
|
296
42
|
*/
|
|
297
43
|
export declare const timingPlugin: StxPlugin;
|
|
298
44
|
/**
|
|
299
|
-
*
|
|
45
|
+
* Context passed to lifecycle hooks
|
|
300
46
|
*/
|
|
301
|
-
export declare
|
|
47
|
+
export declare interface PluginContext {
|
|
48
|
+
template: string
|
|
49
|
+
context: Record<string, unknown>
|
|
50
|
+
filePath: string
|
|
51
|
+
options: StxOptions
|
|
52
|
+
dependencies: Set<string>
|
|
53
|
+
metadata: Record<string, unknown>
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Result from a lifecycle hook
|
|
57
|
+
*/
|
|
58
|
+
export declare interface PluginHookResult {
|
|
59
|
+
template?: string
|
|
60
|
+
context?: Record<string, unknown>
|
|
61
|
+
skip?: boolean
|
|
62
|
+
metadata?: Record<string, unknown>
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Error context passed to onError hook
|
|
66
|
+
*/
|
|
67
|
+
export declare interface PluginErrorContext extends PluginContext {
|
|
68
|
+
error: Error
|
|
69
|
+
phase: string
|
|
70
|
+
directive?: string
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Plugin definition interface
|
|
74
|
+
*/
|
|
75
|
+
export declare interface StxPlugin {
|
|
76
|
+
name: string
|
|
77
|
+
version?: string
|
|
78
|
+
description?: string
|
|
79
|
+
dependencies?: string[]
|
|
80
|
+
priority?: number
|
|
81
|
+
beforeProcess?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
82
|
+
afterParse?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
83
|
+
beforeDirective?: (phase: DirectivePhase, ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
84
|
+
afterDirective?: (phase: DirectivePhase, ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
85
|
+
beforeRender?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
86
|
+
afterRender?: (ctx: PluginContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
87
|
+
onError?: (ctx: PluginErrorContext) => PluginHookResult | Promise<PluginHookResult> | void
|
|
88
|
+
registerDirectives?: () => CustomDirective[]
|
|
89
|
+
registerFilters?: () => Record<string, (value: unknown, ...args: unknown[]) => unknown>
|
|
90
|
+
onRegister?: (options: StxOptions) => void | Promise<void>
|
|
91
|
+
onUnregister?: () => void | Promise<void>
|
|
92
|
+
components?: string | string[]
|
|
93
|
+
functions?: string
|
|
94
|
+
stores?: string
|
|
95
|
+
pages?: string
|
|
96
|
+
middleware?: string
|
|
97
|
+
setup?: (options: Record<string, any>, stx: PluginSetupContext) => void | Promise<void>
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Context passed to plugin setup() function
|
|
101
|
+
*/
|
|
102
|
+
export declare interface PluginSetupContext {
|
|
103
|
+
addDirective: (directive: CustomDirective) => void
|
|
104
|
+
addRoute: (path: string, handler: (req: Request) => Response | Promise<Response>) => void
|
|
105
|
+
addMiddleware: (middleware: any) => void
|
|
106
|
+
pluginDir: string
|
|
107
|
+
config: StxOptions
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Directive type identifier for beforeDirective/afterDirective hooks
|
|
111
|
+
*/
|
|
112
|
+
export type DirectivePhase = | 'comments'
|
|
113
|
+
| 'escaped'
|
|
114
|
+
| 'stacks'
|
|
115
|
+
| 'layouts'
|
|
116
|
+
| 'includes'
|
|
117
|
+
| 'js'
|
|
118
|
+
| 'ts'
|
|
119
|
+
| 'custom'
|
|
120
|
+
| 'components'
|
|
121
|
+
| 'animation'
|
|
122
|
+
| 'routes'
|
|
123
|
+
| 'auth'
|
|
124
|
+
| 'csrf'
|
|
125
|
+
| 'method'
|
|
126
|
+
| 'loops'
|
|
127
|
+
| 'conditionals'
|
|
128
|
+
| 'forms'
|
|
129
|
+
| 'markdown'
|
|
130
|
+
| 'i18n'
|
|
131
|
+
| 'a11y'
|
|
132
|
+
| 'seo'
|
|
133
|
+
| 'expressions';
|
|
134
|
+
/**
|
|
135
|
+
* Plugin manager that handles registration, lifecycle, and execution
|
|
136
|
+
*/
|
|
137
|
+
export declare class PluginManager {
|
|
138
|
+
register(plugin: StxPlugin, options: StxOptions): Promise<void>;
|
|
139
|
+
unregister(name: string): Promise<boolean>;
|
|
140
|
+
get(name: string): StxPlugin | undefined;
|
|
141
|
+
has(name: string): boolean;
|
|
142
|
+
getAll(): StxPlugin[];
|
|
143
|
+
getAllDirectives(): CustomDirective[];
|
|
144
|
+
getAllFilters(): Record<string, (value: unknown, ...args: unknown[]) => unknown>;
|
|
145
|
+
runBeforeProcess(ctx: PluginContext): Promise<PluginContext>;
|
|
146
|
+
runAfterParse(ctx: PluginContext): Promise<PluginContext>;
|
|
147
|
+
runBeforeDirective(phase: DirectivePhase, ctx: PluginContext): Promise<PluginContext>;
|
|
148
|
+
runAfterDirective(phase: DirectivePhase, ctx: PluginContext): Promise<PluginContext>;
|
|
149
|
+
runBeforeRender(ctx: PluginContext): Promise<PluginContext>;
|
|
150
|
+
runAfterRender(ctx: PluginContext): Promise<PluginContext>;
|
|
151
|
+
runOnError(ctx: PluginErrorContext): Promise<PluginContext | null>;
|
|
152
|
+
}
|
package/dist/process.d.ts
CHANGED
|
@@ -1,13 +1,8 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
*
|
|
4
|
-
* Orchestrates the full directive processing pipeline for STX templates.
|
|
5
|
-
* Delegates to specialized modules for signals, components, runtime injection, etc.
|
|
6
|
-
*
|
|
7
|
-
* @module process
|
|
8
|
-
*/
|
|
1
|
+
import { processJsonDirective, processOnceDirective } from './misc-directives';
|
|
2
|
+
import { validateClientScript } from './script-validation';
|
|
9
3
|
import type { StxOptions } from './types';
|
|
4
|
+
export declare function processDirectives(template: string, context: Record<string, any>, filePath: string, options: StxOptions, dependencies: Set<string>): Promise<string>;
|
|
5
|
+
// Re-export public API from extracted modules (preserves backwards compatibility)
|
|
10
6
|
export { injectRouterScript } from './runtime-injection';
|
|
11
7
|
export { processJsonDirective, processOnceDirective } from './misc-directives';
|
|
12
8
|
export { validateClientScript } from './script-validation';
|
|
13
|
-
export declare function processDirectives(template: string, context: Record<string, any>, filePath: string, options: StxOptions, dependencies: Set<string>): Promise<string>;
|
package/dist/process.js
CHANGED
|
@@ -848,10 +848,12 @@ async function processOtherDirectives(template, context, filePath, options, depe
|
|
|
848
848
|
const injectIntoHead = (html, snippet, replaceExistingTitle = !0) => {
|
|
849
849
|
if (!snippet)
|
|
850
850
|
return html;
|
|
851
|
-
const incomingTitle = snippet.match(/<title\b[^>]*>[\s\S]*?<\/title>/i),
|
|
852
|
-
if (incomingTitle && existingTitle) {
|
|
853
|
-
if (replaceExistingTitle)
|
|
854
|
-
|
|
851
|
+
const incomingTitle = snippet.match(/<title\b[^>]*>[\s\S]*?<\/title>/i), existingHead = /<head\b[^>]*>[\s\S]*?(?:<\/head\s*>|<body\b|$)/i.exec(html), existingTitle = existingHead ? /<title\b[^>]*>[\s\S]*?<\/title>/i.exec(existingHead[0]) : null;
|
|
852
|
+
if (incomingTitle && existingHead && existingTitle) {
|
|
853
|
+
if (replaceExistingTitle) {
|
|
854
|
+
const start = existingHead.index + existingTitle.index;
|
|
855
|
+
html = html.slice(0, start) + incomingTitle[0] + html.slice(start + existingTitle[0].length);
|
|
856
|
+
}
|
|
855
857
|
snippet = snippet.replace(incomingTitle[0], "").trim();
|
|
856
858
|
if (!snippet)
|
|
857
859
|
return html;
|
package/dist/prop-sentinels.d.ts
CHANGED
|
@@ -1,3 +1,13 @@
|
|
|
1
|
+
/** Is this value the bare-boolean-attribute marker? */
|
|
2
|
+
export declare function isBooleanAttributeSentinel(value: unknown): boolean;
|
|
3
|
+
/**
|
|
4
|
+
* Last-resort guard for anything about to be written into a response.
|
|
5
|
+
*
|
|
6
|
+
* Nothing should reach output carrying a NUL, but the cost of one escaping is
|
|
7
|
+
* an invalid document and a silent grep, which is far worse than the cost of
|
|
8
|
+
* this check.
|
|
9
|
+
*/
|
|
10
|
+
export declare function stripControlChars(value: string): string;
|
|
1
11
|
/**
|
|
2
12
|
* Sentinel values used while resolving component props.
|
|
3
13
|
*
|
|
@@ -18,14 +28,4 @@
|
|
|
18
28
|
* verification step that greps rendered HTML returns an empty string and reads
|
|
19
29
|
* as a pass (stacksjs/stx#1816).
|
|
20
30
|
*/
|
|
21
|
-
export declare const BOOLEAN_ATTRIBUTE_SENTINEL
|
|
22
|
-
/** Is this value the bare-boolean-attribute marker? */
|
|
23
|
-
export declare function isBooleanAttributeSentinel(value: unknown): boolean;
|
|
24
|
-
/**
|
|
25
|
-
* Last-resort guard for anything about to be written into a response.
|
|
26
|
-
*
|
|
27
|
-
* Nothing should reach output carrying a NUL, but the cost of one escaping is
|
|
28
|
-
* an invalid document and a silent grep, which is far worse than the cost of
|
|
29
|
-
* this check.
|
|
30
|
-
*/
|
|
31
|
-
export declare function stripControlChars(value: string): string;
|
|
31
|
+
export declare const BOOLEAN_ATTRIBUTE_SENTINEL: '\0stx-boolean-attribute';
|
package/dist/public-env.d.ts
CHANGED
|
@@ -1,17 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Public env exposure for client bundles
|
|
3
|
-
*
|
|
4
|
-
* Mirrors the server-side `$env` template context (process.ts:762) onto the
|
|
5
|
-
* client side via build-time substitution. Any env var matching `envPrefix`
|
|
6
|
-
* (default `STX_PUBLIC_`) gets inlined as `import.meta.env.STX_PUBLIC_*` in
|
|
7
|
-
* scripts bundled for the browser.
|
|
8
|
-
*
|
|
9
|
-
* .env: STX_PUBLIC_API_URL=https://api.example.com
|
|
10
|
-
* store: const api = import.meta.env.STX_PUBLIC_API_URL
|
|
11
|
-
* built: const api = "https://api.example.com"
|
|
12
|
-
*
|
|
13
|
-
* Vite-style. Build-time, zero runtime cost.
|
|
14
|
-
*/
|
|
15
1
|
/**
|
|
16
2
|
* Build the `define` map every client bundler/transpiler should pass to
|
|
17
3
|
* Bun.build / new Bun.Transpiler({ define }).
|
package/dist/pwa/directives.d.ts
CHANGED
|
@@ -1,13 +1,25 @@
|
|
|
1
|
+
import type { CustomDirective } from '../types';
|
|
1
2
|
/**
|
|
2
|
-
*
|
|
3
|
-
*
|
|
4
|
-
* Provides template directives for PWA functionality:
|
|
5
|
-
* - @pwa.installButton - Install prompt button
|
|
6
|
-
* - @pwa.updatePrompt - Update notification UI
|
|
7
|
-
* - @pwa.offlineIndicator - Offline status indicator
|
|
8
|
-
* - @pwa.pushSubscribe - Push notification subscription button
|
|
3
|
+
* Generate install button HTML and JavaScript
|
|
9
4
|
*/
|
|
10
|
-
|
|
5
|
+
declare function generateInstallButton(content: string, options: StxOptions): string;
|
|
6
|
+
/**
|
|
7
|
+
* Generate update prompt HTML and JavaScript
|
|
8
|
+
*/
|
|
9
|
+
declare function generateUpdatePrompt(content: string, options: StxOptions): string;
|
|
10
|
+
/**
|
|
11
|
+
* Generate offline indicator HTML and JavaScript
|
|
12
|
+
*/
|
|
13
|
+
// eslint-disable-next-line pickier/no-unused-vars
|
|
14
|
+
declare function generateOfflineIndicator(content: string, options: StxOptions): string;
|
|
15
|
+
/**
|
|
16
|
+
* Generate push subscribe button HTML and JavaScript
|
|
17
|
+
*/
|
|
18
|
+
declare function generatePushSubscribe(content: string, options: StxOptions): string;
|
|
19
|
+
/**
|
|
20
|
+
* Register all PWA directives with the config
|
|
21
|
+
*/
|
|
22
|
+
export declare function registerPwaDirectives(customDirectives: CustomDirective[]): CustomDirective[];
|
|
11
23
|
/**
|
|
12
24
|
* PWA Install Button Directive
|
|
13
25
|
* Usage: @pwa.installButton ... @endpwa.installButton
|
|
@@ -32,7 +44,3 @@ export declare const pwaPushDirective: CustomDirective;
|
|
|
32
44
|
* All PWA directives
|
|
33
45
|
*/
|
|
34
46
|
export declare const pwaDirectives: CustomDirective[];
|
|
35
|
-
/**
|
|
36
|
-
* Register all PWA directives with the config
|
|
37
|
-
*/
|
|
38
|
-
export declare function registerPwaDirectives(customDirectives: CustomDirective[]): CustomDirective[];
|
package/dist/pwa/inject.d.ts
CHANGED
|
@@ -1,13 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* PWA HTML Tag Injection
|
|
3
|
-
*
|
|
4
|
-
* Injects PWA-related meta tags, links, and scripts into HTML output.
|
|
5
|
-
* Handles:
|
|
6
|
-
* - manifest.json link
|
|
7
|
-
* - theme-color meta tag
|
|
8
|
-
* - Apple touch icons
|
|
9
|
-
* - Service worker registration script
|
|
10
|
-
*/
|
|
11
1
|
import type { StxOptions } from '../types';
|
|
12
2
|
/**
|
|
13
3
|
* Generate PWA HTML tags for injection into <head>
|
package/dist/pwa/precache.d.ts
CHANGED
|
@@ -1,26 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* PWA Auto-Precaching
|
|
3
|
-
*
|
|
4
|
-
* Automatically discovers and precaches build output files.
|
|
5
|
-
* Scans the output directory and generates a precache manifest.
|
|
6
|
-
*/
|
|
7
1
|
import type { StxOptions } from '../types';
|
|
8
|
-
/**
|
|
9
|
-
* Precache manifest entry
|
|
10
|
-
*/
|
|
11
|
-
export interface PrecacheEntry {
|
|
12
|
-
url: string;
|
|
13
|
-
revision: string;
|
|
14
|
-
size: number;
|
|
15
|
-
}
|
|
16
|
-
/**
|
|
17
|
-
* Precache manifest result
|
|
18
|
-
*/
|
|
19
|
-
export interface PrecacheManifest {
|
|
20
|
-
entries: PrecacheEntry[];
|
|
21
|
-
totalSize: number;
|
|
22
|
-
fileCount: number;
|
|
23
|
-
}
|
|
24
2
|
/**
|
|
25
3
|
* Generate precache manifest from build output directory
|
|
26
4
|
*/
|
|
@@ -33,3 +11,19 @@ export declare function generatePrecacheManifestJs(manifest: PrecacheManifest):
|
|
|
33
11
|
* Get human-readable size
|
|
34
12
|
*/
|
|
35
13
|
export declare function formatSize(bytes: number): string;
|
|
14
|
+
/**
|
|
15
|
+
* Precache manifest entry
|
|
16
|
+
*/
|
|
17
|
+
export declare interface PrecacheEntry {
|
|
18
|
+
url: string
|
|
19
|
+
revision: string
|
|
20
|
+
size: number
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Precache manifest result
|
|
24
|
+
*/
|
|
25
|
+
export declare interface PrecacheManifest {
|
|
26
|
+
entries: PrecacheEntry[]
|
|
27
|
+
totalSize: number
|
|
28
|
+
fileCount: number
|
|
29
|
+
}
|
|
@@ -1,15 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* PWA Service Worker Generation
|
|
3
|
-
*
|
|
4
|
-
* Generates a service worker JavaScript file with configurable caching strategies.
|
|
5
|
-
* Supports: cache-first, network-first, stale-while-revalidate, network-only, cache-only
|
|
6
|
-
*
|
|
7
|
-
* Additional features:
|
|
8
|
-
* - Push notifications handling
|
|
9
|
-
* - Background sync for form submissions
|
|
10
|
-
* - Cache storage limits and purge strategies
|
|
11
|
-
* - Update notifications
|
|
12
|
-
*/
|
|
13
1
|
import type { StxOptions } from '../types';
|
|
14
2
|
/**
|
|
15
3
|
* Generate the service worker JavaScript code
|
package/dist/pwa.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
// @bun
|
|
2
2
|
import{zn,Le,qo,ec}from"./chunk-2crxkm7j.js";import{Fn,Xr,Ya,Za,Qa}from"./chunk-5t1whxxt.js";import{Uo,Vo,Wo,Ka,Ja}from"./chunk-5dmkkvs7.js";import{ce,yt,Kr}from"./chunk-7t3ykgsm.js";import{nl,rl,sl,ol,br,Cu}from"./chunk-h4k3hyny.js";import B from"fs";import w from"path";import O from"fs";import u from"path";var v=[72,96,128,144,152,192,384,512],S=[120,152,167,180],P=[16,32];async function M(n,t){let e={success:!0,generatedFiles:[],errors:[],warnings:[]},r=n.pwa?.icons;if(!r?.src)return e.errors.push("No source icon specified in pwa.icons.src"),e.success=!1,e;let o=u.isAbsolute(r.src)?r.src:u.resolve(process.cwd(),r.src);if(!await Bun.file(o).exists())return e.errors.push(`Source icon not found: ${o}`),e.success=!1,e;let a=u.resolve(t,r.outputDir||"pwa-icons");try{O.mkdirSync(a,{recursive:!0})}catch{return e.errors.push(`Failed to create output directory: ${a}`),e.success=!1,e}let s=r.sizes||v,l=r.generateWebP??!0,p=r.generateAppleIcons??!0;try{let c;try{c=await import("sharp")}catch{return e.errors.push(`sharp is not installed. Install it with: bun add sharp
|
|
3
|
-
Icon generation requires the sharp package for image processing.`),e.success=!1,e}let g=await c.default(o).metadata();if(g.width&&g.width<512)e.warnings.push(`Source icon is ${g.width}x${g.height}. Recommend using at least 512x512 for best quality.`);for(let i of s){let d=u.join(a,`icon-${i}x${i}.png`);if(await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d),l){let x=u.join(a,`icon-${i}x${i}.webp`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).webp({quality:90}).toFile(x),e.generatedFiles.push(x)}}if(p){for(let d of S){let x=u.join(a,`apple-touch-icon-${d}x${d}.png`);await c.default(o).resize(d,d,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(x),e.generatedFiles.push(x)}let i=u.join(a,"apple-touch-icon.png");await c.default(o).resize(180,180,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(i),e.generatedFiles.push(i)}for(let i of P){let d=u.join(a,`favicon-${i}x${i}.png`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d)}let f=512,y=u.join(a,`icon-maskable-${f}x${f}.png`),m=Math.floor(f*0.1),k=f-m*2;await c.default(o).resize(k,k,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).extend({top:m,bottom:m,left:m,right:m,background:{r:255,g:255,b:255,alpha:1}}).png().toFile(y),e.generatedFiles.push(y)}catch(c){let h=c instanceof Error?c.message:String(c);e.errors.push(`Icon generation failed: ${h}`),e.success=!1}return e}function N(n){let t=n.sizes||v,e=n.outputDir?`/${n.outputDir}`:"/pwa-icons",r=n.generateWebP??!0,o=n.generateAppleIcons??!0,a=[];for(let s of t)if(a.push(`${e}/icon-${s}x${s}.png`),r)a.push(`${e}/icon-${s}x${s}.webp`);if(o){a.push(`${e}/apple-touch-icon.png`);for(let s of S)a.push(`${e}/apple-touch-icon-${s}x${s}.png`)}for(let s of P)a.push(`${e}/favicon-${s}x${s}.png`);return a.push(`${e}/icon-maskable-512x512.png`),a}async function I(){try{return await import("sharp"),!0}catch{return!1}}function A(n,t,e,r){let o=[],a=r.join(" ");for(let s of n)if(o.push({src:`${t}/icon-${s}x${s}.png`,sizes:`${s}x${s}`,type:"image/png",purpose:a}),e)o.push({src:`${t}/icon-${s}x${s}.webp`,sizes:`${s}x${s}`,type:"image/webp",purpose:a});return o}function C(n){return n.map((t)=>({name:t.name,short_name:t.shortName,description:t.description,url:t.url,icons:t.icons?.map((e)=>({src:e.src,sizes:e.sizes,type:e.type}))}))}function T(n){let t=n.pwa?.shareTarget;if(!t?.enabled)return;let e={action:t.action||"/share",method:t.method||"POST",enctype:t.enctype||"multipart/form-data",params:{title:t.params?.title||"title",text:t.params?.text||"text",url:t.params?.url||"url"}};if(t.acceptFiles&&t.acceptFiles.length>0)e.params.files=t.acceptFiles.map((r)=>({name:r.name,accept:r.accept}));return e}function H(n){let t=n.pwa?.fileHandlers;if(!t?.enabled||!t.accept)return;let e=[{action:t.action||"/",accept:t.accept,launch_type:t.launchType||"single-client"}];if(t.icons)e[0].icons=t.icons.map((r)=>({src:r.src,sizes:r.sizes,type:r.type}));return e}function W(n){let t=n.pwa?.protocolHandlers;if(!t||t.length===0)return;return t.map((e)=>({protocol:e.protocol,url:e.url}))}function j(n){let t=n.pwa;if(!t?.enabled||!t.manifest)return null;let{manifest:e,icons:r}=t,o=r?.sizes||[72,96,128,144,152,192,384,512],a=r?.outputDir?`/${r.outputDir}`:"/pwa-icons",s=r?.generateWebP??!0,l=r?.purpose||["any","maskable"],p={name:e.name,short_name:e.shortName||e.name,description:e.description,start_url:e.startUrl||"/",display:e.display||"standalone",display_override:e.displayOverride,orientation:e.orientation,theme_color:e.themeColor,background_color:e.backgroundColor,scope:e.scope||"/",lang:e.lang,dir:e.dir,id:e.id,categories:e.categories,icons:A(o,a,s,l)};if(e.shortcuts&&e.shortcuts.length>0)p.shortcuts=C(e.shortcuts);if(e.screenshots&&e.screenshots.length>0)p.screenshots=e.screenshots.map((f)=>({src:f.src,sizes:f.sizes,type:f.type,label:f.label,form_factor:f.platform}));let c=T(n);if(c)p.share_target=c;let h=H(n);if(h)p.file_handlers=h;let g=W(n);if(g)p.protocol_handlers=g;if(e.launchHandler)p.launch_handler={client_mode:e.launchHandler};if(e.handleLinks)p.handle_links=e.handleLinks;if(e.edgeSidePanel?.enabled)p.edge_side_panel={preferred_width:e.edgeSidePanel.preferredWidth};return p}function _(n){let t=j(n);if(!t)return"";let e=JSON.parse(JSON.stringify(t));return JSON.stringify(e,null,2)}function q(n,t){return{...t,...n,shortcuts:n.shortcuts||t.shortcuts,screenshots:n.screenshots||t.screenshots,categories:n.categories||t.categories}}function D(n){let t=[],e=n.pwa;if(!e?.enabled)return t;let r=e.manifest;if(!r)return t.push("PWA manifest configuration is missing"),t;if(!r.name)t.push("Manifest name is required");let o=["fullscreen","standalone","minimal-ui","browser"];if(r.display&&!o.includes(r.display))t.push(`Invalid display mode: ${r.display}. Must be one of: ${o.join(", ")}`);let a=["any","natural","landscape","landscape-primary","landscape-secondary","portrait","portrait-primary","portrait-secondary"];if(r.orientation&&!a.includes(r.orientation))t.push(`Invalid orientation: ${r.orientation}`);let s=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;if(r.themeColor&&!s.test(r.themeColor))t.push(`Invalid theme color: ${r.themeColor}. Must be a valid hex color.`);if(r.backgroundColor&&!s.test(r.backgroundColor))t.push(`Invalid background color: ${r.backgroundColor}. Must be a valid hex color.`);if(e.shareTarget?.enabled){if(!e.shareTarget.action)t.push("Share target action URL is required")}if(e.fileHandlers?.enabled){if(!e.fileHandlers.accept||Object.keys(e.fileHandlers.accept).length===0)t.push("File handlers must specify accepted MIME types")}if(e.protocolHandlers)for(let l of e.protocolHandlers){if(!l.protocol)t.push("Protocol handler missing protocol");if(!l.url||!l.url.includes("%s"))t.push(`Protocol handler URL must contain %s placeholder: ${l.protocol}`)}return t}import z from"path";async function F(n){let t=n.pwa?.offline;if(!t?.enabled)return"";if(t.page){let e=z.isAbsolute(t.page)?t.page:z.resolve(process.cwd(),t.page);if(await Bun.file(e).exists())try{let{processDirectives:r}=await import("./chunk-
|
|
3
|
+
Icon generation requires the sharp package for image processing.`),e.success=!1,e}let g=await c.default(o).metadata();if(g.width&&g.width<512)e.warnings.push(`Source icon is ${g.width}x${g.height}. Recommend using at least 512x512 for best quality.`);for(let i of s){let d=u.join(a,`icon-${i}x${i}.png`);if(await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d),l){let x=u.join(a,`icon-${i}x${i}.webp`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).webp({quality:90}).toFile(x),e.generatedFiles.push(x)}}if(p){for(let d of S){let x=u.join(a,`apple-touch-icon-${d}x${d}.png`);await c.default(o).resize(d,d,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(x),e.generatedFiles.push(x)}let i=u.join(a,"apple-touch-icon.png");await c.default(o).resize(180,180,{fit:"contain",background:{r:255,g:255,b:255,alpha:1}}).png().toFile(i),e.generatedFiles.push(i)}for(let i of P){let d=u.join(a,`favicon-${i}x${i}.png`);await c.default(o).resize(i,i,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).png().toFile(d),e.generatedFiles.push(d)}let f=512,y=u.join(a,`icon-maskable-${f}x${f}.png`),m=Math.floor(f*0.1),k=f-m*2;await c.default(o).resize(k,k,{fit:"contain",background:{r:0,g:0,b:0,alpha:0}}).extend({top:m,bottom:m,left:m,right:m,background:{r:255,g:255,b:255,alpha:1}}).png().toFile(y),e.generatedFiles.push(y)}catch(c){let h=c instanceof Error?c.message:String(c);e.errors.push(`Icon generation failed: ${h}`),e.success=!1}return e}function N(n){let t=n.sizes||v,e=n.outputDir?`/${n.outputDir}`:"/pwa-icons",r=n.generateWebP??!0,o=n.generateAppleIcons??!0,a=[];for(let s of t)if(a.push(`${e}/icon-${s}x${s}.png`),r)a.push(`${e}/icon-${s}x${s}.webp`);if(o){a.push(`${e}/apple-touch-icon.png`);for(let s of S)a.push(`${e}/apple-touch-icon-${s}x${s}.png`)}for(let s of P)a.push(`${e}/favicon-${s}x${s}.png`);return a.push(`${e}/icon-maskable-512x512.png`),a}async function I(){try{return await import("sharp"),!0}catch{return!1}}function A(n,t,e,r){let o=[],a=r.join(" ");for(let s of n)if(o.push({src:`${t}/icon-${s}x${s}.png`,sizes:`${s}x${s}`,type:"image/png",purpose:a}),e)o.push({src:`${t}/icon-${s}x${s}.webp`,sizes:`${s}x${s}`,type:"image/webp",purpose:a});return o}function C(n){return n.map((t)=>({name:t.name,short_name:t.shortName,description:t.description,url:t.url,icons:t.icons?.map((e)=>({src:e.src,sizes:e.sizes,type:e.type}))}))}function T(n){let t=n.pwa?.shareTarget;if(!t?.enabled)return;let e={action:t.action||"/share",method:t.method||"POST",enctype:t.enctype||"multipart/form-data",params:{title:t.params?.title||"title",text:t.params?.text||"text",url:t.params?.url||"url"}};if(t.acceptFiles&&t.acceptFiles.length>0)e.params.files=t.acceptFiles.map((r)=>({name:r.name,accept:r.accept}));return e}function H(n){let t=n.pwa?.fileHandlers;if(!t?.enabled||!t.accept)return;let e=[{action:t.action||"/",accept:t.accept,launch_type:t.launchType||"single-client"}];if(t.icons)e[0].icons=t.icons.map((r)=>({src:r.src,sizes:r.sizes,type:r.type}));return e}function W(n){let t=n.pwa?.protocolHandlers;if(!t||t.length===0)return;return t.map((e)=>({protocol:e.protocol,url:e.url}))}function j(n){let t=n.pwa;if(!t?.enabled||!t.manifest)return null;let{manifest:e,icons:r}=t,o=r?.sizes||[72,96,128,144,152,192,384,512],a=r?.outputDir?`/${r.outputDir}`:"/pwa-icons",s=r?.generateWebP??!0,l=r?.purpose||["any","maskable"],p={name:e.name,short_name:e.shortName||e.name,description:e.description,start_url:e.startUrl||"/",display:e.display||"standalone",display_override:e.displayOverride,orientation:e.orientation,theme_color:e.themeColor,background_color:e.backgroundColor,scope:e.scope||"/",lang:e.lang,dir:e.dir,id:e.id,categories:e.categories,icons:A(o,a,s,l)};if(e.shortcuts&&e.shortcuts.length>0)p.shortcuts=C(e.shortcuts);if(e.screenshots&&e.screenshots.length>0)p.screenshots=e.screenshots.map((f)=>({src:f.src,sizes:f.sizes,type:f.type,label:f.label,form_factor:f.platform}));let c=T(n);if(c)p.share_target=c;let h=H(n);if(h)p.file_handlers=h;let g=W(n);if(g)p.protocol_handlers=g;if(e.launchHandler)p.launch_handler={client_mode:e.launchHandler};if(e.handleLinks)p.handle_links=e.handleLinks;if(e.edgeSidePanel?.enabled)p.edge_side_panel={preferred_width:e.edgeSidePanel.preferredWidth};return p}function _(n){let t=j(n);if(!t)return"";let e=JSON.parse(JSON.stringify(t));return JSON.stringify(e,null,2)}function q(n,t){return{...t,...n,shortcuts:n.shortcuts||t.shortcuts,screenshots:n.screenshots||t.screenshots,categories:n.categories||t.categories}}function D(n){let t=[],e=n.pwa;if(!e?.enabled)return t;let r=e.manifest;if(!r)return t.push("PWA manifest configuration is missing"),t;if(!r.name)t.push("Manifest name is required");let o=["fullscreen","standalone","minimal-ui","browser"];if(r.display&&!o.includes(r.display))t.push(`Invalid display mode: ${r.display}. Must be one of: ${o.join(", ")}`);let a=["any","natural","landscape","landscape-primary","landscape-secondary","portrait","portrait-primary","portrait-secondary"];if(r.orientation&&!a.includes(r.orientation))t.push(`Invalid orientation: ${r.orientation}`);let s=/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6})$/;if(r.themeColor&&!s.test(r.themeColor))t.push(`Invalid theme color: ${r.themeColor}. Must be a valid hex color.`);if(r.backgroundColor&&!s.test(r.backgroundColor))t.push(`Invalid background color: ${r.backgroundColor}. Must be a valid hex color.`);if(e.shareTarget?.enabled){if(!e.shareTarget.action)t.push("Share target action URL is required")}if(e.fileHandlers?.enabled){if(!e.fileHandlers.accept||Object.keys(e.fileHandlers.accept).length===0)t.push("File handlers must specify accepted MIME types")}if(e.protocolHandlers)for(let l of e.protocolHandlers){if(!l.protocol)t.push("Protocol handler missing protocol");if(!l.url||!l.url.includes("%s"))t.push(`Protocol handler URL must contain %s placeholder: ${l.protocol}`)}return t}import z from"path";async function F(n){let t=n.pwa?.offline;if(!t?.enabled)return"";if(t.page){let e=z.isAbsolute(t.page)?t.page:z.resolve(process.cwd(),t.page);if(await Bun.file(e).exists())try{let{processDirectives:r}=await import("./chunk-qm280dp3.js"),o=await Bun.file(e).text();return await r(o,{},e,n,new Set)}catch(r){console.warn(`[PWA] Failed to process custom offline page: ${r}`)}else console.warn(`[PWA] Custom offline page not found: ${e}`)}return E(n)}function E(n){let t=n.pwa?.offline,e=n.pwa?.manifest,r=t?.fallbackTitle||"You are offline",o=t?.fallbackMessage||"Please check your internet connection and try again.",a=e?.themeColor||"#4f46e5",s=e?.shortName||e?.name||"App";return`<!DOCTYPE html>
|
|
4
4
|
<html lang="en">
|
|
5
5
|
<head>
|
|
6
6
|
<meta charset="UTF-8">
|