@altimateai/ui-components 0.0.77-combobox-beta1 → 0.0.78-beta.1

package/dist/stateDiagram-FKZM4ZOC2.js

@@ -0,0 +1,264 @@
+import { s as R, S as N, a as W } from "./chunk-DI55MBZ52.js";
+import { aG as f, aM as t, aS as S, aT as P, aO as z, N as U, T as _, bi as C, a$ as F } from "./CoachForm.js";
+import { s as T } from "./redux-toolkit.modern.js";
+import { G as O } from "./graph2.js";
+import { l as J } from "./layout2.js";
+var X = /* @__PURE__ */ f((e) => e.append("circle").attr("class", "start-state").attr("r", t().state.sizeUnit).attr("cx", t().state.padding + t().state.sizeUnit).attr("cy", t().state.padding + t().state.sizeUnit), "drawStartState"), D = /* @__PURE__ */ f((e) => e.append("line").style("stroke", "grey").style("stroke-dasharray", "3").attr("x1", t().state.textHeight).attr("class", "divider").attr("x2", t().state.textHeight * 2).attr("y1", 0).attr("y2", 0), "drawDivider"), Y = /* @__PURE__ */ f((e, i) => {
+  const d = e.append("text").attr("x", 2 * t().state.padding).attr("y", t().state.textHeight + 2 * t().state.padding).attr("font-size", t().state.fontSize).attr("class", "state-title").text(i.id), c = d.node().getBBox();
+  return e.insert("rect", ":first-child").attr("x", t().state.padding).attr("y", t().state.padding).attr("width", c.width + 2 * t().state.padding).attr("height", c.height + 2 * t().state.padding).attr("rx", t().state.radius), d;
+}, "drawSimpleState"), $ = /* @__PURE__ */ f((e, i) => {
+  const d = /* @__PURE__ */ f(function(g, B, m) {
+    const E = g.append("tspan").attr("x", 2 * t().state.padding).text(B);
+    m || E.attr("dy", t().state.textHeight);
+  }, "addTspan"), n = e.append("text").attr("x", 2 * t().state.padding).attr("y", t().state.textHeight + 1.3 * t().state.padding).attr("font-size", t().state.fontSize).attr("class", "state-title").text(i.descriptions[0]).node().getBBox(), l = n.height, x = e.append("text").attr("x", t().state.padding).attr(
+    "y",
+    l + t().state.padding * 0.4 + t().state.dividerMargin + t().state.textHeight
+  ).attr("class", "state-description");
+  let a = !0, s = !0;
+  i.descriptions.forEach(function(g) {
+    a || (d(x, g, s), s = !1), a = !1;
+  });
+  const w = e.append("line").attr("x1", t().state.padding).attr("y1", t().state.padding + l + t().state.dividerMargin / 2).attr("y2", t().state.padding + l + t().state.dividerMargin / 2).attr("class", "descr-divider"), p = x.node().getBBox(), o = Math.max(p.width, n.width);
+  return w.attr("x2", o + 3 * t().state.padding), e.insert("rect", ":first-child").attr("x", t().state.padding).attr("y", t().state.padding).attr("width", o + 2 * t().state.padding).attr("height", p.height + l + 2 * t().state.padding).attr("rx", t().state.radius), e;
+}, "drawDescrState"), I = /* @__PURE__ */ f((e, i, d) => {
+  const c = t().state.padding, n = 2 * t().state.padding, l = e.node().getBBox(), x = l.width, a = l.x, s = e.append("text").attr("x", 0).attr("y", t().state.titleShift).attr("font-size", t().state.fontSize).attr("class", "state-title").text(i.id), p = s.node().getBBox().width + n;
+  let o = Math.max(p, x);
+  o === x && (o = o + n);
+  let g;
+  const B = e.node().getBBox();
+  i.doc, g = a - c, p > x && (g = (x - o) / 2 + c), Math.abs(a - B.x) < c && p > x && (g = a - (p - x) / 2);
+  const m = 1 - t().state.textHeight;
+  return e.insert("rect", ":first-child").attr("x", g).attr("y", m).attr("class", d ? "alt-composit" : "composit").attr("width", o).attr(
+    "height",
+    B.height + t().state.textHeight + t().state.titleShift + 1
+  ).attr("rx", "0"), s.attr("x", g + c), p <= x && s.attr("x", a + (o - n) / 2 - p / 2 + c), e.insert("rect", ":first-child").attr("x", g).attr(
+    "y",
+    t().state.titleShift - t().state.textHeight - t().state.padding
+  ).attr("width", o).attr("height", t().state.textHeight * 3).attr("rx", t().state.radius), e.insert("rect", ":first-child").attr("x", g).attr(
+    "y",
+    t().state.titleShift - t().state.textHeight - t().state.padding
+  ).attr("width", o).attr("height", B.height + 3 + 2 * t().state.textHeight).attr("rx", t().state.radius), e;
+}, "addTitleAndBox"), q = /* @__PURE__ */ f((e) => (e.append("circle").attr("class", "end-state-outer").attr("r", t().state.sizeUnit + t().state.miniPadding).attr(
+  "cx",
+  t().state.padding + t().state.sizeUnit + t().state.miniPadding
+).attr(
+  "cy",
+  t().state.padding + t().state.sizeUnit + t().state.miniPadding
+), e.append("circle").attr("class", "end-state-inner").attr("r", t().state.sizeUnit).attr("cx", t().state.padding + t().state.sizeUnit + 2).attr("cy", t().state.padding + t().state.sizeUnit + 2)), "drawEndState"), Z = /* @__PURE__ */ f((e, i) => {
+  let d = t().state.forkWidth, c = t().state.forkHeight;
+  if (i.parentId) {
+    let n = d;
+    d = c, c = n;
+  }
+  return e.append("rect").style("stroke", "black").style("fill", "black").attr("width", d).attr("height", c).attr("x", t().state.padding).attr("y", t().state.padding);
+}, "drawForkJoinState"), j = /* @__PURE__ */ f((e, i, d, c) => {
+  let n = 0;
+  const l = c.append("text");
+  l.style("text-anchor", "start"), l.attr("class", "noteText");
+  let x = e.replace(/\r\n/g, "<br/>");
+  x = x.replace(/\n/g, "<br/>");
+  const a = x.split(z.lineBreakRegex);
+  let s = 1.25 * t().state.noteMargin;
+  for (const w of a) {
+    const p = w.trim();
+    if (p.length > 0) {
+      const o = l.append("tspan");
+      if (o.text(p), s === 0) {
+        const g = o.node().getBBox();
+        s += g.height;
+      }
+      n += s, o.attr("x", i + t().state.noteMargin), o.attr("y", d + n + 1.25 * t().state.noteMargin);
+    }
+  }
+  return { textWidth: l.node().getBBox().width, textHeight: n };
+}, "_drawLongText"), K = /* @__PURE__ */ f((e, i) => {
+  i.attr("class", "state-note");
+  const d = i.append("rect").attr("x", 0).attr("y", t().state.padding), c = i.append("g"), { textWidth: n, textHeight: l } = j(e, 0, 0, c);
+  return d.attr("height", l + 2 * t().state.noteMargin), d.attr("width", n + t().state.noteMargin * 2), d;
+}, "drawNote"), L = /* @__PURE__ */ f(function(e, i) {
+  const d = i.id, c = {
+    id: d,
+    label: i.id,
+    width: 0,
+    height: 0
+  }, n = e.append("g").attr("id", d).attr("class", "stateGroup");
+  i.type === "start" && X(n), i.type === "end" && q(n), (i.type === "fork" || i.type === "join") && Z(n, i), i.type === "note" && K(i.note.text, n), i.type === "divider" && D(n), i.type === "default" && i.descriptions.length === 0 && Y(n, i), i.type === "default" && i.descriptions.length > 0 && $(n, i);
+  const l = n.node().getBBox();
+  return c.width = l.width + 2 * t().state.padding, c.height = l.height + 2 * t().state.padding, c;
+}, "drawState"), G = 0, Q = /* @__PURE__ */ f(function(e, i, d) {
+  const c = /* @__PURE__ */ f(function(s) {
+    switch (s) {
+      case N.relationType.AGGREGATION:
+        return "aggregation";
+      case N.relationType.EXTENSION:
+        return "extension";
+      case N.relationType.COMPOSITION:
+        return "composition";
+      case N.relationType.DEPENDENCY:
+        return "dependency";
+    }
+  }, "getRelationType");
+  i.points = i.points.filter((s) => !Number.isNaN(s.y));
+  const n = i.points, l = U().x(function(s) {
+    return s.x;
+  }).y(function(s) {
+    return s.y;
+  }).curve(_), x = e.append("path").attr("d", l(n)).attr("id", "edge" + G).attr("class", "transition");
+  let a = "";
+  if (t().state.arrowMarkerAbsolute && (a = C(!0)), x.attr(
+    "marker-end",
+    "url(" + a + "#" + c(N.relationType.DEPENDENCY) + "End)"
+  ), d.title !== void 0) {
+    const s = e.append("g").attr("class", "stateLabel"), { x: w, y: p } = F.calcLabelPosition(i.points), o = z.getRows(d.title);
+    let g = 0;
+    const B = [];
+    let m = 0, E = 0;
+    for (let u = 0; u <= o.length; u++) {
+      const h = s.append("text").attr("text-anchor", "middle").text(o[u]).attr("x", w).attr("y", p + g), y = h.node().getBBox();
+      m = Math.max(m, y.width), E = Math.min(E, y.x), S.info(y.x, w, p + g), g === 0 && (g = h.node().getBBox().height, S.info("Title height", g, p)), B.push(h);
+    }
+    let k = g * o.length;
+    if (o.length > 1) {
+      const u = (o.length - 1) * g * 0.5;
+      B.forEach((h, y) => h.attr("y", p + y * g - u)), k = g * o.length;
+    }
+    const r = s.node().getBBox();
+    s.insert("rect", ":first-child").attr("class", "box").attr("x", w - m / 2 - t().state.padding / 2).attr("y", p - k / 2 - t().state.padding / 2 - 3.5).attr("width", m + t().state.padding).attr("height", k + t().state.padding), S.info(r);
+  }
+  G++;
+}, "drawEdge"), b, H = {}, V = /* @__PURE__ */ f(function() {
+}, "setConf"), tt = /* @__PURE__ */ f(function(e) {
+  e.append("defs").append("marker").attr("id", "dependencyEnd").attr("refX", 19).attr("refY", 7).attr("markerWidth", 20).attr("markerHeight", 28).attr("orient", "auto").append("path").attr("d", "M 19,7 L9,13 L14,7 L9,1 Z");
+}, "insertMarkers"), et = /* @__PURE__ */ f(function(e, i, d, c) {
+  b = t().state;
+  const n = t().securityLevel;
+  let l;
+  n === "sandbox" && (l = T("#i" + i));
+  const x = n === "sandbox" ? T(l.nodes()[0].contentDocument.body) : T("body"), a = n === "sandbox" ? l.nodes()[0].contentDocument : document;
+  S.debug("Rendering diagram " + e);
+  const s = x.select(`[id='${i}']`);
+  tt(s);
+  const w = c.db.getRootDoc();
+  A(w, s, void 0, !1, x, a, c);
+  const p = b.padding, o = s.node().getBBox(), g = o.width + p * 2, B = o.height + p * 2, m = g * 1.75;
+  P(s, B, m, b.useMaxWidth), s.attr(
+    "viewBox",
+    `${o.x - b.padding}  ${o.y - b.padding} ` + g + " " + B
+  );
+}, "draw"), at = /* @__PURE__ */ f((e) => e ? e.length * b.fontSizeFactor : 1, "getLabelWidth"), A = /* @__PURE__ */ f((e, i, d, c, n, l, x) => {
+  const a = new O({
+    compound: !0,
+    multigraph: !0
+  });
+  let s, w = !0;
+  for (s = 0; s < e.length; s++)
+    if (e[s].stmt === "relation") {
+      w = !1;
+      break;
+    }
+  d ? a.setGraph({
+    rankdir: "LR",
+    multigraph: !0,
+    compound: !0,
+    // acyclicer: 'greedy',
+    ranker: "tight-tree",
+    ranksep: w ? 1 : b.edgeLengthFactor,
+    nodeSep: w ? 1 : 50,
+    isMultiGraph: !0
+    // ranksep: 5,
+    // nodesep: 1
+  }) : a.setGraph({
+    rankdir: "TB",
+    multigraph: !0,
+    compound: !0,
+    // isCompound: true,
+    // acyclicer: 'greedy',
+    // ranker: 'longest-path'
+    ranksep: w ? 1 : b.edgeLengthFactor,
+    nodeSep: w ? 1 : 50,
+    ranker: "tight-tree",
+    // ranker: 'network-simplex'
+    isMultiGraph: !0
+  }), a.setDefaultEdgeLabel(function() {
+    return {};
+  });
+  const p = x.db.getStates(), o = x.db.getRelations(), g = Object.keys(p);
+  for (const r of g) {
+    const u = p[r];
+    d && (u.parentId = d);
+    let h;
+    if (u.doc) {
+      let y = i.append("g").attr("id", u.id).attr("class", "stateGroup");
+      h = A(u.doc, y, u.id, !c, n, l, x);
+      {
+        y = I(y, u, c);
+        let v = y.node().getBBox();
+        h.width = v.width, h.height = v.height + b.padding / 2, H[u.id] = { y: b.compositTitleSize };
+      }
+    } else
+      h = L(i, u, a);
+    if (u.note) {
+      const y = {
+        descriptions: [],
+        id: u.id + "-note",
+        note: u.note,
+        type: "note"
+      }, v = L(i, y, a);
+      u.note.position === "left of" ? (a.setNode(h.id + "-note", v), a.setNode(h.id, h)) : (a.setNode(h.id, h), a.setNode(h.id + "-note", v)), a.setParent(h.id, h.id + "-group"), a.setParent(h.id + "-note", h.id + "-group");
+    } else
+      a.setNode(h.id, h);
+  }
+  S.debug("Count=", a.nodeCount(), a);
+  let B = 0;
+  o.forEach(function(r) {
+    B++, S.debug("Setting edge", r), a.setEdge(
+      r.id1,
+      r.id2,
+      {
+        relation: r,
+        width: at(r.title),
+        height: b.labelHeight * z.getRows(r.title).length,
+        labelpos: "c"
+      },
+      "id" + B
+    );
+  }), J(a), S.debug("Graph after layout", a.nodes());
+  const m = i.node();
+  a.nodes().forEach(function(r) {
+    r !== void 0 && a.node(r) !== void 0 ? (S.warn("Node " + r + ": " + JSON.stringify(a.node(r))), n.select("#" + m.id + " #" + r).attr(
+      "transform",
+      "translate(" + (a.node(r).x - a.node(r).width / 2) + "," + (a.node(r).y + (H[r] ? H[r].y : 0) - a.node(r).height / 2) + " )"
+    ), n.select("#" + m.id + " #" + r).attr("data-x-shift", a.node(r).x - a.node(r).width / 2), l.querySelectorAll("#" + m.id + " #" + r + " .divider").forEach((h) => {
+      const y = h.parentElement;
+      let v = 0, M = 0;
+      y && (y.parentElement && (v = y.parentElement.getBBox().width), M = parseInt(y.getAttribute("data-x-shift"), 10), Number.isNaN(M) && (M = 0)), h.setAttribute("x1", 0 - M + 8), h.setAttribute("x2", v - M - 8);
+    })) : S.debug("No Node " + r + ": " + JSON.stringify(a.node(r)));
+  });
+  let E = m.getBBox();
+  a.edges().forEach(function(r) {
+    r !== void 0 && a.edge(r) !== void 0 && (S.debug("Edge " + r.v + " -> " + r.w + ": " + JSON.stringify(a.edge(r))), Q(i, a.edge(r), a.edge(r).relation));
+  }), E = m.getBBox();
+  const k = {
+    id: d || "root",
+    label: d || "root",
+    width: 0,
+    height: 0
+  };
+  return k.width = E.width + 2 * b.padding, k.height = E.height + 2 * b.padding, S.debug("Doc rendered", k, a), k;
+}, "renderDoc"), it = {
+  setConf: V,
+  draw: et
+}, ct = {
+  parser: R,
+  get db() {
+    return new N(1);
+  },
+  renderer: it,
+  styles: W,
+  init: /* @__PURE__ */ f((e) => {
+    e.state || (e.state = {}), e.state.arrowMarkerAbsolute = e.arrowMarkerAbsolute;
+  }, "init")
+};
+export {
+  ct as diagram
+};

