@tenphi/cookbook 0.21.1 → 0.21.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/styling.d.ts +2 -2
- package/dist/styling.js +2 -2
- package/docs/architecture.md +47 -2
- package/docs/component-styles.md +96 -33
- package/docs/configuration.md +30 -9
- package/docs/custom-components.md +47 -3
- package/docs/fonts-and-typography.md +21 -3
- package/docs/migration.md +7 -1
- package/docs/upstream/manifest.json +2 -2
- package/docs/upstream/tasty/README.md +6 -6
- package/docs/upstream/tasty/docs/ai-agents.md +21 -2
- package/docs/upstream/tasty/docs/debug.md +2 -5
- package/docs/upstream/tasty/docs/dsl.md +32 -8
- package/docs/upstream/tasty/docs/getting-started.md +13 -11
- package/docs/upstream/tasty/docs/methodology.md +2 -2
- package/docs/upstream/tasty/docs/pipeline.md +33 -9
- package/docs/upstream/tasty/docs/plugins.md +1 -1
- package/docs/upstream/tasty/docs/runtime-benchmarks.md +107 -70
- package/docs/upstream/tasty/docs/ssr.md +1 -1
- package/docs/upstream/tasty/docs/styles.md +43 -5
- package/docs/upstream/tasty/docs/tasty-static.md +1 -1
- package/package.json +3 -3
|
@@ -37,6 +37,24 @@ Use these instead of their raw CSS counterparts:
|
|
|
37
37
|
|
|
38
38
|
## Layout
|
|
39
39
|
|
|
40
|
+
### `overscrollBehavior`
|
|
41
|
+
|
|
42
|
+
The native `overscrollBehavior` shorthand and its `overscrollBehaviorBlock`,
|
|
43
|
+
`overscrollBehaviorInline`, `overscrollBehaviorX`, and `overscrollBehaviorY`
|
|
44
|
+
longhands support `auto`, `contain`, `none`, and `chain`. The shorthand can set
|
|
45
|
+
separate X and Y values, for example `overscrollBehavior: 'chain contain'`.
|
|
46
|
+
|
|
47
|
+
`chain` allows scroll chaining to another scrollable area while suppressing
|
|
48
|
+
boundary effects such as bounce. It requires browser support; use a feature
|
|
49
|
+
query and a fallback floor when targeting browsers without it:
|
|
50
|
+
|
|
51
|
+
```jsx
|
|
52
|
+
overscrollBehaviorBlock: {
|
|
53
|
+
_: 'auto',
|
|
54
|
+
'@supports(overscroll-behavior-block: chain)': 'chain',
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
40
58
|
### `display`
|
|
41
59
|
|
|
42
60
|
Standard CSS display values. Handled together with `hide`, `textOverflow`, `overflow`, and `whiteSpace` for priority resolution.
|
|
@@ -566,15 +584,17 @@ When easing is provided without a duration, the default timing variable is used
|
|
|
566
584
|
| `zIndex` | `z-index` |
|
|
567
585
|
| `inset` | `inset`, `top`, `right`, `bottom`, `left` |
|
|
568
586
|
|
|
569
|
-
|
|
587
|
+
When two entries cover the same property, an entry that names that one property wins over a group such as `theme`, in either order: `opacity 120ms ease-in-out, theme` keeps the opacity timing. Otherwise the later entry wins, as in CSS.
|
|
588
|
+
|
|
589
|
+
Default timing: `$transition` (or `${name}-transition` with `$transition` fallback per semantic name). Prefer omitting the duration or using a duration token instead of repeating raw time values across components. Explicit zero can disable motion.
|
|
570
590
|
|
|
571
591
|
```jsx
|
|
572
|
-
transition="theme
|
|
573
|
-
transition="fill
|
|
574
|
-
transition="fade
|
|
592
|
+
transition="theme"
|
|
593
|
+
transition="fill, radius"
|
|
594
|
+
transition="fade $transition ease-in"
|
|
575
595
|
transition="fill ease-in" // easing without duration (uses default timing)
|
|
576
596
|
transition="radius ease-in-out" // easing keyword only
|
|
577
|
-
transition="$$custom-prop
|
|
597
|
+
transition="$$custom-prop" // custom property transition
|
|
578
598
|
```
|
|
579
599
|
|
|
580
600
|
**Recognized easing keywords:** `ease`, `ease-in`, `ease-out`, `ease-in-out`, `linear`, `step-start`, `step-end`. CSS easing functions (`cubic-bezier(...)`, `steps(...)`, `linear(...)`) are also recognized.
|
|
@@ -583,6 +603,24 @@ If the name is not a semantic name, it is used as a literal CSS property name.
|
|
|
583
603
|
|
|
584
604
|
---
|
|
585
605
|
|
|
606
|
+
### `animation`
|
|
607
|
+
|
|
608
|
+
`animation` is the native CSS shorthand. Tasty parses tokens in its value and
|
|
609
|
+
tracks local `@keyframes` names referenced by it, so it needs no custom style
|
|
610
|
+
handler. Define a complete animation with the shorthand, using a configured
|
|
611
|
+
duration token where appropriate (for example,
|
|
612
|
+
`animation: 'pulse $animation-duration ease-in infinite'`).
|
|
613
|
+
|
|
614
|
+
Use `animationDuration`, `animationTimeline`, `animationRange`, and other CSS
|
|
615
|
+
longhands when changing just one part of an existing animation in a state or
|
|
616
|
+
component extension. Setting `animation` resets omitted parts, including its
|
|
617
|
+
timeline and range. The same principle applies to `transitionDuration` and
|
|
618
|
+
other transition longhands when a base `transition` is already defined.
|
|
619
|
+
`transitionBehavior` remains a separate CSS longhand; Tasty's semantic
|
|
620
|
+
`transition` syntax covers name, timing, easing, and delay.
|
|
621
|
+
|
|
622
|
+
---
|
|
623
|
+
|
|
586
624
|
## Scrollbar & Overflow
|
|
587
625
|
|
|
588
626
|
### `scrollbar`
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tenphi/cookbook",
|
|
3
|
-
"version": "0.21.
|
|
3
|
+
"version": "0.21.4",
|
|
4
4
|
"description": "Repository-native static documentation for Astro",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
@@ -68,8 +68,8 @@
|
|
|
68
68
|
"author": "Andrey Yamanov",
|
|
69
69
|
"license": "MIT",
|
|
70
70
|
"dependencies": {
|
|
71
|
-
"@tenphi/docs": "0.21.
|
|
72
|
-
"@tenphi/renderer": "0.21.
|
|
71
|
+
"@tenphi/docs": "0.21.4",
|
|
72
|
+
"@tenphi/renderer": "0.21.4"
|
|
73
73
|
},
|
|
74
74
|
"peerDependencies": {
|
|
75
75
|
"astro": "^7.3.2"
|