@contractspec/bundle.library 3.7.5 → 3.7.7

package/dist/node/components/docs/manifesto/ManifestoPage.js

@@ -5,179 +5,74 @@ function ManifestoPage() {
     className: "space-y-8",
     children: [
       /* @__PURE__ */ jsxs("div", {
-        className: "space-y-4",
+        className: "space-y-3",
         children: [
+          /* @__PURE__ */ jsx("p", {
+            className: "editorial-kicker",
+            children: "Why ContractSpec"
+          }),
           /* @__PURE__ */ jsx("h1", {
-            className: "text-4xl font-bold",
-            children: "Manifesto"
+            className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
+            children: "Open system, explicit contracts, incremental adoption."
           }),
           /* @__PURE__ */ jsx("p", {
-            className: "text-muted-foreground text-lg",
-            children: "ContractSpec is the deterministic, spec-first compiler that keeps AI-written software coherent, safe, and regenerable. We're building the safety layer for AI-coded systems."
+            className: "max-w-3xl text-lg text-muted-foreground leading-8",
+            children: "ContractSpec exists to make AI-native software more legible and more governable. The system should help teams express durable boundaries, keep generated surfaces aligned, and still own the code and contracts they ship."
           })
         ]
       }),
       /* @__PURE__ */ jsxs("div", {
         className: "space-y-6",
         children: [
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "Compiler, not prison"
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "ContractSpec is a tool in your toolchain, not a platform you're locked into. Like TypeScript compiles to JavaScript, ContractSpec compiles specs to standard code. The generated output is yours—readable, modifiable, and ejectable at any time."
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "We believe developers should own their code. There's no proprietary runtime, no vendor-specific abstractions, no magic that hides complexity. You can always see what ContractSpec generates, understand it, and take it with you if you leave."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
+          /* @__PURE__ */ jsxs("section", {
+            className: "editorial-panel space-y-3",
             children: [
               /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "Standard tech, no magic"
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "Everything ContractSpec generates uses technology you already know: TypeScript, Zod, Prisma, GraphQL, REST, React. There's no new language to learn, no YAML configuration hell, no DSL that only works in our ecosystem."
-              }),
-              /* @__PURE__ */ jsxs("p", {
-                className: "text-muted-foreground",
-                children: [
-                  "Specs are just TypeScript. If you can write",
-                  " ",
-                  /* @__PURE__ */ jsxs("code", {
-                    className: "rounded bg-violet-500/10 px-1.5 py-0.5 text-sm",
-                    children: [
-                      "z.object(",
-                      "{",
-                      " name: z.string() ",
-                      "}",
-                      ")"
-                    ]
-                  }),
-                  ", you can write a ContractSpec. Your existing skills transfer directly."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "Incremental adoption"
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "You don't rewrite your app to use ContractSpec. You stabilize one module at a time. Start with a single API endpoint, a single data model, a single contract. See the value. Expand gradually."
+                className: "font-serif text-3xl tracking-[-0.03em]",
+                children: "Open system, not closed platform"
               }),
               /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "This isn't a big-bang migration. It's a safety layer you add incrementally to existing AI-generated chaos. No pressure. No deadlines. Your pace."
+                className: "text-muted-foreground text-sm leading-7",
+                children: "The OSS layer should remain useful on its own. Teams need explicit contracts, readable code, and outputs they can keep. Studio can sit on top of that system, but it should never be the only way to own or understand the behavior."
               })
             ]
           }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
+          /* @__PURE__ */ jsxs("section", {
+            className: "editorial-panel space-y-3",
             children: [
               /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "AI governance"
+                className: "font-serif text-3xl tracking-[-0.03em]",
+                children: "Contracts before surface sprawl"
               }),
               /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "In 2025, AI agents generate enormous amounts of code. But they can't enforce invariants, they break multi-surface consistency, and they hallucinate refactors. The result is code that's hard to maintain and dangerous to trust."
-              }),
-              /* @__PURE__ */ jsxs("p", {
-                className: "text-muted-foreground",
-                children: [
-                  "ContractSpec provides the governance layer. Contracts define what the system ",
-                  /* @__PURE__ */ jsx("em", {
-                    children: "should"
-                  }),
-                  " do. AI agents read specs, not implementations. Code that violates contracts gets flagged and rejected before it can cause damage."
-                ]
+                className: "text-muted-foreground text-sm leading-7",
+                children: "AI tooling accelerates surface creation faster than most teams can govern it. The answer is not more hidden glue. The answer is a durable contract layer that keeps API, UI, data, workflows, and operator behavior aligned."
               })
             ]
           }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
