@tenphi/tasty 0.0.0-snapshot.f5861ed → 0.0.0-snapshot.f60eafb

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 (337) hide show
  1. package/README.md +39 -28
  2. package/dist/{ssr/async-storage.js → async-storage-B7_o6FKt.js} +17 -8
  3. package/dist/async-storage-B7_o6FKt.js.map +1 -0
  4. package/dist/{ssr/collector.d.ts → collector-LuU1vZ68.d.ts} +11 -15
  5. package/dist/{ssr/collector.js → collector-MOYY2SOr.js} +37 -34
  6. package/dist/collector-MOYY2SOr.js.map +1 -0
  7. package/dist/config-A237aY9H.js +10235 -0
  8. package/dist/config-A237aY9H.js.map +1 -0
  9. package/dist/config-vuCRkBWX.d.ts +884 -0
  10. package/dist/context-CkSg-kDT.js +24 -0
  11. package/dist/context-CkSg-kDT.js.map +1 -0
  12. package/dist/core/index.d.ts +5 -34
  13. package/dist/core/index.js +6 -27
  14. package/dist/core-BkKav78f.js +1592 -0
  15. package/dist/core-BkKav78f.js.map +1 -0
  16. package/dist/{zero/extractor.js → css-writer-Cos9tQRM.js} +75 -13
  17. package/dist/css-writer-Cos9tQRM.js.map +1 -0
  18. package/dist/{ssr/format-global-rules.js → format-global-rules-Dbc_1tc3.js} +3 -3
  19. package/dist/format-global-rules-Dbc_1tc3.js.map +1 -0
  20. package/dist/format-rules-C2oiTsEO.js +143 -0
  21. package/dist/format-rules-C2oiTsEO.js.map +1 -0
  22. package/dist/hydrate-miFzWIKR.js +45 -0
  23. package/dist/hydrate-miFzWIKR.js.map +1 -0
  24. package/dist/index-ZRxZWzlj.d.ts +1602 -0
  25. package/dist/index-dUtwpOux.d.ts +1266 -0
  26. package/dist/index.d.ts +5 -51
  27. package/dist/index.js +731 -35
  28. package/dist/index.js.map +1 -0
  29. package/dist/keyframes-DDtNo_hl.js +587 -0
  30. package/dist/keyframes-DDtNo_hl.js.map +1 -0
  31. package/dist/{utils/merge-styles.d.ts → merge-styles-CtDJMhpJ.d.ts} +3 -3
  32. package/dist/{utils/merge-styles.js → merge-styles-D_HbBOlq.js} +4 -6
  33. package/dist/merge-styles-D_HbBOlq.js.map +1 -0
  34. package/dist/{utils/resolve-recipes.js → resolve-recipes-B7-823LL.js} +5 -8
  35. package/dist/resolve-recipes-B7-823LL.js.map +1 -0
  36. package/dist/ssr/astro-client.d.ts +1 -0
  37. package/dist/ssr/astro-client.js +19 -0
  38. package/dist/ssr/astro-client.js.map +1 -0
  39. package/dist/ssr/astro-middleware.d.ts +15 -0
  40. package/dist/ssr/astro-middleware.js +19 -0
  41. package/dist/ssr/astro-middleware.js.map +1 -0
  42. package/dist/ssr/astro.d.ts +78 -10
  43. package/dist/ssr/astro.js +116 -32
  44. package/dist/ssr/astro.js.map +1 -1
  45. package/dist/ssr/index.d.ts +44 -5
  46. package/dist/ssr/index.js +7 -9
  47. package/dist/ssr/index.js.map +1 -1
  48. package/dist/ssr/next.d.ts +7 -6
  49. package/dist/ssr/next.js +18 -14
  50. package/dist/ssr/next.js.map +1 -1
  51. package/dist/static/index.d.ts +91 -5
  52. package/dist/static/index.js +49 -4
  53. package/dist/static/index.js.map +1 -0
  54. package/dist/static/inject.d.ts +5 -0
  55. package/dist/static/inject.js +17 -0
  56. package/dist/static/inject.js.map +1 -0
  57. package/dist/zero/babel.d.ts +24 -110
  58. package/dist/zero/babel.js +139 -47
  59. package/dist/zero/babel.js.map +1 -1
  60. package/dist/zero/index.d.ts +67 -3
  61. package/dist/zero/index.js +2 -4
  62. package/dist/zero/next.d.ts +12 -0
  63. package/dist/zero/next.js +5 -4
  64. package/dist/zero/next.js.map +1 -1
  65. package/docs/README.md +4 -4
  66. package/docs/adoption.md +5 -3
  67. package/docs/comparison.md +24 -25
  68. package/docs/configuration.md +69 -1
  69. package/docs/debug.md +11 -9
  70. package/docs/design-system.md +22 -10
  71. package/docs/dsl.md +25 -10
  72. package/docs/getting-started.md +10 -10
  73. package/docs/injector.md +43 -27
  74. package/docs/methodology.md +52 -3
  75. package/docs/{PIPELINE.md → pipeline.md} +204 -50
  76. package/docs/{runtime.md → react-api.md} +104 -32
  77. package/docs/ssr.md +139 -81
  78. package/docs/styles.md +17 -0
  79. package/docs/tasty-static.md +101 -2
  80. package/package.json +22 -10
  81. package/tasty.config.ts +1 -0
  82. package/dist/_virtual/_rolldown/runtime.js +0 -8
  83. package/dist/chunks/cacheKey.js +0 -78
  84. package/dist/chunks/cacheKey.js.map +0 -1
  85. package/dist/chunks/definitions.d.ts +0 -37
  86. package/dist/chunks/definitions.js +0 -259
  87. package/dist/chunks/definitions.js.map +0 -1
  88. package/dist/chunks/renderChunk.js +0 -60
  89. package/dist/chunks/renderChunk.js.map +0 -1
  90. package/dist/config.d.ts +0 -366
  91. package/dist/config.js +0 -504
  92. package/dist/config.js.map +0 -1
  93. package/dist/counter-style/index.js +0 -51
  94. package/dist/counter-style/index.js.map +0 -1
  95. package/dist/debug.d.ts +0 -89
  96. package/dist/debug.js +0 -454
  97. package/dist/debug.js.map +0 -1
  98. package/dist/font-face/index.js +0 -63
  99. package/dist/font-face/index.js.map +0 -1
  100. package/dist/hooks/resolve-ssr-collector.js +0 -15
  101. package/dist/hooks/resolve-ssr-collector.js.map +0 -1
  102. package/dist/hooks/useCounterStyle.d.ts +0 -50
  103. package/dist/hooks/useCounterStyle.js +0 -47
  104. package/dist/hooks/useCounterStyle.js.map +0 -1
  105. package/dist/hooks/useFontFace.d.ts +0 -43
  106. package/dist/hooks/useFontFace.js +0 -71
  107. package/dist/hooks/useFontFace.js.map +0 -1
  108. package/dist/hooks/useGlobalStyles.d.ts +0 -30
  109. package/dist/hooks/useGlobalStyles.js +0 -79
  110. package/dist/hooks/useGlobalStyles.js.map +0 -1
  111. package/dist/hooks/useKeyframes.d.ts +0 -56
  112. package/dist/hooks/useKeyframes.js +0 -65
  113. package/dist/hooks/useKeyframes.js.map +0 -1
  114. package/dist/hooks/useProperty.d.ts +0 -79
  115. package/dist/hooks/useProperty.js +0 -110
  116. package/dist/hooks/useProperty.js.map +0 -1
  117. package/dist/hooks/useRawCSS.d.ts +0 -53
  118. package/dist/hooks/useRawCSS.js +0 -36
  119. package/dist/hooks/useRawCSS.js.map +0 -1
  120. package/dist/hooks/useStyles.d.ts +0 -45
  121. package/dist/hooks/useStyles.js +0 -238
  122. package/dist/hooks/useStyles.js.map +0 -1
  123. package/dist/injector/index.d.ts +0 -183
  124. package/dist/injector/index.js +0 -180
  125. package/dist/injector/index.js.map +0 -1
  126. package/dist/injector/injector.d.ts +0 -166
  127. package/dist/injector/injector.js +0 -465
  128. package/dist/injector/injector.js.map +0 -1
  129. package/dist/injector/sheet-manager.d.ts +0 -136
  130. package/dist/injector/sheet-manager.js +0 -734
  131. package/dist/injector/sheet-manager.js.map +0 -1
  132. package/dist/injector/types.d.ts +0 -204
  133. package/dist/keyframes/index.js +0 -206
  134. package/dist/keyframes/index.js.map +0 -1
  135. package/dist/parser/classify.js +0 -320
  136. package/dist/parser/classify.js.map +0 -1
  137. package/dist/parser/const.js +0 -49
  138. package/dist/parser/const.js.map +0 -1
  139. package/dist/parser/lru.js +0 -109
  140. package/dist/parser/lru.js.map +0 -1
  141. package/dist/parser/parser.d.ts +0 -25
  142. package/dist/parser/parser.js +0 -116
  143. package/dist/parser/parser.js.map +0 -1
  144. package/dist/parser/tokenizer.js +0 -69
  145. package/dist/parser/tokenizer.js.map +0 -1
  146. package/dist/parser/types.d.ts +0 -51
  147. package/dist/parser/types.js +0 -46
  148. package/dist/parser/types.js.map +0 -1
  149. package/dist/pipeline/conditions.d.ts +0 -134
  150. package/dist/pipeline/conditions.js +0 -406
  151. package/dist/pipeline/conditions.js.map +0 -1
  152. package/dist/pipeline/exclusive.js +0 -231
  153. package/dist/pipeline/exclusive.js.map +0 -1
  154. package/dist/pipeline/index.d.ts +0 -55
  155. package/dist/pipeline/index.js +0 -709
  156. package/dist/pipeline/index.js.map +0 -1
  157. package/dist/pipeline/materialize.js +0 -1104
  158. package/dist/pipeline/materialize.js.map +0 -1
  159. package/dist/pipeline/parseStateKey.d.ts +0 -15
  160. package/dist/pipeline/parseStateKey.js +0 -447
  161. package/dist/pipeline/parseStateKey.js.map +0 -1
  162. package/dist/pipeline/simplify.js +0 -516
  163. package/dist/pipeline/simplify.js.map +0 -1
  164. package/dist/pipeline/warnings.js +0 -18
  165. package/dist/pipeline/warnings.js.map +0 -1
  166. package/dist/plugins/okhsl-plugin.d.ts +0 -35
  167. package/dist/plugins/okhsl-plugin.js +0 -98
  168. package/dist/plugins/okhsl-plugin.js.map +0 -1
  169. package/dist/plugins/types.d.ts +0 -76
  170. package/dist/properties/index.js +0 -223
  171. package/dist/properties/index.js.map +0 -1
  172. package/dist/properties/property-type-resolver.d.ts +0 -24
  173. package/dist/properties/property-type-resolver.js +0 -91
  174. package/dist/properties/property-type-resolver.js.map +0 -1
  175. package/dist/ssr/async-storage.d.ts +0 -17
  176. package/dist/ssr/async-storage.js.map +0 -1
  177. package/dist/ssr/collect-auto-properties.js +0 -40
  178. package/dist/ssr/collect-auto-properties.js.map +0 -1
  179. package/dist/ssr/collector.js.map +0 -1
  180. package/dist/ssr/context.d.ts +0 -8
  181. package/dist/ssr/context.js +0 -14
  182. package/dist/ssr/context.js.map +0 -1
  183. package/dist/ssr/format-global-rules.js.map +0 -1
  184. package/dist/ssr/format-keyframes.js +0 -70
  185. package/dist/ssr/format-keyframes.js.map +0 -1
  186. package/dist/ssr/format-property.js +0 -50
  187. package/dist/ssr/format-property.js.map +0 -1
  188. package/dist/ssr/format-rules.js +0 -73
  189. package/dist/ssr/format-rules.js.map +0 -1
  190. package/dist/ssr/hydrate.d.ts +0 -22
  191. package/dist/ssr/hydrate.js +0 -50
  192. package/dist/ssr/hydrate.js.map +0 -1
  193. package/dist/ssr/ssr-collector-ref.js +0 -12
  194. package/dist/ssr/ssr-collector-ref.js.map +0 -1
  195. package/dist/states/index.d.ts +0 -49
  196. package/dist/states/index.js +0 -171
  197. package/dist/states/index.js.map +0 -1
  198. package/dist/static/tastyStatic.d.ts +0 -46
  199. package/dist/static/tastyStatic.js +0 -31
  200. package/dist/static/tastyStatic.js.map +0 -1
  201. package/dist/static/types.d.ts +0 -49
  202. package/dist/static/types.js +0 -24
  203. package/dist/static/types.js.map +0 -1
  204. package/dist/styles/align.d.ts +0 -15
  205. package/dist/styles/align.js +0 -14
  206. package/dist/styles/align.js.map +0 -1
  207. package/dist/styles/border.d.ts +0 -25
  208. package/dist/styles/border.js +0 -114
  209. package/dist/styles/border.js.map +0 -1
  210. package/dist/styles/color.d.ts +0 -14
  211. package/dist/styles/color.js +0 -27
  212. package/dist/styles/color.js.map +0 -1
  213. package/dist/styles/createStyle.js +0 -80
  214. package/dist/styles/createStyle.js.map +0 -1
  215. package/dist/styles/dimension.js +0 -97
  216. package/dist/styles/dimension.js.map +0 -1
  217. package/dist/styles/display.d.ts +0 -37
  218. package/dist/styles/display.js +0 -67
  219. package/dist/styles/display.js.map +0 -1
  220. package/dist/styles/fade.d.ts +0 -15
  221. package/dist/styles/fade.js +0 -58
  222. package/dist/styles/fade.js.map +0 -1
  223. package/dist/styles/fill.d.ts +0 -42
  224. package/dist/styles/fill.js +0 -52
  225. package/dist/styles/fill.js.map +0 -1
  226. package/dist/styles/flow.d.ts +0 -16
  227. package/dist/styles/flow.js +0 -12
  228. package/dist/styles/flow.js.map +0 -1
  229. package/dist/styles/gap.d.ts +0 -31
  230. package/dist/styles/gap.js +0 -37
  231. package/dist/styles/gap.js.map +0 -1
  232. package/dist/styles/height.d.ts +0 -17
  233. package/dist/styles/height.js +0 -20
  234. package/dist/styles/height.js.map +0 -1
  235. package/dist/styles/index.d.ts +0 -2
  236. package/dist/styles/index.js +0 -9
  237. package/dist/styles/index.js.map +0 -1
  238. package/dist/styles/inset.d.ts +0 -52
  239. package/dist/styles/inset.js +0 -150
  240. package/dist/styles/inset.js.map +0 -1
  241. package/dist/styles/justify.d.ts +0 -15
  242. package/dist/styles/justify.js +0 -14
  243. package/dist/styles/justify.js.map +0 -1
  244. package/dist/styles/list.d.ts +0 -16
  245. package/dist/styles/list.js +0 -98
  246. package/dist/styles/list.js.map +0 -1
  247. package/dist/styles/margin.d.ts +0 -24
  248. package/dist/styles/margin.js +0 -104
  249. package/dist/styles/margin.js.map +0 -1
  250. package/dist/styles/outline.d.ts +0 -29
  251. package/dist/styles/outline.js +0 -65
  252. package/dist/styles/outline.js.map +0 -1
  253. package/dist/styles/padding.d.ts +0 -24
  254. package/dist/styles/padding.js +0 -104
  255. package/dist/styles/padding.js.map +0 -1
  256. package/dist/styles/predefined.d.ts +0 -71
  257. package/dist/styles/predefined.js +0 -238
  258. package/dist/styles/predefined.js.map +0 -1
  259. package/dist/styles/preset.d.ts +0 -52
  260. package/dist/styles/preset.js +0 -127
  261. package/dist/styles/preset.js.map +0 -1
  262. package/dist/styles/radius.d.ts +0 -14
  263. package/dist/styles/radius.js +0 -51
  264. package/dist/styles/radius.js.map +0 -1
  265. package/dist/styles/scrollbar.d.ts +0 -25
  266. package/dist/styles/scrollbar.js +0 -48
  267. package/dist/styles/scrollbar.js.map +0 -1
  268. package/dist/styles/shadow.d.ts +0 -14
  269. package/dist/styles/shadow.js +0 -24
  270. package/dist/styles/shadow.js.map +0 -1
  271. package/dist/styles/transition.d.ts +0 -14
  272. package/dist/styles/transition.js +0 -158
  273. package/dist/styles/transition.js.map +0 -1
  274. package/dist/styles/types.d.ts +0 -547
  275. package/dist/styles/width.d.ts +0 -17
  276. package/dist/styles/width.js +0 -20
  277. package/dist/styles/width.js.map +0 -1
  278. package/dist/tasty.d.ts +0 -119
  279. package/dist/tasty.js +0 -232
  280. package/dist/tasty.js.map +0 -1
  281. package/dist/types.d.ts +0 -184
  282. package/dist/utils/cache-wrapper.js +0 -22
  283. package/dist/utils/cache-wrapper.js.map +0 -1
  284. package/dist/utils/case-converter.js +0 -8
  285. package/dist/utils/case-converter.js.map +0 -1
  286. package/dist/utils/color-math.d.ts +0 -46
  287. package/dist/utils/color-math.js +0 -749
  288. package/dist/utils/color-math.js.map +0 -1
  289. package/dist/utils/color-space.d.ts +0 -5
  290. package/dist/utils/color-space.js +0 -229
  291. package/dist/utils/color-space.js.map +0 -1
  292. package/dist/utils/colors.d.ts +0 -5
  293. package/dist/utils/colors.js +0 -11
  294. package/dist/utils/colors.js.map +0 -1
  295. package/dist/utils/css-types.d.ts +0 -7
  296. package/dist/utils/dotize.d.ts +0 -26
  297. package/dist/utils/dotize.js +0 -122
  298. package/dist/utils/dotize.js.map +0 -1
  299. package/dist/utils/filter-base-props.d.ts +0 -15
  300. package/dist/utils/filter-base-props.js +0 -45
  301. package/dist/utils/filter-base-props.js.map +0 -1
  302. package/dist/utils/get-display-name.d.ts +0 -7
  303. package/dist/utils/get-display-name.js +0 -10
  304. package/dist/utils/get-display-name.js.map +0 -1
  305. package/dist/utils/has-keys.js +0 -13
  306. package/dist/utils/has-keys.js.map +0 -1
  307. package/dist/utils/is-dev-env.js +0 -19
  308. package/dist/utils/is-dev-env.js.map +0 -1
  309. package/dist/utils/is-valid-element-type.js +0 -15
  310. package/dist/utils/is-valid-element-type.js.map +0 -1
  311. package/dist/utils/merge-styles.js.map +0 -1
  312. package/dist/utils/mod-attrs.d.ts +0 -8
  313. package/dist/utils/mod-attrs.js +0 -21
  314. package/dist/utils/mod-attrs.js.map +0 -1
  315. package/dist/utils/process-tokens.d.ts +0 -21
  316. package/dist/utils/process-tokens.js +0 -91
  317. package/dist/utils/process-tokens.js.map +0 -1
  318. package/dist/utils/resolve-recipes.d.ts +0 -17
  319. package/dist/utils/resolve-recipes.js.map +0 -1
  320. package/dist/utils/selector-transform.js +0 -32
  321. package/dist/utils/selector-transform.js.map +0 -1
  322. package/dist/utils/string.js +0 -8
  323. package/dist/utils/string.js.map +0 -1
  324. package/dist/utils/styles.d.ts +0 -99
  325. package/dist/utils/styles.js +0 -221
  326. package/dist/utils/styles.js.map +0 -1
  327. package/dist/utils/typography.d.ts +0 -47
  328. package/dist/utils/typography.js +0 -51
  329. package/dist/utils/typography.js.map +0 -1
  330. package/dist/utils/warnings.d.ts +0 -16
  331. package/dist/utils/warnings.js +0 -16
  332. package/dist/utils/warnings.js.map +0 -1
  333. package/dist/zero/css-writer.d.ts +0 -45
  334. package/dist/zero/css-writer.js +0 -74
  335. package/dist/zero/css-writer.js.map +0 -1
  336. package/dist/zero/extractor.d.ts +0 -24
  337. package/dist/zero/extractor.js.map +0 -1
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  <p align="center">
8
8
  <strong>Deterministic styling for stateful component systems.</strong><br>