package/dist/stateDiagram-v2-4FDKWEC3.js

@@ -1,10 +1,10 @@
-import { s as a, S as t, b as r, a as s } from "./chunk-DI55MBZ5.js";
-import { a1 as i } from "./CoachForm.js";
+import { s as t, S as a, b as r, a as s } from "./chunk-DI55MBZ5.js";
+import { _ as i } from "./CoachForm.js";
 import "./redux-toolkit.modern.js";
-var l = {
-  parser: a,
+var _ = {
+  parser: t,
   get db() {
-    return new t(2);
+    return new a(2);
   },
   renderer: r,
   styles: s,
@@ -13,5 +13,5 @@ var l = {
   }, "init")
 };
 export {
-  l as diagram
+  _ as diagram
 };

package/dist/stateDiagram-v2-4FDKWEC32.js

@@ -0,0 +1,17 @@
+import { s as a, S as t, b as r, a as s } from "./chunk-DI55MBZ52.js";
+import { aG as i } from "./CoachForm.js";
+import "./redux-toolkit.modern.js";
+var l = {
+  parser: a,
+  get db() {
+    return new t(2);
+  },
+  renderer: r,
+  styles: s,
+  init: /* @__PURE__ */ i((e) => {
+    e.state || (e.state = {}), e.state.arrowMarkerAbsolute = e.arrowMarkerAbsolute;
+  }, "init")
+};
+export {
+  l as diagram
+};

