@contractspec/example.learning-journey-ui-onboarding 1.57.0 → 1.58.0

package/dist/node/components/CodeSnippet.js

@@ -0,0 +1,65 @@
+// src/components/CodeSnippet.tsx
+import { useState } from "react";
+import { Button } from "@contractspec/lib.design-system";
+import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function CodeSnippet({
+  code,
+  language = "typescript",
+  title
+}) {
+  const [copied, setCopied] = useState(false);
+  const handleCopy = async () => {
+    await navigator.clipboard.writeText(code);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  };
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "bg-muted/50 overflow-hidden rounded-lg border",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "bg-muted flex items-center justify-between border-b px-4 py-2",
+        children: [
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "flex items-center gap-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("span", {
+                className: "text-muted-foreground text-xs font-medium uppercase",
+                children: language
+              }, undefined, false, undefined, this),
+              title && /* @__PURE__ */ jsxDEV(Fragment, {
+                children: [
+                  /* @__PURE__ */ jsxDEV("span", {
+                    className: "text-muted-foreground",
+                    children: "•"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("span", {
+                    className: "text-sm",
+                    children: title
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Button, {
+            variant: "ghost",
+            size: "sm",
+            onClick: handleCopy,
+            className: "h-7 text-xs",
+            children: copied ? "✓ Copied" : "Copy"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("pre", {
+        className: "overflow-x-auto p-4",
+        children: /* @__PURE__ */ jsxDEV("code", {
+          className: "text-sm",
+          children: code
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  CodeSnippet
+};

package/dist/node/components/JourneyMap.js

@@ -0,0 +1,59 @@
+// src/components/JourneyMap.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var SURFACE_ICONS = {
+  templates: "\uD83D\uDCCB",
+  "spec-editor": "✏️",
+  regenerator: "\uD83D\uDD04",
+  playground: "\uD83C\uDFAE",
+  evolution: "\uD83E\uDD16",
+  dashboard: "\uD83D\uDCCA",
+  settings: "⚙️",
+  default: "\uD83D\uDCCD"
+};
+function JourneyMap({
+  steps,
+  completedStepIds,
+  currentStepId
+}) {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "relative overflow-x-auto pb-4",
+    children: /* @__PURE__ */ jsxDEV("div", {
+      className: "flex min-w-max items-center gap-2",
+      children: steps.map((step, index) => {
+        const isCompleted = completedStepIds.includes(step.id);
+        const isCurrent = step.id === currentStepId;
+        const surface = step.metadata?.surface ?? "default";
+        const icon = SURFACE_ICONS[surface] ?? SURFACE_ICONS.default;
+        return /* @__PURE__ */ jsxDEV("div", {
+          className: "flex items-center",
+          children: [
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex flex-col items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV("div", {
+                  className: cn("flex h-14 w-14 items-center justify-center rounded-2xl border-2 text-2xl transition-all", isCompleted && "border-green-500 bg-green-500/10", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/10 ring-4 ring-violet-500/20", !isCompleted && !isCurrent && "border-muted bg-muted/50"),
+                  children: isCompleted ? "✓" : icon
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("div", {
+                  className: "text-center",
+                  children: /* @__PURE__ */ jsxDEV("p", {
+                    className: cn("max-w-[100px] truncate text-xs font-medium", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-violet-500", !isCompleted && !isCurrent && "text-muted-foreground"),
+                    children: step.title
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            index < steps.length - 1 && /* @__PURE__ */ jsxDEV("div", {
+              className: cn("mx-2 h-1 w-8 rounded-full transition-colors", completedStepIds.includes(steps[index + 1]?.id ?? "") ? "bg-green-500" : isCompleted ? "bg-green-500/50" : "bg-muted")
+            }, undefined, false, undefined, this)
+          ]
+        }, step.id, true, undefined, this);
+      })
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+export {
+  JourneyMap
+};

package/dist/node/components/StepChecklist.js

@@ -0,0 +1,97 @@
+// src/components/StepChecklist.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { cn } from "@contractspec/lib.ui-kit-core";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function StepChecklist({
+  step,
+  stepNumber,
+  isCompleted,
+  isCurrent,
+  isExpanded,
+  onToggle,
+  onComplete
+}) {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: cn("rounded-xl border transition-all", isCompleted && "border-green-500/50 bg-green-500/5", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/5", !isCompleted && !isCurrent && "border-border"),
+    children: [
+      /* @__PURE__ */ jsxDEV("button", {
+        type: "button",
+        className: "flex w-full items-center gap-4 p-4 text-left",
+        onClick: onToggle,
+        children: [
+          /* @__PURE__ */ jsxDEV("div", {
+            className: cn("flex h-8 w-8 shrink-0 items-center justify-center rounded-full border-2 text-sm font-semibold transition-colors", isCompleted && "border-green-500 bg-green-500 text-white", isCurrent && !isCompleted && "border-violet-500 text-violet-500", !isCompleted && !isCurrent && "border-muted-foreground text-muted-foreground"),
+            children: isCompleted ? "✓" : stepNumber
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "min-w-0 flex-1",
+            children: [
+              /* @__PURE__ */ jsxDEV("h4", {
+                className: cn("font-semibold", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-foreground", !isCompleted && !isCurrent && "text-muted-foreground"),
+                children: step.title
+              }, undefined, false, undefined, this),
+              !isExpanded && step.description && /* @__PURE__ */ jsxDEV("p", {
+                className: "text-muted-foreground truncate text-sm",
+                children: step.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          step.xpReward && /* @__PURE__ */ jsxDEV("span", {
+            className: cn("shrink-0 rounded-full px-2 py-1 text-xs font-semibold", isCompleted ? "bg-green-500/10 text-green-500" : "bg-muted text-muted-foreground"),
+            children: [
+              "+",
+              step.xpReward,
+              " XP"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("span", {
+            className: cn("shrink-0 transition-transform", isExpanded && "rotate-180"),
+            children: "▼"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      isExpanded && /* @__PURE__ */ jsxDEV("div", {
+        className: "border-t px-4 py-4",
+        children: [
+          step.description && /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground mb-4",
+            children: step.description
+          }, undefined, false, undefined, this),
+          step.instructions && /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-muted mb-4 rounded-lg p-4",
+            children: [
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "mb-2 text-sm font-medium",
+                children: "Instructions:"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "text-muted-foreground text-sm",
+                children: step.instructions
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "flex flex-wrap gap-2",
+            children: [
+              step.actionUrl && /* @__PURE__ */ jsxDEV(Button, {
+                variant: "outline",
+                size: "sm",
+                onClick: () => window.open(step.actionUrl, "_blank"),
+                children: step.actionLabel ?? "Try it"
+              }, undefined, false, undefined, this),
+              !isCompleted && /* @__PURE__ */ jsxDEV(Button, {
+                size: "sm",
+                onClick: onComplete,
+                children: "Mark as Complete"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  StepChecklist
+};

package/dist/node/components/index.js

@@ -0,0 +1,219 @@
+// src/components/StepChecklist.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { cn } from "@contractspec/lib.ui-kit-core";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function StepChecklist({
+  step,
+  stepNumber,
+  isCompleted,
+  isCurrent,
+  isExpanded,
+  onToggle,
+  onComplete
+}) {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: cn("rounded-xl border transition-all", isCompleted && "border-green-500/50 bg-green-500/5", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/5", !isCompleted && !isCurrent && "border-border"),
+    children: [
+      /* @__PURE__ */ jsxDEV("button", {
+        type: "button",
+        className: "flex w-full items-center gap-4 p-4 text-left",
+        onClick: onToggle,
+        children: [
+          /* @__PURE__ */ jsxDEV("div", {
+            className: cn("flex h-8 w-8 shrink-0 items-center justify-center rounded-full border-2 text-sm font-semibold transition-colors", isCompleted && "border-green-500 bg-green-500 text-white", isCurrent && !isCompleted && "border-violet-500 text-violet-500", !isCompleted && !isCurrent && "border-muted-foreground text-muted-foreground"),
+            children: isCompleted ? "✓" : stepNumber
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "min-w-0 flex-1",
+            children: [
+              /* @__PURE__ */ jsxDEV("h4", {
+                className: cn("font-semibold", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-foreground", !isCompleted && !isCurrent && "text-muted-foreground"),
+                children: step.title
+              }, undefined, false, undefined, this),
+              !isExpanded && step.description && /* @__PURE__ */ jsxDEV("p", {
+                className: "text-muted-foreground truncate text-sm",
+                children: step.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          step.xpReward && /* @__PURE__ */ jsxDEV("span", {
+            className: cn("shrink-0 rounded-full px-2 py-1 text-xs font-semibold", isCompleted ? "bg-green-500/10 text-green-500" : "bg-muted text-muted-foreground"),
+            children: [
+              "+",
+              step.xpReward,
+              " XP"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("span", {
+            className: cn("shrink-0 transition-transform", isExpanded && "rotate-180"),
+            children: "▼"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      isExpanded && /* @__PURE__ */ jsxDEV("div", {
+        className: "border-t px-4 py-4",
+        children: [
+          step.description && /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground mb-4",
+            children: step.description
+          }, undefined, false, undefined, this),
+          step.instructions && /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-muted mb-4 rounded-lg p-4",
+            children: [
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "mb-2 text-sm font-medium",
+                children: "Instructions:"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "text-muted-foreground text-sm",
+                children: step.instructions
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "flex flex-wrap gap-2",
+            children: [
+              step.actionUrl && /* @__PURE__ */ jsxDEV(Button, {
+                variant: "outline",
+                size: "sm",
+                onClick: () => window.open(step.actionUrl, "_blank"),
+                children: step.actionLabel ?? "Try it"
+              }, undefined, false, undefined, this),
+              !isCompleted && /* @__PURE__ */ jsxDEV(Button, {
+                size: "sm",
+                onClick: onComplete,
+                children: "Mark as Complete"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/JourneyMap.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 SURFACE_ICONS = {
+  templates: "\uD83D\uDCCB",
+  "spec-editor": "✏️",
+  regenerator: "\uD83D\uDD04",
+  playground: "\uD83C\uDFAE",
+  evolution: "\uD83E\uDD16",
+  dashboard: "\uD83D\uDCCA",
+  settings: "⚙️",
+  default: "\uD83D\uDCCD"
+};
+function JourneyMap({
+  steps,
+  completedStepIds,
+  currentStepId
+}) {
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: "relative overflow-x-auto pb-4",
+    children: /* @__PURE__ */ jsxDEV2("div", {
+      className: "flex min-w-max items-center gap-2",
+      children: steps.map((step, index) => {
+        const isCompleted = completedStepIds.includes(step.id);
+        const isCurrent = step.id === currentStepId;
+        const surface = step.metadata?.surface ?? "default";
+        const icon = SURFACE_ICONS[surface] ?? SURFACE_ICONS.default;
+        return /* @__PURE__ */ jsxDEV2("div", {
+          className: "flex items-center",
+          children: [
+            /* @__PURE__ */ jsxDEV2("div", {
+              className: "flex flex-col items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV2("div", {
+                  className: cn2("flex h-14 w-14 items-center justify-center rounded-2xl border-2 text-2xl transition-all", isCompleted && "border-green-500 bg-green-500/10", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/10 ring-4 ring-violet-500/20", !isCompleted && !isCurrent && "border-muted bg-muted/50"),
+                  children: isCompleted ? "✓" : icon
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV2("div", {
+                  className: "text-center",
+                  children: /* @__PURE__ */ jsxDEV2("p", {
+                    className: cn2("max-w-[100px] truncate text-xs font-medium", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-violet-500", !isCompleted && !isCurrent && "text-muted-foreground"),
+                    children: step.title
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            index < steps.length - 1 && /* @__PURE__ */ jsxDEV2("div", {
+              className: cn2("mx-2 h-1 w-8 rounded-full transition-colors", completedStepIds.includes(steps[index + 1]?.id ?? "") ? "bg-green-500" : isCompleted ? "bg-green-500/50" : "bg-muted")
+            }, undefined, false, undefined, this)
+          ]
+        }, step.id, true, undefined, this);
+      })
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+
+// src/components/CodeSnippet.tsx
+import { useState } from "react";
+import { Button as Button2 } from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV3, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function CodeSnippet({
+  code,
+  language = "typescript",
+  title
+}) {
+  const [copied, setCopied] = useState(false);
+  const handleCopy = async () => {
+    await navigator.clipboard.writeText(code);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  };
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "bg-muted/50 overflow-hidden rounded-lg border",
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "bg-muted flex items-center justify-between border-b px-4 py-2",
+        children: [
+          /* @__PURE__ */ jsxDEV3("div", {
+            className: "flex items-center gap-2",
+            children: [
+              /* @__PURE__ */ jsxDEV3("span", {
+                className: "text-muted-foreground text-xs font-medium uppercase",
+                children: language
+              }, undefined, false, undefined, this),
+              title && /* @__PURE__ */ jsxDEV3(Fragment, {
+                children: [
+                  /* @__PURE__ */ jsxDEV3("span", {
+                    className: "text-muted-foreground",
+                    children: "•"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV3("span", {
+                    className: "text-sm",
+                    children: title
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3(Button2, {
+            variant: "ghost",
+            size: "sm",
+            onClick: handleCopy,
+            className: "h-7 text-xs",
+            children: copied ? "✓ Copied" : "Copy"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("pre", {
+        className: "overflow-x-auto p-4",
+        children: /* @__PURE__ */ jsxDEV3("code", {
+          className: "text-sm",
+          children: code
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  StepChecklist,
+  JourneyMap,
+  CodeSnippet
+};

package/dist/node/docs/index.js

@@ -0,0 +1,22 @@
+// src/docs/learning-journey-ui-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-onboarding",
+    title: "Learning Journey UI — Onboarding",
+    summary: "UI mini-app components for onboarding: checklists, snippets, and journey mapping.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-onboarding",
+    tags: ["learning", "ui", "onboarding"],
+    body: `## Includes
+- Onboarding mini-app shell
+- Views: overview, steps, progress, timeline
+- Components: step checklist, code snippet, journey map
+
+## Notes
+- Compose with design system components.
+- Ensure accessible labels and keyboard navigation.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/docs/learning-journey-ui-onboarding.docblock.js

@@ -0,0 +1,22 @@
+// src/docs/learning-journey-ui-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-onboarding",
+    title: "Learning Journey UI — Onboarding",
+    summary: "UI mini-app components for onboarding: checklists, snippets, and journey mapping.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-onboarding",
+    tags: ["learning", "ui", "onboarding"],
+    body: `## Includes
+- Onboarding mini-app shell
+- Views: overview, steps, progress, timeline
+- Components: step checklist, code snippet, journey map
+
+## Notes
+- Compose with design system components.
+- Ensure accessible labels and keyboard navigation.`
+  }
+];
+registerDocBlocks(blocks);

package/dist/node/example.js

@@ -0,0 +1,32 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "learning-journey-ui-onboarding",
+    version: "1.0.0",
+    title: "Learning Journey UI — Onboarding",
+    description: "UI mini-app for onboarding patterns: checklists, code snippets, journey map.",
+    kind: "ui",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "ui", "onboarding"]
+  },
+  docs: {
+    rootDocId: "docs.examples.learning-journey-ui-onboarding"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-ui-onboarding",
+    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
+};