+          /* @__PURE__ */ jsxs("section", {
+            className: "editorial-panel space-y-3",
             children: [
               /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "Multi-surface consistency"
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "One spec generates API endpoints, database schemas, UI types, event definitions, and MCP tools. All surfaces stay in sync because they share the same source of truth."
+                className: "font-serif text-3xl tracking-[-0.03em]",
+                children: "Incremental adoption wins"
               }),
               /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "No more chasing drift between your API and your database. No more frontend types that don't match backend contracts. One change to the spec, all surfaces update consistently."
+                className: "text-muted-foreground text-sm leading-7",
+                children: "Most teams already have a codebase. The practical path is to stabilize one boundary at a time, prove the loop, and grow from there. That is why the docs and product should lead with one module, one endpoint, one workflow, one unsafe surface at a time."
               })
             ]
           }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "space-y-3",
+          /* @__PURE__ */ jsxs("section", {
+            className: "editorial-panel space-y-3",
             children: [
               /* @__PURE__ */ jsx("h2", {
-                className: "text-2xl font-bold",
-                children: "Safe regeneration"
+                className: "font-serif text-3xl tracking-[-0.03em]",
+                children: "Studio should stay additive"
               }),
               /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: "You can regenerate code at any time without fear. Specs enforce invariants. Breaking changes are caught at compile time, not in production. Roll back to any previous version with confidence."
-              }),
-              /* @__PURE__ */ jsx("p", {
-                className: "text-muted-foreground",
-                children: `This is the promise of spec-first development: the code is derived from the spec, so regenerating it is always safe. No more "don't touch that file" warnings. No more fear of AI-generated spaghetti.`
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs("div", {
-        className: "space-y-4",
-        children: [
-          /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
-            children: "Join us"
-          }),
-          /* @__PURE__ */ jsx("p", {
-            className: "text-muted-foreground",
-            children: "We're building the safety layer for AI-coded systems. If you believe developers should own their code, that AI needs governance, and that standard tech beats proprietary magic—we'd love to have you."
-          }),
-          /* @__PURE__ */ jsxs("p", {
-            className: "text-muted-foreground",
-            children: [
-              "You keep your app. We stabilize it, one module at a time. You own the code. It's standard tech.",
-              " ",
-              /* @__PURE__ */ jsx("span", {
-                className: "font-semibold text-violet-400",
-                children: "We're the compiler, not the prison."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "flex flex-wrap gap-4 pt-4",
-            children: [
-              /* @__PURE__ */ jsx("a", {
-                href: "/install",
-                className: "btn-primary",
-                children: "Install OSS Core"
-              }),
-              /* @__PURE__ */ jsx("a", {
-                href: "https://www.contractspec.studio",
-                className: "btn-ghost",
-                children: "Try Studio"
+                className: "text-muted-foreground text-sm leading-7",
+                children: "The best operating product can and should exist on top of the open system. But the OSS foundation must remain strong enough that technical adopters trust it before they ever adopt Studio."
               })
             ]
           })

package/dist/node/components/docs/ops/AutoEvolutionOpsPage.js

@@ -8,11 +8,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Auto-Evolution Runbook"
           }),
           /* @__PURE__ */ jsx("p", {
-            className: "text-muted-foreground text-lg",
+            className: "text-lg text-muted-foreground",
             children: "Configure sampling, approvals, experiments, and golden tests so your app keeps improving without regressions."
           })
         ]
@@ -21,11 +21,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Pipeline overview"
           }),
           /* @__PURE__ */ jsxs("ol", {
-            className: "text-muted-foreground list-decimal space-y-2 pl-6 text-sm",
+            className: "list-decimal space-y-2 pl-6 text-muted-foreground text-sm",
             children: [
               /* @__PURE__ */ jsx("li", {
                 children: "Tracing middleware emits telemetry samples with tenant/user context."
@@ -56,11 +56,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Key environment variables"
           }),
           /* @__PURE__ */ jsx("pre", {
-            className: "bg-muted rounded-lg border p-4 text-sm",
+            className: "rounded-lg border bg-muted p-4 text-sm",
             children: `# Telemetry sampling
 AUTO_EVOLUTION_SAMPLE_RATE=0.02
 AUTO_EVOLUTION_WINDOW_MS=900000
@@ -79,11 +79,11 @@ AUTO_EVOLUTION_MAX_P99_MS=500`
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Operations checklist"
           }),
           /* @__PURE__ */ jsxs("ul", {
-            className: "text-muted-foreground list-disc space-y-2 pl-6 text-sm",
+            className: "list-disc space-y-2 pl-6 text-muted-foreground text-sm",
             children: [
               /* @__PURE__ */ jsx("li", {
                 children: "Review new `SpecSuggestion` records every morning (UI coming soon; Prisma view today)."
@@ -123,7 +123,7 @@ AUTO_EVOLUTION_MAX_P99_MS=500`
           className: "card-subtle space-y-2 p-4",
           children: [
             /* @__PURE__ */ jsx("h3", {
-              className: "text-lg font-semibold",
+              className: "font-semibold text-lg",
               children: card.title
             }),
             /* @__PURE__ */ jsx("p", {

package/dist/node/components/docs/ops/DistributedTracingOpsPage.js

@@ -8,11 +8,11 @@ function OpsDistributedTracingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Distributed Tracing"
           }),
           /* @__PURE__ */ jsx("p", {
-            className: "text-muted-foreground text-lg",
+            className: "text-lg text-muted-foreground",
             children: "ContractSpec uses OpenTelemetry (OTel) for distributed tracing. This guide explains how to configure exporters and collectors."
           })
         ]
@@ -21,14 +21,14 @@ function OpsDistributedTracingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Configuration"
           }),
           /* @__PURE__ */ jsx("p", {
             children: "Configure the OTel SDK via environment variables:"
           }),
           /* @__PURE__ */ jsx("pre", {
-            className: "bg-muted rounded-lg border p-4 text-sm",
+            className: "rounded-lg border bg-muted p-4 text-sm",
             children: `OTEL_SERVICE_NAME=my-service
 OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
 OTEL_TRACES_SAMPLER=parentbased_traceidratio
@@ -40,7 +40,7 @@ OTEL_TRACES_SAMPLER_ARG=0.1`
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Exporters"
           }),
           /* @__PURE__ */ jsx("p", {

package/dist/node/components/docs/ops/index.js

@@ -8,11 +8,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Auto-Evolution Runbook"
           }),
           /* @__PURE__ */ jsx("p", {
-            className: "text-muted-foreground text-lg",
+            className: "text-lg text-muted-foreground",
             children: "Configure sampling, approvals, experiments, and golden tests so your app keeps improving without regressions."
           })
         ]
@@ -21,11 +21,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Pipeline overview"
           }),
           /* @__PURE__ */ jsxs("ol", {
-            className: "text-muted-foreground list-decimal space-y-2 pl-6 text-sm",
+            className: "list-decimal space-y-2 pl-6 text-muted-foreground text-sm",
             children: [
               /* @__PURE__ */ jsx("li", {
                 children: "Tracing middleware emits telemetry samples with tenant/user context."
@@ -56,11 +56,11 @@ function OpsAutoEvolutionPage() {
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Key environment variables"
           }),
           /* @__PURE__ */ jsx("pre", {
-            className: "bg-muted rounded-lg border p-4 text-sm",
+            className: "rounded-lg border bg-muted p-4 text-sm",
             children: `# Telemetry sampling
 AUTO_EVOLUTION_SAMPLE_RATE=0.02
 AUTO_EVOLUTION_WINDOW_MS=900000
@@ -79,11 +79,11 @@ AUTO_EVOLUTION_MAX_P99_MS=500`
         className: "space-y-3",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Operations checklist"
           }),
           /* @__PURE__ */ jsxs("ul", {
-            className: "text-muted-foreground list-disc space-y-2 pl-6 text-sm",
+            className: "list-disc space-y-2 pl-6 text-muted-foreground text-sm",
             children: [
               /* @__PURE__ */ jsx("li", {
                 children: "Review new `SpecSuggestion` records every morning (UI coming soon; Prisma view today)."
@@ -123,7 +123,7 @@ AUTO_EVOLUTION_MAX_P99_MS=500`
           className: "card-subtle space-y-2 p-4",
           children: [
             /* @__PURE__ */ jsx("h3", {
-              className: "text-lg font-semibold",
+              className: "font-semibold text-lg",
               children: card.title
             }),
             /* @__PURE__ */ jsx("p", {
@@ -147,11 +147,11 @@ function OpsDistributedTracingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Distributed Tracing"
           }),
           /* @__PURE__ */ jsx2("p", {
-            className: "text-muted-foreground text-lg",
+            className: "text-lg text-muted-foreground",
             children: "ContractSpec uses OpenTelemetry (OTel) for distributed tracing. This guide explains how to configure exporters and collectors."
           })
         ]
@@ -160,14 +160,14 @@ function OpsDistributedTracingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Configuration"
           }),
           /* @__PURE__ */ jsx2("p", {
             children: "Configure the OTel SDK via environment variables:"
           }),
           /* @__PURE__ */ jsx2("pre", {
-            className: "bg-muted rounded-lg border p-4 text-sm",
+            className: "rounded-lg border bg-muted p-4 text-sm",
             children: `OTEL_SERVICE_NAME=my-service
 OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
 OTEL_TRACES_SAMPLER=parentbased_traceidratio
@@ -179,7 +179,7 @@ OTEL_TRACES_SAMPLER_ARG=0.1`
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Exporters"
           }),
           /* @__PURE__ */ jsx2("p", {

package/dist/node/components/docs/reference/DocsMarkdownContent.js

@@ -90,7 +90,7 @@ function parseDocsMarkdown(content) {
 
 // src/components/docs/reference/DocsMarkdownContent.tsx
 import { CodeBlock } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import {
   BlockQuote,
   H2,

package/dist/node/components/docs/reference/DocsReferenceContent.js

@@ -90,7 +90,7 @@ function parseDocsMarkdown(content) {
 
 // src/components/docs/reference/DocsMarkdownContent.tsx
 import { CodeBlock } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import {
   BlockQuote,
   H2,
@@ -193,9 +193,9 @@ function DocsMarkdownContent({ content }) {
 }
 
 // src/components/docs/reference/DocsReferenceContent.tsx
+import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { DataViewRenderer } from "@contractspec/lib.design-system";
 import { VStack as VStack2 } from "@contractspec/lib.ui-kit-web/ui/stack";
-import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 "use client";
 function extractMeta(content, label) {

package/dist/node/components/docs/reference/DocsReferenceIndexClient.js

@@ -1,16 +1,16 @@
 // src/components/docs/reference/DocsReferenceIndexClient.tsx
-import { useMemo, useState } from "react";
+import {
+  DocsIndexDataView,
+  DocsSearchForm
+} from "@contractspec/lib.contracts-spec/docs";
 import {
   DataViewList,
   formRenderer,
   StatusChip
 } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import { H1, Muted } from "@contractspec/lib.ui-kit-web/ui/typography";
-import {
-  DocsIndexDataView,
-  DocsSearchForm
-} from "@contractspec/lib.contracts-spec/docs";
+import { useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 "use client";
 function cleanSummary(summary) {
@@ -76,10 +76,10 @@ function DocsReferenceIndexClient({
         gap: "sm",
         children: [
           /* @__PURE__ */ jsx(H1, {
-            children: "Contract Reference"
+            children: "Reference"
           }),
           /* @__PURE__ */ jsx(Muted, {
-            children: "Auto-generated reference docs for operations, events, forms, data views, and presentations."
+            children: "Generated reference material for public contract surfaces, versions, owners, and example-backed implementations. Use this when you need the repo truth, not just the narrative docs layer."
           })
         ]
       }),

package/dist/node/components/docs/reference/DocsReferenceIndexPage.js

@@ -69,18 +69,18 @@ async function getGeneratedDocById(id) {
 }
 
 // src/components/docs/reference/DocsReferenceIndexClient.tsx
-import { useMemo, useState } from "react";
+import {
+  DocsIndexDataView,
+  DocsSearchForm
+} from "@contractspec/lib.contracts-spec/docs";
 import {
   DataViewList,
   formRenderer,
   StatusChip
 } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import { H1, Muted } from "@contractspec/lib.ui-kit-web/ui/typography";
-import {
-  DocsIndexDataView,
-  DocsSearchForm
-} from "@contractspec/lib.contracts-spec/docs";
+import { useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 "use client";
 function cleanSummary(summary) {
@@ -146,10 +146,10 @@ function DocsReferenceIndexClient({
         gap: "sm",
         children: [
           /* @__PURE__ */ jsx(H1, {
-            children: "Contract Reference"
+            children: "Reference"
           }),
           /* @__PURE__ */ jsx(Muted, {
-            children: "Auto-generated reference docs for operations, events, forms, data views, and presentations."
+            children: "Generated reference material for public contract surfaces, versions, owners, and example-backed implementations. Use this when you need the repo truth, not just the narrative docs layer."
           })
         ]
       }),

package/dist/node/components/docs/reference/DocsReferencePage.js

@@ -90,7 +90,7 @@ function parseDocsMarkdown(content) {
 
 // src/components/docs/reference/DocsMarkdownContent.tsx
 import { CodeBlock } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import {
   BlockQuote,
   H2,
@@ -193,9 +193,9 @@ function DocsMarkdownContent({ content }) {
 }
 
 // src/components/docs/reference/DocsReferenceContent.tsx
+import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { DataViewRenderer } from "@contractspec/lib.design-system";
 import { VStack as VStack2 } from "@contractspec/lib.ui-kit-web/ui/stack";
-import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 "use client";
 function extractMeta(content, label) {

package/dist/node/components/docs/reference/index.js

@@ -69,18 +69,18 @@ async function getGeneratedDocById(id) {
 }
 
 // src/components/docs/reference/DocsReferenceIndexClient.tsx
-import { useMemo, useState } from "react";
+import {
+  DocsIndexDataView,
+  DocsSearchForm
+} from "@contractspec/lib.contracts-spec/docs";
 import {
   DataViewList,
   formRenderer,
   StatusChip
 } from "@contractspec/lib.design-system";
-import { VStack, HStack } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack, VStack } from "@contractspec/lib.ui-kit-web/ui/stack";
 import { H1, Muted } from "@contractspec/lib.ui-kit-web/ui/typography";
-import {
-  DocsIndexDataView,
-  DocsSearchForm
-} from "@contractspec/lib.contracts-spec/docs";
+import { useMemo, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 "use client";
 function cleanSummary(summary) {
@@ -146,10 +146,10 @@ function DocsReferenceIndexClient({
         gap: "sm",
         children: [
           /* @__PURE__ */ jsx(H1, {
-            children: "Contract Reference"
+            children: "Reference"
           }),
           /* @__PURE__ */ jsx(Muted, {
-            children: "Auto-generated reference docs for operations, events, forms, data views, and presentations."
+            children: "Generated reference material for public contract surfaces, versions, owners, and example-backed implementations. Use this when you need the repo truth, not just the narrative docs layer."
           })
         ]
       }),
@@ -295,7 +295,7 @@ function parseDocsMarkdown(content) {
 
 // src/components/docs/reference/DocsMarkdownContent.tsx
 import { CodeBlock } from "@contractspec/lib.design-system";
-import { VStack as VStack2, HStack as HStack2 } from "@contractspec/lib.ui-kit-web/ui/stack";
+import { HStack as HStack2, VStack as VStack2 } from "@contractspec/lib.ui-kit-web/ui/stack";
 import {
   BlockQuote,
   H2,
@@ -398,9 +398,9 @@ function DocsMarkdownContent({ content }) {
 }
 
 // src/components/docs/reference/DocsReferenceContent.tsx
+import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { DataViewRenderer } from "@contractspec/lib.design-system";
 import { VStack as VStack3 } from "@contractspec/lib.ui-kit-web/ui/stack";
-import { ContractReferenceDataView } from "@contractspec/lib.contracts-spec/docs";
 import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 "use client";
 function extractMeta(content, label) {