@contractspec/bundle.library 1.12.0 → 1.13.0

package/dist/presentation/features/templates/FeatureEventDetailTemplate/index.js

@@ -1,3 +1,304 @@
-import { FeatureEventDetailTemplate } from "./FeatureEventDetailTemplate.js";
+// @bun
+// src/presentation/features/hooks/useRelatedDocs.ts
+import { useMemo } from "react";
+import { defaultDocRegistry } from "@contractspec/lib.contracts";
+"use client";
+function useRelatedDocs(key, tags) {
+  const docs = useMemo(() => {
+    try {
+      const allDocs = defaultDocRegistry.list();
+      return allDocs.filter(({ block }) => {
+        const keyMatch = block.id.toLowerCase().includes(key.toLowerCase()) || block.title.toLowerCase().includes(key.toLowerCase());
+        const tagMatch = tags?.some((t) => block.tags?.some((bt) => bt.toLowerCase().includes(t.toLowerCase())));
+        return keyMatch || tagMatch;
+      }).map(({ block, route }) => ({
+        id: block.id,
+        title: block.title,
+        summary: block.summary,
+        route
+      }));
+    } catch (e) {
+      console.error("Failed to fetch related docs:", e);
+      return [];
+    }
+  }, [key, tags]);
+  return docs;
+}
 
