@contractspec/example.learning-journey-ui-gamified 1.56.1 → 1.58.0

package/dist/browser/components/DayCalendar.js

@@ -0,0 +1,42 @@
+// src/components/DayCalendar.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function DayCalendar({
+  totalDays,
+  currentDay,
+  completedDays
+}) {
+  const days = Array.from({ length: totalDays }, (_, i) => i + 1);
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "grid grid-cols-7 gap-2",
+    children: days.map((day) => {
+      const isCompleted = completedDays.includes(day);
+      const isCurrent = day === currentDay;
+      const isLocked = day > currentDay;
+      return /* @__PURE__ */ jsxDEV("div", {
+        className: cn("flex h-12 w-12 flex-col items-center justify-center rounded-lg border text-sm font-medium transition-all", isCompleted && "border-green-500 bg-green-500/10 text-green-500", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/10 text-violet-500 ring-2 ring-violet-500/50", isLocked && "border-muted bg-muted/50 text-muted-foreground", !isCompleted && !isCurrent && !isLocked && "border-border bg-card"),
+        children: isCompleted ? /* @__PURE__ */ jsxDEV("span", {
+          className: "text-lg",
+          children: "✓"
+        }, undefined, false, undefined, this) : isLocked ? /* @__PURE__ */ jsxDEV("span", {
+          className: "text-lg",
+          children: "\uD83D\uDD12"
+        }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(Fragment, {
+          children: [
+            /* @__PURE__ */ jsxDEV("span", {
+              className: "text-muted-foreground text-xs",
+              children: "Day"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV("span", {
+              children: day
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, day, false, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+export {
+  DayCalendar
+};

package/dist/browser/components/FlashCard.js

@@ -0,0 +1,102 @@
+// src/components/FlashCard.tsx
+import { useState } from "react";
+import { Button } from "@contractspec/lib.design-system";
+import { Card, CardContent } from "@contractspec/lib.ui-kit-web/ui/card";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function FlashCard({
+  step,
+  isCompleted,
+  isCurrent,
+  onComplete
+}) {
+  const [isFlipped, setIsFlipped] = useState(false);
+  return /* @__PURE__ */ jsxDEV(Card, {
+    className: cn("relative cursor-pointer overflow-hidden transition-all duration-300", isCurrent && "ring-primary ring-2", isCompleted && "opacity-60"),
+    onClick: () => !isCompleted && setIsFlipped(!isFlipped),
+    children: /* @__PURE__ */ jsxDEV(CardContent, {
+      className: "p-6",
+      children: [
+        /* @__PURE__ */ jsxDEV("div", {
+          className: cn("space-y-4 transition-opacity duration-200", isFlipped ? "opacity-0" : "opacity-100"),
+          children: [
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex items-start justify-between",
+              children: [
+                /* @__PURE__ */ jsxDEV("div", {
+                  className: "flex-1",
+                  children: [
+                    /* @__PURE__ */ jsxDEV("h3", {
+                      className: "text-lg font-semibold",
+                      children: step.title
+                    }, undefined, false, undefined, this),
+                    step.description && /* @__PURE__ */ jsxDEV("p", {
+                      className: "text-muted-foreground mt-1 text-sm",
+                      children: step.description
+                    }, undefined, false, undefined, this)
+                  ]
+                }, undefined, true, undefined, this),
+                step.xpReward && /* @__PURE__ */ jsxDEV("span", {
+                  className: "rounded-full bg-green-500/10 px-2 py-1 text-xs font-semibold text-green-500",
+                  children: [
+                    "+",
+                    step.xpReward,
+                    " XP"
+                  ]
+                }, undefined, true, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            isCompleted && /* @__PURE__ */ jsxDEV("div", {
+              className: "flex items-center gap-2 text-green-500",
+              children: [
+                /* @__PURE__ */ jsxDEV("span", {
+                  children: "✓"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("span", {
+                  className: "text-sm font-medium",
+                  children: "Completed"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            isCurrent && !isCompleted && /* @__PURE__ */ jsxDEV("p", {
+              className: "text-muted-foreground text-xs",
+              children: "Tap to reveal action"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        isFlipped && !isCompleted && /* @__PURE__ */ jsxDEV("div", {
+          className: "absolute inset-0 flex flex-col items-center justify-center gap-4 bg-gradient-to-br from-violet-500/10 to-violet-600/10 p-6",
+          children: [
+            /* @__PURE__ */ jsxDEV("p", {
+              className: "text-center text-sm",
+              children: step.instructions ?? "Complete this step to earn XP"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV(Button, {
+                  variant: "outline",
+                  size: "sm",
+                  onClick: () => setIsFlipped(false),
+                  children: "Back"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV(Button, {
+                  size: "sm",
+                  onClick: (e) => {
+                    e.stopPropagation();
+                    onComplete?.();
+                  },
+                  children: "Mark Complete"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+export {
+  FlashCard
+};

package/dist/browser/components/MasteryRing.js

@@ -0,0 +1,75 @@
+// src/components/MasteryRing.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var sizeStyles = {
+  sm: { container: "h-16 w-16", text: "text-xs", ring: 48, stroke: 4 },
+  md: { container: "h-24 w-24", text: "text-sm", ring: 72, stroke: 6 },
+  lg: { container: "h-32 w-32", text: "text-base", ring: 96, stroke: 8 }
+};
+var colorStyles = {
+  green: "stroke-green-500",
+  blue: "stroke-blue-500",
+  violet: "stroke-violet-500",
+  orange: "stroke-orange-500"
+};
+function MasteryRing({
+  label,
+  percentage,
+  size = "md",
+  color = "violet"
+}) {
+  const styles = sizeStyles[size];
+  const radius = (styles.ring - styles.stroke) / 2;
+  const circumference = 2 * Math.PI * radius;
+  const strokeDashoffset = circumference - percentage / 100 * circumference;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: cn("relative flex flex-col items-center gap-1", styles.container),
+    children: [
+      /* @__PURE__ */ jsxDEV("svg", {
+        className: "absolute -rotate-90",
+        width: styles.ring,
+        height: styles.ring,
+        viewBox: `0 0 ${styles.ring} ${styles.ring}`,
+        children: [
+          /* @__PURE__ */ jsxDEV("circle", {
+            cx: styles.ring / 2,
+            cy: styles.ring / 2,
+            r: radius,
+            fill: "none",
+            strokeWidth: styles.stroke,
+            className: "stroke-muted"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("circle", {
+            cx: styles.ring / 2,
+            cy: styles.ring / 2,
+            r: radius,
+            fill: "none",
+            strokeWidth: styles.stroke,
+            strokeLinecap: "round",
+            strokeDasharray: circumference,
+            strokeDashoffset,
+            className: cn("transition-all duration-500", colorStyles[color])
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex h-full flex-col items-center justify-center",
+        children: /* @__PURE__ */ jsxDEV("span", {
+          className: cn("font-bold", styles.text),
+          children: [
+            Math.round(percentage),
+            "%"
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("span", {
+        className: cn("text-muted-foreground mt-1 truncate", styles.text),
+        children: label
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  MasteryRing
+};

package/dist/browser/components/index.js

@@ -0,0 +1,217 @@
+// src/components/FlashCard.tsx
+import { useState } from "react";
+import { Button } from "@contractspec/lib.design-system";
+import { Card, CardContent } from "@contractspec/lib.ui-kit-web/ui/card";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function FlashCard({
+  step,
+  isCompleted,
+  isCurrent,
+  onComplete
+}) {
+  const [isFlipped, setIsFlipped] = useState(false);
+  return /* @__PURE__ */ jsxDEV(Card, {
+    className: cn("relative cursor-pointer overflow-hidden transition-all duration-300", isCurrent && "ring-primary ring-2", isCompleted && "opacity-60"),
+    onClick: () => !isCompleted && setIsFlipped(!isFlipped),
+    children: /* @__PURE__ */ jsxDEV(CardContent, {
+      className: "p-6",
+      children: [
+        /* @__PURE__ */ jsxDEV("div", {
+          className: cn("space-y-4 transition-opacity duration-200", isFlipped ? "opacity-0" : "opacity-100"),
+          children: [
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex items-start justify-between",
+              children: [
+                /* @__PURE__ */ jsxDEV("div", {
+                  className: "flex-1",
+                  children: [
+                    /* @__PURE__ */ jsxDEV("h3", {
+                      className: "text-lg font-semibold",
+                      children: step.title
+                    }, undefined, false, undefined, this),
+                    step.description && /* @__PURE__ */ jsxDEV("p", {
+                      className: "text-muted-foreground mt-1 text-sm",
+                      children: step.description
+                    }, undefined, false, undefined, this)
+                  ]
+                }, undefined, true, undefined, this),
+                step.xpReward && /* @__PURE__ */ jsxDEV("span", {
+                  className: "rounded-full bg-green-500/10 px-2 py-1 text-xs font-semibold text-green-500",
+                  children: [
+                    "+",
+                    step.xpReward,
+                    " XP"
+                  ]
+                }, undefined, true, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            isCompleted && /* @__PURE__ */ jsxDEV("div", {
+              className: "flex items-center gap-2 text-green-500",
+              children: [
+                /* @__PURE__ */ jsxDEV("span", {
+                  children: "✓"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("span", {
+                  className: "text-sm font-medium",
+                  children: "Completed"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            isCurrent && !isCompleted && /* @__PURE__ */ jsxDEV("p", {
+              className: "text-muted-foreground text-xs",
+              children: "Tap to reveal action"
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        isFlipped && !isCompleted && /* @__PURE__ */ jsxDEV("div", {
+          className: "absolute inset-0 flex flex-col items-center justify-center gap-4 bg-gradient-to-br from-violet-500/10 to-violet-600/10 p-6",
+          children: [
+            /* @__PURE__ */ jsxDEV("p", {
+              className: "text-center text-sm",
+              children: step.instructions ?? "Complete this step to earn XP"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV(Button, {
+                  variant: "outline",
+                  size: "sm",
+                  onClick: () => setIsFlipped(false),
+                  children: "Back"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV(Button, {
+                  size: "sm",
+                  onClick: (e) => {
+                    e.stopPropagation();
+                    onComplete?.();
+                  },
+                  children: "Mark Complete"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      ]
+    }, undefined, true, undefined, this)
+  }, undefined, false, undefined, this);
+}
+
+// src/components/MasteryRing.tsx
+import { cn as cn2 } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+var sizeStyles = {
+  sm: { container: "h-16 w-16", text: "text-xs", ring: 48, stroke: 4 },
+  md: { container: "h-24 w-24", text: "text-sm", ring: 72, stroke: 6 },
+  lg: { container: "h-32 w-32", text: "text-base", ring: 96, stroke: 8 }
+};
+var colorStyles = {
+  green: "stroke-green-500",
+  blue: "stroke-blue-500",
+  violet: "stroke-violet-500",
+  orange: "stroke-orange-500"
+};
+function MasteryRing({
+  label,
+  percentage,
+  size = "md",
+  color = "violet"
+}) {
+  const styles = sizeStyles[size];
+  const radius = (styles.ring - styles.stroke) / 2;
+  const circumference = 2 * Math.PI * radius;
+  const strokeDashoffset = circumference - percentage / 100 * circumference;
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: cn2("relative flex flex-col items-center gap-1", styles.container),
+    children: [
+      /* @__PURE__ */ jsxDEV2("svg", {
+        className: "absolute -rotate-90",
+        width: styles.ring,
+        height: styles.ring,
+        viewBox: `0 0 ${styles.ring} ${styles.ring}`,
+        children: [
+          /* @__PURE__ */ jsxDEV2("circle", {
+            cx: styles.ring / 2,
+            cy: styles.ring / 2,
+            r: radius,
+            fill: "none",
+            strokeWidth: styles.stroke,
+            className: "stroke-muted"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2("circle", {
+            cx: styles.ring / 2,
+            cy: styles.ring / 2,
+            r: radius,
+            fill: "none",
+            strokeWidth: styles.stroke,
+            strokeLinecap: "round",
+            strokeDasharray: circumference,
+            strokeDashoffset,
+            className: cn2("transition-all duration-500", colorStyles[color])
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "flex h-full flex-col items-center justify-center",
+        children: /* @__PURE__ */ jsxDEV2("span", {
+          className: cn2("font-bold", styles.text),
+          children: [
+            Math.round(percentage),
+            "%"
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("span", {
+        className: cn2("text-muted-foreground mt-1 truncate", styles.text),
+        children: label
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/DayCalendar.tsx
+import { cn as cn3 } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV3, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function DayCalendar({
+  totalDays,
+  currentDay,
+  completedDays
+}) {
+  const days = Array.from({ length: totalDays }, (_, i) => i + 1);
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "grid grid-cols-7 gap-2",
+    children: days.map((day) => {
+      const isCompleted = completedDays.includes(day);
+      const isCurrent = day === currentDay;
+      const isLocked = day > currentDay;
+      return /* @__PURE__ */ jsxDEV3("div", {
+        className: cn3("flex h-12 w-12 flex-col items-center justify-center rounded-lg border text-sm font-medium transition-all", isCompleted && "border-green-500 bg-green-500/10 text-green-500", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/10 text-violet-500 ring-2 ring-violet-500/50", isLocked && "border-muted bg-muted/50 text-muted-foreground", !isCompleted && !isCurrent && !isLocked && "border-border bg-card"),
+        children: isCompleted ? /* @__PURE__ */ jsxDEV3("span", {
+          className: "text-lg",
+          children: "✓"
+        }, undefined, false, undefined, this) : isLocked ? /* @__PURE__ */ jsxDEV3("span", {
+          className: "text-lg",
+          children: "\uD83D\uDD12"
+        }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV3(Fragment, {
+          children: [
+            /* @__PURE__ */ jsxDEV3("span", {
+              className: "text-muted-foreground text-xs",
+              children: "Day"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV3("span", {
+              children: day
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, day, false, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+export {
+  MasteryRing,
+  FlashCard,
+  DayCalendar
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,22 @@
+// src/docs/learning-journey-ui-gamified.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-gamified",
+    title: "Learning Journey UI — Gamified",
+    summary: "UI mini-app components for gamified learning: flashcards, mastery, streak/calendar.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-gamified",
+    tags: ["learning", "ui", "gamified"],
+    body: `## Includes
+- Gamified mini-app shell
+- Views: overview, steps, progress, timeline
+- Components: flash card, mastery ring, day calendar
+
+## Notes
+- Compose with design system components.
+- Respect prefers-reduced-motion; keep tap targets large.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/docs/learning-journey-ui-gamified.docblock.js

@@ -0,0 +1,22 @@
+// src/docs/learning-journey-ui-gamified.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-gamified",
+    title: "Learning Journey UI — Gamified",
+    summary: "UI mini-app components for gamified learning: flashcards, mastery, streak/calendar.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-gamified",
+    tags: ["learning", "ui", "gamified"],
+    body: `## Includes
+- Gamified mini-app shell
+- Views: overview, steps, progress, timeline
+- Components: flash card, mastery ring, day calendar
+
+## Notes
+- Compose with design system components.
+- Respect prefers-reduced-motion; keep tap targets large.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/browser/example.js

@@ -0,0 +1,32 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "learning-journey-ui-gamified",
+    version: "1.0.0",
+    title: "Learning Journey UI — Gamified",
+    description: "UI mini-app for gamified learning: flashcards, mastery ring, calendar.",
+    kind: "ui",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "ui", "gamified"]
+  },
+  docs: {
+    rootDocId: "docs.examples.learning-journey-ui-gamified"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-ui-gamified",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["playground", "markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};