@contractspec/bundle.library 1.11.1 → 1.13.0

package/dist/node/presentation/features/templates/FeatureOperationsTemplate/FeatureOperationsTemplate.js

@@ -0,0 +1,214 @@
+// src/features/contracts-registry.ts
+import {
+  OperationSpecRegistry,
+  EventRegistry
+} from "@contractspec/lib.contracts";
+import { PresentationRegistry } from "@contractspec/lib.contracts/presentations";
+import { DataViewRegistry } from "@contractspec/lib.contracts/data-views";
+import { FormRegistry } from "@contractspec/lib.contracts/forms";
+import {
+  serializeOperationSpec,
+  serializeEventSpec,
+  serializePresentationSpec,
+  serializeDataViewSpec,
+  serializeFormSpec
+} from "@contractspec/lib.contracts/serialization";
+import {
+  ContractReferenceDataView,
+  ContractReferenceQuery,
+  DocsGeneratedEvent,
+  DocsGenerateCommand,
+  DocsIndexDataView,
+  DocsIndexQuery,
+  DocsLayoutPresentation,
+  DocsPublishedEvent,
+  DocsPublishCommand,
+  DocsReferencePagePresentation,
+  DocsSearchForm,
+  ExampleCatalogDataView
+} from "@contractspec/lib.contracts/docs";
+var operationRegistry = null;
+function createContractSpecOperationRegistry() {
+  const registry = new OperationSpecRegistry;
+  registry.register(DocsIndexQuery).register(ContractReferenceQuery).register(DocsGenerateCommand).register(DocsPublishCommand);
+  return registry;
+}
+function getContractSpecOperationRegistry() {
+  if (!operationRegistry) {
+    operationRegistry = createContractSpecOperationRegistry();
+  }
+  return operationRegistry;
+}
+function resolveOperationSpec(key, version) {
+  return getContractSpecOperationRegistry().get(key, version);
+}
+var eventRegistry = null;
+function createContractSpecEventRegistry() {
+  const registry = new EventRegistry;
+  registry.register(DocsGeneratedEvent).register(DocsPublishedEvent);
+  return registry;
+}
+function getContractSpecEventRegistry() {
+  if (!eventRegistry) {
+    eventRegistry = createContractSpecEventRegistry();
+  }
+  return eventRegistry;
+}
+function resolveEventSpec(key, version) {
+  return getContractSpecEventRegistry().get(key, version);
+}
+var presentationRegistry = null;
+function createContractSpecPresentationRegistry() {
+  const registry = new PresentationRegistry;
+  registry.register(DocsLayoutPresentation).register(DocsReferencePagePresentation);
+  return registry;
+}
+function getContractSpecPresentationRegistry() {
+  if (!presentationRegistry) {
+    presentationRegistry = createContractSpecPresentationRegistry();
+  }
+  return presentationRegistry;
+}
+function resolvePresentationSpec(key, version) {
+  return getContractSpecPresentationRegistry().get(key, version);
+}
+var dataViewRegistry = null;
+function createContractSpecDataViewRegistry() {
+  const registry = new DataViewRegistry;
+  registry.register(DocsIndexDataView).register(ContractReferenceDataView).register(ExampleCatalogDataView);
+  return registry;
+}
+function getContractSpecDataViewRegistry() {
+  if (!dataViewRegistry) {
+    dataViewRegistry = createContractSpecDataViewRegistry();
+  }
+  return dataViewRegistry;
+}
+function resolveDataViewSpec(key, version) {
+  return getContractSpecDataViewRegistry().get(key, version);
+}
+var formRegistry = null;
+function createContractSpecFormRegistry() {
+  const registry = new FormRegistry;
+  registry.register(DocsSearchForm);
+  return registry;
+}
+function getContractSpecFormRegistry() {
+  if (!formRegistry) {
+    formRegistry = createContractSpecFormRegistry();
+  }
+  return formRegistry;
+}
+function resolveFormSpec(key, _version) {
+  return getContractSpecFormRegistry().get(key);
+}
+function resolveSerializedOperationSpec(key, version) {
+  const spec = resolveOperationSpec(key, version);
+  return serializeOperationSpec(spec) ?? undefined;
+}
+function resolveSerializedEventSpec(key, version) {
+  const spec = resolveEventSpec(key, version);
+  return serializeEventSpec(spec) ?? undefined;
+}
+function resolveSerializedPresentationSpec(key, version) {
+  const spec = resolvePresentationSpec(key, version);
+  return serializePresentationSpec(spec) ?? undefined;
+}
+function resolveSerializedDataViewSpec(key, version) {
+  const spec = resolveDataViewSpec(key, version);
+  return serializeDataViewSpec(spec) ?? undefined;
+}
+function resolveSerializedFormSpec(key, version) {
+  const spec = resolveFormSpec(key, version);
+  return serializeFormSpec(spec) ?? undefined;
+}
+function resetContractSpecOperationRegistry() {
+  operationRegistry = null;
+}
+function resetContractSpecEventRegistry() {
+  eventRegistry = null;
+}
+function resetContractSpecPresentationRegistry() {
+  presentationRegistry = null;
+}
+function resetContractSpecDataViewRegistry() {
+  dataViewRegistry = null;
+}
+function resetContractSpecFormRegistry() {
+  formRegistry = null;
+}
+function resetAllContractSpecRegistries() {
+  resetContractSpecOperationRegistry();
+  resetContractSpecEventRegistry();
+  resetContractSpecPresentationRegistry();
+  resetContractSpecDataViewRegistry();
+  resetContractSpecFormRegistry();
+}
+
+// src/presentation/features/organisms/FeatureOperationsList.tsx
+import { EntityCard } from "@contractspec/lib.design-system";
+import { Zap } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function FeatureOperationsList({
+  feature
+}) {
+  if (!feature.operations?.length)
+    return null;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3",
+    children: feature.operations.map((op) => {
+      const spec = resolveSerializedOperationSpec(op.key, op.version);
+      return /* @__PURE__ */ jsxDEV(EntityCard, {
+        cardTitle: op.key,
+        cardSubtitle: `v${op.version}`,
+        footer: spec?.meta.description,
+        icon: /* @__PURE__ */ jsxDEV(Zap, {
+          className: "h-4 w-4"
+        }, undefined, false, undefined, this),
+        href: `/features/${feature.meta.key}/operations/${op.key}`
+      }, op.key, false, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+
+// src/presentation/features/templates/FeatureOperationsTemplate/FeatureOperationsTemplate.tsx
+import {
+  Breadcrumbs,
+  PageHeaderResponsive
+} from "@contractspec/lib.design-system";
+import { VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function FeatureOperationsTemplate({
+  feature,
+  className
+}) {
+  return /* @__PURE__ */ jsxDEV2(VStack, {
+    gap: "lg",
+    className: cn("mx-auto w-full max-w-5xl p-6", className),
+    children: [
+      /* @__PURE__ */ jsxDEV2(PageHeaderResponsive, {
+        title: "Operations",
+        subtitle: `Operations defined in ${feature.meta.title ?? feature.meta.key}`,
+        breadcrumb: /* @__PURE__ */ jsxDEV2(Breadcrumbs, {
+          items: [
+            { label: "Features", href: "/features" },
+            {
+              label: feature.meta.title || feature.meta.key,
+              href: `/features/${feature.meta.key}`
+            },
+            { label: "Operations" }
+          ]
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2(FeatureOperationsList, {
+        feature
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  FeatureOperationsTemplate
+};

package/dist/node/presentation/features/templates/FeatureOperationsTemplate/index.js

@@ -0,0 +1,214 @@
+// src/features/contracts-registry.ts
+import {
+  OperationSpecRegistry,
+  EventRegistry
+} from "@contractspec/lib.contracts";
+import { PresentationRegistry } from "@contractspec/lib.contracts/presentations";
+import { DataViewRegistry } from "@contractspec/lib.contracts/data-views";
+import { FormRegistry } from "@contractspec/lib.contracts/forms";
+import {
+  serializeOperationSpec,
+  serializeEventSpec,
+  serializePresentationSpec,
+  serializeDataViewSpec,
+  serializeFormSpec
+} from "@contractspec/lib.contracts/serialization";
+import {
+  ContractReferenceDataView,
+  ContractReferenceQuery,
+  DocsGeneratedEvent,
+  DocsGenerateCommand,
+  DocsIndexDataView,
+  DocsIndexQuery,
+  DocsLayoutPresentation,
+  DocsPublishedEvent,
+  DocsPublishCommand,
+  DocsReferencePagePresentation,
+  DocsSearchForm,
+  ExampleCatalogDataView
+} from "@contractspec/lib.contracts/docs";
+var operationRegistry = null;
+function createContractSpecOperationRegistry() {
+  const registry = new OperationSpecRegistry;
+  registry.register(DocsIndexQuery).register(ContractReferenceQuery).register(DocsGenerateCommand).register(DocsPublishCommand);
+  return registry;
+}
+function getContractSpecOperationRegistry() {
+  if (!operationRegistry) {
+    operationRegistry = createContractSpecOperationRegistry();
+  }
+  return operationRegistry;
+}
+function resolveOperationSpec(key, version) {
+  return getContractSpecOperationRegistry().get(key, version);
+}
+var eventRegistry = null;
+function createContractSpecEventRegistry() {
+  const registry = new EventRegistry;
+  registry.register(DocsGeneratedEvent).register(DocsPublishedEvent);
+  return registry;
+}
+function getContractSpecEventRegistry() {
+  if (!eventRegistry) {
+    eventRegistry = createContractSpecEventRegistry();
+  }
+  return eventRegistry;
+}
+function resolveEventSpec(key, version) {
+  return getContractSpecEventRegistry().get(key, version);
+}
+var presentationRegistry = null;
+function createContractSpecPresentationRegistry() {
+  const registry = new PresentationRegistry;
+  registry.register(DocsLayoutPresentation).register(DocsReferencePagePresentation);
+  return registry;
+}
+function getContractSpecPresentationRegistry() {
+  if (!presentationRegistry) {
+    presentationRegistry = createContractSpecPresentationRegistry();
+  }
+  return presentationRegistry;
+}
+function resolvePresentationSpec(key, version) {
+  return getContractSpecPresentationRegistry().get(key, version);
+}
+var dataViewRegistry = null;
+function createContractSpecDataViewRegistry() {
+  const registry = new DataViewRegistry;
+  registry.register(DocsIndexDataView).register(ContractReferenceDataView).register(ExampleCatalogDataView);
+  return registry;
+}
+function getContractSpecDataViewRegistry() {
+  if (!dataViewRegistry) {
+    dataViewRegistry = createContractSpecDataViewRegistry();
+  }
+  return dataViewRegistry;
+}
+function resolveDataViewSpec(key, version) {
+  return getContractSpecDataViewRegistry().get(key, version);
+}
+var formRegistry = null;
+function createContractSpecFormRegistry() {
+  const registry = new FormRegistry;
+  registry.register(DocsSearchForm);
+  return registry;
+}
+function getContractSpecFormRegistry() {
+  if (!formRegistry) {
+    formRegistry = createContractSpecFormRegistry();
+  }
+  return formRegistry;
+}
+function resolveFormSpec(key, _version) {
+  return getContractSpecFormRegistry().get(key);
+}
+function resolveSerializedOperationSpec(key, version) {
+  const spec = resolveOperationSpec(key, version);
+  return serializeOperationSpec(spec) ?? undefined;
+}
+function resolveSerializedEventSpec(key, version) {
+  const spec = resolveEventSpec(key, version);
+  return serializeEventSpec(spec) ?? undefined;
+}
+function resolveSerializedPresentationSpec(key, version) {
+  const spec = resolvePresentationSpec(key, version);
+  return serializePresentationSpec(spec) ?? undefined;
+}
+function resolveSerializedDataViewSpec(key, version) {
+  const spec = resolveDataViewSpec(key, version);
+  return serializeDataViewSpec(spec) ?? undefined;
+}
+function resolveSerializedFormSpec(key, version) {
+  const spec = resolveFormSpec(key, version);
+  return serializeFormSpec(spec) ?? undefined;
+}
+function resetContractSpecOperationRegistry() {
+  operationRegistry = null;
+}
+function resetContractSpecEventRegistry() {
+  eventRegistry = null;
+}
+function resetContractSpecPresentationRegistry() {
+  presentationRegistry = null;
+}
+function resetContractSpecDataViewRegistry() {
+  dataViewRegistry = null;
+}
+function resetContractSpecFormRegistry() {
+  formRegistry = null;
+}
+function resetAllContractSpecRegistries() {
+  resetContractSpecOperationRegistry();
+  resetContractSpecEventRegistry();
+  resetContractSpecPresentationRegistry();
+  resetContractSpecDataViewRegistry();
+  resetContractSpecFormRegistry();
+}
+
+// src/presentation/features/organisms/FeatureOperationsList.tsx
+import { EntityCard } from "@contractspec/lib.design-system";
+import { Zap } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function FeatureOperationsList({
+  feature
+}) {
+  if (!feature.operations?.length)
+    return null;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3",
+    children: feature.operations.map((op) => {
+      const spec = resolveSerializedOperationSpec(op.key, op.version);
+      return /* @__PURE__ */ jsxDEV(EntityCard, {
+        cardTitle: op.key,
+        cardSubtitle: `v${op.version}`,
+        footer: spec?.meta.description,
+        icon: /* @__PURE__ */ jsxDEV(Zap, {
+          className: "h-4 w-4"
+        }, undefined, false, undefined, this),
+        href: `/features/${feature.meta.key}/operations/${op.key}`
+      }, op.key, false, undefined, this);
+    })
+  }, undefined, false, undefined, this);
+}
+
+// src/presentation/features/templates/FeatureOperationsTemplate/FeatureOperationsTemplate.tsx
+import {
+  Breadcrumbs,
+  PageHeaderResponsive
+} from "@contractspec/lib.design-system";
+import { VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function FeatureOperationsTemplate({
+  feature,
+  className
+}) {
+  return /* @__PURE__ */ jsxDEV2(VStack, {
+    gap: "lg",
+    className: cn("mx-auto w-full max-w-5xl p-6", className),
+    children: [
+      /* @__PURE__ */ jsxDEV2(PageHeaderResponsive, {
+        title: "Operations",
+        subtitle: `Operations defined in ${feature.meta.title ?? feature.meta.key}`,
+        breadcrumb: /* @__PURE__ */ jsxDEV2(Breadcrumbs, {
+          items: [
+            { label: "Features", href: "/features" },
+            {
+              label: feature.meta.title || feature.meta.key,
+              href: `/features/${feature.meta.key}`
+            },
+            { label: "Operations" }
+          ]
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2(FeatureOperationsList, {
+        feature
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  FeatureOperationsTemplate
+};

package/dist/node/presentation/features/templates/FeatureOverviewTemplate/FeatureOverviewTemplate.js

@@ -0,0 +1,187 @@
+// src/presentation/features/organisms/FeatureDetail/FeatureDetail.tsx
+import {
+  StatCard,
+  StatCardGroup,
+  StatusChip
+} from "@contractspec/lib.design-system";
+import { Box, HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import Link from "next/link";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+var stabilityTone = {
+  stable: "success",
+  beta: "warning",
+  experimental: "info",
+  deprecated: "danger"
+};
+function FeatureDetail({ feature, className }) {
+  const { meta, operations, events, presentations, capabilities } = feature;
+  const tone = stabilityTone[meta.stability] ?? "neutral";
+  return /* @__PURE__ */ jsxDEV(VStack, {
+    gap: "lg",
+    className: cn("w-full", className),
+    children: [
+      /* @__PURE__ */ jsxDEV(HStack, {
+        gap: "sm",
+        children: [
+          /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone,
+            label: meta.stability ?? "unknown"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: "neutral",
+            label: meta.key,
+            size: "sm"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(StatusChip, {
+            tone: "neutral",
+            label: `v${meta.version}`,
+            size: "sm"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(StatCardGroup, {
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: `./${feature.meta.key}/operations`,
+            children: /* @__PURE__ */ jsxDEV(StatCard, {
+              label: "Operations",
+              value: operations?.length ?? 0
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: `./${feature.meta.key}/events`,
+            children: /* @__PURE__ */ jsxDEV(StatCard, {
+              label: "Events",
+              value: events?.length ?? 0
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: `./${feature.meta.key}/presentations`,
+            children: /* @__PURE__ */ jsxDEV(StatCard, {
+              label: "Presentations",
+              value: presentations?.length ?? 0
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      capabilities?.provides?.length ? /* @__PURE__ */ jsxDEV(Box, {
+        className: "flex-col rounded-lg border p-4",
+        gap: "sm",
+        align: "start",
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "font-semibold",
+            children: "Provides Capabilities"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(HStack, {
+            gap: "xs",
+            wrap: "wrap",
+            children: capabilities.provides.map((cap) => /* @__PURE__ */ jsxDEV(StatusChip, {
+              tone: "success",
+              label: `${cap.key} v${cap.version}`,
+              size: "sm"
+            }, `${cap.key}-${cap.version}`, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this) : null,
+      capabilities?.requires?.length ? /* @__PURE__ */ jsxDEV(Box, {
+        className: "flex-col rounded-lg border p-4",
+        gap: "sm",
+        align: "start",
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "font-semibold",
+            children: "Requires Capabilities"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(HStack, {
+            gap: "xs",
+            wrap: "wrap",
+            children: capabilities.requires.map((req) => /* @__PURE__ */ jsxDEV(StatusChip, {
+              tone: "info",
+              label: `${req.key}${req.version ? ` v${req.version}` : ""}${req.optional ? " (optional)" : ""}`,
+              size: "sm"
+            }, req.key, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this) : null,
+      meta.tags?.length ? /* @__PURE__ */ jsxDEV(Box, {
+        className: "flex-col rounded-lg border p-4",
+        gap: "sm",
+        align: "start",
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "font-semibold",
+            children: "Tags"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(HStack, {
+            gap: "xs",
+            wrap: "wrap",
+            children: meta.tags.map((tag) => /* @__PURE__ */ jsxDEV(StatusChip, {
+              tone: "neutral",
+              label: `#${tag}`,
+              size: "sm"
+            }, tag, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this) : null,
+      meta.owners?.length ? /* @__PURE__ */ jsxDEV(Box, {
+        className: "flex-col rounded-lg border p-4",
+        gap: "sm",
+        align: "start",
+        children: [
+          /* @__PURE__ */ jsxDEV("span", {
+            className: "font-semibold",
+            children: "Owners"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(HStack, {
+            gap: "xs",
+            wrap: "wrap",
+            children: meta.owners.map((owner) => /* @__PURE__ */ jsxDEV(StatusChip, {
+              tone: "neutral",
+              label: owner,
+              size: "sm"
+            }, owner, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this) : null
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/presentation/features/templates/FeatureOverviewTemplate/FeatureOverviewTemplate.tsx
+import {
+  PageHeaderResponsive,
+  Breadcrumbs
+} from "@contractspec/lib.design-system";
+import { VStack as VStack2 } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { cn as cn2 } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function FeatureOverviewTemplate({
+  feature,
+  className
+}) {
+  return /* @__PURE__ */ jsxDEV2(VStack2, {
+    gap: "lg",
+    className: cn2("mx-auto w-full max-w-5xl p-6", className),
+    children: [
+      /* @__PURE__ */ jsxDEV2(PageHeaderResponsive, {
+        title: feature.meta.title || feature.meta.key,
+        subtitle: feature.meta.description || "Feature overview",
+        breadcrumb: /* @__PURE__ */ jsxDEV2(Breadcrumbs, {
+          items: [
+            { label: "Features", href: "/features" },
+            { label: feature.meta.title || feature.meta.key }
+          ]
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV2(FeatureDetail, {
+        feature
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  FeatureOverviewTemplate
+};