@contractspec/example.learning-journey-ui-shared 1.57.0 → 1.59.0

package/.turbo/turbo-build.log

@@ -1,54 +1,53 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-ui-shared/tsdown.config.js 
-ℹ entry: src/example.ts, src/index.ts, src/types.ts, src/components/BadgeDisplay.tsx, src/components/StreakCounter.tsx, src/components/ViewTabs.tsx, src/components/XpBar.tsx, src/components/index.ts, src/docs/index.ts, src/docs/learning-journey-ui-shared.docblock.ts, src/hooks/index.ts, src/hooks/useLearningProgress.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/hooks/useLearningProgress.js                     2.54 kB │ gzip: 0.90 kB
-ℹ dist/components/BadgeDisplay.js                       1.51 kB │ gzip: 0.78 kB
-ℹ dist/components/XpBar.js                              1.31 kB │ gzip: 0.63 kB
-ℹ dist/components/StreakCounter.js                      1.11 kB │ gzip: 0.59 kB
-ℹ dist/components/ViewTabs.js                           1.10 kB │ gzip: 0.59 kB
-ℹ dist/example.js                                       0.90 kB │ gzip: 0.50 kB
-ℹ dist/docs/learning-journey-ui-shared.docblock.js      0.77 kB │ gzip: 0.45 kB
-ℹ dist/index.js                                         0.50 kB │ gzip: 0.20 kB
-ℹ dist/components/index.js                              0.24 kB │ gzip: 0.12 kB
-ℹ dist/hooks/index.js                                   0.10 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.js                                    0.05 kB │ gzip: 0.07 kB
-ℹ dist/types.js                                         0.00 kB │ gzip: 0.02 kB
-ℹ dist/hooks/useLearningProgress.js.map                 4.65 kB │ gzip: 1.63 kB
-ℹ dist/components/BadgeDisplay.js.map                   2.37 kB │ gzip: 1.14 kB
-ℹ dist/components/XpBar.js.map                          1.92 kB │ gzip: 0.90 kB
-ℹ dist/components/ViewTabs.js.map                       1.82 kB │ gzip: 0.87 kB
-ℹ dist/components/StreakCounter.js.map                  1.64 kB │ gzip: 0.79 kB
-ℹ dist/example.js.map                                   1.36 kB │ gzip: 0.69 kB
-ℹ dist/docs/learning-journey-ui-shared.docblock.js.map  1.09 kB │ gzip: 0.60 kB
-ℹ dist/types.d.ts.map                                   0.67 kB │ gzip: 0.28 kB
-ℹ dist/components/XpBar.d.ts.map                        0.21 kB │ gzip: 0.17 kB
-ℹ dist/components/StreakCounter.d.ts.map                0.21 kB │ gzip: 0.16 kB
-ℹ dist/components/BadgeDisplay.d.ts.map                 0.21 kB │ gzip: 0.17 kB
-ℹ dist/components/ViewTabs.d.ts.map                     0.20 kB │ gzip: 0.16 kB
-ℹ dist/hooks/useLearningProgress.d.ts.map               0.18 kB │ gzip: 0.15 kB
-ℹ dist/example.d.ts.map                                 0.13 kB │ gzip: 0.13 kB
-ℹ dist/types.d.ts                                       1.70 kB │ gzip: 0.61 kB
-ℹ dist/index.d.ts                                       0.81 kB │ gzip: 0.25 kB
-ℹ dist/hooks/useLearningProgress.d.ts                   0.72 kB │ gzip: 0.35 kB
-ℹ dist/components/StreakCounter.d.ts                    0.35 kB │ gzip: 0.23 kB
-ℹ dist/components/BadgeDisplay.d.ts                     0.35 kB │ gzip: 0.23 kB
-ℹ dist/components/ViewTabs.d.ts                         0.34 kB │ gzip: 0.23 kB
-ℹ dist/components/XpBar.d.ts                            0.32 kB │ gzip: 0.23 kB
-ℹ dist/example.d.ts                                     0.25 kB │ gzip: 0.17 kB
-ℹ dist/components/index.d.ts                            0.24 kB │ gzip: 0.12 kB
-ℹ dist/hooks/index.d.ts                                 0.10 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.d.ts                                  0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/learning-journey-ui-shared.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 38 files, total: 32.00 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - tsdown:external (78%)
-  - rolldown-plugin-dts:generate (20%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=12
+Bundled 12 modules in 33ms
 
-✔ Build complete in 27495ms
+  components/BadgeDisplay.js                    1.79 KB   (entry point)
+  ./index.js                                    10.32 KB  (entry point)
+  hooks/index.js                                2.49 KB   (entry point)
+  hooks/useLearningProgress.js                  2.49 KB   (entry point)
+  ./types.js                                    8 bytes   (entry point)
+  components/index.js                           6.24 KB   (entry point)
+  components/StreakCounter.js                   1.29 KB   (entry point)
+  components/ViewTabs.js                        1.36 KB   (entry point)
+  components/XpBar.js                           1.79 KB   (entry point)
+  docs/index.js                                 0.73 KB   (entry point)
+  docs/learning-journey-ui-shared.docblock.js   0.73 KB   (entry point)
+  ./example.js                                  0.91 KB   (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=12
+Bundled 12 modules in 16ms
+
+  components/BadgeDisplay.js                    1.78 KB   (entry point)
+  ./index.js                                    10.30 KB  (entry point)
+  hooks/index.js                                2.48 KB   (entry point)
+  hooks/useLearningProgress.js                  2.48 KB   (entry point)
+  ./types.js                                    0 KB      (entry point)
+  components/index.js                           6.23 KB   (entry point)
+  components/StreakCounter.js                   1.28 KB   (entry point)
+  components/ViewTabs.js                        1.35 KB   (entry point)
+  components/XpBar.js                           1.78 KB   (entry point)
+  docs/index.js                                 0.72 KB   (entry point)
+  docs/learning-journey-ui-shared.docblock.js   0.72 KB   (entry point)
+  ./example.js                                  0.90 KB   (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=12
+Bundled 12 modules in 15ms
+
+  components/BadgeDisplay.js                    1.78 KB   (entry point)
+  ./index.js                                    10.30 KB  (entry point)
+  hooks/index.js                                2.48 KB   (entry point)
+  hooks/useLearningProgress.js                  2.48 KB   (entry point)
+  ./types.js                                    0 KB      (entry point)
+  components/index.js                           6.23 KB   (entry point)
+  components/StreakCounter.js                   1.28 KB   (entry point)
+  components/ViewTabs.js                        1.35 KB   (entry point)
+  components/XpBar.js                           1.78 KB   (entry point)
+  docs/index.js                                 0.72 KB   (entry point)
+  docs/learning-journey-ui-shared.docblock.js   0.72 KB   (entry point)
+  ./example.js                                  0.90 KB   (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @contractspec/example.learning-journey-ui-shared
 
+## 1.59.0
+
+### Minor Changes
+
+- 1a0cf44: fix: publishConfig not supported by bun
+
+### Patch Changes
+
+- Updated dependencies [1a0cf44]
+  - @contractspec/module.learning-journey@1.59.0
+  - @contractspec/lib.design-system@1.59.0
+  - @contractspec/lib.ui-kit-web@1.59.0
+  - @contractspec/lib.contracts@1.59.0
+
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/module.learning-journey@1.58.0
+  - @contractspec/lib.design-system@1.58.0
+  - @contractspec/lib.ui-kit-web@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/components/BadgeDisplay.js

@@ -0,0 +1,54 @@
+// src/components/BadgeDisplay.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var BADGE_ICONS = {
+  studio_first_30m: "\uD83C\uDFAF",
+  platform_tour: "\uD83D\uDDFA️",
+  crm_first_win: "\uD83C\uDFC6",
+  drill_master: "\uD83E\uDDE0",
+  coach_listener: "\uD83D\uDC42",
+  quest_complete: "⭐",
+  streak_7: "\uD83D\uDD25",
+  streak_30: "\uD83D\uDC8E",
+  default: "\uD83C\uDFC5"
+};
+var sizeStyles = {
+  sm: "h-6 w-6 text-sm",
+  md: "h-8 w-8 text-base",
+  lg: "h-10 w-10 text-lg"
+};
+function BadgeDisplay({
+  badges,
+  maxVisible = 5,
+  size = "md"
+}) {
+  const visibleBadges = badges.slice(0, maxVisible);
+  const hiddenCount = badges.length - maxVisible;
+  if (badges.length === 0) {
+    return /* @__PURE__ */ jsxDEV("div", {
+      className: "text-muted-foreground text-sm",
+      children: "No badges earned yet"
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "flex items-center gap-1",
+    children: [
+      visibleBadges.map((badge) => /* @__PURE__ */ jsxDEV("div", {
+        className: cn("flex items-center justify-center rounded-full bg-gradient-to-br from-amber-400/20 to-amber-600/20", sizeStyles[size]),
+        title: badge.replace(/_/g, " "),
+        children: BADGE_ICONS[badge] ?? BADGE_ICONS.default
+      }, badge, false, undefined, this)),
+      hiddenCount > 0 && /* @__PURE__ */ jsxDEV("div", {
+        className: cn("text-muted-foreground bg-muted flex items-center justify-center rounded-full", sizeStyles[size], "text-xs font-medium"),
+        children: [
+          "+",
+          hiddenCount
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  BadgeDisplay
+};

package/dist/browser/components/StreakCounter.js

@@ -0,0 +1,50 @@
+// src/components/StreakCounter.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var sizeStyles = {
+  sm: {
+    container: "gap-1 px-2 py-1",
+    icon: "text-base",
+    text: "text-xs"
+  },
+  md: {
+    container: "gap-1.5 px-3 py-1.5",
+    icon: "text-lg",
+    text: "text-sm"
+  },
+  lg: {
+    container: "gap-2 px-4 py-2",
+    icon: "text-xl",
+    text: "text-base"
+  }
+};
+function StreakCounter({
+  days,
+  isActive = true,
+  size = "md"
+}) {
+  const styles = sizeStyles[size];
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: cn("inline-flex items-center rounded-full font-semibold", styles.container, isActive ? "bg-orange-500/10 text-orange-500" : "bg-muted text-muted-foreground"),
+    children: [
+      /* @__PURE__ */ jsxDEV("span", {
+        className: styles.icon,
+        role: "img",
+        "aria-label": "streak",
+        children: "\uD83D\uDD25"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("span", {
+        className: styles.text,
+        children: [
+          days,
+          " ",
+          days === 1 ? "day" : "days"
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  StreakCounter
+};

package/dist/browser/components/ViewTabs.js

@@ -0,0 +1,46 @@
+// src/components/ViewTabs.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var VIEW_LABELS = {
+  overview: { label: "Overview", icon: "\uD83D\uDCCA" },
+  steps: { label: "Steps", icon: "\uD83D\uDCDD" },
+  progress: { label: "Progress", icon: "\uD83D\uDCC8" },
+  timeline: { label: "Timeline", icon: "\uD83D\uDCC5" }
+};
+var DEFAULT_VIEWS = [
+  "overview",
+  "steps",
+  "progress",
+  "timeline"
+];
+function ViewTabs({
+  currentView,
+  onViewChange,
+  availableViews = DEFAULT_VIEWS
+}) {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "flex flex-wrap gap-2",
+    children: availableViews.map((view) => {
+      const { label, icon } = VIEW_LABELS[view];
+      const isActive = currentView === view;
+      return /* @__PURE__ */ jsxDEV(Button, {
+        variant: isActive ? "default" : "outline",
+        size: "sm",
+        onClick: () => onViewChange(view),
+        className: "gap-1.5",
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            children: icon
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("span", {
+            children: label
+          }, undefined, false, undefined, this)
+        ]
+      }, view, true, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+export {
+  ViewTabs
+};

package/dist/browser/components/XpBar.js

@@ -0,0 +1,62 @@
+// src/components/XpBar.tsx
+import { Progress } from "@contractspec/lib.ui-kit-web/ui/progress";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var sizeStyles = {
+  sm: "h-2",
+  md: "h-3",
+  lg: "h-4"
+};
+var labelSizeStyles = {
+  sm: "text-xs",
+  md: "text-sm",
+  lg: "text-base"
+};
+function XpBar({
+  current,
+  max,
+  level,
+  showLabel = true,
+  size = "md"
+}) {
+  const percentage = max > 0 ? Math.min(current / max * 100, 100) : 0;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "w-full space-y-1",
+    children: [
+      showLabel && /* @__PURE__ */ jsxDEV("div", {
+        className: cn("flex items-center justify-between", labelSizeStyles[size]),
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "text-muted-foreground font-medium",
+            children: [
+              level !== undefined && /* @__PURE__ */ jsxDEV("span", {
+                className: "text-primary mr-1",
+                children: [
+                  "Lvl ",
+                  level
+                ]
+              }, undefined, true, undefined, this),
+              "XP"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "font-semibold",
+            children: [
+              current.toLocaleString(),
+              " / ",
+              max.toLocaleString()
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Progress, {
+        value: percentage,
+        className: cn("bg-muted", sizeStyles[size])
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  XpBar
+};

package/dist/browser/components/index.js

@@ -0,0 +1,209 @@
+// src/components/BadgeDisplay.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var BADGE_ICONS = {
+  studio_first_30m: "\uD83C\uDFAF",
+  platform_tour: "\uD83D\uDDFA️",
+  crm_first_win: "\uD83C\uDFC6",
+  drill_master: "\uD83E\uDDE0",
+  coach_listener: "\uD83D\uDC42",
+  quest_complete: "⭐",
+  streak_7: "\uD83D\uDD25",
+  streak_30: "\uD83D\uDC8E",
+  default: "\uD83C\uDFC5"
+};
+var sizeStyles = {
+  sm: "h-6 w-6 text-sm",
+  md: "h-8 w-8 text-base",
+  lg: "h-10 w-10 text-lg"
+};
+function BadgeDisplay({
+  badges,
+  maxVisible = 5,
+  size = "md"
+}) {
+  const visibleBadges = badges.slice(0, maxVisible);
+  const hiddenCount = badges.length - maxVisible;
+  if (badges.length === 0) {
+    return /* @__PURE__ */ jsxDEV("div", {
+      className: "text-muted-foreground text-sm",
+      children: "No badges earned yet"
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "flex items-center gap-1",
+    children: [
+      visibleBadges.map((badge) => /* @__PURE__ */ jsxDEV("div", {
+        className: cn("flex items-center justify-center rounded-full bg-gradient-to-br from-amber-400/20 to-amber-600/20", sizeStyles[size]),
+        title: badge.replace(/_/g, " "),
+        children: BADGE_ICONS[badge] ?? BADGE_ICONS.default
+      }, badge, false, undefined, this)),
+      hiddenCount > 0 && /* @__PURE__ */ jsxDEV("div", {
+        className: cn("text-muted-foreground bg-muted flex items-center justify-center rounded-full", sizeStyles[size], "text-xs font-medium"),
+        children: [
+          "+",
+          hiddenCount
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/StreakCounter.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 sizeStyles2 = {
+  sm: {
+    container: "gap-1 px-2 py-1",
+    icon: "text-base",
+    text: "text-xs"
+  },
+  md: {
+    container: "gap-1.5 px-3 py-1.5",
+    icon: "text-lg",
+    text: "text-sm"
+  },
+  lg: {
+    container: "gap-2 px-4 py-2",
+    icon: "text-xl",
+    text: "text-base"
+  }
+};
+function StreakCounter({
+  days,
+  isActive = true,
+  size = "md"
+}) {
+  const styles = sizeStyles2[size];
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: cn2("inline-flex items-center rounded-full font-semibold", styles.container, isActive ? "bg-orange-500/10 text-orange-500" : "bg-muted text-muted-foreground"),
+    children: [
+      /* @__PURE__ */ jsxDEV2("span", {
+        className: styles.icon,
+        role: "img",
+        "aria-label": "streak",
+        children: "\uD83D\uDD25"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2("span", {
+        className: styles.text,
+        children: [
+          days,
+          " ",
+          days === 1 ? "day" : "days"
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/ViewTabs.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+"use client";
+var VIEW_LABELS = {
+  overview: { label: "Overview", icon: "\uD83D\uDCCA" },
+  steps: { label: "Steps", icon: "\uD83D\uDCDD" },
+  progress: { label: "Progress", icon: "\uD83D\uDCC8" },
+  timeline: { label: "Timeline", icon: "\uD83D\uDCC5" }
+};
+var DEFAULT_VIEWS = [
+  "overview",
+  "steps",
+  "progress",
+  "timeline"
+];
+function ViewTabs({
+  currentView,
+  onViewChange,
+  availableViews = DEFAULT_VIEWS
+}) {
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "flex flex-wrap gap-2",
+    children: availableViews.map((view) => {
+      const { label, icon } = VIEW_LABELS[view];
+      const isActive = currentView === view;
+      return /* @__PURE__ */ jsxDEV3(Button, {
+        variant: isActive ? "default" : "outline",
+        size: "sm",
+        onClick: () => onViewChange(view),
+        className: "gap-1.5",
+        children: [
+          /* @__PURE__ */ jsxDEV3("span", {
+            children: icon
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3("span", {
+            children: label
+          }, undefined, false, undefined, this)
+        ]
+      }, view, true, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+
+// src/components/XpBar.tsx
+import { Progress } from "@contractspec/lib.ui-kit-web/ui/progress";
+import { cn as cn3 } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+"use client";
+var sizeStyles3 = {
+  sm: "h-2",
+  md: "h-3",
+  lg: "h-4"
+};
+var labelSizeStyles = {
+  sm: "text-xs",
+  md: "text-sm",
+  lg: "text-base"
+};
+function XpBar({
+  current,
+  max,
+  level,
+  showLabel = true,
+  size = "md"
+}) {
+  const percentage = max > 0 ? Math.min(current / max * 100, 100) : 0;
+  return /* @__PURE__ */ jsxDEV4("div", {
+    className: "w-full space-y-1",
+    children: [
+      showLabel && /* @__PURE__ */ jsxDEV4("div", {
+        className: cn3("flex items-center justify-between", labelSizeStyles[size]),
+        children: [
+          /* @__PURE__ */ jsxDEV4("span", {
+            className: "text-muted-foreground font-medium",
+            children: [
+              level !== undefined && /* @__PURE__ */ jsxDEV4("span", {
+                className: "text-primary mr-1",
+                children: [
+                  "Lvl ",
+                  level
+                ]
+              }, undefined, true, undefined, this),
+              "XP"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV4("span", {
+            className: "font-semibold",
+            children: [
+              current.toLocaleString(),
+              " / ",
+              max.toLocaleString()
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV4(Progress, {
+        value: percentage,
+        className: cn3("bg-muted", sizeStyles3[size])
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  XpBar,
+  ViewTabs,
+  StreakCounter,
+  BadgeDisplay
+};

package/dist/browser/docs/index.js

@@ -0,0 +1,21 @@
+// src/docs/learning-journey-ui-shared.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-shared",
+    title: "Learning Journey UI — Shared",
+    summary: "Shared UI components and hooks for learning journey mini-apps.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-shared",
+    tags: ["learning", "ui", "shared"],
+    body: `## Includes
+- Hooks: useLearningProgress
+- Components: XpBar, StreakCounter, BadgeDisplay, ViewTabs
+
+## Notes
+- Keep components accessible (labels, focus, contrast).
+- Prefer design-system tokens and components.`
+  }
+];
+registerDocBlocks(blocks);

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

@@ -0,0 +1,21 @@
+// src/docs/learning-journey-ui-shared.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-shared",
+    title: "Learning Journey UI — Shared",
+    summary: "Shared UI components and hooks for learning journey mini-apps.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-shared",
+    tags: ["learning", "ui", "shared"],
+    body: `## Includes
+- Hooks: useLearningProgress
+- Components: XpBar, StreakCounter, BadgeDisplay, ViewTabs
+
+## Notes
+- Keep components accessible (labels, focus, contrast).
+- Prefer design-system tokens and components.`
+  }
+];
+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-shared",
+    version: "1.0.0",
+    title: "Learning Journey UI — Shared",
+    description: "Shared UI components and hooks for learning journey mini-apps.",
+    kind: "ui",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "ui", "shared"]
+  },
+  docs: {
+    rootDocId: "docs.examples.learning-journey-ui-shared"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-ui-shared",
+    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
+};