9
- A design-system styling engine that compiles component states into mutually exclusive selectors.
9
+ A design-system styling engine that compiles component states into mutually exclusive selectors, so complex components stay predictable as they evolve.
10
10
  </p>
11
11
 
12
12
  <p align="center">
@@ -23,6 +23,8 @@ It compiles state maps into **mutually exclusive selectors**, so for a given pro
23
23
 
24
24
  That is the core guarantee: component styling resolves from declared state logic, not from source-order accidents or specificity fights.
25
25
 
26
+ The practical payoff shows up later: adding states, variants, and overrides stays inside the state map instead of reopening selector logic by hand.
27
+
26
28
  Tasty fits best when you are building a design system or component library with intersecting states, variants, tokens, sub-elements, responsive rules, and extension semantics that need to stay predictable over time.
27
29
 
28
30
  On top of that foundation, Tasty gives teams a governed styling model: a CSS-like DSL, tokens, recipes, typed style props, sub-elements, and multiple rendering modes.
@@ -35,6 +37,7 @@ On top of that foundation, Tasty gives teams a governed styling model: a CSS-lik
35
37
  ## Why Tasty
36
38
 
37
39
  - **Deterministic composition, not cascade fights** — Stateful styles resolve from the state map you declared, not from selector competition. See [How It Actually Works](#how-it-actually-works).
40
+ - **Easier to extend over time** — When components gain new states, variants, or overrides, you update declared branches instead of re-deriving selector interactions by hand.
38
41
  - **Built for design-system teams** — Best fit for reusable component systems with complex state interactions.
39
42
  - **A governed styling model, not just syntax sugar** — Design-system authors define the styling language product teams consume.
40
43
  - **DSL that still feels like CSS** — Familiar property names, less selector boilerplate. Start with the [Style DSL](docs/dsl.md), then use [Style Properties](docs/styles.md) as the handler reference.
@@ -42,7 +45,7 @@ On top of that foundation, Tasty gives teams a governed styling model: a CSS-lik
42
45
  ### Supporting capabilities
43
46
 
44
47
  - **Typed style props and mod props** — `styleProps` exposes selected CSS properties as typed React props (`<Space flow="row" gap="2x">`); `modProps` does the same for modifier keys (`<Button isLoading size="large">`). Both support state maps and full TypeScript autocomplete. See [Style Props](#style-props) and [Mod Props](#mod-props).
45
- - **Runtime, SSR, and zero-runtime options** — Use `tasty()` for runtime React components, add SSR integrations when your framework renders that runtime on the server, or use `tastyStatic()` when you specifically want build-time extraction instead of runtime styling.
48
+ - **Server-compatible by default, zero client JS in server-only contexts** — All `tasty()` components and style functions are hook-free. In server-only rendering (Next.js RSC, Astro without islands, SSG), they produce zero client JavaScript with the full feature set. Add SSR integration only when your app also has client-side hydration. Use `tastyStatic()` only when you need build-time extraction without React.
46
49
  - **Broad modern CSS coverage** — Media queries, container queries, `@supports`, `:has()`, `@starting-style`, `@property`, `@keyframes`, and more. Features that do not fit the component model (such as `@layer` and `!important`) are intentionally left out.
47
50
  - **Performance and caching** — Runtime mode injects CSS on demand, reuses chunks aggressively, and relies on multi-level caching so large component systems stay practical.
48
51
  - **TypeScript-first and AI-friendly** — Style definitions are declarative, structurally consistent, and fully typed, which helps both humans and tooling understand advanced stateful styles without hidden cascade logic.
@@ -79,7 +82,7 @@ For the fuller docs map beyond the quick routes above, start here:
79
82
  - **[Comparison](docs/comparison.md)** — read this first if you are evaluating whether Tasty fits your team's styling model
80
83
  - **[Adoption Guide](docs/adoption.md)** — understand who Tasty is for, where it fits, and how to introduce it incrementally
81
84
  - **[Getting Started](docs/getting-started.md)** — the canonical onboarding path: install, first component, optional shared `configure()`, ESLint, editor tooling, and rendering mode selection
82
- - **[Style rendering pipeline](docs/PIPELINE.md)** — see the selector model behind deterministic style resolution
85
+ - **[Style rendering pipeline](docs/pipeline.md)** — see the selector model behind deterministic style resolution
83
86
  - **[Docs Hub](docs/README.md)** — choose docs by role and task: runtime, zero-runtime, runtime SSR integration, design-system authoring, internals, and debugging
84
87
  - **[Methodology](docs/methodology.md)** — the recommended component model and public API conventions for design-system code
85
88
 
@@ -188,7 +191,7 @@ Use `configure()` once when your app or design system needs shared aliases, toke
188
191
  </Space>
189
192
  ```
190
193
 
191
- See [Style Props](#style-props) and [Mod Props](#mod-props) below, or the full reference in [Runtime API](docs/runtime.md#style-props).
194
+ See [Style Props](#style-props) and [Mod Props](#mod-props) below, or the full reference in [React API](docs/react-api.md#style-props).
192
195
 
193
196
  ## Choose a Styling Approach
194
197
 
@@ -196,16 +199,17 @@ Once you understand the component model, pick the rendering mode that matches yo
196
199
 
197
200
  | Approach | Entry point | Best for | Trade-off |
198
201
  |----------|-------------|----------|-----------|
199
- | **Runtime** | `@tenphi/tasty` | Interactive apps with reusable stateful components and design systems | Full feature set; CSS is generated on demand at runtime |
200
- | **Zero-runtime** | `@tenphi/tasty/static` | Static sites, SSG, landing pages | Requires the Babel plugin; no component-level `styleProps` or runtime-only APIs |
202
+ | **Runtime (default)** | `tasty()` from `@tenphi/tasty` | All React apps server-rendered by default, zero client JS until you need interactivity | Full feature set; CSS computed during React rendering (server or client) |
203
+ | **Runtime + SSR integration** | Add `@tenphi/tasty/ssr/*` | Apps with client-side hydration (Next.js client components, Astro islands) | Adds CSS deduplication, FOUC prevention, and client cache hydration |
204
+ | **Zero-runtime** | `tastyStatic()` from `@tenphi/tasty/static` | Non-React frameworks or when you need build-time extraction without React | Requires the Babel plugin; no component-level `styleProps` or runtime-only APIs |
201
205
 
202
- If your framework can execute runtime React code on the server, you can also add **SSR on top of runtime** with `@tenphi/tasty/ssr/*`. This uses the same `tasty()` pipeline, but collects CSS during server rendering and hydrates the cache on the client. That is the model for Next.js, generic React SSR, and Astro islands. See [Getting Started](docs/getting-started.md#choosing-a-rendering-mode), [Zero Runtime](docs/tasty-static.md), and [Server-Side Rendering](docs/ssr.md).
206
+ All `tasty()` components are hook-free and work as React Server Components. In server-only contexts Next.js RSC without `'use client'`, Astro without `client:*` directives, and other SSG setups — they produce the same end result as `tastyStatic()` (static HTML + CSS, zero client JavaScript) but with the full feature set including `styleProps`, sub-elements, and variants. SSR integration is only needed when your app also has client-side rendering. See [Getting Started](docs/getting-started.md#choosing-a-rendering-mode), [Zero Runtime](docs/tasty-static.md), and [Server-Side Rendering](docs/ssr.md).
203
207
 
204
208
  ## How It Actually Works
205
209
 
206
210
  This is the core idea that makes everything else possible.
207
211
 
208
- For the end-to-end architecture — parsing state keys, building exclusive conditions, merging by output, and materializing selectors and at-rules — see **[Style rendering pipeline](docs/PIPELINE.md)**.
212
+ For the end-to-end architecture — parsing state keys, building exclusive conditions, merging by output, and materializing selectors and at-rules — see **[Style rendering pipeline](docs/pipeline.md)**.
209
213
 
210
214
  ### The structural problem with normal CSS
211
215
 
@@ -347,7 +351,7 @@ Every style property accepts a state mapping object. Keys can be combined with b
347
351
  | Feature query | `@supports(display: grid)` | `@supports (display: grid)` |
348
352
  | Entry animation | `@starting` | `@starting-style` |
349
353
 
350
- Combine with `&` (AND), `|` (OR), `!` (NOT):
354
+ Combine with `&` (AND), `|` (OR), `!` (NOT), `^` (XOR):
351
355
 
352
356
  ```tsx
353
357
  fill: {
@@ -363,7 +367,7 @@ Compound components can style inner parts from the parent definition with capita
363
367
 
364
368
  Sub-elements share the root state context by default, so keys like `:hover`, modifiers, root states, and media queries resolve as one coordinated styling block. Use `@own(...)` when a sub-element should react to its own state, and use the `$` selector affix when you need precise descendant targeting.
365
369
 
366
- See [Runtime API - Sub-element Styling](docs/runtime.md#sub-element-styling), [Style DSL - Advanced States](docs/dsl.md#advanced-states--prefix), and [Methodology](docs/methodology.md#component-architecture-root--sub-elements).
370
+ See [React API - Sub-element Styling](docs/react-api.md#sub-element-styling), [Style DSL - Advanced States](docs/dsl.md#advanced-states--prefix), and [Methodology](docs/methodology.md#component-architecture-root--sub-elements).
367
371
 
368
372
  ### Style Props
369
373
 
@@ -378,7 +382,7 @@ const Space = tasty({
378
382
  <Space flow="row" gap={{ '': '2x', '@tablet': '4x' }}>
379
383
  ```
380
384
 
381
- See [Runtime API - Style Props](docs/runtime.md#style-props) and [Methodology - styleProps](docs/methodology.md#styleprops-as-the-public-api).
385
+ See [React API - Style Props](docs/react-api.md#style-props) and [Methodology - styleProps](docs/methodology.md#styleprops-as-the-public-api).
382
386
 
383
387
  ### Mod Props
384
388
 
@@ -397,13 +401,13 @@ const Button = tasty({
397
401
  <Button isLoading size="lg">Submit</Button>
398
402
  ```
399
403
 
400
- See [Runtime API - Mod Props](docs/runtime.md#mod-props) and [Methodology - modProps](docs/methodology.md#modprops-and-mods).
404
+ See [React API - Mod Props](docs/react-api.md#mod-props) and [Methodology - modProps](docs/methodology.md#modprops-and-mods).
401
405
 
402
406
  ### Variants
403
407
 
404
408
  Variants let one component expose named visual versions without pre-generating a separate class for every possible combination. In runtime mode, Tasty emits only the variant CSS that is actually used.
405
409
 
406
- See [Runtime API - Variants](docs/runtime.md#variants).
410
+ See [React API - Variants](docs/react-api.md#variants).
407
411
 
408
412
  ### Recipes
409
413
 
@@ -427,11 +431,11 @@ Use explicit `@properties` only when you need to override defaults such as `inhe
427
431
 
428
432
  See [Style DSL - Properties (`@property`)](docs/dsl.md#properties-property).
429
433
 
430
- ### React Hooks
434
+ ### Style Functions
431
435
 
432
- When you do not need a full component wrapper, use the hooks directly: `useStyles` for local class names, `useGlobalStyles` for selector-scoped global CSS, `useRawCSS` for raw rules, plus `useKeyframes` and `useProperty` for animation and custom-property primitives.
436
+ When you do not need a full component wrapper, use the style functions directly: `useStyles` for local class names, `useGlobalStyles` for selector-scoped global CSS, `useRawCSS` for raw rules, plus `useKeyframes`, `useProperty`, `useFontFace`, and `useCounterStyle` for animation, custom-property, font, and counter-style primitives. All style functions are hook-free and work in React Server Components.
433
437
 
434
- See [Runtime API - Hooks](docs/runtime.md#hooks).
438
+ See [React API - Style Functions](docs/react-api.md#style-functions).
435
439
 
436
440
  ### Zero-Runtime Mode
437
441
 
@@ -441,15 +445,19 @@ See [Zero Runtime (tastyStatic)](docs/tasty-static.md) and [Getting Started - Ch
441
445
 
442
446
  ### `tasty` vs `tastyStatic`
443
447
 
444
- `tasty()` returns React components and injects CSS on demand at runtime. `tastyStatic()` returns class names and extracts CSS during the build. Both share the same DSL, tokens, units, state mappings, and recipes, so the main choice is runtime flexibility versus build-time extraction.
448
+ `tasty()` returns React components that compute CSS during rendering. In server-only contexts, this produces static HTML + CSS with zero client JavaScript — the same end result as `tastyStatic()` but with the full feature set. `tastyStatic()` returns class names and extracts CSS during the build via a Babel plugin, with no React dependency at runtime. Both share the same DSL, tokens, units, state mappings, and recipes. Use `tasty()` as the default for any React-based setup; use `tastyStatic()` when you need build-time extraction without React.
445
449
 
446
- See [Zero Runtime (tastyStatic)](docs/tasty-static.md), [Runtime API](docs/runtime.md), and [Comparison - Build-time vs runtime](docs/comparison.md#build-time-vs-runtime).
450
+ See [Zero Runtime (tastyStatic)](docs/tasty-static.md), [React API](docs/react-api.md), and [Comparison - Build-time vs runtime](docs/comparison.md#build-time-vs-runtime).
447
451
 
448
452
  ### Server-Side Rendering
449
453
 
450
- SSR layers on top of runtime `tasty()` rather than introducing a separate styling model. Existing components stay unchanged while Tasty collects CSS during server rendering and hydrates the cache on the client.
454
+ `tasty()` components already work on the server without any SSR integration they are hook-free and render as React Server Components by default. In server-only contexts (Next.js RSC, Astro without islands), they produce zero client JavaScript with the full feature set.
455
+
456
+ SSR integration (`TastyRegistry`, `tastyIntegration`) adds CSS batching, deduplication across component trees, FOUC prevention, and client cache hydration. Use it when your app also has client-side rendering:
451
457
 
452
- Use `@tenphi/tasty/ssr/next` for Next.js App Router, `@tenphi/tasty/ssr/astro` for Astro, or the core SSR API for other React SSR setups.
458
+ - `@tenphi/tasty/ssr/next` for Next.js App Router (mixed server + client components)
459
+ - `@tenphi/tasty/ssr/astro` for Astro (with or without islands)
460
+ - The core SSR API for other React SSR setups
453
461
 
454
462
  See the [full SSR guide](docs/ssr.md).
455
463
 
@@ -457,7 +465,7 @@ See the [full SSR guide](docs/ssr.md).
457
465
 
458
466
  | Import | Description | Platform |
459
467
  |--------|-------------|----------|
460
- | `@tenphi/tasty` | Runtime style engine (`tasty`, hooks, `configure`) | Browser |
468
+ | `@tenphi/tasty` | Runtime style engine (`tasty`, style functions, `configure`) | Browser |
461
469
  | `@tenphi/tasty/static` | Zero-runtime static styles (`tastyStatic`) | Browser |
462
470
  | `@tenphi/tasty/core` | Lower-level internals (config, parser, pipeline, injector, style handlers) for tooling and advanced use | Browser / Node |
463
471
  | `@tenphi/tasty/babel-plugin` | Babel plugin for zero-runtime CSS extraction | Node |
@@ -465,7 +473,8 @@ See the [full SSR guide](docs/ssr.md).
465
473
  | `@tenphi/tasty/next` | Next.js integration wrapper | Node |
466
474
  | `@tenphi/tasty/ssr` | Core SSR API (collector, context, hydration) | Node |
467
475
  | `@tenphi/tasty/ssr/next` | Next.js App Router SSR integration | Node |
468
- | `@tenphi/tasty/ssr/astro` | Astro middleware + auto-hydration | Node / Browser |
476
+ | `@tenphi/tasty/ssr/astro` | Astro integration + middleware | Node |
477
+ | `@tenphi/tasty/ssr/astro-client` | Astro client-side cache hydration | Browser |
469
478
 
470
479
  ## Browser Requirements
471
480
 
@@ -483,11 +492,13 @@ All sizes measured with [size-limit](https://github.com/ai/size-limit) — minif
483
492
 
484
493
  | Entry point | Size |
485
494
  |-------------|------|
486
- | `@tenphi/tasty` (runtime + SSR) | ~44 kB |
487
- | `@tenphi/tasty/core` (runtime, no SSR) | ~41 kB |
488
- | `@tenphi/tasty/static` (zero-runtime) | ~1.5 kB |
495
+ | `@tenphi/tasty` (runtime + SSR) | 50.19 kB |
496
+ | `@tenphi/tasty/core` (runtime, no SSR) | 47.76 kB |
497
+ | `@tenphi/tasty/static` (zero-runtime) | 16.43 kB |
498
+ | `@tenphi/tasty/zero` (programmatic extraction) | 29.6 kB |
499
+ | `@tenphi/tasty/babel-plugin` (Babel plugin entry) | 43.7 kB |
489
500
 
490
- Run `pnpm size` for exact up-to-date numbers.
501
+ Run `pnpm size` to reproduce (outputs may shift slightly with releases).
491
502
 
492
503
  ### Runtime Benchmarks
493
504
 
@@ -605,7 +616,7 @@ Start from the docs hub if you want the shortest path to the right guide for you
605
616
  ### Reference
606
617
 
607
618
  - **[Style DSL](docs/dsl.md)** — The Tasty style language: state maps, tokens, units, color syntax, extending semantics, recipes, keyframes, and @property
608
- - **[Runtime API](docs/runtime.md)** — React-specific API: `tasty()` factory, component props, variants, sub-elements, and hooks
619
+ - **[React API](docs/react-api.md)** — React-specific API: `tasty()` factory, component props, variants, sub-elements, and style functions
609
620
  - **[Configuration](docs/configuration.md)** — Global configuration: tokens, recipes, custom units, style handlers, and TypeScript extensions
610
621
  - **[Style Properties](docs/styles.md)** — Complete reference for all enhanced style properties: syntax, values, modifiers, and recommendations
611
622
 
@@ -616,7 +627,7 @@ Start from the docs hub if you want the shortest path to the right guide for you
616
627
 
617
628
  ### Internals
618
629
 
619
- - **[Style rendering pipeline](docs/PIPELINE.md)** — How `Styles` become mutually exclusive CSS rules: parse → exclusives → combinations → handlers → merge → materialize (`src/pipeline/`)
630
+ - **[Style rendering pipeline](docs/pipeline.md)** — How `Styles` become mutually exclusive CSS rules: parse → exclusives → combinations → handlers → merge → materialize (`src/pipeline/`)
620
631
  - **[Style Injector](docs/injector.md)** — Internal CSS injection engine: `inject()`, `injectGlobal()`, `injectRawCSS()`, `keyframes()`, deduplication, reference counting, cleanup, SSR support, and Shadow DOM
621
632
  - **[Debug Utilities](docs/debug.md)** — Runtime CSS inspection via `tastyDebug`: CSS extraction, element inspection, cache metrics, chunk breakdown, and performance monitoring
622
633
 
@@ -1,5 +1,4 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
-
3
2
  //#region src/ssr/async-storage.ts
4
3
  /**
5
4
  * AsyncLocalStorage integration for SSR collector discovery.
@@ -9,27 +8,37 @@ import { AsyncLocalStorage } from "node:async_hooks";
9
8
  * The middleware calls runWithCollector() around the render, and
10
9
  * useStyles() calls getSSRCollector() to find it.
11
10
  *
11
+ * Uses globalThis to ensure the AsyncLocalStorage instance is shared
12
+ * across module instances — frameworks like Astro may load middleware
13
+ * and page components from separate module graphs.
14
+ *
12
15
  * This module imports from 'node:async_hooks' — it must be excluded
13
16
  * from client bundles via the build configuration.
14
17
  */
15
- const tastySSRStorage = new AsyncLocalStorage();
18
+ const ALS_KEY = "__tasty_ssr_als__";
19
+ function getSharedStorage() {
20
+ const g = globalThis;
21
+ if (!g[ALS_KEY]) g[ALS_KEY] = new AsyncLocalStorage();
22
+ return g[ALS_KEY];
23
+ }
16
24
  /**
17
25
  * Run a function with a ServerStyleCollector bound to the current
18
26
  * async context. All useStyles() calls within `fn` (and any async
19
27
  * continuations) will find this collector via getSSRCollector().
20
28
  */
21
29
  function runWithCollector(collector, fn) {
22
- return tastySSRStorage.run(collector, fn);
30
+ return getSharedStorage().run(collector, fn);
23
31
  }
24
32
  /**
25
33
  * Retrieve the ServerStyleCollector bound to the current async context.
26
34
  * Returns null when called outside of runWithCollector() or on the client.
27
35
  */
28
36
  function getSSRCollector() {
29
- if (typeof tastySSRStorage?.getStore !== "function") return null;
30
- return tastySSRStorage.getStore() ?? null;
37
+ const storage = getSharedStorage();
38
+ if (typeof storage?.getStore !== "function") return null;
39
+ return storage.getStore() ?? null;
31
40
  }
32
-
33
41
  //#endregion
34
- export { getSSRCollector, runWithCollector };
35
- //# sourceMappingURL=async-storage.js.map
42
+ export { runWithCollector as n, getSSRCollector as t };
43
+
44
+ //# sourceMappingURL=async-storage-B7_o6FKt.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"async-storage-B7_o6FKt.js","names":[],"sources":["../src/ssr/async-storage.ts"],"sourcesContent":["/**\n * AsyncLocalStorage integration for SSR collector discovery.\n *\n * Used by Astro middleware and generic framework integrations where\n * the library cannot wrap the React tree with a context provider.\n * The middleware calls runWithCollector() around the render, and\n * useStyles() calls getSSRCollector() to find it.\n *\n * Uses globalThis to ensure the AsyncLocalStorage instance is shared\n * across module instances — frameworks like Astro may load middleware\n * and page components from separate module graphs.\n *\n * This module imports from 'node:async_hooks' — it must be excluded\n * from client bundles via the build configuration.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport type { ServerStyleCollector } from './collector';\n\nconst ALS_KEY = '__tasty_ssr_als__';\n\nfunction getSharedStorage(): AsyncLocalStorage<ServerStyleCollector> {\n const g = globalThis as Record<string, unknown>;\n if (!g[ALS_KEY]) {\n g[ALS_KEY] = new AsyncLocalStorage<ServerStyleCollector>();\n }\n return g[ALS_KEY] as AsyncLocalStorage<ServerStyleCollector>;\n}\n\n/**\n * Run a function with a ServerStyleCollector bound to the current\n * async context. All useStyles() calls within `fn` (and any async\n * continuations) will find this collector via getSSRCollector().\n */\nexport function runWithCollector<T>(\n collector: ServerStyleCollector,\n fn: () => T,\n): T {\n return getSharedStorage().run(collector, fn);\n}\n\n/**\n * Retrieve the ServerStyleCollector bound to the current async context.\n * Returns null when called outside of runWithCollector() or on the client.\n */\nexport function getSSRCollector(): ServerStyleCollector | null {\n const storage = getSharedStorage();\n if (typeof storage?.getStore !== 'function') return null;\n return storage.getStore() ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,UAAU;AAEhB,SAAS,mBAA4D;CACnE,MAAM,IAAI;AACV,KAAI,CAAC,EAAE,SACL,GAAE,WAAW,IAAI,mBAAyC;AAE5D,QAAO,EAAE;;;;;;;AAQX,SAAgB,iBACd,WACA,IACG;AACH,QAAO,kBAAkB,CAAC,IAAI,WAAW,GAAG;;;;;;AAO9C,SAAgB,kBAA+C;CAC7D,MAAM,UAAU,kBAAkB;AAClC,KAAI,OAAO,SAAS,aAAa,WAAY,QAAO;AACpD,QAAO,QAAQ,UAAU,IAAI"}
@@ -1,19 +1,9 @@
1
- import { StyleResult } from "../pipeline/index.js";
1
+ import { n as StyleResult } from "./index-dUtwpOux.js";
2
2
 
3
3
  //#region src/ssr/collector.d.ts
4
- /**
5
- * Cache state serialized to the client for hydration.
6
- */
7
- interface SSRCacheState {
8
- /** cacheKey → className map, to pre-populate the client registry */
9
- entries: Record<string, string>;
10
- /** Counter value so client allocations don't collide with server ones */
11
- classCounter: number;
12
- }
13
4
  declare class ServerStyleCollector {
14
5
  private chunks;
15
6
  private cacheKeyToClassName;
16
- private classCounter;
17
7
  private flushedKeys;
18
8
  private propertyRules;
19
9
  private flushedPropertyKeys;
@@ -34,6 +24,10 @@ declare class ServerStyleCollector {
34
24
  * Collect internal @property rules and :root token defaults.
35
25
  * Mirrors markStylesGenerated() from the client-side injector.
36
26
  * Called automatically on first chunk collection; idempotent.
27
+ *
28
+ * Internals are always emitted here — the RSC path deliberately
29
+ * defers to SSR so that tokens appear exactly once per page in
30
+ * <style data-tasty-ssr> (avoiding duplication of large token sets).
37
31
  */
38
32
  collectInternals(): void;
39
33
  /**
@@ -92,11 +86,13 @@ declare class ServerStyleCollector {
92
86
  * Used for streaming SSR (renderToPipeableStream + useServerInsertedHTML).
93
87
  */
94
88
  flushCSS(): string;
89
+ private flushedClassNames;
95
90
  /**
96
- * Serialize the cache state for client hydration.
91
+ * Return class names rendered since the last call (for streaming).
92
+ * Used to emit lightweight class-list scripts for client hydration.
97
93
  */
98
- getCacheState(): SSRCacheState;
94
+ getRenderedClassNames(): string[];
99
95
  }
100
96
  //#endregion
101
- export { SSRCacheState, ServerStyleCollector };
102
- //# sourceMappingURL=collector.d.ts.map
97
+ export { ServerStyleCollector as t };
98
+ //# sourceMappingURL=collector-LuU1vZ68.d.ts.map
@@ -1,30 +1,24 @@
1
- import { fontFaceContentHash, formatFontFaceRule } from "../font-face/index.js";
2
- import { formatCounterStyleRule } from "../counter-style/index.js";
3
- import { renderStyles } from "../pipeline/index.js";
4
- import { INTERNAL_PROPERTIES, getGlobalConfigTokens, getGlobalCounterStyle, getGlobalFontFace, getGlobalProperties, hasGlobalProperties } from "../config.js";
5
- import { formatPropertyCSS } from "./format-property.js";
6
- import { formatGlobalRules } from "./format-global-rules.js";
7
- import { formatRules } from "./format-rules.js";
8
-
1
+ import { F as formatFontFaceRule, P as fontFaceContentHash, a as getGlobalCounterStyle, ct as hashString, i as getGlobalConfigTokens, j as formatCounterStyleRule, o as getGlobalFontFace, r as getEffectiveProperties, u as getGlobalStyles, x as renderStyles } from "./config-A237aY9H.js";
2
+ import { n as formatPropertyCSS, t as formatRules } from "./format-rules-C2oiTsEO.js";
3
+ import { t as formatGlobalRules } from "./format-global-rules-Dbc_1tc3.js";
9
4
  //#region src/ssr/collector.ts
10
5
  /**
11
6
  * ServerStyleCollector — server-safe style collector for SSR.
12
7
  *
13
8
  * Accumulates CSS rules and cache metadata during server rendering.
14
9
  * This is the server-side counterpart to StyleInjector: it allocates
15
- * sequential class names (t0, t1, …), formats CSS rules into text,
16
- * and serializes the cache state for client hydration.
10
+ * hash-based class names (`t${hash}`), formats CSS rules into text,
11
+ * and tracks rendered class names for lightweight client transfer.
17
12
  *
18
13
  * One instance is created per HTTP request. Concurrent requests
19
14
  * each get their own collector (via AsyncLocalStorage or React context).
20
15
  */
21
- function generateClassName(counter) {
22
- return `t${counter}`;
16
+ function generateClassName(cacheKey) {
17
+ return `t${hashString(cacheKey)}`;
23
18
  }
24
19
  var ServerStyleCollector = class {
25
20
  chunks = /* @__PURE__ */ new Map();
26
21
  cacheKeyToClassName = /* @__PURE__ */ new Map();
27
- classCounter = 0;
28
22
  flushedKeys = /* @__PURE__ */ new Set();
29
23
  propertyRules = /* @__PURE__ */ new Map();
30
24
  flushedPropertyKeys = /* @__PURE__ */ new Set();
@@ -45,20 +39,17 @@ var ServerStyleCollector = class {
45
39
  * Collect internal @property rules and :root token defaults.
46
40
  * Mirrors markStylesGenerated() from the client-side injector.
47
41
  * Called automatically on first chunk collection; idempotent.
42
+ *
43
+ * Internals are always emitted here — the RSC path deliberately
44
+ * defers to SSR so that tokens appear exactly once per page in
45
+ * <style data-tasty-ssr> (avoiding duplication of large token sets).
48
46
  */
49
47
  collectInternals() {
50
48
  if (this.internalsCollected) return;
51
49
  this.internalsCollected = true;
52
- for (const [token, definition] of Object.entries(INTERNAL_PROPERTIES)) {
50
+ for (const [token, definition] of Object.entries(getEffectiveProperties())) {
53
51
  const css = formatPropertyCSS(token, definition);
54
- if (css) this.collectProperty(`__internal:${token}`, css);
55
- }
56
- if (hasGlobalProperties()) {
57
- const globalProps = getGlobalProperties();
58
- if (globalProps) for (const [token, definition] of Object.entries(globalProps)) {
59
- const css = formatPropertyCSS(token, definition);
60
- if (css) this.collectProperty(`__global:${token}`, css);
61
- }
52
+ if (css) this.collectProperty(`__prop:${token}`, css);
62
53
  }
63
54
  const tokenStyles = getGlobalConfigTokens();
64
55
  if (tokenStyles && Object.keys(tokenStyles).length > 0) {
@@ -82,6 +73,16 @@ var ServerStyleCollector = class {
82
73
  const css = formatCounterStyleRule(name, descriptors);
83
74
  this.collectCounterStyle(name, css);
84
75
  }
76
+ const globalStyles = getGlobalStyles();
77
+ if (globalStyles) {
78
+ for (const [selector, styles] of Object.entries(globalStyles)) if (Object.keys(styles).length > 0) {
79
+ const rules = renderStyles(styles, selector);
80
+ if (rules.length > 0) {
81
+ const css = formatGlobalRules(rules);
82
+ if (css) this.collectGlobalStyles(`__global:styles:${selector}`, css);
83
+ }
84
+ }
85
+ }
85
86
  }
86
87
  /**
87
88
  * Allocate a className for a cache key, server-side.
@@ -93,7 +94,7 @@ var ServerStyleCollector = class {
93
94
  className: existing,
94
95
  isNewAllocation: false
95
96
  };
96
- const className = generateClassName(this.classCounter++);
97
+ const className = generateClassName(cacheKey);
97
98
  this.cacheKeyToClassName.set(cacheKey, className);
98
99
  return {
99
100
  className,
@@ -209,19 +210,21 @@ var ServerStyleCollector = class {
209
210
  }
210
211
  return parts.join("\n");
211
212
  }
213
+ flushedClassNames = /* @__PURE__ */ new Set();
212
214
  /**
213
- * Serialize the cache state for client hydration.
215
+ * Return class names rendered since the last call (for streaming).
216
+ * Used to emit lightweight class-list scripts for client hydration.
214
217
  */
215
- getCacheState() {
216
- const entries = {};
217
- for (const [cacheKey, className] of this.cacheKeyToClassName) entries[cacheKey] = className;
218
- return {
219
- entries,
220
- classCounter: this.classCounter
221
- };
218
+ getRenderedClassNames() {
219
+ const names = [];
220
+ for (const className of this.cacheKeyToClassName.values()) if (!this.flushedClassNames.has(className)) {
221
+ this.flushedClassNames.add(className);
222
+ names.push(className);
223
+ }
224
+ return names;
222
225
  }
223
226
  };
224
-
225
227
  //#endregion
226
- export { ServerStyleCollector };
227
- //# sourceMappingURL=collector.js.map
228
+ export { ServerStyleCollector as t };
229
+
230
+ //# sourceMappingURL=collector-MOYY2SOr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collector-MOYY2SOr.js","names":[],"sources":["../src/ssr/collector.ts"],"sourcesContent":["/**\n * ServerStyleCollector — server-safe style collector for SSR.\n *\n * Accumulates CSS rules and cache metadata during server rendering.\n * This is the server-side counterpart to StyleInjector: it allocates\n * hash-based class names (`t${hash}`), formats CSS rules into text,\n * and tracks rendered class names for lightweight client transfer.\n *\n * One instance is created per HTTP request. Concurrent requests\n * each get their own collector (via AsyncLocalStorage or React context).\n */\n\nimport {\n getEffectiveProperties,\n getGlobalStyles,\n getGlobalCounterStyle,\n getGlobalFontFace,\n getGlobalConfigTokens,\n} from '../config';\nimport { formatCounterStyleRule } from '../counter-style';\nimport { fontFaceContentHash, formatFontFaceRule } from '../font-face';\nimport { renderStyles } from '../pipeline';\nimport type { StyleResult } from '../pipeline';\nimport { hashString } from '../utils/hash';\nimport { formatPropertyCSS } from './format-property';\nimport { formatGlobalRules } from './format-global-rules';\nimport { formatRules } from './format-rules';\n\nfunction generateClassName(cacheKey: string): string {\n return `t${hashString(cacheKey)}`;\n}\n\nexport class ServerStyleCollector {\n private chunks = new Map<string, string>();\n private cacheKeyToClassName = new Map<string, string>();\n private flushedKeys = new Set<string>();\n private propertyRules = new Map<string, string>();\n private flushedPropertyKeys = new Set<string>();\n private keyframeRules = new Map<string, string>();\n private flushedKeyframeKeys = new Set<string>();\n private globalStyles = new Map<string, string>();\n private flushedGlobalKeys = new Set<string>();\n private rawCSS = new Map<string, string>();\n private flushedRawKeys = new Set<string>();\n private fontFaceRules = new Map<string, string>();\n private flushedFontFaceKeys = new Set<string>();\n private counterStyleRules = new Map<string, string>();\n private flushedCounterStyleKeys = new Set<string>();\n private keyframesCounter = 0;\n private counterStyleCounter = 0;\n private internalsCollected = false;\n\n /**\n * Collect internal @property rules and :root token defaults.\n * Mirrors markStylesGenerated() from the client-side injector.\n * Called automatically on first chunk collection; idempotent.\n *\n * Internals are always emitted here — the RSC path deliberately\n * defers to SSR so that tokens appear exactly once per page in\n * <style data-tasty-ssr> (avoiding duplication of large token sets).\n */\n collectInternals(): void {\n if (this.internalsCollected) return;\n this.internalsCollected = true;\n\n for (const [token, definition] of Object.entries(\n getEffectiveProperties(),\n )) {\n const css = formatPropertyCSS(token, definition);\n if (css) {\n this.collectProperty(`__prop:${token}`, css);\n }\n }\n\n const tokenStyles = getGlobalConfigTokens();\n if (tokenStyles && Object.keys(tokenStyles).length > 0) {\n const tokenRules = renderStyles(tokenStyles, ':root') as StyleResult[];\n if (tokenRules.length > 0) {\n const css = formatGlobalRules(tokenRules);\n if (css) {\n this.collectGlobalStyles('__global:tokens', css);\n }\n }\n }\n\n const globalFF = getGlobalFontFace();\n if (globalFF) {\n for (const [family, input] of Object.entries(globalFF)) {\n const descriptors = Array.isArray(input) ? input : [input];\n for (const desc of descriptors) {\n const hash = fontFaceContentHash(family, desc);\n const css = formatFontFaceRule(family, desc);\n this.collectFontFace(hash, css);\n }\n }\n }\n\n const globalCS = getGlobalCounterStyle();\n if (globalCS) {\n for (const [name, descriptors] of Object.entries(globalCS)) {\n const css = formatCounterStyleRule(name, descriptors);\n this.collectCounterStyle(name, css);\n }\n }\n\n const globalStyles = getGlobalStyles();\n if (globalStyles) {\n for (const [selector, styles] of Object.entries(globalStyles)) {\n if (Object.keys(styles).length > 0) {\n const rules = renderStyles(styles, selector) as StyleResult[];\n if (rules.length > 0) {\n const css = formatGlobalRules(rules);\n if (css) {\n this.collectGlobalStyles(`__global:styles:${selector}`, css);\n }\n }\n }\n }\n }\n }\n\n /**\n * Allocate a className for a cache key, server-side.\n * Mirrors StyleInjector.allocateClassName but without DOM access.\n */\n allocateClassName(cacheKey: string): {\n className: string;\n isNewAllocation: boolean;\n } {\n const existing = this.cacheKeyToClassName.get(cacheKey);\n if (existing) {\n return { className: existing, isNewAllocation: false };\n }\n\n const className = generateClassName(cacheKey);\n this.cacheKeyToClassName.set(cacheKey, className);\n\n return { className, isNewAllocation: true };\n }\n\n /**\n * Record CSS rules for a chunk.\n * Called by useStyles during server render.\n */\n collectChunk(\n cacheKey: string,\n className: string,\n rules: StyleResult[],\n ): void {\n if (this.chunks.has(cacheKey)) return;\n const css = formatRules(rules, className);\n if (css) {\n this.chunks.set(cacheKey, css);\n }\n }\n\n /**\n * Record a @property rule. Deduplicated by name.\n */\n collectProperty(name: string, css: string): void {\n if (!this.propertyRules.has(name)) {\n this.propertyRules.set(name, css);\n }\n }\n\n /**\n * Record a @keyframes rule. Deduplicated by name.\n */\n collectKeyframes(name: string, css: string): void {\n if (!this.keyframeRules.has(name)) {\n this.keyframeRules.set(name, css);\n }\n }\n\n /**\n * Allocate a keyframe name for SSR. Uses provided name or generates one.\n */\n allocateKeyframeName(providedName?: string): string {\n return providedName ?? `k${this.keyframesCounter++}`;\n }\n\n /**\n * Record a @font-face rule. Deduplicated by key (content hash).\n */\n collectFontFace(key: string, css: string): void {\n if (!this.fontFaceRules.has(key)) {\n this.fontFaceRules.set(key, css);\n }\n }\n\n /**\n * Record a @counter-style rule. Deduplicated by name.\n */\n collectCounterStyle(name: string, css: string): void {\n if (!this.counterStyleRules.has(name)) {\n this.counterStyleRules.set(name, css);\n }\n }\n\n /**\n * Allocate a counter-style name for SSR. Uses provided name or generates one.\n */\n allocateCounterStyleName(providedName?: string): string {\n return providedName ?? `cs${this.counterStyleCounter++}`;\n }\n\n /**\n * Record global styles (from useGlobalStyles). Deduplicated by key.\n */\n collectGlobalStyles(key: string, css: string): void {\n if (!this.globalStyles.has(key)) {\n this.globalStyles.set(key, css);\n }\n }\n\n /**\n * Record raw CSS text (from useRawCSS). Deduplicated by key.\n */\n collectRawCSS(key: string, css: string): void {\n if (!this.rawCSS.has(key)) {\n this.rawCSS.set(key, css);\n }\n }\n\n /**\n * Extract all CSS collected so far as a single string.\n * Includes @property and @keyframes rules.\n * Used for non-streaming SSR (renderToString).\n */\n getCSS(): string {\n const parts: string[] = [];\n\n for (const css of this.propertyRules.values()) {\n parts.push(css);\n }\n\n for (const css of this.fontFaceRules.values()) {\n parts.push(css);\n }\n\n for (const css of this.counterStyleRules.values()) {\n parts.push(css);\n }\n\n for (const css of this.rawCSS.values()) {\n parts.push(css);\n }\n\n for (const css of this.globalStyles.values()) {\n parts.push(css);\n }\n\n for (const css of this.chunks.values()) {\n parts.push(css);\n }\n\n for (const css of this.keyframeRules.values()) {\n parts.push(css);\n }\n\n return parts.join('\\n');\n }\n\n /**\n * Flush only newly collected CSS since the last flush.\n * Used for streaming SSR (renderToPipeableStream + useServerInsertedHTML).\n */\n flushCSS(): string {\n const parts: string[] = [];\n\n for (const [name, css] of this.propertyRules) {\n if (!this.flushedPropertyKeys.has(name)) {\n parts.push(css);\n this.flushedPropertyKeys.add(name);\n }\n }\n\n for (const [key, css] of this.fontFaceRules) {\n if (!this.flushedFontFaceKeys.has(key)) {\n parts.push(css);\n this.flushedFontFaceKeys.add(key);\n }\n }\n\n for (const [key, css] of this.counterStyleRules) {\n if (!this.flushedCounterStyleKeys.has(key)) {\n parts.push(css);\n this.flushedCounterStyleKeys.add(key);\n }\n }\n\n for (const [key, css] of this.rawCSS) {\n if (!this.flushedRawKeys.has(key)) {\n parts.push(css);\n this.flushedRawKeys.add(key);\n }\n }\n\n for (const [key, css] of this.globalStyles) {\n if (!this.flushedGlobalKeys.has(key)) {\n parts.push(css);\n this.flushedGlobalKeys.add(key);\n }\n }\n\n for (const [key, css] of this.chunks) {\n if (!this.flushedKeys.has(key)) {\n parts.push(css);\n this.flushedKeys.add(key);\n }\n }\n\n for (const [name, css] of this.keyframeRules) {\n if (!this.flushedKeyframeKeys.has(name)) {\n parts.push(css);\n this.flushedKeyframeKeys.add(name);\n }\n }\n\n return parts.join('\\n');\n }\n\n private flushedClassNames = new Set<string>();\n\n /**\n * Return class names rendered since the last call (for streaming).\n * Used to emit lightweight class-list scripts for client hydration.\n */\n getRenderedClassNames(): string[] {\n const names: string[] = [];\n for (const className of this.cacheKeyToClassName.values()) {\n if (!this.flushedClassNames.has(className)) {\n this.flushedClassNames.add(className);\n names.push(className);\n }\n }\n return names;\n }\n}\n"],"mappings":"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"}