stream-chat-react-native-core 9.12.1 → 9.14.0

package/src/a2ui/components/iconPaths.ts

@@ -0,0 +1,116 @@
+/*
+ * The paths of Material Icons (Round), from Google's material-design-icons
+ * (https://github.com/google/material-design-icons), licensed under the Apache License, Version 2.0:
+ * https://www.apache.org/licenses/LICENSE-2.0
+ */
+
+// Copied from @material-design-icons/svg 0.14.15 (round): one 24 × 24 path for each icon name of
+// the A2UI basic catalog, as Material names them (`photo_camera` for `camera`, `credit_card` for
+// `payment`, …).
+export const A2UI_ICON_PATHS: Record<string, string> = {
+  accountCircle:
+    'M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 4c1.93 0 3.5 1.57 3.5 3.5S13.93 13 12 13s-3.5-1.57-3.5-3.5S10.07 6 12 6zm0 14c-2.03 0-4.43-.82-6.14-2.88a9.947 9.947 0 0 1 12.28 0C16.43 19.18 14.03 20 12 20z',
+  add: 'M18 13h-5v5c0 .55-.45 1-1 1s-1-.45-1-1v-5H6c-.55 0-1-.45-1-1s.45-1 1-1h5V6c0-.55.45-1 1-1s1 .45 1 1v5h5c.55 0 1 .45 1 1s-.45 1-1 1z',
+  arrowBack:
+    'M19 11H7.83l4.88-4.88c.39-.39.39-1.03 0-1.42a.996.996 0 0 0-1.41 0l-6.59 6.59a.996.996 0 0 0 0 1.41l6.59 6.59a.996.996 0 1 0 1.41-1.41L7.83 13H19c.55 0 1-.45 1-1s-.45-1-1-1z',
+  arrowForward:
+    'M5 13h11.17l-4.88 4.88c-.39.39-.39 1.03 0 1.42.39.39 1.02.39 1.41 0l6.59-6.59a.996.996 0 0 0 0-1.41l-6.58-6.6a.996.996 0 1 0-1.41 1.41L16.17 11H5c-.55 0-1 .45-1 1s.45 1 1 1z',
+  attachFile:
+    'M16.5 6.75v10.58c0 2.09-1.53 3.95-3.61 4.15A3.993 3.993 0 0 1 8.5 17.5V5.14c0-1.31.94-2.5 2.24-2.63A2.5 2.5 0 0 1 13.5 5v10.5c0 .55-.45 1-1 1s-1-.45-1-1V6.75c0-.41-.34-.75-.75-.75s-.75.34-.75.75v8.61c0 1.31.94 2.5 2.24 2.63A2.5 2.5 0 0 0 15 15.5V5.17c0-2.09-1.53-3.95-3.61-4.15A3.998 3.998 0 0 0 7 5v12.27c0 2.87 2.1 5.44 4.96 5.71 3.29.3 6.04-2.26 6.04-5.48V6.75c0-.41-.34-.75-.75-.75s-.75.34-.75.75z',
+  calendarToday:
+    'M20 3h-1V2c0-.55-.45-1-1-1s-1 .45-1 1v1H7V2c0-.55-.45-1-1-1s-1 .45-1 1v1H4c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-1 18H5c-.55 0-1-.45-1-1V8h16v12c0 .55-.45 1-1 1z',
+  call: 'm19.23 15.26-2.54-.29a1.99 1.99 0 0 0-1.64.57l-1.84 1.84a15.045 15.045 0 0 1-6.59-6.59l1.85-1.85c.43-.43.64-1.03.57-1.64l-.29-2.52a2.001 2.001 0 0 0-1.99-1.77H5.03c-1.13 0-2.07.94-2 2.07.53 8.54 7.36 15.36 15.89 15.89 1.13.07 2.07-.87 2.07-2v-1.73c.01-1.01-.75-1.86-1.76-1.98z',
+  camera:
+    'M20 4h-3.17l-1.24-1.35A1.99 1.99 0 0 0 14.12 2H9.88c-.56 0-1.1.24-1.48.65L7.17 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2zm-8 13c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5z',
+  check:
+    'M9 16.17 5.53 12.7a.996.996 0 1 0-1.41 1.41l4.18 4.18c.39.39 1.02.39 1.41 0L20.29 7.71a.996.996 0 1 0-1.41-1.41L9 16.17z',
+  close:
+    'M18.3 5.71a.996.996 0 0 0-1.41 0L12 10.59 7.11 5.7A.996.996 0 1 0 5.7 7.11L10.59 12 5.7 16.89a.996.996 0 1 0 1.41 1.41L12 13.41l4.89 4.89a.996.996 0 1 0 1.41-1.41L13.41 12l4.89-4.89c.38-.38.38-1.02 0-1.4z',
+  delete:
+    'M6 19c0 1.1.9 2 2 2h8c1.1 0 2-.9 2-2V9c0-1.1-.9-2-2-2H8c-1.1 0-2 .9-2 2v10zM18 4h-2.5l-.71-.71c-.18-.18-.44-.29-.7-.29H9.91c-.26 0-.52.11-.7.29L8.5 4H6c-.55 0-1 .45-1 1s.45 1 1 1h12c.55 0 1-.45 1-1s-.45-1-1-1z',
+  download:
+    'M16.59 9H15V4c0-.55-.45-1-1-1h-4c-.55 0-1 .45-1 1v5H7.41c-.89 0-1.34 1.08-.71 1.71l4.59 4.59c.39.39 1.02.39 1.41 0l4.59-4.59c.63-.63.19-1.71-.7-1.71zM5 19c0 .55.45 1 1 1h12c.55 0 1-.45 1-1s-.45-1-1-1H6c-.55 0-1 .45-1 1z',
+  edit: 'M3 17.46v3.04c0 .28.22.5.5.5h3.04c.13 0 .26-.05.35-.15L17.81 9.94l-3.75-3.75L3.15 17.1c-.1.1-.15.22-.15.36zM20.71 7.04a.996.996 0 0 0 0-1.41l-2.34-2.34a.996.996 0 0 0-1.41 0l-1.83 1.83 3.75 3.75 1.83-1.83z',
+  event:
+    'M16 10.53a.754.754 0 0 0-1.06 0l-4.35 4.35L9 13.29a.754.754 0 0 0-1.06 0c-.29.29-.29.77 0 1.06l1.94 1.94c.39.39 1.02.39 1.41 0l4.7-4.7c.3-.29.3-.77.01-1.06zM19 3h-1V2c0-.55-.45-1-1-1s-1 .45-1 1v1H8V2c0-.55-.45-1-1-1s-1 .45-1 1v1H5c-1.11 0-1.99.9-1.99 2L3 19a2 2 0 0 0 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-1 16H6c-.55 0-1-.45-1-1V8h14v10c0 .55-.45 1-1 1z',
+  error:
+    'M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 11c-.55 0-1-.45-1-1V8c0-.55.45-1 1-1s1 .45 1 1v4c0 .55-.45 1-1 1zm1 4h-2v-2h2v2z',
+  fastForward:
+    'm5.58 16.89 5.77-4.07c.56-.4.56-1.24 0-1.63L5.58 7.11C4.91 6.65 4 7.12 4 7.93v8.14c0 .81.91 1.28 1.58.82zM13 7.93v8.14c0 .81.91 1.28 1.58.82l5.77-4.07c.56-.4.56-1.24 0-1.63l-5.77-4.07c-.67-.47-1.58 0-1.58.81z',
+  favorite:
+    'M13.35 20.13c-.76.69-1.93.69-2.69-.01l-.11-.1C5.3 15.27 1.87 12.16 2 8.28c.06-1.7.93-3.33 2.34-4.29 2.64-1.8 5.9-.96 7.66 1.1 1.76-2.06 5.02-2.91 7.66-1.1 1.41.96 2.28 2.59 2.34 4.29.14 3.88-3.3 6.99-8.55 11.76l-.1.09z',
+  favoriteOff:
+    'M19.66 3.99c-2.64-1.8-5.9-.96-7.66 1.1-1.76-2.06-5.02-2.91-7.66-1.1-1.4.96-2.28 2.58-2.34 4.29-.14 3.88 3.3 6.99 8.55 11.76l.1.09c.76.69 1.93.69 2.69-.01l.11-.1c5.25-4.76 8.68-7.87 8.55-11.75-.06-1.7-.94-3.32-2.34-4.28zM12.1 18.55l-.1.1-.1-.1C7.14 14.24 4 11.39 4 8.5 4 6.5 5.5 5 7.5 5c1.54 0 3.04.99 3.57 2.36h1.87C13.46 5.99 14.96 5 16.5 5c2 0 3.5 1.5 3.5 3.5 0 2.89-3.14 5.74-7.9 10.05z',
+  folder:
+    'M10.59 4.59C10.21 4.21 9.7 4 9.17 4H4c-1.1 0-1.99.9-1.99 2L2 18c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2h-8l-1.41-1.41z',
+  help: 'M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm1 17h-2v-2h2v2zm2.07-7.75-.9.92c-.5.51-.86.97-1.04 1.69-.08.32-.13.68-.13 1.14h-2v-.5a3.997 3.997 0 0 1 1.17-2.83l1.24-1.26c.46-.44.68-1.1.55-1.8a1.99 1.99 0 0 0-1.39-1.53c-1.11-.31-2.14.32-2.47 1.27-.12.37-.43.65-.82.65h-.3C8.4 9 8 8.44 8.16 7.88a4.008 4.008 0 0 1 3.23-2.83c1.52-.24 2.97.55 3.87 1.8 1.18 1.63.83 3.38-.19 4.4z',
+  home: 'M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z',
+  info: 'M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm0 15c-.55 0-1-.45-1-1v-4c0-.55.45-1 1-1s1 .45 1 1v4c0 .55-.45 1-1 1zm1-8h-2V7h2v2z',
+  locationOn:
+    'M12 2c-4.2 0-8 3.22-8 8.2 0 3.18 2.45 6.92 7.34 11.23.38.33.95.33 1.33 0C17.55 17.12 20 13.38 20 10.2 20 5.22 16.2 2 12 2zm0 10c-1.1 0-2-.9-2-2s.9-2 2-2 2 .9 2 2-.9 2-2 2z',
+  lock: 'M18 8h-1V6c0-2.76-2.24-5-5-5S7 3.24 7 6v2H6c-1.1 0-2 .9-2 2v10c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V10c0-1.1-.9-2-2-2zm-6 9c-1.1 0-2-.9-2-2s.9-2 2-2 2 .9 2 2-.9 2-2 2zM9 8V6c0-1.66 1.34-3 3-3s3 1.34 3 3v2H9z',
+  lockOpen:
+    'M12 13c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2zm6-5h-1V6c0-2.76-2.24-5-5-5-2.28 0-4.27 1.54-4.84 3.75-.14.54.18 1.08.72 1.22a1 1 0 0 0 1.22-.72A2.996 2.996 0 0 1 12 3c1.65 0 3 1.35 3 3v2H6c-1.1 0-2 .9-2 2v10c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2V10c0-1.1-.9-2-2-2zm0 11c0 .55-.45 1-1 1H7c-.55 0-1-.45-1-1v-8c0-.55.45-1 1-1h10c.55 0 1 .45 1 1v8z',
+  mail: 'M20 4H4c-1.1 0-1.99.9-1.99 2L2 18c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2zm-.4 4.25-7.07 4.42c-.32.2-.74.2-1.06 0L4.4 8.25a.85.85 0 1 1 .9-1.44L12 11l6.7-4.19a.85.85 0 1 1 .9 1.44z',
+  menu: 'M4 18h16c.55 0 1-.45 1-1s-.45-1-1-1H4c-.55 0-1 .45-1 1s.45 1 1 1zm0-5h16c.55 0 1-.45 1-1s-.45-1-1-1H4c-.55 0-1 .45-1 1s.45 1 1 1zM3 7c0 .55.45 1 1 1h16c.55 0 1-.45 1-1s-.45-1-1-1H4c-.55 0-1 .45-1 1z',
+  moreVert:
+    'M12 8c1.1 0 2-.9 2-2s-.9-2-2-2-2 .9-2 2 .9 2 2 2zm0 2c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2zm0 6c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2z',
+  moreHoriz:
+    'M6 10c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2zm12 0c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2zm-6 0c-1.1 0-2 .9-2 2s.9 2 2 2 2-.9 2-2-.9-2-2-2z',
+  notificationsOff:
+    'M12 22c1.1 0 2-.9 2-2h-4a2 2 0 0 0 2 2zm6-11c0-3.07-1.64-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68c-.24.06-.47.15-.69.23L18 13.1V11zM5.41 3.35 4 4.76l2.81 2.81C6.29 8.57 6 9.73 6 11v5l-1.29 1.29c-.63.63-.19 1.71.7 1.71h12.83l1.74 1.74 1.41-1.41L5.41 3.35z',
+  notifications:
+    'M12 22c1.1 0 2-.9 2-2h-4a2 2 0 0 0 2 2zm6-6v-5c0-3.07-1.64-5.64-4.5-6.32V4c0-.83-.67-1.5-1.5-1.5s-1.5.67-1.5 1.5v.68C7.63 5.36 6 7.92 6 11v5l-1.29 1.29c-.63.63-.19 1.71.7 1.71h13.17c.89 0 1.34-1.08.71-1.71L18 16z',
+  pause:
+    'M8 19c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2s-2 .9-2 2v10c0 1.1.9 2 2 2zm6-12v10c0 1.1.9 2 2 2s2-.9 2-2V7c0-1.1-.9-2-2-2s-2 .9-2 2z',
+  payment:
+    'M20 4H4c-1.11 0-1.99.89-1.99 2L2 18c0 1.11.89 2 2 2h16c1.11 0 2-.89 2-2V6c0-1.11-.89-2-2-2zm-1 14H5c-.55 0-1-.45-1-1v-5h16v5c0 .55-.45 1-1 1zm1-10H4V6h16v2z',
+  person:
+    'M12 12c2.21 0 4-1.79 4-4s-1.79-4-4-4-4 1.79-4 4 1.79 4 4 4zm0 2c-2.67 0-8 1.34-8 4v1c0 .55.45 1 1 1h14c.55 0 1-.45 1-1v-1c0-2.66-5.33-4-8-4z',
+  phone:
+    'm19.23 15.26-2.54-.29a1.99 1.99 0 0 0-1.64.57l-1.84 1.84a15.045 15.045 0 0 1-6.59-6.59l1.85-1.85c.43-.43.64-1.03.57-1.64l-.29-2.52a2.001 2.001 0 0 0-1.99-1.77H5.03c-1.13 0-2.07.94-2 2.07.53 8.54 7.36 15.36 15.89 15.89 1.13.07 2.07-.87 2.07-2v-1.73c.01-1.01-.75-1.86-1.76-1.98z',
+  photo:
+    'M21 19V5c0-1.1-.9-2-2-2H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2zM8.9 13.98l2.1 2.53 3.1-3.99c.2-.26.6-.26.8.01l3.51 4.68a.5.5 0 0 1-.4.8H6.02c-.42 0-.65-.48-.39-.81L8.12 14c.19-.26.57-.27.78-.02z',
+  play: 'M8 6.82v10.36c0 .79.87 1.27 1.54.84l8.14-5.18a1 1 0 0 0 0-1.69L9.54 5.98A.998.998 0 0 0 8 6.82z',
+  print:
+    'M19 8H5c-1.66 0-3 1.34-3 3v4c0 1.1.9 2 2 2h2v2c0 1.1.9 2 2 2h8c1.1 0 2-.9 2-2v-2h2c1.1 0 2-.9 2-2v-4c0-1.66-1.34-3-3-3zm-4 11H9c-.55 0-1-.45-1-1v-4h8v4c0 .55-.45 1-1 1zm4-7c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1zm-2-9H7c-.55 0-1 .45-1 1v2c0 .55.45 1 1 1h10c.55 0 1-.45 1-1V4c0-.55-.45-1-1-1z',
+  refresh:
+    'M17.65 6.35a7.95 7.95 0 0 0-6.48-2.31c-3.67.37-6.69 3.35-7.1 7.02C3.52 15.91 7.27 20 12 20a7.98 7.98 0 0 0 7.21-4.56c.32-.67-.16-1.44-.9-1.44-.37 0-.72.2-.88.53a5.994 5.994 0 0 1-6.8 3.31c-2.22-.49-4.01-2.3-4.48-4.52A6.002 6.002 0 0 1 12 6c1.66 0 3.14.69 4.22 1.78l-1.51 1.51c-.63.63-.19 1.71.7 1.71H19c.55 0 1-.45 1-1V6.41c0-.89-1.08-1.34-1.71-.71l-.64.65z',
+  rewind:
+    'M11 16.07V7.93c0-.81-.91-1.28-1.58-.82l-5.77 4.07c-.56.4-.56 1.24 0 1.63l5.77 4.07c.67.47 1.58 0 1.58-.81zm1.66-3.25 5.77 4.07c.66.47 1.58-.01 1.58-.82V7.93c0-.81-.91-1.28-1.58-.82l-5.77 4.07a1 1 0 0 0 0 1.64z',
+  search:
+    'M15.5 14h-.79l-.28-.27a6.5 6.5 0 0 0 1.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 0 0-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 0 0 5.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z',
+  send: 'm3.4 20.4 17.45-7.48a1 1 0 0 0 0-1.84L3.4 3.6a.993.993 0 0 0-1.39.91L2 9.12c0 .5.37.93.87.99L17 12 2.87 13.88c-.5.07-.87.5-.87 1l.01 4.61c0 .71.73 1.2 1.39.91z',
+  settings:
+    'M19.5 12c0-.23-.01-.45-.03-.68l1.86-1.41c.4-.3.51-.86.26-1.3l-1.87-3.23a.987.987 0 0 0-1.25-.42l-2.15.91c-.37-.26-.76-.49-1.17-.68l-.29-2.31c-.06-.5-.49-.88-.99-.88h-3.73c-.51 0-.94.38-1 .88l-.29 2.31c-.41.19-.8.42-1.17.68l-2.15-.91c-.46-.2-1-.02-1.25.42L2.41 8.62c-.25.44-.14.99.26 1.3l1.86 1.41a7.343 7.343 0 0 0 0 1.35l-1.86 1.41c-.4.3-.51.86-.26 1.3l1.87 3.23c.25.44.79.62 1.25.42l2.15-.91c.37.26.76.49 1.17.68l.29 2.31c.06.5.49.88.99.88h3.73c.5 0 .93-.38.99-.88l.29-2.31c.41-.19.8-.42 1.17-.68l2.15.91c.46.2 1 .02 1.25-.42l1.87-3.23c.25-.44.14-.99-.26-1.3l-1.86-1.41c.03-.23.04-.45.04-.68zm-7.46 3.5c-1.93 0-3.5-1.57-3.5-3.5s1.57-3.5 3.5-3.5 3.5 1.57 3.5 3.5-1.57 3.5-3.5 3.5z',
+  share:
+    'M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81 1.66 0 3-1.34 3-3s-1.34-3-3-3-3 1.34-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9c-1.66 0-3 1.34-3 3s1.34 3 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.16c-.05.21-.08.43-.08.65 0 1.61 1.31 2.92 2.92 2.92s2.92-1.31 2.92-2.92-1.31-2.92-2.92-2.92z',
+  shoppingCart:
+    'M7 18c-1.1 0-1.99.9-1.99 2S5.9 22 7 22s2-.9 2-2-.9-2-2-2zM1 3c0 .55.45 1 1 1h1l3.6 7.59-1.35 2.44C4.52 15.37 5.48 17 7 17h11c.55 0 1-.45 1-1s-.45-1-1-1H7l1.1-2h7.45c.75 0 1.41-.41 1.75-1.03l3.58-6.49A.996.996 0 0 0 20.01 4H5.21l-.67-1.43a.993.993 0 0 0-.9-.57H2c-.55 0-1 .45-1 1zm16 15c-1.1 0-1.99.9-1.99 2s.89 2 1.99 2 2-.9 2-2-.9-2-2-2z',
+  skipNext:
+    'm7.58 16.89 5.77-4.07c.56-.4.56-1.24 0-1.63L7.58 7.11C6.91 6.65 6 7.12 6 7.93v8.14c0 .81.91 1.28 1.58.82zM16 7v10c0 .55.45 1 1 1s1-.45 1-1V7c0-.55-.45-1-1-1s-1 .45-1 1z',
+  skipPrevious:
+    'M7 6c.55 0 1 .45 1 1v10c0 .55-.45 1-1 1s-1-.45-1-1V7c0-.55.45-1 1-1zm3.66 6.82 5.77 4.07c.66.47 1.58-.01 1.58-.82V7.93c0-.81-.91-1.28-1.58-.82l-5.77 4.07a1 1 0 0 0 0 1.64z',
+  star: 'm12 17.27 4.15 2.51c.76.46 1.69-.22 1.49-1.08l-1.1-4.72 3.67-3.18c.67-.58.31-1.68-.57-1.75l-4.83-.41-1.89-4.46c-.34-.81-1.5-.81-1.84 0L9.19 8.63l-4.83.41c-.88.07-1.24 1.17-.57 1.75l3.67 3.18-1.1 4.72c-.2.86.73 1.54 1.49 1.08l4.15-2.5z',
+  starHalf:
+    'm19.65 9.04-4.84-.42-1.89-4.45c-.34-.81-1.5-.81-1.84 0L9.19 8.63l-4.83.41c-.88.07-1.24 1.17-.57 1.75l3.67 3.18-1.1 4.72c-.2.86.73 1.54 1.49 1.08l4.15-2.5 4.15 2.51c.76.46 1.69-.22 1.49-1.08l-1.1-4.73 3.67-3.18c.67-.58.32-1.68-.56-1.75zM12 15.4V6.1l1.71 4.04 4.38.38-3.32 2.88 1 4.28L12 15.4z',
+  starOff:
+    'm19.65 9.04-4.84-.42-1.89-4.45c-.34-.81-1.5-.81-1.84 0L9.19 8.63l-4.83.41c-.88.07-1.24 1.17-.57 1.75l3.67 3.18-1.1 4.72c-.2.86.73 1.54 1.49 1.08l4.15-2.5 4.15 2.51c.76.46 1.69-.22 1.49-1.08l-1.1-4.73 3.67-3.18c.67-.58.32-1.68-.56-1.75zM12 15.4l-3.76 2.27 1-4.28-3.32-2.88 4.38-.38L12 6.1l1.71 4.04 4.38.38-3.32 2.88 1 4.28L12 15.4z',
+  stop: 'M8 6h8c1.1 0 2 .9 2 2v8c0 1.1-.9 2-2 2H8c-1.1 0-2-.9-2-2V8c0-1.1.9-2 2-2z',
+  upload:
+    'M10 16h4c.55 0 1-.45 1-1v-5h1.59c.89 0 1.34-1.08.71-1.71L12.71 3.7a.996.996 0 0 0-1.41 0L6.71 8.29c-.63.63-.19 1.71.7 1.71H9v5c0 .55.45 1 1 1zm-4 2h12c.55 0 1 .45 1 1s-.45 1-1 1H6c-.55 0-1-.45-1-1s.45-1 1-1z',
+  visibility:
+    'M12 4C7 4 2.73 7.11 1 11.5 2.73 15.89 7 19 12 19s9.27-3.11 11-7.5C21.27 7.11 17 4 12 4zm0 12.5c-2.76 0-5-2.24-5-5s2.24-5 5-5 5 2.24 5 5-2.24 5-5 5zm0-8c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z',
+  visibilityOff:
+    'M12 6.5c2.76 0 5 2.24 5 5 0 .51-.1 1-.24 1.46l3.06 3.06c1.39-1.23 2.49-2.77 3.18-4.53C21.27 7.11 17 4 12 4c-1.27 0-2.49.2-3.64.57l2.17 2.17c.47-.14.96-.24 1.47-.24zM2.71 3.16a.996.996 0 0 0 0 1.41l1.97 1.97A11.892 11.892 0 0 0 1 11.5C2.73 15.89 7 19 12 19c1.52 0 2.97-.3 4.31-.82l2.72 2.72a.996.996 0 1 0 1.41-1.41L4.13 3.16c-.39-.39-1.03-.39-1.42 0zM12 16.5c-2.76 0-5-2.24-5-5 0-.77.18-1.5.49-2.14l1.57 1.57c-.03.18-.06.37-.06.57 0 1.66 1.34 3 3 3 .2 0 .38-.03.57-.07L14.14 16c-.65.32-1.37.5-2.14.5zm2.97-5.33a2.97 2.97 0 0 0-2.64-2.64l2.64 2.64z',
+  volumeDown:
+    'M18.5 12A4.5 4.5 0 0 0 16 7.97v8.05c1.48-.73 2.5-2.25 2.5-4.02zM5 10v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71V6.41c0-.89-1.08-1.34-1.71-.71L9 9H6c-.55 0-1 .45-1 1z',
+  volumeMute:
+    'M7 10v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71V6.41c0-.89-1.08-1.34-1.71-.71L11 9H8c-.55 0-1 .45-1 1z',
+  volumeOff:
+    'M3.63 3.63a.996.996 0 0 0 0 1.41L7.29 8.7 7 9H4c-.55 0-1 .45-1 1v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71v-4.17l4.18 4.18c-.49.37-1.02.68-1.6.91-.36.15-.58.53-.58.92 0 .72.73 1.18 1.39.91.8-.33 1.55-.77 2.22-1.31l1.34 1.34a.996.996 0 1 0 1.41-1.41L5.05 3.63c-.39-.39-1.02-.39-1.42 0zM19 12c0 .82-.15 1.61-.41 2.34l1.53 1.53c.56-1.17.88-2.48.88-3.87 0-3.83-2.4-7.11-5.78-8.4-.59-.23-1.22.23-1.22.86v.19c0 .38.25.71.61.85C17.18 6.54 19 9.06 19 12zm-8.71-6.29-.17.17L12 7.76V6.41c0-.89-1.08-1.33-1.71-.7zM16.5 12A4.5 4.5 0 0 0 14 7.97v1.79l2.48 2.48c.01-.08.02-.16.02-.24z',
+  volumeUp:
+    'M3 10v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71V6.41c0-.89-1.08-1.34-1.71-.71L7 9H4c-.55 0-1 .45-1 1zm13.5 2A4.5 4.5 0 0 0 14 7.97v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 4.45v.2c0 .38.25.71.6.85C17.18 6.53 19 9.06 19 12s-1.82 5.47-4.4 6.5c-.36.14-.6.47-.6.85v.2c0 .63.63 1.07 1.21.85C18.6 19.11 21 15.84 21 12s-2.4-7.11-5.79-8.4c-.58-.23-1.21.22-1.21.85z',
+  warning:
+    'M4.47 21h15.06c1.54 0 2.5-1.67 1.73-3L13.73 4.99c-.77-1.33-2.69-1.33-3.46 0L2.74 18c-.77 1.33.19 3 1.73 3zM12 14c-.55 0-1-.45-1-1v-2c0-.55.45-1 1-1s1 .45 1 1v2c0 .55-.45 1-1 1zm1 4h-2v-2h2v2z',
+};