-export { FeatureEventDetailTemplate };
+// src/presentation/features/templates/FeatureEventDetailTemplate/FeatureEventDetailTemplate.tsx
+import {
+  Breadcrumbs,
+  CodeBlock,
+  EmptyState,
+  PageHeaderResponsive,
+  StatusChip
+} from "@contractspec/lib.design-system";
+import { Card } from "@contractspec/lib.ui-kit-web/ui/card";
+import { Box, HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { BookOpen, Code, Database, Radio } from "lucide-react";
+import Link from "next/link";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function FeatureEventDetailTemplate({
+  feature,
+  eventKey,
+  event,
+  spec,
+  className
+}) {
+  const eventRef = event ?? feature.events?.find((ev) => ev.key === eventKey);
+  const relatedDocs = useRelatedDocs(eventRef?.key || "", spec?.meta?.tags);
+  if (!eventRef) {
+    return /* @__PURE__ */ jsxDEV(VStack, {
+      gap: "lg",
+      className: cn("mx-auto w-full max-w-5xl p-6", className),
+      children: [
+        /* @__PURE__ */ jsxDEV(PageHeaderResponsive, {
+          title: "Event Not Found",
+          subtitle: `Event ${eventKey} not found in feature ${feature.meta.key}`,
+          breadcrumb: /* @__PURE__ */ jsxDEV(Breadcrumbs, {
+            items: [
+              { label: "Features", href: "/features" },
+              {
+                label: feature.meta.title || feature.meta.key,
+                href: `/features/${feature.meta.key}`
+              },
+              {
+                label: "Events",
+                href: `/features/${feature.meta.key}/events`
+              }
+            ]
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(EmptyState, {
+          title: "Event not found",
+          description: `The event '${eventKey}' could not be found in this feature.`,
+          icon: /* @__PURE__ */ jsxDEV(Radio, {
+            className: "text-muted-foreground h-12 w-12"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV(VStack, {
+    gap: "lg",
+    className: cn("mx-auto w-full max-w-5xl p-6", className),
+    children: [
+      /* @__PURE__ */ jsxDEV(PageHeaderResponsive, {
+        title: eventRef.key,
+        subtitle: `Event defined in ${feature.meta.title ?? feature.meta.key}`,
+        breadcrumb: /* @__PURE__ */ jsxDEV(Breadcrumbs, {
+          items: [
+            { label: "Features", href: "/features" },
+            {
+              label: feature.meta.title || feature.meta.key,
+              href: `/features/${feature.meta.key}`
+            },
+            { label: "Events", href: `/features/${feature.meta.key}#events` },
+            { label: eventRef.key }
+          ]
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV(HStack, {
+        gap: "sm",
+        children: [
+          /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: "neutral",
+            label: eventRef.key,
+            size: "sm",
+            icon: /* @__PURE__ */ jsxDEV(Radio, {
+              className: "h-3 w-3"
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: "neutral",
+            label: `v${eventRef.version}`,
+            size: "sm"
+          }, undefined, false, undefined, this),
+          spec?.meta?.stability ? /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: spec.meta.stability === "stable" ? "success" : "warning",
+            label: spec.meta.stability,
+            size: "sm"
+          }, undefined, false, undefined, this) : null
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "grid grid-cols-1 gap-6 lg:grid-cols-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "space-y-6 lg:col-span-2",
+            children: /* @__PURE__ */ jsxDEV(Card, {
+              className: "p-6",
+              children: /* @__PURE__ */ jsxDEV(VStack, {
+                gap: "md",
+                children: [
+                  /* @__PURE__ */ jsxDEV(HStack, {
+                    className: "items-center gap-2 border-b pb-2",
+                    children: [
+                      /* @__PURE__ */ jsxDEV(Code, {
+                        className: "text-muted-foreground h-5 w-5"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("h3", {
+                        className: "text-lg font-semibold",
+                        children: "Payload Definition"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
+                  spec ? /* @__PURE__ */ jsxDEV(VStack, {
+                    gap: "lg",
+                    children: [
+                      spec.meta.description && /* @__PURE__ */ jsxDEV("p", {
+                        className: "text-muted-foreground",
+                        children: spec.meta.description
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV(Box, {
+                        className: "flex-col gap-2",
+                        children: [
+                          /* @__PURE__ */ jsxDEV("span", {
+                            className: "text-muted-foreground text-sm font-medium tracking-wider uppercase",
+                            children: "Payload Schema"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV(CodeBlock, {
+                            code: JSON.stringify(spec.payload, null, 2),
+                            language: "json"
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this) : /* @__PURE__ */ jsxDEV(VStack, {
+                    gap: "md",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("p", {
+                        className: "text-muted-foreground",
+                        children: "Full payload details are not available for this event reference."
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV(CodeBlock, {
+                        code: JSON.stringify(eventRef, null, 2),
+                        language: "json"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "space-y-6",
+            children: /* @__PURE__ */ jsxDEV(Card, {
+              className: "p-6",
+              children: /* @__PURE__ */ jsxDEV(VStack, {
+                gap: "md",
+                children: [
+                  /* @__PURE__ */ jsxDEV(HStack, {
+                    className: "items-center gap-2 border-b pb-2",
+                    children: [
+                      /* @__PURE__ */ jsxDEV(Database, {
+                        className: "text-muted-foreground h-5 w-5"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("h3", {
+                        className: "text-lg font-semibold",
+                        children: "Metadata"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV("dl", {
+                    className: "grid grid-cols-1 gap-4 text-sm",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("div", {
+                        children: [
+                          /* @__PURE__ */ jsxDEV("dt", {
+                            className: "text-muted-foreground",
+                            children: "Key"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV("dd", {
+                            className: "truncate font-medium",
+                            children: eventRef.key
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this),
+                      /* @__PURE__ */ jsxDEV("div", {
+                        children: [
+                          /* @__PURE__ */ jsxDEV("dt", {
+                            className: "text-muted-foreground",
+                            children: "Version"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV("dd", {
+                            className: "font-medium",
+                            children: eventRef.version
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this),
+                      spec?.meta?.owners && /* @__PURE__ */ jsxDEV("div", {
+                        children: [
+                          /* @__PURE__ */ jsxDEV("dt", {
+                            className: "text-muted-foreground",
+                            children: "Owners"
+                          }, undefined, false, undefined, this),
+                          /* @__PURE__ */ jsxDEV("dd", {
+                            className: "flex flex-wrap gap-1 font-medium",
+                            children: spec.meta.owners.map((o) => /* @__PURE__ */ jsxDEV(StatusChip, {
+                              label: o,
+                              size: "sm",
+                              tone: "neutral"
+                            }, o, false, undefined, this))
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          relatedDocs?.length ? /* @__PURE__ */ jsxDEV("div", {
+            className: "lg:col-span-3",
+            children: /* @__PURE__ */ jsxDEV(Card, {
+              className: "p-6",
+              children: /* @__PURE__ */ jsxDEV(VStack, {
+                gap: "md",
+                children: [
+                  /* @__PURE__ */ jsxDEV(HStack, {
+                    className: "items-center gap-2 border-b pb-2",
+                    children: [
+                      /* @__PURE__ */ jsxDEV(BookOpen, {
+                        className: "text-muted-foreground h-5 w-5"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("h3", {
+                        className: "text-lg font-semibold",
+                        children: "Related Documentation"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3",
+                    children: relatedDocs.map((doc) => /* @__PURE__ */ jsxDEV(Link, {
+                      href: doc.route || `/docs/${doc.id}`,
+                      className: "group block",
+                      children: /* @__PURE__ */ jsxDEV("div", {
+                        className: "hover:border-primary h-full rounded-lg border p-4 transition-colors",
+                        children: [
+                          /* @__PURE__ */ jsxDEV("h4", {
+                            className: "group-hover:text-primary mb-1 font-semibold",
+                            children: doc.title
+                          }, undefined, false, undefined, this),
+                          doc.summary && /* @__PURE__ */ jsxDEV("p", {
+                            className: "text-muted-foreground line-clamp-2 text-sm",
+                            children: doc.summary
+                          }, undefined, false, undefined, this)
+                        ]
+                      }, undefined, true, undefined, this)
+                    }, doc.id, false, undefined, this))
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this) : null
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  FeatureEventDetailTemplate
+};

package/dist/presentation/features/templates/FeatureEventDetailTemplate/types.d.ts

@@ -1,14 +1,10 @@
-import { EventRef, FeatureModuleSpec } from "@contractspec/lib.contracts/features";
-import { SerializedEventSpec } from "@contractspec/lib.contracts/serialization";
-
-//#region src/presentation/features/templates/FeatureEventDetailTemplate/types.d.ts
-interface FeatureEventDetailTemplateProps {
-  feature: FeatureModuleSpec;
-  eventKey: string;
-  event?: EventRef;
-  spec?: SerializedEventSpec;
-  className?: string;
+import type { EventRef, FeatureModuleSpec } from '@contractspec/lib.contracts/features';
+import type { SerializedEventSpec } from '@contractspec/lib.contracts/serialization';
+export interface FeatureEventDetailTemplateProps {
+    feature: FeatureModuleSpec;
+    eventKey: string;
+    event?: EventRef;
+    spec?: SerializedEventSpec;
+    className?: string;
 }
-//#endregion
-export { FeatureEventDetailTemplateProps };
 //# sourceMappingURL=types.d.ts.map

package/dist/presentation/features/templates/FeatureEventDetailTemplate/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../src/presentation/features/templates/FeatureEventDetailTemplate/types.ts"],"mappings":";;;;UAMiB,+BAAA;EACf,OAAA,EAAS,iBAAA;EACT,QAAA;EACA,KAAA,GAAQ,QAAA;EACR,IAAA,GAAO,mBAAA;EACP,SAAA;AAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/features/templates/FeatureEventDetailTemplate/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EAClB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/presentation/features/templates/FeatureEventDetailTemplate/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.d.ts

@@ -1,11 +1,3 @@
-import { FeatureListTemplateProps } from "../types.js";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-
-//#region src/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.d.ts
-declare function FeatureEventsTemplate({
-  feature,
-  className
-}: FeatureListTemplateProps): react_jsx_runtime0.JSX.Element;
-//#endregion
-export { FeatureEventsTemplate };
+import type { FeatureListTemplateProps } from '../types';
+export declare function FeatureEventsTemplate({ feature, className, }: FeatureListTemplateProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=FeatureEventsTemplate.d.ts.map

package/dist/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureEventsTemplate.d.ts","names":[],"sources":["../../../../../src/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.tsx"],"mappings":";;;;iBAWgB,qBAAA,CAAA;EACd,OAAA;EACA;AAAA,GACC,wBAAA,GAAwB,kBAAA,CAAA,GAAA,CAAA,OAAA"}
+{"version":3,"file":"FeatureEventsTemplate.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/features/templates/FeatureEventsTemplate/FeatureEventsTemplate.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAGzD,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,SAAS,GACV,EAAE,wBAAwB,2CAsB1B"}