@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.
- package/README.md +39 -28
- package/dist/{ssr/async-storage.js → async-storage-B7_o6FKt.js} +17 -8
- package/dist/async-storage-B7_o6FKt.js.map +1 -0
- package/dist/{ssr/collector.d.ts → collector-LuU1vZ68.d.ts} +11 -15
- package/dist/{ssr/collector.js → collector-MOYY2SOr.js} +37 -34
- package/dist/collector-MOYY2SOr.js.map +1 -0
- package/dist/config-A237aY9H.js +10235 -0
- package/dist/config-A237aY9H.js.map +1 -0
- package/dist/config-vuCRkBWX.d.ts +884 -0
- package/dist/context-CkSg-kDT.js +24 -0
- package/dist/context-CkSg-kDT.js.map +1 -0
- package/dist/core/index.d.ts +5 -34
- package/dist/core/index.js +6 -27
- package/dist/core-BkKav78f.js +1592 -0
- package/dist/core-BkKav78f.js.map +1 -0
- package/dist/{zero/extractor.js → css-writer-Cos9tQRM.js} +75 -13
- package/dist/css-writer-Cos9tQRM.js.map +1 -0
- package/dist/{ssr/format-global-rules.js → format-global-rules-Dbc_1tc3.js} +3 -3
- package/dist/format-global-rules-Dbc_1tc3.js.map +1 -0
- package/dist/format-rules-C2oiTsEO.js +143 -0
- package/dist/format-rules-C2oiTsEO.js.map +1 -0
- package/dist/hydrate-miFzWIKR.js +45 -0
- package/dist/hydrate-miFzWIKR.js.map +1 -0
- package/dist/index-ZRxZWzlj.d.ts +1602 -0
- package/dist/index-dUtwpOux.d.ts +1266 -0
- package/dist/index.d.ts +5 -51
- package/dist/index.js +731 -35
- package/dist/index.js.map +1 -0
- package/dist/keyframes-DDtNo_hl.js +587 -0
- package/dist/keyframes-DDtNo_hl.js.map +1 -0
- package/dist/{utils/merge-styles.d.ts → merge-styles-CtDJMhpJ.d.ts} +3 -3
- package/dist/{utils/merge-styles.js → merge-styles-D_HbBOlq.js} +4 -6
- package/dist/merge-styles-D_HbBOlq.js.map +1 -0
- package/dist/{utils/resolve-recipes.js → resolve-recipes-B7-823LL.js} +5 -8
- package/dist/resolve-recipes-B7-823LL.js.map +1 -0
- package/dist/ssr/astro-client.d.ts +1 -0
- package/dist/ssr/astro-client.js +19 -0
- package/dist/ssr/astro-client.js.map +1 -0
- package/dist/ssr/astro-middleware.d.ts +15 -0
- package/dist/ssr/astro-middleware.js +19 -0
- package/dist/ssr/astro-middleware.js.map +1 -0
- package/dist/ssr/astro.d.ts +78 -10
- package/dist/ssr/astro.js +116 -32
- package/dist/ssr/astro.js.map +1 -1
- package/dist/ssr/index.d.ts +44 -5
- package/dist/ssr/index.js +7 -9
- package/dist/ssr/index.js.map +1 -1
- package/dist/ssr/next.d.ts +7 -6
- package/dist/ssr/next.js +18 -14
- package/dist/ssr/next.js.map +1 -1
- package/dist/static/index.d.ts +91 -5
- package/dist/static/index.js +49 -4
- package/dist/static/index.js.map +1 -0
- package/dist/static/inject.d.ts +5 -0
- package/dist/static/inject.js +17 -0
- package/dist/static/inject.js.map +1 -0
- package/dist/zero/babel.d.ts +24 -110
- package/dist/zero/babel.js +139 -47
- package/dist/zero/babel.js.map +1 -1
- package/dist/zero/index.d.ts +67 -3
- package/dist/zero/index.js +2 -4
- package/dist/zero/next.d.ts +12 -0
- package/dist/zero/next.js +5 -4
- package/dist/zero/next.js.map +1 -1
- package/docs/README.md +4 -4
- package/docs/adoption.md +5 -3
- package/docs/comparison.md +24 -25
- package/docs/configuration.md +69 -1
- package/docs/debug.md +11 -9
- package/docs/design-system.md +22 -10
- package/docs/dsl.md +25 -10
- package/docs/getting-started.md +10 -10
- package/docs/injector.md +43 -27
- package/docs/methodology.md +52 -3
- package/docs/{PIPELINE.md → pipeline.md} +204 -50
- package/docs/{runtime.md → react-api.md} +104 -32
- package/docs/ssr.md +139 -81
- package/docs/styles.md +17 -0
- package/docs/tasty-static.md +101 -2
- package/package.json +22 -10
- package/tasty.config.ts +1 -0
- package/dist/_virtual/_rolldown/runtime.js +0 -8
- package/dist/chunks/cacheKey.js +0 -78
- package/dist/chunks/cacheKey.js.map +0 -1
- package/dist/chunks/definitions.d.ts +0 -37
- package/dist/chunks/definitions.js +0 -259
- package/dist/chunks/definitions.js.map +0 -1
- package/dist/chunks/renderChunk.js +0 -60
- package/dist/chunks/renderChunk.js.map +0 -1
- package/dist/config.d.ts +0 -366
- package/dist/config.js +0 -504
- package/dist/config.js.map +0 -1
- package/dist/counter-style/index.js +0 -51
- package/dist/counter-style/index.js.map +0 -1
- package/dist/debug.d.ts +0 -89
- package/dist/debug.js +0 -454
- package/dist/debug.js.map +0 -1
- package/dist/font-face/index.js +0 -63
- package/dist/font-face/index.js.map +0 -1
- package/dist/hooks/resolve-ssr-collector.js +0 -15
- package/dist/hooks/resolve-ssr-collector.js.map +0 -1
- package/dist/hooks/useCounterStyle.d.ts +0 -50
- package/dist/hooks/useCounterStyle.js +0 -47
- package/dist/hooks/useCounterStyle.js.map +0 -1
- package/dist/hooks/useFontFace.d.ts +0 -43
- package/dist/hooks/useFontFace.js +0 -71
- package/dist/hooks/useFontFace.js.map +0 -1
- package/dist/hooks/useGlobalStyles.d.ts +0 -30
- package/dist/hooks/useGlobalStyles.js +0 -79
- package/dist/hooks/useGlobalStyles.js.map +0 -1
- package/dist/hooks/useKeyframes.d.ts +0 -56
- package/dist/hooks/useKeyframes.js +0 -65
- package/dist/hooks/useKeyframes.js.map +0 -1
- package/dist/hooks/useProperty.d.ts +0 -79
- package/dist/hooks/useProperty.js +0 -110
- package/dist/hooks/useProperty.js.map +0 -1
- package/dist/hooks/useRawCSS.d.ts +0 -53
- package/dist/hooks/useRawCSS.js +0 -36
- package/dist/hooks/useRawCSS.js.map +0 -1
- package/dist/hooks/useStyles.d.ts +0 -45
- package/dist/hooks/useStyles.js +0 -238
- package/dist/hooks/useStyles.js.map +0 -1
- package/dist/injector/index.d.ts +0 -183
- package/dist/injector/index.js +0 -180
- package/dist/injector/index.js.map +0 -1
- package/dist/injector/injector.d.ts +0 -166
- package/dist/injector/injector.js +0 -465
- package/dist/injector/injector.js.map +0 -1
- package/dist/injector/sheet-manager.d.ts +0 -136
- package/dist/injector/sheet-manager.js +0 -734
- package/dist/injector/sheet-manager.js.map +0 -1
- package/dist/injector/types.d.ts +0 -204
- package/dist/keyframes/index.js +0 -206
- package/dist/keyframes/index.js.map +0 -1
- package/dist/parser/classify.js +0 -320
- package/dist/parser/classify.js.map +0 -1
- package/dist/parser/const.js +0 -49
- package/dist/parser/const.js.map +0 -1
- package/dist/parser/lru.js +0 -109
- package/dist/parser/lru.js.map +0 -1
- package/dist/parser/parser.d.ts +0 -25
- package/dist/parser/parser.js +0 -116
- package/dist/parser/parser.js.map +0 -1
- package/dist/parser/tokenizer.js +0 -69
- package/dist/parser/tokenizer.js.map +0 -1
- package/dist/parser/types.d.ts +0 -51
- package/dist/parser/types.js +0 -46
- package/dist/parser/types.js.map +0 -1
- package/dist/pipeline/conditions.d.ts +0 -134
- package/dist/pipeline/conditions.js +0 -406
- package/dist/pipeline/conditions.js.map +0 -1
- package/dist/pipeline/exclusive.js +0 -231
- package/dist/pipeline/exclusive.js.map +0 -1
- package/dist/pipeline/index.d.ts +0 -55
- package/dist/pipeline/index.js +0 -709
- package/dist/pipeline/index.js.map +0 -1
- package/dist/pipeline/materialize.js +0 -1104
- package/dist/pipeline/materialize.js.map +0 -1
- package/dist/pipeline/parseStateKey.d.ts +0 -15
- package/dist/pipeline/parseStateKey.js +0 -447
- package/dist/pipeline/parseStateKey.js.map +0 -1
- package/dist/pipeline/simplify.js +0 -516
- package/dist/pipeline/simplify.js.map +0 -1
- package/dist/pipeline/warnings.js +0 -18
- package/dist/pipeline/warnings.js.map +0 -1
- package/dist/plugins/okhsl-plugin.d.ts +0 -35
- package/dist/plugins/okhsl-plugin.js +0 -98
- package/dist/plugins/okhsl-plugin.js.map +0 -1
- package/dist/plugins/types.d.ts +0 -76
- package/dist/properties/index.js +0 -223
- package/dist/properties/index.js.map +0 -1
- package/dist/properties/property-type-resolver.d.ts +0 -24
- package/dist/properties/property-type-resolver.js +0 -91
- package/dist/properties/property-type-resolver.js.map +0 -1
- package/dist/ssr/async-storage.d.ts +0 -17
- package/dist/ssr/async-storage.js.map +0 -1
- package/dist/ssr/collect-auto-properties.js +0 -40
- package/dist/ssr/collect-auto-properties.js.map +0 -1
- package/dist/ssr/collector.js.map +0 -1
- package/dist/ssr/context.d.ts +0 -8
- package/dist/ssr/context.js +0 -14
- package/dist/ssr/context.js.map +0 -1
- package/dist/ssr/format-global-rules.js.map +0 -1
- package/dist/ssr/format-keyframes.js +0 -70
- package/dist/ssr/format-keyframes.js.map +0 -1
- package/dist/ssr/format-property.js +0 -50
- package/dist/ssr/format-property.js.map +0 -1
- package/dist/ssr/format-rules.js +0 -73
- package/dist/ssr/format-rules.js.map +0 -1
- package/dist/ssr/hydrate.d.ts +0 -22
- package/dist/ssr/hydrate.js +0 -50
- package/dist/ssr/hydrate.js.map +0 -1
- package/dist/ssr/ssr-collector-ref.js +0 -12
- package/dist/ssr/ssr-collector-ref.js.map +0 -1
- package/dist/states/index.d.ts +0 -49
- package/dist/states/index.js +0 -171
- package/dist/states/index.js.map +0 -1
- package/dist/static/tastyStatic.d.ts +0 -46
- package/dist/static/tastyStatic.js +0 -31
- package/dist/static/tastyStatic.js.map +0 -1
- package/dist/static/types.d.ts +0 -49
- package/dist/static/types.js +0 -24
- package/dist/static/types.js.map +0 -1
- package/dist/styles/align.d.ts +0 -15
- package/dist/styles/align.js +0 -14
- package/dist/styles/align.js.map +0 -1
- package/dist/styles/border.d.ts +0 -25
- package/dist/styles/border.js +0 -114
- package/dist/styles/border.js.map +0 -1
- package/dist/styles/color.d.ts +0 -14
- package/dist/styles/color.js +0 -27
- package/dist/styles/color.js.map +0 -1
- package/dist/styles/createStyle.js +0 -80
- package/dist/styles/createStyle.js.map +0 -1
- package/dist/styles/dimension.js +0 -97
- package/dist/styles/dimension.js.map +0 -1
- package/dist/styles/display.d.ts +0 -37
- package/dist/styles/display.js +0 -67
- package/dist/styles/display.js.map +0 -1
- package/dist/styles/fade.d.ts +0 -15
- package/dist/styles/fade.js +0 -58
- package/dist/styles/fade.js.map +0 -1
- package/dist/styles/fill.d.ts +0 -42
- package/dist/styles/fill.js +0 -52
- package/dist/styles/fill.js.map +0 -1
- package/dist/styles/flow.d.ts +0 -16
- package/dist/styles/flow.js +0 -12
- package/dist/styles/flow.js.map +0 -1
- package/dist/styles/gap.d.ts +0 -31
- package/dist/styles/gap.js +0 -37
- package/dist/styles/gap.js.map +0 -1
- package/dist/styles/height.d.ts +0 -17
- package/dist/styles/height.js +0 -20
- package/dist/styles/height.js.map +0 -1
- package/dist/styles/index.d.ts +0 -2
- package/dist/styles/index.js +0 -9
- package/dist/styles/index.js.map +0 -1
- package/dist/styles/inset.d.ts +0 -52
- package/dist/styles/inset.js +0 -150
- package/dist/styles/inset.js.map +0 -1
- package/dist/styles/justify.d.ts +0 -15
- package/dist/styles/justify.js +0 -14
- package/dist/styles/justify.js.map +0 -1
- package/dist/styles/list.d.ts +0 -16
- package/dist/styles/list.js +0 -98
- package/dist/styles/list.js.map +0 -1
- package/dist/styles/margin.d.ts +0 -24
- package/dist/styles/margin.js +0 -104
- package/dist/styles/margin.js.map +0 -1
- package/dist/styles/outline.d.ts +0 -29
- package/dist/styles/outline.js +0 -65
- package/dist/styles/outline.js.map +0 -1
- package/dist/styles/padding.d.ts +0 -24
- package/dist/styles/padding.js +0 -104
- package/dist/styles/padding.js.map +0 -1
- package/dist/styles/predefined.d.ts +0 -71
- package/dist/styles/predefined.js +0 -238
- package/dist/styles/predefined.js.map +0 -1
- package/dist/styles/preset.d.ts +0 -52
- package/dist/styles/preset.js +0 -127
- package/dist/styles/preset.js.map +0 -1
- package/dist/styles/radius.d.ts +0 -14
- package/dist/styles/radius.js +0 -51
- package/dist/styles/radius.js.map +0 -1
- package/dist/styles/scrollbar.d.ts +0 -25
- package/dist/styles/scrollbar.js +0 -48
- package/dist/styles/scrollbar.js.map +0 -1
- package/dist/styles/shadow.d.ts +0 -14
- package/dist/styles/shadow.js +0 -24
- package/dist/styles/shadow.js.map +0 -1
- package/dist/styles/transition.d.ts +0 -14
- package/dist/styles/transition.js +0 -158
- package/dist/styles/transition.js.map +0 -1
- package/dist/styles/types.d.ts +0 -547
- package/dist/styles/width.d.ts +0 -17
- package/dist/styles/width.js +0 -20
- package/dist/styles/width.js.map +0 -1
- package/dist/tasty.d.ts +0 -119
- package/dist/tasty.js +0 -232
- package/dist/tasty.js.map +0 -1
- package/dist/types.d.ts +0 -184
- package/dist/utils/cache-wrapper.js +0 -22
- package/dist/utils/cache-wrapper.js.map +0 -1
- package/dist/utils/case-converter.js +0 -8
- package/dist/utils/case-converter.js.map +0 -1
- package/dist/utils/color-math.d.ts +0 -46
- package/dist/utils/color-math.js +0 -749
- package/dist/utils/color-math.js.map +0 -1
- package/dist/utils/color-space.d.ts +0 -5
- package/dist/utils/color-space.js +0 -229
- package/dist/utils/color-space.js.map +0 -1
- package/dist/utils/colors.d.ts +0 -5
- package/dist/utils/colors.js +0 -11
- package/dist/utils/colors.js.map +0 -1
- package/dist/utils/css-types.d.ts +0 -7
- package/dist/utils/dotize.d.ts +0 -26
- package/dist/utils/dotize.js +0 -122
- package/dist/utils/dotize.js.map +0 -1
- package/dist/utils/filter-base-props.d.ts +0 -15
- package/dist/utils/filter-base-props.js +0 -45
- package/dist/utils/filter-base-props.js.map +0 -1
- package/dist/utils/get-display-name.d.ts +0 -7
- package/dist/utils/get-display-name.js +0 -10
- package/dist/utils/get-display-name.js.map +0 -1
- package/dist/utils/has-keys.js +0 -13
- package/dist/utils/has-keys.js.map +0 -1
- package/dist/utils/is-dev-env.js +0 -19
- package/dist/utils/is-dev-env.js.map +0 -1
- package/dist/utils/is-valid-element-type.js +0 -15
- package/dist/utils/is-valid-element-type.js.map +0 -1
- package/dist/utils/merge-styles.js.map +0 -1
- package/dist/utils/mod-attrs.d.ts +0 -8
- package/dist/utils/mod-attrs.js +0 -21
- package/dist/utils/mod-attrs.js.map +0 -1
- package/dist/utils/process-tokens.d.ts +0 -21
- package/dist/utils/process-tokens.js +0 -91
- package/dist/utils/process-tokens.js.map +0 -1
- package/dist/utils/resolve-recipes.d.ts +0 -17
- package/dist/utils/resolve-recipes.js.map +0 -1
- package/dist/utils/selector-transform.js +0 -32
- package/dist/utils/selector-transform.js.map +0 -1
- package/dist/utils/string.js +0 -8
- package/dist/utils/string.js.map +0 -1
- package/dist/utils/styles.d.ts +0 -99
- package/dist/utils/styles.js +0 -221
- package/dist/utils/styles.js.map +0 -1
- package/dist/utils/typography.d.ts +0 -47
- package/dist/utils/typography.js +0 -51
- package/dist/utils/typography.js.map +0 -1
- package/dist/utils/warnings.d.ts +0 -16
- package/dist/utils/warnings.js +0 -16
- package/dist/utils/warnings.js.map +0 -1
- package/dist/zero/css-writer.d.ts +0 -45
- package/dist/zero/css-writer.js +0 -74
- package/dist/zero/css-writer.js.map +0 -1
- package/dist/zero/extractor.d.ts +0 -24
- 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
|
-
- **
|
|
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/
|
|
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 [
|
|
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` |
|
|
200
|
-
| **
|
|
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
|
-
|
|
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/
|
|
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 [
|
|
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 [
|
|
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 [
|
|
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 [
|
|
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
|
-
###
|
|
434
|
+
### Style Functions
|
|
431
435
|
|
|
432
|
-
When you do not need a full component wrapper, use the
|
|
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 [
|
|
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
|
|
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), [
|
|
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
|
-
|
|
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
|
-
|
|
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`,
|
|
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
|
|
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) |
|
|
487
|
-
| `@tenphi/tasty/core` (runtime, no SSR) |
|
|
488
|
-
| `@tenphi/tasty/static` (zero-runtime) |
|
|
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`
|
|
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
|
-
- **[
|
|
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/
|
|
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
|
|
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
|
|
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
|
-
|
|
30
|
-
|
|
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 {
|
|
35
|
-
|
|
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 "
|
|
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
|
-
*
|
|
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
|
-
|
|
94
|
+
getRenderedClassNames(): string[];
|
|
99
95
|
}
|
|
100
96
|
//#endregion
|
|
101
|
-
export {
|
|
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,
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
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
|
-
*
|
|
16
|
-
* and
|
|
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(
|
|
22
|
-
return `t${
|
|
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(
|
|
50
|
+
for (const [token, definition] of Object.entries(getEffectiveProperties())) {
|
|
53
51
|
const css = formatPropertyCSS(token, definition);
|
|
54
|
-
if (css) this.collectProperty(`
|
|
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(
|
|
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
|
-
*
|
|
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
|
-
|
|
216
|
-
const
|
|
217
|
-
for (const
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
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
|
-
|
|
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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"}
|