Drop generated cards; registry descriptions become Elements tooltips

- resolveRefs no longer adds cards to a diagram; it returns node id →
  description, which the page sets as the tooltip of the matching row in
  Archify's Elements panel
- hand-written cards pass through unchanged; docs and changelog

src/model/format.ts

@@ -55,42 +55,6 @@ export interface Registry {
   problems: ModelProblem[];
 }
 
-/** Archify card dot colour for a component type (the colours Archify gives the nodes). */
-const DOT_BY_TYPE: Record<string, string> = {
-  frontend: 'cyan',
-  backend: 'emerald',
-  database: 'violet',
-  cloud: 'amber',
-  security: 'rose',
-  messagebus: 'orange',
-  external: 'slate',
-};
-
-export function dotForType(type?: string): string {
-  return DOT_BY_TYPE[type ?? ''] ?? 'slate';
-}
-
-export interface Card {
-  dot: string;
-  title: string;
-  items: string[];
-}
-
-/**
- * Archify info cards for registry elements: one per element that has a
- * description, titled by its label. What a diagram gets below itself when
- * it draws shared elements and defines no cards of its own.
- */
-export function cardsFromElements(elements: Iterable<RegistryElement>): Card[] {
-  const cards: Card[] = [];
-  for (const element of elements) {
-    if (!element.description) continue;
-    const items = [element.description.trim()];
-    cards.push({ dot: dotForType(element.type), title: element.label ?? element.id, items });
-  }
-  return cards;
-}
-
 export function isMainFile(fileName: string): boolean {
   return (fileName.split(/[\\/]/).pop() ?? '') === MAIN_FILE;
 }
@@ -196,6 +160,8 @@ export interface ResolvedDiagram {
   links: Map<string, string>;
   /** Registry element ids used by this diagram. */
   used: Set<string>;
+  /** Node id → registry description, for the Elements panel. */
+  descriptions: Map<string, string>;
 }
 
 export interface ResolveOptions {
@@ -208,20 +174,19 @@ export interface ResolveOptions {
  * Expands `ref` components from the registry and strips what Archify does
  * not know. Component order and indexes are kept, so Archify's diagnostics
  * (JSON pointers) still point at the right component in the source file.
- * A diagram without `cards` of its own gets cards from the descriptions of
- * the shared elements it draws, so the registry text shows under the diagram.
  */
 export function resolveRefs(doc: unknown, options: ResolveOptions): ResolvedDiagram {
   const problems: ModelProblem[] = [];
   const refs = new Map<number, RegistryElement>();
   const links = new Map<string, string>();
   const used = new Set<string>();
-  if (!isObj(doc)) return { diagram: {}, problems, refs, links, used };
+  const descriptions = new Map<string, string>();
+  if (!isObj(doc)) return { diagram: {}, problems, refs, links, used, descriptions };
   const diagram: Obj = { ...doc };
   delete diagram.model;
   const { registry } = options;
   const components = Array.isArray(doc.components) ? doc.components : undefined;
-  if (!components) return { diagram, problems, refs, links, used };
+  if (!components) return { diagram, problems, refs, links, used, descriptions };
 
   diagram.components = components.map((raw, index) => {
     if (!isObj(raw)) return raw;
@@ -248,6 +213,7 @@ export function resolveRefs(doc: unknown, options: ResolveOptions): ResolvedDiag
     }
     used.add(ref);
     refs.set(index, element);
+    if (element.description) descriptions.set(id, element.description.trim());
     for (const key of Object.keys(own)) {
       if ((COPIED_FIELDS as readonly string[]).includes(key) && !(OVERRIDABLE_FIELDS as readonly string[]).includes(key)) {
         problems.push({
@@ -267,14 +233,7 @@ export function resolveRefs(doc: unknown, options: ResolveOptions): ResolvedDiag
     if (link) links.set(id, link);
     return merged;
   });
-  if (diagram.cards === undefined && refs.size) {
-    const seen = new Set<string>();
-    const elements: RegistryElement[] = [];
-    for (const element of refs.values()) if (!seen.has(element.id)) { seen.add(element.id); elements.push(element); }
-    const cards = cardsFromElements(elements);
-    if (cards.length) diagram.cards = cards;
-  }
-  return { diagram, problems, refs, links, used };
+  return { diagram, problems, refs, links, used, descriptions };
 }
 
 /** Group of a diagram inside a model: '' for the root folder, else the folder path with '/' separators. */