Smart Connections Component Patterns

Use this skill when editing or creating Smart Connections UI components under src/components/**, especially when you need to preserve the project’s component lifecycle, listener guards, and env/settings fallbacks.

Critical

• Keep component work inside src/components/**; do not move UI logic into src/main.js, release scripts, or migration files.
• Match the existing component lifecycle used in this repo: build_html(...) → render(...) → post_process(...).
• Guard all event attachment with if (!container._has_listeners) so rerenders do not duplicate handlers.
• Prefer existing helpers and patterns from:
  • src/components/connections-list/v4.js
  • src/components/connections-list-item/v3.js
  • src/components/connections-view/v3.js
  • src/components/connections_codeblock.js
  • src/components/lookup/item_view.js
• Keep fallbacks explicit, especially opts.connections_settings ?? env.connections_lists.settings or the equivalent env fallback used by nearby components.