@hjmds/design-contracts 1.31.0 → 1.32.1

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 (59) hide show
  1. package/dist/behaviors.d.ts +2 -0
  2. package/dist/behaviors.d.ts.map +1 -1
  3. package/dist/bottom-navigation.d.ts +19 -0
  4. package/dist/bottom-navigation.d.ts.map +1 -1
  5. package/dist/bottom-navigation.js +21 -0
  6. package/dist/bottom-navigation.js.map +1 -1
  7. package/dist/catalog.d.ts +37 -0
  8. package/dist/catalog.d.ts.map +1 -1
  9. package/dist/catalog.js +2 -1
  10. package/dist/catalog.js.map +1 -1
  11. package/dist/component-recipes.d.ts +39 -0
  12. package/dist/component-recipes.d.ts.map +1 -1
  13. package/dist/component-recipes.js +27 -1
  14. package/dist/component-recipes.js.map +1 -1
  15. package/dist/image-choice.d.ts +40 -0
  16. package/dist/image-choice.d.ts.map +1 -1
  17. package/dist/image-choice.js +49 -0
  18. package/dist/image-choice.js.map +1 -1
  19. package/dist/pagination.d.ts +53 -0
  20. package/dist/pagination.d.ts.map +1 -1
  21. package/dist/pagination.js +48 -0
  22. package/dist/pagination.js.map +1 -1
  23. package/dist/screen-patterns.d.ts +52 -2
  24. package/dist/screen-patterns.d.ts.map +1 -1
  25. package/dist/screen-patterns.js +34 -1
  26. package/dist/screen-patterns.js.map +1 -1
  27. package/dist/version.d.ts +1 -1
  28. package/dist/version.js +1 -1
  29. package/dist/version.js.map +1 -1
  30. package/docs/authoring-tools.md +1 -0
  31. package/docs/bottom-navigation.md +18 -0
  32. package/docs/data-workflows.md +1 -0
  33. package/docs/generated/component-maturity.md +1 -1
  34. package/docs/generated/renderer-evidence.json +7 -5
  35. package/docs/generated/renderer-evidence.md +1 -1
  36. package/docs/generated/showcase-manifest.json +4 -2
  37. package/docs/pagination.md +17 -0
  38. package/docs/screen-patterns.md +37 -1
  39. package/docs/toast.md +10 -0
  40. package/docs/usage/README.md +6 -6
  41. package/docs/usage/components/bottom-cta.md +11 -0
  42. package/docs/usage/components/bottom-navigation.md +36 -2
  43. package/docs/usage/components/chat-date-separator.md +3 -3
  44. package/docs/usage/components/chat-message.md +5 -2
  45. package/docs/usage/components/chat-screen.md +1 -1
  46. package/docs/usage/components/comment-thread-row.md +1 -1
  47. package/docs/usage/components/conversation-row.md +3 -3
  48. package/docs/usage/components/icon-tile.md +9 -2
  49. package/docs/usage/components/image-choice-group.md +33 -4
  50. package/docs/usage/components/media-selection-screen.md +5 -3
  51. package/docs/usage/components/moderation-screen.md +20 -1
  52. package/docs/usage/components/page-indicator.md +3 -3
  53. package/docs/usage/components/pagination.md +28 -4
  54. package/docs/usage/components/screen-layout.md +6 -3
  55. package/docs/usage/components/search-screen.md +5 -3
  56. package/docs/usage/components/toast.md +5 -0
  57. package/docs/usage/components/typing-indicator.md +3 -3
  58. package/docs/usage/screens/common-conversation-list.md +2 -2
  59. package/package.json +1 -1
@@ -970,6 +970,18 @@ export const bottomNavigationRecipe = {
970
970
  large: control.minTouchTarget,
971
971
  xlarge: control.buttonHeight.large,
972
972
  },
973
+ /**
974
+ * Floating frames for `configuration.shape` (Utilverse home shells, 2026-10-18). `surfacePadding` is the inner
975
+ * gap between the frame and the destination row; the two tighter frames pair with `density: "compact"` for the
976
+ * desktop-shell docks. Radii are theme radius tokens, so a design profile's radius scale still applies.
977
+ * `standard` is absent on purpose: it keeps `presentations.floating`.
978
+ */
979
+ shapes: {
980
+ rounded: { radius: "xl", surfacePadding: spacing.xs },
981
+ pill: { radius: "full", surfacePadding: spacing.xs },
982
+ compact: { radius: "lg", surfacePadding: spacing.xxs },
983
+ square: { radius: "sm", surfacePadding: spacing.xxs },
984
+ },
973
985
  adaptive: {
974
986
  web: "fixed-compact-viewport",
975
987
  native: "navigator-tab-bar",
@@ -1069,6 +1081,15 @@ export const bottomNavigationRecipe = {
1069
1081
  strokeWidth: { idle: stroke.strong, selected: 3 },
1070
1082
  scale: { idle: 1, selected: 1.06 },
1071
1083
  },
1084
+ /**
1085
+ * `configuration.iconEmphasis: "lift"` (Utilverse dock artwork, 2026-10-18): the selected icon rises one 4pt
1086
+ * step on top of the selected scale, and idle icons dim. Full-color artwork cannot take the selected tint, so
1087
+ * without the dim only the label would mark the current destination. 0.82 is the dock's measured idle opacity.
1088
+ */
1089
+ liftEmphasis: {
1090
+ translateY: -spacing.xxs,
1091
+ idleOpacity: 0.82,
1092
+ },
1072
1093
  },
1073
1094
  label: {
1074
1095
  fontWeight: fontWeight.medium,
@@ -1657,7 +1678,12 @@ export const toastRecipe = {
1657
1678
  // the first line instead of centring on the whole block. Product media (44) start-aligns to the same top and
1658
1679
  // is not the anchor: centring the title on the media pushed the description below the avatar.
1659
1680
  anchor: { blockSize: toastBadgeDiameter },
1660
- // Retired in 1.10.0 (width 0): the icon badge carries tone. Kept so the slot contract stays additive.
1681
+ /**
1682
+ * @deprecated Toast has no edge stripe: the tinted icon badge (or product media) carries tone. Retired in 1.10.0
1683
+ * (width 0); since 1.32.0 neither renderer draws an element for it, so there is nothing for a product to hide
1684
+ * (2026-10-18 BurnTok still hid a strip that no longer existed). Kept only so the published recipe shape stays
1685
+ * compatible; remove in the next major.
1686
+ */
1661
1687
  toneMark: { width: 0, radius: "full" },
1662
1688
  icon: { glyph: "sm", badgeDiameter: toastBadgeDiameter, badgeRadius: "full" },
1663
1689
  // A product media (mascot, avatar) replaces the tone badge in the same leading column. 44 keeps a