@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.
@@ -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
- Default timing: `$transition` (or `${name}-transition` with `$transition` fallback per semantic name).
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 0.3s"
573
- transition="fill 0.2s, radius 0.3s"
574
- transition="fade 0.15s ease-in"
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 0.3s" // custom property transition
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`
@@ -489,7 +489,7 @@ const button = tastyStatic({
489
489
  radius: '1r',
490
490
  fill: '#gray.20',
491
491
  color: '#text',
492
- transition: 'fill 0.15s',
492
+ transition: 'fill',
493
493
  });
494
494
 
495
495
  // Variants
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tenphi/cookbook",
3
- "version": "0.21.1",
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.1",
72
- "@tenphi/renderer": "0.21.1"
71
+ "@tenphi/docs": "0.21.4",
72
+ "@tenphi/renderer": "0.21.4"
73
73
  },
74
74
  "peerDependencies": {
75
75
  "astro": "^7.3.2"