@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.
Files changed (381) hide show
  1. package/dist/a11y.d.ts +51 -111
  2. package/dist/animation.d.ts +131 -74
  3. package/dist/api-client.d.ts +11 -21
  4. package/dist/api-handler.d.ts +4 -4
  5. package/dist/appearance-bootstrap.d.ts +16 -77
  6. package/dist/application-layers.d.ts +11 -20
  7. package/dist/asset-roots.d.ts +7 -27
  8. package/dist/assets.d.ts +7 -9
  9. package/dist/async-components.d.ts +56 -78
  10. package/dist/auth.d.ts +0 -3
  11. package/dist/browser-core-imports.d.ts +2 -2
  12. package/dist/build-externalize-repeated.d.ts +0 -25
  13. package/dist/build-externalize.d.ts +18 -53
  14. package/dist/build-id.d.ts +40 -28
  15. package/dist/build-message.d.ts +20 -44
  16. package/dist/builtins/attrs.d.ts +0 -14
  17. package/dist/builtins/drawer.d.ts +3 -22
  18. package/dist/builtins/icon.d.ts +17 -19
  19. package/dist/builtins/image-alpha.d.ts +8 -8
  20. package/dist/builtins/image-delivery.d.ts +38 -40
  21. package/dist/builtins/image-placeholder.d.ts +12 -50
  22. package/dist/builtins/image-warmup-worker.d.ts +1 -1
  23. package/dist/builtins/image-worker.d.ts +6 -32
  24. package/dist/builtins/index.d.ts +16 -6
  25. package/dist/builtins/modal.d.ts +13 -23
  26. package/dist/builtins/safe-image.d.ts +2 -42
  27. package/dist/builtins/stx-image.d.ts +44 -24
  28. package/dist/builtins/stx-link.d.ts +5 -8
  29. package/dist/builtins/stx-loading-indicator.d.ts +11 -10
  30. package/dist/builtins/suspense.d.ts +6 -27
  31. package/dist/builtins/toast.d.ts +15 -16
  32. package/dist/builtins/transition-group.d.ts +1 -25
  33. package/dist/caching.d.ts +24 -21
  34. package/dist/{chunk-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
  35. package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
  36. package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
  37. package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
  38. package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
  39. package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
  40. package/dist/chunk-557wtdps.js +2 -0
  41. package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
  42. package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
  43. package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
  44. package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
  45. package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
  46. package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
  47. package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
  48. package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
  49. package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
  50. package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
  51. package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
  52. package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
  53. package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
  54. package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
  55. package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
  56. package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
  57. package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
  58. package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
  59. package/dist/{chunk-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
  60. package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
  61. package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
  62. package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
  63. package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
  64. package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
  65. package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
  66. package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
  67. package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
  68. package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
  69. package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
  70. package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
  71. package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
  72. package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
  73. package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
  74. package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
  75. package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
  76. package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
  77. package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
  78. package/dist/chunk-zpz6q2fh.js +2 -0
  79. package/dist/chunk-zxt94g45.js +2 -0
  80. package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
  81. package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
  82. package/dist/cli.js +7 -7
  83. package/dist/client/directive.d.ts +0 -7
  84. package/dist/client/index.d.ts +1 -0
  85. package/dist/client/signals-appearance-runtime.d.ts +1 -1
  86. package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
  87. package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
  88. package/dist/client/signals-class-runtime.d.ts +1 -1
  89. package/dist/client/signals-component-api-runtime.d.ts +1 -1
  90. package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
  91. package/dist/client/signals-component-props-runtime.d.ts +1 -1
  92. package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
  93. package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
  94. package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
  95. package/dist/client/signals-context-runtime.d.ts +1 -1
  96. package/dist/client/signals-cookie-runtime.d.ts +1 -1
  97. package/dist/client/signals-devtools-runtime.d.ts +1 -1
  98. package/dist/client/signals-dialog-runtime.d.ts +1 -1
  99. package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
  100. package/dist/client/signals-drawer-runtime.d.ts +1 -1
  101. package/dist/client/signals-effect-runtime.d.ts +1 -1
  102. package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
  103. package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
  104. package/dist/client/signals-expression-runtime.d.ts +1 -1
  105. package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
  106. package/dist/client/signals-for-runtime.d.ts +1 -1
  107. package/dist/client/signals-globals-runtime.d.ts +1 -1
  108. package/dist/client/signals-handler-runtime.d.ts +1 -1
  109. package/dist/client/signals-head-runtime.d.ts +1 -1
  110. package/dist/client/signals-helpers-runtime.d.ts +1 -1
  111. package/dist/client/signals-host-runtime.d.ts +1 -1
  112. package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
  113. package/dist/client/signals-hydration-runtime.d.ts +1 -1
  114. package/dist/client/signals-if-chain-runtime.d.ts +1 -1
  115. package/dist/client/signals-if-runtime.d.ts +1 -1
  116. package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
  117. package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
  118. package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
  119. package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
  120. package/dist/client/signals-loop-row-runtime.d.ts +1 -1
  121. package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
  122. package/dist/client/signals-model-runtime.d.ts +1 -1
  123. package/dist/client/signals-mount-runtime.d.ts +1 -1
  124. package/dist/client/signals-navigation-runtime.d.ts +1 -1
  125. package/dist/client/signals-notify-runtime.d.ts +1 -1
  126. package/dist/client/signals-optimistic-runtime.d.ts +1 -1
  127. package/dist/client/signals-overlay-runtime.d.ts +1 -1
  128. package/dist/client/signals-pipe-runtime.d.ts +1 -1
  129. package/dist/client/signals-proxy-runtime.d.ts +1 -1
  130. package/dist/client/signals-query-runtime.d.ts +1 -1
  131. package/dist/client/signals-reactive-runtime.d.ts +1 -1
  132. package/dist/client/signals-ref-runtime.d.ts +1 -1
  133. package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
  134. package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
  135. package/dist/client/signals-show-runtime.d.ts +1 -1
  136. package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
  137. package/dist/client/signals-spa-load-runtime.d.ts +1 -1
  138. package/dist/client/signals-state-runtime.d.ts +1 -1
  139. package/dist/client/signals-storage-runtime.d.ts +1 -1
  140. package/dist/client/signals-store-registry-runtime.d.ts +1 -1
  141. package/dist/client/signals-style-runtime.d.ts +1 -1
  142. package/dist/client/signals-suspense-runtime.d.ts +1 -1
  143. package/dist/client/signals-timer-runtime.d.ts +1 -1
  144. package/dist/client/signals-toast-runtime.d.ts +1 -1
  145. package/dist/client/signals-tooltip-runtime.d.ts +1 -1
  146. package/dist/client/signals-transition-group-runtime.d.ts +1 -1
  147. package/dist/client/signals-websocket-runtime.d.ts +1 -1
  148. package/dist/client-helpers.d.ts +1 -312
  149. package/dist/client-module-registry.d.ts +4 -27
  150. package/dist/client-parameter-bindings.d.ts +1 -4
  151. package/dist/client-script-bundler.d.ts +55 -103
  152. package/dist/client-script.d.ts +69 -127
  153. package/dist/color-mode-boot.d.ts +21 -58
  154. package/dist/component-client-factories.d.ts +8 -9
  155. package/dist/component-contract-checks.d.ts +15 -18
  156. package/dist/component-contract.d.ts +6 -6
  157. package/dist/component-hmr.d.ts +8 -7
  158. package/dist/component-model.d.ts +14 -20
  159. package/dist/component-processing.d.ts +51 -59
  160. package/dist/component-registry.d.ts +28 -99
  161. package/dist/component-renderer.d.ts +19 -16
  162. package/dist/component-resolution.d.ts +8 -8
  163. package/dist/component-tags.d.ts +1 -1
  164. package/dist/composable-loader.d.ts +6 -41
  165. package/dist/composables/use-fetch.d.ts +45 -114
  166. package/dist/composables/use-form.d.ts +2 -56
  167. package/dist/composables/use-intersection-observer.d.ts +1 -1
  168. package/dist/composables.d.ts +75 -74
  169. package/dist/composition-api.d.ts +19 -43
  170. package/dist/computed.d.ts +93 -86
  171. package/dist/conditionals.d.ts +0 -24
  172. package/dist/config.d.ts +30 -24
  173. package/dist/config.js +3 -0
  174. package/dist/craft-bridge.d.ts +1 -467
  175. package/dist/craft-components.d.ts +234 -680
  176. package/dist/craft-entry.js +1 -1
  177. package/dist/craft.js +1 -1
  178. package/dist/csp.d.ts +41 -107
  179. package/dist/database.d.ts +1 -1
  180. package/dist/defer.d.ts +0 -24
  181. package/dist/dev-server/terminal-colors.d.ts +32 -32
  182. package/dist/dev-server/ts-css.d.ts +26 -35
  183. package/dist/dev-server/types.d.ts +33 -29
  184. package/dist/directive-api.d.ts +42 -85
  185. package/dist/directive-arguments.d.ts +14 -39
  186. package/dist/document-shell.d.ts +49 -81
  187. package/dist/dynamic-components.d.ts +0 -9
  188. package/dist/engine-bindings.d.ts +1 -1
  189. package/dist/env.d.ts +26 -0
  190. package/dist/error-boundaries.d.ts +36 -43
  191. package/dist/error-handling.d.ts +1 -1
  192. package/dist/errors/codes.d.ts +43 -51
  193. package/dist/errors/formatter.d.ts +38 -58
  194. package/dist/errors/index.d.ts +61 -5
  195. package/dist/errors/logger.d.ts +40 -114
  196. package/dist/errors/sanitizer.d.ts +28 -53
  197. package/dist/errors/types.d.ts +31 -44
  198. package/dist/events.d.ts +32 -94
  199. package/dist/expressions.d.ts +57 -62
  200. package/dist/find-body-tag.d.ts +5 -34
  201. package/dist/first-script-tag.d.ts +0 -23
  202. package/dist/forms-validation.d.ts +117 -149
  203. package/dist/forms.d.ts +161 -120
  204. package/dist/framework-composables.d.ts +0 -32
  205. package/dist/head-injection.d.ts +30 -32
  206. package/dist/head-keys.d.ts +12 -15
  207. package/dist/head.d.ts +110 -139
  208. package/dist/heatmap.d.ts +76 -152
  209. package/dist/html-masking.d.ts +38 -62
  210. package/dist/hydration-runtime.d.ts +24 -20
  211. package/dist/hydration.d.ts +11 -10
  212. package/dist/i18n.d.ts +34 -95
  213. package/dist/image-optimization/auto-sibling.d.ts +4 -32
  214. package/dist/imported-signals.d.ts +0 -36
  215. package/dist/includes.d.ts +6 -69
  216. package/dist/index.d.ts +2 -1
  217. package/dist/init.d.ts +12 -20
  218. package/dist/internal-markdown.d.ts +8 -12
  219. package/dist/interpolation-context.d.ts +15 -15
  220. package/dist/island-chunking.d.ts +13 -30
  221. package/dist/keep-alive.d.ts +52 -72
  222. package/dist/layout-types.d.ts +2 -27
  223. package/dist/lazy-module.d.ts +0 -10
  224. package/dist/loading-indicator.d.ts +8 -5
  225. package/dist/loop-binding.d.ts +4 -7
  226. package/dist/loops.d.ts +25 -67
  227. package/dist/markdown.d.ts +1 -0
  228. package/dist/media/image/component.d.ts +9 -25
  229. package/dist/media/image/directive.d.ts +1 -15
  230. package/dist/media/image/placeholder.d.ts +9 -20
  231. package/dist/media/image/processor/cache.d.ts +18 -40
  232. package/dist/media/image/processor/index.d.ts +10 -1
  233. package/dist/media/image/processor/optimizer.d.ts +1 -12
  234. package/dist/media/image/processor/responsive.d.ts +6 -16
  235. package/dist/media/image/srcset.d.ts +49 -47
  236. package/dist/media/shared/cache.d.ts +31 -51
  237. package/dist/media/shared/hash.d.ts +0 -7
  238. package/dist/media/types.d.ts +754 -1235
  239. package/dist/media/video/directive.d.ts +1 -15
  240. package/dist/media/video/index.d.ts +17 -39
  241. package/dist/media/video/processor/cache.d.ts +19 -42
  242. package/dist/media/video/processor/index.d.ts +18 -1
  243. package/dist/media/video/processor/streaming.d.ts +10 -17
  244. package/dist/media/video/processor/thumbnail.d.ts +15 -21
  245. package/dist/media/video/processor/transcoder.d.ts +1 -11
  246. package/dist/meta-arguments.d.ts +14 -39
  247. package/dist/method-spoofing.d.ts +0 -7
  248. package/dist/middleware.d.ts +0 -60
  249. package/dist/native/bridge/protocol.d.ts +2 -1
  250. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  251. package/dist/native/compiler/icons.d.ts +249 -243
  252. package/dist/native/compiler/svg.d.ts +35 -24
  253. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  254. package/dist/native/runtime/native-host.d.ts +1 -1
  255. package/dist/native/runtime/native-host.js +3 -0
  256. package/dist/offline/app-service-worker.d.ts +50 -114
  257. package/dist/offline/kept-store.d.ts +23 -37
  258. package/dist/offline/query-cache.d.ts +55 -126
  259. package/dist/owned-routes.d.ts +0 -31
  260. package/dist/page-response.d.ts +8 -39
  261. package/dist/parser/directive-parser.d.ts +45 -57
  262. package/dist/parser/expression-parser.d.ts +35 -33
  263. package/dist/parser/index.d.ts +39 -4
  264. package/dist/parser/tokenizer.d.ts +49 -61
  265. package/dist/partial-hydration.d.ts +51 -82
  266. package/dist/performance-utils.d.ts +115 -255
  267. package/dist/placeholder.d.ts +9 -18
  268. package/dist/plugin-system.d.ts +115 -264
  269. package/dist/process.d.ts +4 -9
  270. package/dist/process.js +6 -4
  271. package/dist/prop-sentinels.d.ts +11 -11
  272. package/dist/public-env.d.ts +0 -14
  273. package/dist/pwa/directives.d.ts +20 -12
  274. package/dist/pwa/inject.d.ts +0 -10
  275. package/dist/pwa/precache.d.ts +16 -22
  276. package/dist/pwa/service-worker.d.ts +0 -12
  277. package/dist/pwa.js +1 -1
  278. package/dist/reactive-bindings.d.ts +11 -34
  279. package/dist/reactive-tracking.d.ts +0 -36
  280. package/dist/reactive.d.ts +41 -58
  281. package/dist/render-memo.d.ts +5 -23
  282. package/dist/resolve-stx-targets.d.ts +6 -44
  283. package/dist/route-middleware.d.ts +35 -2
  284. package/dist/route-rules.d.ts +10 -13
  285. package/dist/router.d.ts +9 -8
  286. package/dist/routes.d.ts +3 -1
  287. package/dist/runtime-config-server.d.ts +14 -17
  288. package/dist/runtime-config.d.ts +2 -3
  289. package/dist/runtime-globals.d.ts +90 -122
  290. package/dist/runtime-injection.d.ts +0 -8
  291. package/dist/scaffolding.d.ts +30 -26
  292. package/dist/script-emit.d.ts +0 -30
  293. package/dist/script-validation.d.ts +6 -12
  294. package/dist/seo.d.ts +75 -153
  295. package/dist/server-api.d.ts +9 -12
  296. package/dist/server-bindings.d.ts +1 -26
  297. package/dist/server-data.d.ts +4 -5
  298. package/dist/sfc-template.d.ts +8 -8
  299. package/dist/signal-processing.d.ts +37 -53
  300. package/dist/signals-api.d.ts +58 -135
  301. package/dist/signals.d.ts +18 -24
  302. package/dist/site-url.d.ts +31 -28
  303. package/dist/slots.d.ts +20 -86
  304. package/dist/source-signature.d.ts +5 -28
  305. package/dist/ssg.d.ts +158 -337
  306. package/dist/ssg.js +2 -2
  307. package/dist/state-dir.d.ts +4 -4
  308. package/dist/store-loader.d.ts +0 -10
  309. package/dist/story/analytics.d.ts +60 -138
  310. package/dist/story/bookmarks.d.ts +34 -87
  311. package/dist/story/cli.d.ts +69 -123
  312. package/dist/story/collect/scanner.d.ts +0 -4
  313. package/dist/story/collect/tree.d.ts +1 -8
  314. package/dist/story/commands/build.d.ts +6 -11
  315. package/dist/story/commands/dev.d.ts +8 -15
  316. package/dist/story/commands/preview.d.ts +7 -13
  317. package/dist/story/config-watcher.d.ts +13 -20
  318. package/dist/story/config.d.ts +8 -11
  319. package/dist/story/context.d.ts +8 -14
  320. package/dist/story/hmr.d.ts +26 -24
  321. package/dist/story/hot-swap.d.ts +23 -34
  322. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  323. package/dist/story/output.d.ts +44 -46
  324. package/dist/story/performance.d.ts +45 -107
  325. package/dist/story/presets.d.ts +41 -107
  326. package/dist/story/renderer.d.ts +27 -41
  327. package/dist/story/search.d.ts +12 -23
  328. package/dist/story/server.d.ts +11 -21
  329. package/dist/story/setup.d.ts +15 -23
  330. package/dist/story/testing.d.ts +40 -65
  331. package/dist/story/types.d.ts +160 -262
  332. package/dist/streaming.d.ts +57 -119
  333. package/dist/strip-literals.d.ts +1 -25
  334. package/dist/stx-module-imports.d.ts +7 -0
  335. package/dist/stx-virtual-ts.d.ts +102 -253
  336. package/dist/style-scoping.d.ts +8 -21
  337. package/dist/suspense.d.ts +52 -67
  338. package/dist/teleport.d.ts +0 -22
  339. package/dist/template-syntax-escape.d.ts +8 -8
  340. package/dist/template-tag-balance.d.ts +6 -22
  341. package/dist/testing.d.ts +26 -11
  342. package/dist/theme-tokens.d.ts +388 -134
  343. package/dist/transitions.d.ts +55 -66
  344. package/dist/ts-css-config.d.ts +12 -70
  345. package/dist/types/component-types.d.ts +122 -187
  346. package/dist/types/config-types.d.ts +341 -956
  347. package/dist/types/context-types.d.ts +24 -46
  348. package/dist/types/csp-types.d.ts +66 -70
  349. package/dist/types/directive-types.d.ts +156 -223
  350. package/dist/types/index.d.ts +110 -6
  351. package/dist/types/pwa-types.d.ts +148 -273
  352. package/dist/types.d.ts +1 -0
  353. package/dist/unresolved-identifiers.d.ts +22 -24
  354. package/dist/url-safety.d.ts +32 -32
  355. package/dist/utils.d.ts +21 -36
  356. package/dist/validator.d.ts +26 -28
  357. package/dist/variable-extractor.d.ts +19 -49
  358. package/dist/view-composers.d.ts +81 -80
  359. package/dist/virtual-scrolling.d.ts +82 -101
  360. package/dist/visual-testing.d.ts +10 -9
  361. package/dist/vue-template.d.ts +0 -23
  362. package/dist/web-components/css-scoping.d.ts +11 -21
  363. package/dist/web-components.d.ts +58 -81
  364. package/dist/x-element.d.ts +1 -0
  365. package/package.json +6 -6
  366. package/stx.d.ts +2 -2
  367. package/dist/app-service-worker.d.ts +0 -165
  368. package/dist/chunk-49gwmcrn.js +0 -2
  369. package/dist/chunk-6va5pe2m.js +0 -2
  370. package/dist/chunk-bm2q1srp.js +0 -2
  371. package/dist/signals-context-runtime.d.ts +0 -2
  372. package/dist/signals-drawer-runtime.d.ts +0 -2
  373. package/dist/signals-host-runtime.d.ts +0 -9
  374. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  375. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  376. package/dist/signals-notify-runtime.d.ts +0 -2
  377. package/dist/signals-optimistic-runtime.d.ts +0 -2
  378. package/dist/signals-overlay-runtime.d.ts +0 -2
  379. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  380. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  381. package/dist/signals-storage-runtime.d.ts +0 -2
@@ -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
- * Variables plugin that adds common variables to context
45
+ * Context passed to lifecycle hooks
300
46
  */
301
- export declare function createVariablesPlugin(variables: Record<string, unknown>): StxPlugin;
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
- * Core Template Processing Pipeline
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), existingTitle = html.match(/<title\b[^>]*>[\s\S]*?<\/title>/i);
852
- if (incomingTitle && existingTitle) {
853
- if (replaceExistingTitle)
854
- html = html.replace(existingTitle[0], incomingTitle[0]);
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;
@@ -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 = "\0stx-boolean-attribute";
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';
@@ -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 }).
@@ -1,13 +1,25 @@
1
+ import type { CustomDirective } from '../types';
1
2
  /**
2
- * PWA Template Directives
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
- import type { CustomDirective } from '../types';
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[];
@@ -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>
@@ -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-xq2ck69k.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>
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">