package/src/a2ui/components/types.ts

@@ -0,0 +1,24 @@
+import type { ComponentType } from 'react';
+
+import type { ComponentNode } from '@a2ui/web_core';
+
+/**
+ * What a view of one of the basic catalog's components gets: what the agent wrote for it, with
+ * its bindings and functions worked out. A property the person can change, such as a TextField's
+ * `value`, comes with a setter named after it (`setValue`). A child is a node, drawn with
+ * `A2UIChild`, and children are a list of them.
+ */
+export type A2UIComponentProps = {
+  /** The component where the agent placed it, for its id and its place in the data model. */
+  node: ComponentNode;
+  props: Record<string, unknown>;
+};
+
+/** Views of the basic catalog's components by their A2UI type, such as `Card`. */
+export type A2UIComponents = Partial<Record<string, ComponentType<A2UIComponentProps>>>;
+
+/** An icon an app draws for A2UI's Icon, in the color and at the size it is given. */
+export type A2UIIcon = ComponentType<{ color: string; size: number }>;
+
+/** The app's icons by the names A2UI's Icon takes, such as `shoppingCart`. */
+export type A2UIIcons = Partial<Record<string, A2UIIcon>>;

package/src/a2ui/index.ts

@@ -0,0 +1,18 @@
+// The A2UI renderer for the AI components' generated UI. Its own entry point, so an app whose
+// agent never writes A2UI doesn't bundle the A2UI core.
+export {
+  A2UI_DEFAULT_CATALOG_ID,
+  type A2UIError,
+  type A2UIRendererOptions,
+  createA2UIRenderer,
+} from './A2UIRenderer';
+export { A2UI_VERSION } from './A2UIStream';
+export {
+  A2UI_PROTOCOL_OVERVIEW,
+  type A2UIInstructionsConfig,
+  A2UIInstructionsError,
+} from './A2UIInstructions';
+export { a2uiInstructions, a2uiProblems } from './instructions';
+export { A2UIChild, A2UIChildren } from './A2UISurface';
+export { A2UI_BASIC_COMPONENTS } from './components/basicComponents';
+export type { A2UIComponentProps, A2UIComponents, A2UIIcon, A2UIIcons } from './components/types';

