fix(a11y): add aria-describedby to svg and make star icons decorative

- Icon.astro: add aria-describedby to normalizedProps when desc is
  provided and icon is meaningful, binding <svg> to its <desc id>
  (WCAG 1.1.1 / 4.1.2)
- map.astro: remove per-star title props so each icon is decorative;
  the <figure aria-label> and <figcaption> carry the collective meaning
  and screen readers no longer announce each star separately

Author: yacosta738

demo/src/pages/map.astro

@@ -9,14 +9,12 @@ import Base from "../layouts/base.astro";
   <!--
     Star rating example: wrap the group in a <figure> with a <figcaption>
     so screen readers understand the collective meaning (WCAG 1.1.1 / 1.3.1).
-    Each Icon is decorative within the group — aria-hidden is set automatically.
+    Each Icon is decorative within the group — no title prop, so aria-hidden
+    is applied automatically by Icon.astro.
   -->
   <figure aria-label="Rating: 4 out of 5 stars">
-    {Array.from({ length: 5 }, (_, i) => (
-      <Icon
-        name="ic:outline-star"
-        title={i < 4 ? `Star ${i + 1}` : `Empty star ${i + 1}`}
-      />
+    {Array.from({ length: 5 }, () => (
+      <Icon name="ic:outline-star" />
     ))}
     <figcaption class="visually-hidden">4 out of 5 stars</figcaption>
   </figure>

packages/core/components/Icon.astro

@@ -113,12 +113,17 @@ const renderData = iconToSVG(iconData);
 // - If a title is provided the icon is meaningful → role="img"
 // - Otherwise it is decorative → aria-hidden="true"
 const isDecorative = !title;
+const descId = desc ? `${id}:desc` : undefined;
 const normalizedProps = {
   ...(renderData.attributes as Partial<IconifyIconBuildResult["attributes"]>),
   // Prevent SVGs from being focusable in IE/Edge and some browsers
   focusable: "false" as const,
-  // Decorative icons must be hidden from the accessibility tree (WCAG 1.1.1)
-  ...(isDecorative ? { "aria-hidden": "true" as const } : { role: "img" as const }),
+  // Decorative icons must be hidden from the accessibility tree (WCAG 1.1.1).
+  // Meaningful icons get role="img" and, when a desc is provided, aria-describedby
+  // pointing to the stable <desc id> so assistive technologies read the description.
+  ...(isDecorative
+    ? { "aria-hidden": "true" as const }
+    : { role: "img" as const, ...(descId ? { "aria-describedby": descId } : {}) }),
   ...props,
 };
 // biome-ignore lint/correctness/noUnusedVariables: used in the Astro template below, outside Biome's JS scope