@contractspec/bundle.library 3.7.7 → 3.8.4

package/dist/components/docs/examples/index.js

@@ -1,4 +1,54 @@
 // @bun
+// src/components/docs/examples/exampleShowcaseData.ts
+var EXAMPLE_SHOWCASES = {
+  "agent-console": {
+    key: "agent-console",
+    lead: "Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.",
+    sandboxHref: "/sandbox?template=agent-console",
+    referenceHref: "/docs/reference/agent-console/agent-console",
+    llmsHref: "/llms/example.agent-console",
+    repoHref: "https://github.com/lssm-tech/contractspec/tree/main/packages/examples/agent-console",
+    localCommands: `bun run --cwd packages/examples/agent-console build
+bun run --cwd packages/examples/agent-console test
+bun run --cwd packages/apps/web-landing dev
+
+# Open in the browser
+# http://localhost:3000/sandbox?template=agent-console`
+  },
+  "ai-chat-assistant": {
+    key: "ai-chat-assistant",
+    lead: "Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.",
+    sandboxHref: "/sandbox?template=ai-chat-assistant",
+    referenceHref: "/docs/reference/ai-chat-assistant/assistant.search",
+    llmsHref: "/llms/example.ai-chat-assistant",
+    repoHref: "https://github.com/lssm-tech/contractspec/tree/main/packages/examples/ai-chat-assistant",
+    localCommands: `bun run --cwd packages/examples/ai-chat-assistant build
+bun run --cwd packages/examples/ai-chat-assistant test
+bun run --cwd packages/apps/web-landing dev
+
+# Open in the browser
+# http://localhost:3000/sandbox?template=ai-chat-assistant`
+  },
+  "messaging-agent-actions": {
+    key: "messaging-agent-actions",
+    lead: "Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations.",
+    sandboxHref: "/sandbox?template=messaging-agent-actions",
+    referenceHref: "/docs/reference/messaging-agent-actions/messaging.agentActions.process",
+    llmsHref: "/llms/example.messaging-agent-actions",
+    repoHref: "https://github.com/lssm-tech/contractspec/tree/main/packages/examples/messaging-agent-actions",
+    localCommands: `bun run --cwd packages/examples/messaging-agent-actions build
+bun run --cwd packages/examples/messaging-agent-actions test
+bun run --cwd packages/examples/messaging-agent-actions proof
+bun run --cwd packages/apps/web-landing dev
+
+# Open in the browser
+# http://localhost:3000/sandbox?template=messaging-agent-actions`
+  }
+};
+function getExampleShowcaseData(key) {
+  return EXAMPLE_SHOWCASES[key];
+}
+
 // src/components/docs/examples/DocsExamplesPage.tsx
 import { ExampleCatalogDataView } from "@contractspec/lib.contracts-spec/docs";
 import {
@@ -14,6 +64,9 @@ import { jsx, jsxs } from "react/jsx-runtime";
 function buildReferenceRoute(key) {
   return `/docs/reference/${key}/${key}`;
 }
+function buildDocsRoute(key) {
+  return getExampleShowcaseData(key)?.sandboxHref ? `/docs/examples/${key}` : buildReferenceRoute(key);
+}
 function DocsExamplesPage() {
   const items = listExamples().map((example) => {
     const title = example.meta.title ?? example.meta.key;
@@ -21,7 +74,7 @@ function DocsExamplesPage() {
       id: example.meta.key,
       title,
       summary: example.meta.summary ?? example.meta.description,
-      route: buildReferenceRoute(example.meta.key),
+      route: buildDocsRoute(example.meta.key),
       tags: example.meta.tags,
       sandboxEnabled: example.surfaces.sandbox.enabled
     };
@@ -59,7 +112,7 @@ function DocsExamplesPage() {
             justify: "end",
             children: [
               example.sandboxEnabled ? /* @__PURE__ */ jsx(ButtonLink, {
-                href: "/sandbox",
+                href: `/sandbox?template=${example.id}`,
                 size: "sm",
                 variant: "outline",
                 children: "Sandbox"
@@ -80,6 +133,212 @@ function DocsExamplesPage() {
     ]
   });
 }
+
+// src/components/docs/examples/ExampleShowcasePage.tsx
+import { ButtonLink as ButtonLink2, CodeBlock } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { getExample } from "@contractspec/module.examples";
+import { FileCode2, Play, TerminalSquare } from "lucide-react";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function ExampleShowcasePage({ exampleKey }) {
+  const showcase = getExampleShowcaseData(exampleKey);
+  const example = getExample(exampleKey);
+  if (!showcase || !example) {
+    return null;
+  }
+  const title = example.meta.title ?? example.meta.key;
+  const summary = example.meta.summary ?? example.meta.description ?? "";
+  const packageName = example.entrypoints.packageName;
+  return /* @__PURE__ */ jsxs2("div", {
+    className: "space-y-10",
+    children: [
+      /* @__PURE__ */ jsxs2("section", {
+        className: "space-y-5",
+        children: [
+          /* @__PURE__ */ jsx2("p", {
+            className: "editorial-kicker",
+            children: "Meetup-ready example"
+          }),
+          /* @__PURE__ */ jsx2("h1", {
+            className: "editorial-title max-w-5xl",
+            children: title
+          }),
+          /* @__PURE__ */ jsx2("p", {
+            className: "editorial-subtitle",
+            children: showcase.lead
+          }),
+          /* @__PURE__ */ jsx2("p", {
+            className: "editorial-copy max-w-4xl",
+            children: summary
+          }),
+          /* @__PURE__ */ jsxs2("div", {
+            className: "flex flex-wrap gap-3",
+            children: [
+              /* @__PURE__ */ jsx2(ButtonLink2, {
+                href: showcase.sandboxHref,
+                children: "Open sandbox"
+              }),
+              /* @__PURE__ */ jsx2(ButtonLink2, {
+                href: showcase.referenceHref,
+                variant: "outline",
+                children: "Generated reference"
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsxs2("section", {
+        className: "grid gap-5 lg:grid-cols-3",
+        children: [
+          /* @__PURE__ */ jsxs2("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs2("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx2("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx2(Play, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx2("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Sandbox preview"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx2("p", {
+                className: "editorial-copy text-sm",
+                children: "Load the same public browser surface used for the prepared live demo."
+              }),
+              /* @__PURE__ */ jsx2(ButtonLink2, {
+                href: showcase.sandboxHref,
+                size: "sm",
+                children: "Open preview"
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsxs2("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs2("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx2("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx2(FileCode2, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx2("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Reference docs"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx2("p", {
+                className: "editorial-copy text-sm",
+                children: "Inspect the generated contract-facing material instead of relying on marketing summaries."
+              }),
+              /* @__PURE__ */ jsx2(ButtonLink2, {
+                href: showcase.referenceHref,
+                size: "sm",
+                variant: "outline",
+                children: "Open reference"
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsxs2("article", {
+            className: "editorial-panel space-y-4",
+            children: [
+              /* @__PURE__ */ jsxs2("div", {
+                className: "flex items-center gap-3",
+                children: [
+                  /* @__PURE__ */ jsx2("div", {
+                    className: "rounded-full border border-border/80 bg-background/85 p-2",
+                    children: /* @__PURE__ */ jsx2(TerminalSquare, {
+                      size: 18
+                    })
+                  }),
+                  /* @__PURE__ */ jsx2("h2", {
+                    className: "font-semibold text-xl",
+                    children: "Package context"
+                  })
+                ]
+              }),
+              /* @__PURE__ */ jsx2("p", {
+                className: "editorial-copy text-sm",
+                children: "Use the agent-facing package page for fast repo orientation, then jump to the source directory."
+              }),
+              /* @__PURE__ */ jsx2("p", {
+                className: "rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",
+                children: packageName
+              }),
+              /* @__PURE__ */ jsxs2("div", {
+                className: "flex flex-wrap gap-2",
+                children: [
+                  /* @__PURE__ */ jsx2(ButtonLink2, {
+                    href: showcase.llmsHref,
+                    size: "sm",
+                    variant: "outline",
+                    children: "LLMS page"
+                  }),
+                  /* @__PURE__ */ jsx2(ButtonLink2, {
+                    href: showcase.repoHref,
+                    size: "sm",
+                    variant: "outline",
+                    children: "GitHub source"
+                  })
+                ]
+              })
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsxs2("section", {
+        className: "editorial-panel space-y-5",
+        children: [
+          /* @__PURE__ */ jsxs2("div", {
+            className: "space-y-2",
+            children: [
+              /* @__PURE__ */ jsx2("p", {
+                className: "editorial-kicker",
+                children: "Talk commands"
+              }),
+              /* @__PURE__ */ jsx2("h2", {
+                className: "editorial-panel-title",
+                children: "Exact local commands for the meetup lane"
+              }),
+              /* @__PURE__ */ jsx2("p", {
+                className: "editorial-copy text-sm",
+                children: "Use the package build and test first, then launch the web shell and open the prepared sandbox route."
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsx2(CodeBlock, {
+            language: "bash",
+            filename: `${exampleKey}-meetup-runbook`,
+            code: showcase.localCommands
+          }),
+          /* @__PURE__ */ jsxs2("p", {
+            className: "text-muted-foreground text-sm",
+            children: [
+              "For the full fallback order and safe live-edit workflow, use",
+              " ",
+              /* @__PURE__ */ jsx2(Link, {
+                href: "https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",
+                children: "the meetup runbook"
+              }),
+              "."
+            ]
+          })
+        ]
+      })
+    ]
+  });
+}
 export {
+  ExampleShowcasePage,
   DocsExamplesPage
 };

package/dist/components/docs/generated/docs-index.generated.d.ts

@@ -1,5 +1,5 @@
 export type DocsIndexSource = 'generated' | 'docblock';
-export interface DocsIndexEntry {
+export type DocsIndexEntry = {
     id: string;
     title: string;
     summary?: string;
@@ -11,17 +11,17 @@ export interface DocsIndexEntry {
     visibility?: string;
     version?: string;
     owners?: string[];
-}
-export interface DocsIndexChunk {
+};
+export type DocsIndexChunk = {
     key: string;
     file: string;
     total: number;
-}
-export interface DocsIndexManifest {
+};
+export type DocsIndexManifest = {
     generatedAt: string;
     total: number;
     version: string | null;
     contentRoot: string | null;
     chunks: DocsIndexChunk[];
-}
+};
 export declare const DOCS_INDEX_MANIFEST = "docs-index.manifest.json";