package/src/a2ui/instructions.ts

@@ -0,0 +1,341 @@
+// What teaches an agent's model to write A2UI, and what checks what it is shown. It runs the
+// A2UI core alone, without the renderer's views, so it runs in a script or a build too.
+import {
+  Catalog,
+  type ComponentApi,
+  type FunctionImplementation,
+  getComponentReferences,
+  MAX_GLOBAL_DEPTH,
+  MessageProcessor,
+  RELAXED_VALIDATION,
+} from '@a2ui/web_core';
+
+import {
+  A2UI_PROTOCOL_OVERVIEW,
+  type A2UIInstructionsConfig,
+  A2UIInstructionsError,
+  blocksIn,
+  fenceOf,
+  sorted,
+  writing,
+} from './A2UIInstructions';
+import { A2UI_VERSION, a2uiMessagesIn, normalizeA2UIMessage } from './A2UIStream';
+import { A2UI_DEFAULT_CATALOG_ID, a2uiAppCatalogDocument } from './catalogDocument';
+import { basicCatalogDefinitions } from './catalogs';
+
+import type { AIUIComponent } from '../ai-components/generative-ui/AIUIComponent';
+import type { AIUIComponentDefinition } from '../ai-components/generative-ui/AIUIComponentDefinition';
+import { isRecord } from '../ai-components/generative-ui/AIUIHelpers';
+
+type Entry = ComponentApi;
+
+const definitionOf = (component: AIUIComponent | AIUIComponentDefinition) =>
+  'definition' in component ? component.definition : component;
+
+/**
+ * The catalog an agent writes with: the basic catalog, or what `keep` names of it less what
+ * `removing` names, and the app's components.
+ */
+export const a2uiCatalogFor = ({
+  catalogId = A2UI_DEFAULT_CATALOG_ID,
+  components = [],
+  keep,
+  removing,
+  tools = [],
+}: Pick<
+  A2UIInstructionsConfig,
+  'catalogId' | 'components' | 'keep' | 'removing' | 'tools'
+> = {}): Catalog<Entry> => {
+  const basicCatalog = basicCatalogDefinitions();
+  const kept = keep && new Set(keep);
+  const removed = new Set(removing);
+  const ofBasic = (names: Iterable<string>) =>
+    [...names].filter((name) => (!kept || kept.has(name)) && !removed.has(name));
+  const definitions = components.map(definitionOf);
+  const app = definitions.length
+    ? [
+        ...Catalog.fromJson(
+          a2uiAppCatalogDocument(catalogId, definitions, { bindings: false }),
+          A2UI_VERSION,
+        ).components.values(),
+      ]
+    : [];
+  // The app's tools, as functions the agent can call from the UI, less one named like a function of
+  // the basic catalog, which comes first.
+  const usable = tools.filter(({ name }) => !basicCatalog.functions.has(name));
+  const toolFunctions = usable.length
+    ? [
+        ...Catalog.fromJson(
+          a2uiAppCatalogDocument(catalogId, [], { bindings: false, tools: usable }),
+          A2UI_VERSION,
+        ).functions.values(),
+      ]
+    : [];
+  // The catalog's guidelines, without its examples: they name the basic catalog rather than
+  // this one, and components `keep` may leave out.
+  const guidelines = basicCatalog.instructions?.split('\n## Examples')[0].trim();
+  return (basicCatalog as unknown as Catalog<Entry>).derive({
+    catalogId,
+    components: [...ofBasic(basicCatalog.components.keys()), ...app],
+    // Only described, never run: what the agent is told and what is checked needs no implementation.
+    functions: [
+      ...ofBasic(basicCatalog.functions.keys()),
+      ...(toolFunctions as unknown as FunctionImplementation[]),
+    ],
+    ...(guidelines ? { instructions: guidelines } : {}),
+  });
+};
+
+/**
+ * The instructions that teach an agent's model to write A2UI the app's renderer shows, in
+ * Markdown: how a reply carries its UI, the protocol, the catalog's guidelines and the catalog
+ * itself with the app's components, then what `config` adds. Throws an `A2UIInstructionsError`
+ * when an example would not render.
+ */
+export const a2uiInstructionsText = (config: A2UIInstructionsConfig = {}) => {
+  const catalog = a2uiCatalogFor(config);
+  const fence = fenceOf(config.fence);
+  const broken = (config.examples ?? []).flatMap((example) =>
+    blocksIn(example, fence).flatMap((block) =>
+      a2uiProblemsWith(block, catalog).map((problem) => `example: ${problem}`),
+    ),
+  );
+  if (broken.length) throw new A2UIInstructionsError(broken);
+  const { instructions, ...document } = catalog.toJson() as Record<string, unknown>;
+  const { examples = [], notes = [], preamble, rules = [] } = config;
+  return [
+    ...(preamble ? [preamble] : []),
+    writing(fence, catalog.id),
+    A2UI_PROTOCOL_OVERVIEW,
+    ...(typeof instructions === 'string' && instructions ? [instructions] : []),
+    ...(notes.length ? [`## The app's components\n\n${notes.join('\n')}`] : []),
+    `## The catalog \`${catalog.id}\`\n\n\`\`\`json\n${JSON.stringify(sorted(document))}\n\`\`\``,
+    ...(rules.length
+      ? [`## Rules\n\n${rules.map((rule, index) => `${index + 1}. ${rule}`).join('\n')}`]
+      : []),
+    ...(examples.length ? [`## Examples\n\n${examples.join('\n\n')}`] : []),
+  ].join('\n\n');
+};
+
+type Components = Map<string, Record<string, unknown>>;
+
+const MESSAGE_KINDS = [
+  'createSurface',
+  'updateComponents',
+  'updateDataModel',
+  'deleteSurface',
+  'callRendererFunction',
+  'agentFunctionResponse',
+];
+
+const componentsOf = (value: unknown) => (Array.isArray(value) ? value.filter(isRecord) : []);
+
+const duplicates = (components: Record<string, unknown>[], surfaceId: string) => {
+  const seen = new Set<unknown>();
+  const repeated = new Set<unknown>();
+  for (const { id } of components) {
+    if (seen.has(id)) repeated.add(id);
+    seen.add(id);
+  }
+  return [...repeated].map(
+    (id) => `surface ${surfaceId} defines ${String(id)} more than once in one message`,
+  );
+};
+
+/**
+ * What is wrong with the A2UI messages of `text` for a renderer with `catalog`, or nothing
+ * when they render as written: messages it can't read, components it doesn't have or that don't
+ * fit their schemas, and references that lead nowhere, with each component checked against its
+ * schema by the A2UI core as a renderer checks it.
+ */
+export const a2uiProblemsWith = (text: string, catalog: Catalog<Entry>) => {
+  const problems: string[] = [];
+  const surfaces = new Map<string, Components>();
+  let created = false;
+  for (const raw of a2uiMessagesIn(text)) {
+    let json: unknown;
+    try {
+      json = JSON.parse(raw);
+    } catch {
+      json = undefined;
+    }
+    if (!isRecord(json)) {
+      problems.push(`this isn't JSON: ${raw.slice(0, 80)}`);
+      continue;
+    }
+    const message = normalizeA2UIMessage(json, catalog.id);
+    const kind = MESSAGE_KINDS.find((name) => name in message);
+    const body = kind ? message[kind] : undefined;
+    const surfaceId = isRecord(body) ? body.surfaceId : undefined;
+    if (!kind) {
+      problems.push(`this isn't an A2UI message: ${raw.slice(0, 80)}`);
+    } else if (kind === 'callRendererFunction' || kind === 'agentFunctionResponse') {
+      problems.push("a reply's UI calls no functions");
+    } else if (typeof surfaceId !== 'string' || !isRecord(body)) {
+      problems.push(`a ${kind} names no surfaceId`);
+    } else if (kind === 'createSurface') {
+      if (surfaces.has(surfaceId)) {
+        problems.push(
+          `surface ${surfaceId} is created again: delete it first, or change it with updateComponents and updateDataModel`,
+        );
+        continue;
+      }
+      created = true;
+      const components = componentsOf(body.components);
+      problems.push(...duplicates(components, surfaceId));
+      if (typeof body.catalogId === 'string' && body.catalogId !== catalog.id) {
+        problems.push(
+          `surface ${surfaceId} names the catalog ${body.catalogId}, not ${catalog.id}`,
+        );
+      }
+      surfaces.set(
+        surfaceId,
+        new Map(components.map((component) => [String(component.id), component])),
+      );
+    } else if (kind === 'updateComponents') {
+      const kept = surfaces.get(surfaceId);
+      if (!kept) {
+        problems.push(`surface ${surfaceId} gets components before it is created`);
+        continue;
+      }
+      const components = componentsOf(body.components);
+      problems.push(...duplicates(components, surfaceId));
+      for (const component of components) kept.set(String(component.id), component);
+    } else if (kind === 'updateDataModel' && !surfaces.has(surfaceId)) {
+      problems.push(`surface ${surfaceId} gets data before it is created`);
+    } else if (kind === 'deleteSurface') {
+      // What a deleted surface held never shows; its id may be created again.
+      surfaces.delete(surfaceId);
+    }
+  }
+  if (!created) problems.push('nothing renders: there is no createSurface');
+  for (const [surfaceId, components] of surfaces) {
+    problems.push(...surfaceProblems(components, surfaceId, catalog));
+  }
+  return problems;
+};
+
+// Each component checked against its schema, by the A2UI core as a renderer checks it, then
+// what the surface's components make together.
+const surfaceProblems = (components: Components, surfaceId: string, catalog: Catalog<Entry>) => {
+  const problems: string[] = [];
+  const processor = new MessageProcessor([catalog], undefined, {
+    reportErrorsOnly: true,
+  });
+  const config = { ...RELAXED_VALIDATION, allowUnknownElements: false };
+  processor.processMessagesWithErrors(
+    {
+      createSurface: { catalogId: catalog.id, surfaceId: 'lint' },
+      version: A2UI_VERSION,
+    },
+    { validationConfig: config },
+  );
+  const references = new Map<string, string[]>();
+  const ids = [...components.keys()].sort();
+  for (const id of ids) {
+    const component = components.get(id) as Record<string, unknown>;
+    const errors = processor.processMessagesWithErrors(
+      {
+        updateComponents: { components: [component], surfaceId: 'lint' },
+        version: A2UI_VERSION,
+      },
+      { validationConfig: config },
+    );
+    // A cycle is told once, with the depth, below.
+    for (const { error } of errors) {
+      if (error.code === 'RECURSION_LIMIT_EXCEEDED') continue;
+      problems.push(`${id}: ${String(error.message)}`);
+    }
+    let children: string[] = [];
+    try {
+      children = [...getComponentReferences(component, catalog)].map(([child]) => child);
+    } catch {
+      children = [];
+    }
+    references.set(id, children);
+  }
+  for (const [id, children] of references) {
+    for (const child of children) {
+      if (!components.has(child)) problems.push(`${id} holds ${child}, which is not defined`);
+    }
+  }
+  if (!components.has('root')) {
+    return [...problems, `surface ${surfaceId} has no component with the id root`];
+  }
+  const reached = new Set<string>();
+  const next = ['root'];
+  while (next.length) {
+    const id = next.pop() as string;
+    if (reached.has(id)) continue;
+    reached.add(id);
+    next.push(...(references.get(id) ?? []));
+  }
+  for (const id of ids) {
+    if (!reached.has(id)) problems.push(`${id} is defined but nothing holds it`);
+  }
+  return [...problems, ...nestingProblems(references, surfaceId)];
+};
+
+// A component that holds itself, directly or through others, never finishes rendering, and a
+// renderer stops at MAX_GLOBAL_DEPTH levels.
+const nestingProblems = (references: Map<string, string[]>, surfaceId: string) => {
+  const problems: string[] = [];
+  const depths = new Map<string, number>();
+  const visiting = new Set<string>();
+  let reportedCycle = false;
+  const depthOf = (id: string): number => {
+    const known = depths.get(id);
+    if (known !== undefined) return known;
+    if (visiting.has(id)) {
+      if (!reportedCycle) {
+        problems.push(`${id} holds itself through its children, so it never finishes rendering`);
+        reportedCycle = true;
+      }
+      return 0;
+    }
+    visiting.add(id);
+    const deepest = Math.max(
+      0,
+      ...(references.get(id) ?? []).filter((child) => references.has(child)).map(depthOf),
+    );
+    visiting.delete(id);
+    depths.set(id, deepest + 1);
+    return deepest + 1;
+  };
+  if (references.has('root') && depthOf('root') > MAX_GLOBAL_DEPTH) {
+    problems.push(`surface ${surfaceId} nests components deeper than ${MAX_GLOBAL_DEPTH} levels`);
+  }
+  for (const id of [...references.keys()].sort()) depthOf(id);
+  return problems;
+};
+
+/** What is wrong with the A2UI messages of `text` for the catalog `config` makes, or nothing. */
+export const a2uiProblemsIn = (
+  text: string,
+  config: Pick<
+    A2UIInstructionsConfig,
+    'catalogId' | 'components' | 'keep' | 'removing' | 'tools'
+  > = {},
+) => a2uiProblemsWith(text, a2uiCatalogFor(config));
+
+/**
+ * The instructions that teach an agent's model to write A2UI with the basic catalog and the
+ * app's components, in Markdown, from the A2UI core's own catalog. Give them to the agent's
+ * backend, as the part of its instructions about UI. It runs in a script or
+ * a build too, and rejects with an `A2UIInstructionsError` when an example would not render.
+ */
+export const a2uiInstructions = (config: A2UIInstructionsConfig = {}) =>
+  new Promise<string>((resolve) => resolve(a2uiInstructionsText(config)));
+
+/**
+ * What is wrong with the A2UI messages of `text`, such as an agent's example, for the catalog
+ * `config` makes, or nothing when they render as written: messages the renderer can't read,
+ * components it doesn't have or that don't fit their schemas, and references that lead nowhere.
+ */
+export const a2uiProblems = (
+  text: string,
+  config: Pick<
+    A2UIInstructionsConfig,
+    'catalogId' | 'components' | 'keep' | 'removing' | 'tools'
+  > = {},
+) => new Promise<string[]>((resolve) => resolve(a2uiProblemsIn(text, config)));