package/dist/storybook/Typography.stories.tsx

@@ -15,22 +15,13 @@ type Story = StoryObj<typeof meta>;
 export const Typography: Story = {
   args: {
     variant: "h1",
-    weight: "regular",
-    size: "md",
+    weight: "semibold",
     children: "Heading 1",
   },
   render: () => (
     <div className="space-y-8">
-      {/* Heading 1 Variations */}
+      {/* Heading 1 Variations - Only Medium & Semibold */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="h1" weight="light">
-          Heading 1
-          <br /> Light
-        </Component>
-        <Component variant="h1" weight="regular">
-          Heading 1
-          <br /> Regular
-        </Component>
         <Component variant="h1" weight="medium">
           Heading 1 <br />
           Medium
@@ -39,25 +30,13 @@ export const Typography: Story = {
           Heading 1 <br />
           Semibold
         </Component>
-        <Component variant="h1" weight="bold">
-          Heading 1 <br />
-          Bold
-        </Component>
         <Component variant="caption" className="text-gray-500">
-          32px / Line height: 32px
+          30px / Line height: 38px
         </Component>
       </div>
 
-      {/* Heading 2 Variations */}
+      {/* Heading 2 Variations - Only Medium & Semibold */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="h2" weight="light">
-          Heading 2 <br />
-          Light
-        </Component>
-        <Component variant="h2" weight="regular">
-          Heading 2 <br />
-          Regular
-        </Component>
         <Component variant="h2" weight="medium">
           Heading 2 <br />
           Medium
@@ -66,25 +45,13 @@ export const Typography: Story = {
           Heading 2 <br />
           Semibold
         </Component>
-        <Component variant="h2" weight="bold">
-          Heading 2 <br />
-          Bold
-        </Component>
         <Component variant="caption" className="text-gray-500">
           24px / Line height: 32px
         </Component>
       </div>
 
-      {/* Heading 3 Variations */}
+      {/* Heading 3 Variations - Only Medium & Semibold */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="h3" weight="light">
-          Heading 3 <br />
-          Light
-        </Component>
-        <Component variant="h3" weight="regular">
-          Heading 3 <br />
-          Regular
-        </Component>
         <Component variant="h3" weight="medium">
           Heading 3 <br />
           Medium
@@ -93,25 +60,13 @@ export const Typography: Story = {
           Heading 3 <br />
           Semibold
         </Component>
-        <Component variant="h3" weight="bold">
-          Heading 3 <br />
-          Bold
-        </Component>
         <Component variant="caption" className="text-gray-500">
-          18px / Line height: 26px
+          20px / Line height: 24px
         </Component>
       </div>
 
-      {/* Heading 4 Variations */}
+      {/* Heading 4 Variations - Only Medium & Semibold */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="h4" weight="light">
-          Heading 4 <br />
-          Light
-        </Component>
-        <Component variant="h4" weight="regular">
-          Heading 4 <br />
-          Regular
-        </Component>
         <Component variant="h4" weight="medium">
           Heading 4 <br />
           Medium
@@ -120,25 +75,13 @@ export const Typography: Story = {
           Heading 4 <br />
           Semibold
         </Component>
-        <Component variant="h4" weight="bold">
-          Heading 4 <br />
-          Bold
-        </Component>
         <Component variant="caption" className="text-gray-500">
           16px / Line height: 24px
         </Component>
       </div>
 
-      {/* Subheading Variations */}
+      {/* Subheading Variations - Only Medium & Semibold */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="subheading" weight="light">
-          Sub heading <br />
-          Light
-        </Component>
-        <Component variant="subheading" weight="regular">
-          Sub heading <br />
-          Regular
-        </Component>
         <Component variant="subheading" weight="medium">
           Sub heading <br />
           Medium
@@ -147,56 +90,140 @@ export const Typography: Story = {
           Sub heading <br />
           Semibold
         </Component>
-        <Component variant="subheading" weight="bold">
-          Sub heading <br />
-          Bold
-        </Component>
         <Component variant="caption" className="text-gray-500">
           14px / Line height: 20px
         </Component>
       </div>
 
-      {/* Body/Paragraph Example */}
+      {/* Body Text - Regular Weight */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="body" size="xs">
-          Body XS <br /> Regular
+        <Component variant="body" weight="regular" size="lg">
+          Body Large <br /> Regular
         </Component>
-        <Component variant="body" size="sm">
-          Body SM <br /> Regular
+        <Component variant="body" weight="regular" size="regular">
+          Body Regular <br /> Regular
         </Component>
-        <Component variant="body" size="md">
-          Body MD <br /> Regular
+        <Component variant="body" weight="regular" size="sm">
+          Body Small <br /> Regular
         </Component>
-        <Component variant="body" size="lg">
-          Body LG <br /> Regular
+        <Component variant="body" weight="regular" size="xs">
+          Body X-Small <br /> Regular
         </Component>
-        <Component variant="body" size="xl">
-          Body XL <br /> Regular
+        <Component weight="regular" size="xxs">
+          Body XX-Small <br /> Regular
         </Component>
         <Component variant="caption" className="text-gray-500">
-          14px, 10px, 8px | Line height: 18px, 16px, 14px
+          18px/24px, 16px/24px, 14px/20px, 12px/18px, 10px/14px
         </Component>
       </div>
 
-      {/* Caption Example */}
+      {/* Body Text - Medium Weight */}
       <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
-        <Component variant="caption" size="xs">
-          Caption XS <br /> Regular
+        <Component variant="body" weight="medium" size="lg">
+          Body Large <br /> Medium
+        </Component>
+        <Component variant="body" weight="medium" size="regular">
+          Body Regular <br /> Medium
         </Component>
-        <Component variant="caption" size="sm">
-          Caption SM <br /> Regular
+        <Component variant="body" weight="medium" size="sm">
+          Body Small <br /> Medium
         </Component>
-        <Component variant="caption" weight="medium" size="sm">
-          Caption SM <br /> Medium
+        <Component variant="body" weight="medium" size="xs">
+          Body X-Small <br /> Medium
+        </Component>
+        <Component variant="body" weight="medium" size="xxs">
+          Body XX-Small <br /> Medium
+        </Component>
+        <Component variant="caption" className="text-gray-500">
+          For emphasis, key values, important inline text
+        </Component>
+      </div>
+
+      {/* Caption - Base Size Only (8px/16px) */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="caption">
+          Caption <br /> Base Size
+        </Component>
+        <Component variant="caption" className="text-gray-500">
+          8px/16px - For extremely tiny metadata only
         </Component>
-        <Component variant="caption" weight="medium" size="md">
-          Caption MD <br /> Medium
+        <Component variant="caption" className="text-gray-500">
+          Note: For all other sizes, use variant=&quot;body&quot;
+        </Component>
+      </div>
+
+      {/* Semantic Variants Section Header */}
+      <div className="al-border-t-2 al-pt-8 al-mt-8">
+        <Component variant="h2" weight="semibold" className="al-mb-4">
+          Semantic Variants
+        </Component>
+        <Component variant="caption" className="text-gray-500 al-mb-4 al-block">
+          Pre-configured variants for consistent page structure. No weight/size props allowed.
+        </Component>
+      </div>
+
+      {/* Page Heading - Fixed H2 Semibold */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="page-heading">Page Heading</Component>
+        <Component variant="caption" className="text-gray-500">
+          H2 + Semibold (fixed) - Use for main page titles
+        </Component>
+      </div>
+
+      {/* Section Heading - Fixed H3 Medium */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="section-heading">Section Heading</Component>
+        <Component variant="caption" className="text-gray-500">
+          H3 + Medium (fixed) - Use for section titles within a page
+        </Component>
+      </div>
+
+      {/* Utilities Section Header */}
+      <div className="al-border-t-2 al-pt-8 al-mt-8">
+        <Component variant="h2" weight="semibold" className="al-mb-4">
+          Utility Variants
+        </Component>
+      </div>
+
+      {/* Button Text Utility - 3 sizes, fixed Medium weight */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="button" size="xs">
+          Button XS <br /> (12px/16px)
+        </Component>
+        <Component variant="button" size="sm">
+          Button SM <br /> (14px/20px)
+        </Component>
+        <Component variant="button" size="md">
+          Button MD <br /> (16px/24px)
+        </Component>
+        <Component variant="caption" className="text-gray-500">
+          Button text utility - Fixed Medium weight (500)
+        </Component>
+      </div>
+
+      {/* Table Header Utility - Fixed size, 2 weights */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="table-header" weight="medium">
+          Table Header <br /> Medium
+        </Component>
+        <Component variant="table-header" weight="semibold">
+          Table Header <br /> Semibold
+        </Component>
+        <Component variant="caption" className="text-gray-500">
+          12px/18px - For table column headers
+        </Component>
+      </div>
+
+      {/* Placeholder Utility - 2 sizes, fixed Regular weight, auto-italic */}
+      <div className="al-border al-flex al-justify-between al-p-4 al-my-2">
+        <Component variant="placeholder" size="regular">
+          Placeholder Regular <br /> (14px/20px)
         </Component>
-        <Component variant="caption" weight="medium" size="lg">
-          Caption LG <br /> Medium
+        <Component variant="placeholder" size="large">
+          Placeholder Large <br /> (16px/24px)
         </Component>
         <Component variant="caption" className="text-gray-500">
-          14px, 10px | Line height: 18px, 16px
+          Italic placeholder text - Fixed Regular weight (400)
         </Component>
       </div>
     </div>