package/src/a2ui/secrets.ts

@@ -0,0 +1,154 @@
+import type { ComponentApi, SurfaceModel } from '@a2ui/web_core';
+
+import { isRecord } from '../ai-components/generative-ui/AIUIHelpers';
+
+/**
+ * `value` without the person's secrets, such as a password they typed into an obscured TextField:
+ * each string that holds one has it cut out, wherever it is, so none reaches the agent.
+ */
+export const withoutSecrets = <T>(value: T, secrets: readonly string[]): T => {
+  const known = secrets.filter((secret) => secret !== '');
+  if (known.length === 0) return value;
+  const clean = (item: unknown): unknown => {
+    if (typeof item === 'string') {
+      return known.reduce((text, secret) => text.split(secret).join(''), item);
+    }
+    if (Array.isArray(item)) return item.map(clean);
+    if (isRecord(item)) {
+      return Object.fromEntries(Object.entries(item).map(([key, entry]) => [key, clean(entry)]));
+    }
+    return item;
+  };
+  return clean(value) as T;
+};
+
+const resolvedPath = (base: string, path: string) => {
+  if (path.startsWith('/')) return path;
+  const parent = base === '/' ? '' : base.replace(/\/$/, '');
+  return path === '' || path === '.' ? parent || '/' : `${parent}/${path}`;
+};
+
+const placesOf = (surface: SurfaceModel<ComponentApi>) => {
+  const places: Array<{ dataPath: string; id: string }> = [];
+  const seen = new Set<string>();
+  const visit = (id: string, dataPath: string) => {
+    const key = `${id}\u0000${dataPath}`;
+    const component = surface.componentsModel.get(id);
+    if (!component || seen.has(key)) return;
+    seen.add(key);
+    places.push({ dataPath, id });
+    const children = (value: unknown): void => {
+      if (typeof value === 'string') return visit(value, dataPath);
+      if (Array.isArray(value)) return value.forEach(children);
+      if (!isRecord(value)) return;
+      const { componentId, path } = value;
+      if (typeof componentId === 'string' && typeof path === 'string') {
+        const listPath = resolvedPath(dataPath, path);
+        const items: unknown = surface.dataModel.get(listPath);
+        if (Array.isArray(items)) {
+          items.forEach((_, index) => visit(componentId, resolvedPath(listPath, `${index}`)));
+        }
+        return;
+      }
+      Object.values(value).forEach(children);
+    };
+    Object.values(component.properties as Record<string, unknown>).forEach(children);
+  };
+  visit(surface.rootId, '/');
+  for (const component of surface.componentsModel.values) {
+    if (!places.some(({ id }) => id === component.id)) visit(component.id, '/');
+  }
+  return places;
+};
+
+// The paths each surface's obscured fields write, as they resolved when they showed: inside a
+// list, or with a variant bound to the data model, the components alone don't tell.
+const shownSecretPaths = new WeakMap<object, Set<string>>();
+
+/** Keeps what is written at `path` of `surface`'s data model from the agent, such as a password. */
+export const keepSecretPath = (surface: SurfaceModel<ComponentApi>, path: string) => {
+  let paths = shownSecretPaths.get(surface);
+  if (!paths) {
+    paths = new Set();
+    shownSecretPaths.set(surface, paths);
+  }
+  paths.add(path);
+};
+
+/**
+ * The data model paths a surface's obscured TextFields write, such as a password's: those its
+ * components name, whether or not they show, and those of the ones that showed.
+ */
+export const secretPathsOf = (surface: SurfaceModel<ComponentApi> | undefined) => {
+  if (!surface) return [];
+  const paths = new Set(shownSecretPaths.get(surface));
+  for (const { dataPath, id } of placesOf(surface)) {
+    const component = surface.componentsModel.get(id);
+    const { value, variant } = (component?.properties ?? {}) as Record<string, unknown>;
+    if (component?.type !== 'TextField' || variant !== 'obscured' || !isRecord(value)) continue;
+    const path = value['@path'];
+    if (typeof path === 'string') paths.add(resolvedPath(dataPath, path));
+  }
+  return [...paths];
+};
+
+/** What the person typed into a surface's obscured TextFields. */
+export const secretValuesOf = (surface: SurfaceModel<ComponentApi> | undefined): string[] =>
+  secretPathsOf(surface).flatMap((path) => {
+    const value: unknown = surface?.dataModel.get(path);
+    return typeof value === 'string' && value !== '' ? [value] : [];
+  });
+
+/** The keys of an action's context the agent bound to one of the surface's obscured fields. */
+export const secretContextKeysOf = (
+  surface: SurfaceModel<ComponentApi> | undefined,
+  sourceComponentId: string,
+) => {
+  const secretPaths = secretPathsOf(surface);
+  const action: unknown = surface?.componentsModel.get(sourceComponentId)?.properties.action;
+  const context = isRecord(action) && isRecord(action.event) ? action.event.context : undefined;
+  if (!isRecord(context) || !surface) return [];
+  const dataPaths = placesOf(surface)
+    .filter(({ id }) => id === sourceComponentId)
+    .map(({ dataPath }) => dataPath);
+  return Object.entries(context).flatMap(([key, value]) => {
+    const path = isRecord(value) ? value['@path'] : undefined;
+    if (typeof path !== 'string') return [];
+    return dataPaths.some((dataPath) => {
+      const bound = resolvedPath(dataPath, path);
+      return secretPaths.some((secret) => bound === secret || bound.startsWith(`${secret}/`));
+    })
+      ? [key]
+      : [];
+  });
+};
+
+const unescape = (segment: string) => segment.replace(/~1/g, '/').replace(/~0/g, '~');
+
+/** `value` without what is at each of `paths`, JSON Pointers such as `/account/password`. */
+export const withoutPaths = (value: unknown, paths: Iterable<string>): unknown => {
+  let result = value;
+  for (const path of paths) {
+    const segments = path.split('/').slice(1).map(unescape);
+    if (segments.length === 0) return undefined;
+    const remove = (node: unknown, index: number): unknown => {
+      const key = segments[index];
+      const last = index === segments.length - 1;
+      if (Array.isArray(node)) {
+        const at = Number(key);
+        if (!Number.isInteger(at) || at < 0 || at >= node.length) return node;
+        return last
+          ? node.filter((_, position) => position !== at)
+          : node.map((item, position) => (position === at ? remove(item, index + 1) : item));
+      }
+      if (!isRecord(node) || !(key in node)) return node;
+      if (last) {
+        const { [key]: _removed, ...rest } = node;
+        return rest;
+      }
+      return { ...node, [key]: remove(node[key], index + 1) };
+    };
+    result = remove(result, 0);
+  }
+  return result;
+};