@contractspec/bundle.library 3.7.6 → 3.8.2

package/src/components/docs/reference/DocsMarkdownContent.tsx

@@ -1,94 +1,94 @@
 'use client';
 
 import { CodeBlock, type CodeLanguage } 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,
-  H3,
-  H4,
-  Muted,
-  P,
+	BlockQuote,
+	H2,
+	H3,
+	H4,
+	Muted,
+	P,
 } from '@contractspec/lib.ui-kit-web/ui/typography';
 import { parseDocsMarkdown } from './docsMarkdownParser';
 
 const CODE_LANGUAGES = new Set<CodeLanguage>([
-  'typescript',
-  'tsx',
-  'javascript',
-  'jsx',
-  'bash',
-  'shell',
-  'json',
-  'yaml',
-  'graphql',
-  'sql',
-  'python',
-  'go',
-  'rust',
-  'css',
-  'scss',
-  'html',
-  'markdown',
-  'text',
+	'typescript',
+	'tsx',
+	'javascript',
+	'jsx',
+	'bash',
+	'shell',
+	'json',
+	'yaml',
+	'graphql',
+	'sql',
+	'python',
+	'go',
+	'rust',
+	'css',
+	'scss',
+	'html',
+	'markdown',
+	'text',
 ]);
 
 function toCodeLanguage(language?: string): CodeLanguage {
-  if (!language) return 'text';
-  const normalized = language.toLowerCase() as CodeLanguage;
-  return CODE_LANGUAGES.has(normalized) ? normalized : 'text';
+	if (!language) return 'text';
+	const normalized = language.toLowerCase() as CodeLanguage;
+	return CODE_LANGUAGES.has(normalized) ? normalized : 'text';
 }
 
 function renderHeading(level: number, text: string) {
-  if (level <= 2) return <H2>{text}</H2>;
-  if (level === 3) return <H3>{text}</H3>;
-  return <H4>{text}</H4>;
+	if (level <= 2) return <H2>{text}</H2>;
+	if (level === 3) return <H3>{text}</H3>;
+	return <H4>{text}</H4>;
 }
 
 export function DocsMarkdownContent({ content }: { content: string }) {
-  const blocks = parseDocsMarkdown(content);
+	const blocks = parseDocsMarkdown(content);
 
-  if (!blocks.length) {
-    return <Muted>No reference content available.</Muted>;
-  }
+	if (!blocks.length) {
+		return <Muted>No reference content available.</Muted>;
+	}
 
-  return (
-    <VStack gap="md">
-      {blocks.map((block, index) => {
-        switch (block.type) {
-          case 'heading':
-            return (
-              <VStack key={index}>
-                {renderHeading(block.level, block.text)}
-              </VStack>
-            );
-          case 'paragraph':
-            return <P key={index}>{block.text}</P>;
-          case 'quote':
-            return <BlockQuote key={index}>{block.text}</BlockQuote>;
-          case 'code':
-            return (
-              <CodeBlock
-                key={index}
-                language={toCodeLanguage(block.language)}
-                code={block.code}
-              />
-            );
-          case 'list':
-            return (
-              <VStack key={index} gap="xs">
-                {block.items.map((item, itemIndex) => (
-                  <HStack key={itemIndex} gap="sm" align="start">
-                    <Muted>{block.ordered ? `${itemIndex + 1}.` : '•'}</Muted>
-                    <P className="leading-relaxed">{item}</P>
-                  </HStack>
-                ))}
-              </VStack>
-            );
-          default:
-            return null;
-        }
-      })}
-    </VStack>
-  );
+	return (
+		<VStack gap="md">
+			{blocks.map((block, index) => {
+				switch (block.type) {
+					case 'heading':
+						return (
+							<VStack key={index}>
+								{renderHeading(block.level, block.text)}
+							</VStack>
+						);
+					case 'paragraph':
+						return <P key={index}>{block.text}</P>;
+					case 'quote':
+						return <BlockQuote key={index}>{block.text}</BlockQuote>;
+					case 'code':
+						return (
+							<CodeBlock
+								key={index}
+								language={toCodeLanguage(block.language)}
+								code={block.code}
+							/>
+						);
+					case 'list':
+						return (
+							<VStack key={index} gap="xs">
+								{block.items.map((item, itemIndex) => (
+									<HStack key={itemIndex} gap="sm" align="start">
+										<Muted>{block.ordered ? `${itemIndex + 1}.` : '•'}</Muted>
+										<P className="leading-relaxed">{item}</P>
+									</HStack>
+								))}
+							</VStack>
+						);
+					default:
+						return null;
+				}
+			})}
+		</VStack>
+	);
 }

package/src/components/docs/reference/DocsReferenceContent.tsx

@@ -1,73 +1,73 @@
 'use client';
 
+import { ContractReferenceDataView } from '@contractspec/lib.contracts-spec/docs';
 import { DataViewRenderer } from '@contractspec/lib.design-system';
 import { VStack } from '@contractspec/lib.ui-kit-web/ui/stack';
-import { ContractReferenceDataView } from '@contractspec/lib.contracts-spec/docs';
 import type { DocsIndexEntry } from '../generated/docs-index.generated';
 import { DocsMarkdownContent } from './DocsMarkdownContent';
 
 interface DocsReferenceContentProps {
-  entry: DocsIndexEntry;
-  content: string;
+	entry: DocsIndexEntry;
+	content: string;
 }
 
 function extractMeta(content: string, label: string) {
-  const match = content.match(new RegExp(`- \\*\\*${label}\\*\\*: (.+)`, 'i'));
-  return match?.[1]?.trim();
+	const match = content.match(new RegExp(`- \\*\\*${label}\\*\\*: (.+)`, 'i'));
+	return match?.[1]?.trim();
 }
 
 function cleanSummary(summary?: string) {
-  if (!summary) return undefined;
-  return summary
-    .replace(/<!--.*?-->/g, '')
-    .replace(/[ \t]+/g, ' ')
-    .replace(/\n{3,}/g, '\n\n')
-    .trim();
+	if (!summary) return undefined;
+	return summary
+		.replace(/<!--.*?-->/g, '')
+		.replace(/[ \t]+/g, ' ')
+		.replace(/\n{3,}/g, '\n\n')
+		.trim();
 }
 
 export function DocsReferenceContent({
-  entry,
-  content,
+	entry,
+	content,
 }: DocsReferenceContentProps) {
-  const summary = cleanSummary(entry.summary);
-  const type = extractMeta(content, 'Type');
-  const version = extractMeta(content, 'Version') ?? entry.version;
-  const tags = extractMeta(content, 'Tags')
-    ?.split(',')
-    .map((tag) => tag.trim())
-    .filter(Boolean);
-  const owners = extractMeta(content, 'Owners')
-    ?.split(',')
-    .map((owner) => owner.trim())
-    .filter(Boolean);
-  const stability = extractMeta(content, 'Stability') ?? entry.visibility;
+	const summary = cleanSummary(entry.summary);
+	const type = extractMeta(content, 'Type');
+	const version = extractMeta(content, 'Version') ?? entry.version;
+	const tags = extractMeta(content, 'Tags')
+		?.split(',')
+		.map((tag) => tag.trim())
+		.filter(Boolean);
+	const owners = extractMeta(content, 'Owners')
+		?.split(',')
+		.map((owner) => owner.trim())
+		.filter(Boolean);
+	const stability = extractMeta(content, 'Stability') ?? entry.visibility;
 
-  const referenceItem = {
-    reference: {
-      key: entry.title ?? entry.id,
-      version,
-      type,
-      title: entry.title ?? entry.id,
-      description: summary,
-      tags: tags ?? entry.tags,
-      owners: owners ?? entry.owners,
-      stability,
-    },
-  };
+	const referenceItem = {
+		reference: {
+			key: entry.title ?? entry.id,
+			version,
+			type,
+			title: entry.title ?? entry.id,
+			description: summary,
+			tags: tags ?? entry.tags,
+			owners: owners ?? entry.owners,
+			stability,
+		},
+	};
 
-  const detailSpec = {
-    ...ContractReferenceDataView,
-    meta: {
-      ...ContractReferenceDataView.meta,
-      title: entry.title ?? ContractReferenceDataView.meta.title,
-      description: summary ?? ContractReferenceDataView.meta.description,
-    },
-  };
+	const detailSpec = {
+		...ContractReferenceDataView,
+		meta: {
+			...ContractReferenceDataView.meta,
+			title: entry.title ?? ContractReferenceDataView.meta.title,
+			description: summary ?? ContractReferenceDataView.meta.description,
+		},
+	};
 
-  return (
-    <VStack gap="xl">
-      <DataViewRenderer spec={detailSpec} item={referenceItem} />
-      <DocsMarkdownContent content={content} />
-    </VStack>
-  );
+	return (
+		<VStack gap="xl">
+			<DataViewRenderer spec={detailSpec} item={referenceItem} />
+			<DocsMarkdownContent content={content} />
+		</VStack>
+	);
 }

package/src/components/docs/reference/DocsReferenceIndexClient.tsx

@@ -1,137 +1,138 @@
 'use client';
 
-import { useMemo, useState } from 'react';
 import {
-  DataViewList,
-  formRenderer,
-  StatusChip,
+	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 type { DocsIndexEntry } from '../generated/docs-index.generated';
 
 interface Filters {
-  query?: string;
-  visibility?: string;
-  kind?: string;
+	query?: string;
+	visibility?: string;
+	kind?: string;
 }
 
 interface DocsReferenceIndexClientProps {
-  entries: readonly DocsIndexEntry[];
+	entries: readonly DocsIndexEntry[];
 }
 
 function cleanSummary(summary?: string) {
-  if (!summary) return undefined;
-  return summary
-    .replace(/<!--.*?-->/g, '')
-    .replace(/[ \t]+/g, ' ')
-    .replace(/\n{3,}/g, '\n\n')
-    .trim();
+	if (!summary) return undefined;
+	return summary
+		.replace(/<!--.*?-->/g, '')
+		.replace(/[ \t]+/g, ' ')
+		.replace(/\n{3,}/g, '\n\n')
+		.trim();
 }
 
 function normalizeEntry(entry: DocsIndexEntry): DocsIndexEntry {
-  const summary = cleanSummary(entry.summary);
-  const kind =
-    entry.kind ?? (entry.source === 'generated' ? 'reference' : undefined);
-  const visibility =
-    entry.visibility ?? (entry.source === 'generated' ? 'public' : undefined);
+	const summary = cleanSummary(entry.summary);
+	const kind =
+		entry.kind ?? (entry.source === 'generated' ? 'reference' : undefined);
+	const visibility =
+		entry.visibility ?? (entry.source === 'generated' ? 'public' : undefined);
 
-  return {
-    ...entry,
-    summary,
-    kind,
-    visibility,
-  };
+	return {
+		...entry,
+		summary,
+		kind,
+		visibility,
+	};
 }
 
 function matchesQuery(entry: DocsIndexEntry, query: string) {
-  if (!query) return true;
-  const haystack = [entry.title, entry.summary, entry.id, ...(entry.tags ?? [])]
-    .filter(Boolean)
-    .join(' ')
-    .toLowerCase();
-  return haystack.includes(query.toLowerCase());
+	if (!query) return true;
+	const haystack = [entry.title, entry.summary, entry.id, ...(entry.tags ?? [])]
+		.filter(Boolean)
+		.join(' ')
+		.toLowerCase();
+	return haystack.includes(query.toLowerCase());
 }
 
 export function DocsReferenceIndexClient({
-  entries,
+	entries,
 }: DocsReferenceIndexClientProps) {
-  const [filters, setFilters] = useState<Filters>({});
+	const [filters, setFilters] = useState<Filters>({});
 
-  const normalizedEntries = useMemo(
-    () => entries.map(normalizeEntry),
-    [entries]
-  );
+	const normalizedEntries = useMemo(
+		() => entries.map(normalizeEntry),
+		[entries]
+	);
 
-  const filteredEntries = useMemo(() => {
-    const query = filters.query?.trim() ?? '';
-    return normalizedEntries.filter((entry) => {
-      if (filters.kind && entry.kind !== filters.kind) return false;
-      if (filters.visibility && entry.visibility !== filters.visibility)
-        return false;
-      return matchesQuery(entry, query);
-    });
-  }, [filters, normalizedEntries]);
+	const filteredEntries = useMemo(() => {
+		const query = filters.query?.trim() ?? '';
+		return normalizedEntries.filter((entry) => {
+			if (filters.kind && entry.kind !== filters.kind) return false;
+			if (filters.visibility && entry.visibility !== filters.visibility)
+				return false;
+			return matchesQuery(entry, query);
+		});
+	}, [filters, normalizedEntries]);
 
-  const searchForm = formRenderer.render(DocsSearchForm, {
-    defaultValues: {
-      query: filters.query ?? '',
-      visibility: filters.visibility ?? '',
-      kind: filters.kind ?? '',
-    },
-    overrides: {
-      onSubmitOverride: (values: unknown) => {
-        const submitted = values as Filters;
-        setFilters({
-          query: submitted.query ?? '',
-          visibility: submitted.visibility ?? '',
-          kind: submitted.kind ?? '',
-        });
-      },
-    },
-  });
+	const searchForm = formRenderer.render(DocsSearchForm, {
+		defaultValues: {
+			query: filters.query ?? '',
+			visibility: filters.visibility ?? '',
+			kind: filters.kind ?? '',
+		},
+		overrides: {
+			onSubmitOverride: (values: unknown) => {
+				const submitted = values as Filters;
+				setFilters({
+					query: submitted.query ?? '',
+					visibility: submitted.visibility ?? '',
+					kind: submitted.kind ?? '',
+				});
+			},
+		},
+	});
 
-  return (
-    <VStack gap="xl">
-      <VStack gap="sm">
-        <H1>Contract Reference</H1>
-        <Muted>
-          Auto-generated reference docs for operations, events, forms, data
-          views, and presentations.
-        </Muted>
-      </VStack>
+	return (
+		<VStack gap="xl">
+			<VStack gap="sm">
+				<H1>Reference</H1>
+				<Muted>
+					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.
+				</Muted>
+			</VStack>
 
-      <VStack gap="sm" className="max-w-2xl">
-        {searchForm}
-      </VStack>
+			<VStack gap="sm" className="max-w-2xl">
+				{searchForm}
+			</VStack>
 
-      <DataViewList
-        spec={DocsIndexDataView}
-        items={filteredEntries}
-        emptyState={<Muted>No reference docs match your filters.</Muted>}
-        onSelect={(entry) => {
-          if (entry.route) {
-            window.location.assign(entry.route);
-          }
-        }}
-        renderActions={(entry) => {
-          return (
-            <HStack gap="xs" justify="end">
-              {entry.kind ? <StatusChip size="sm" label={entry.kind} /> : null}
-              {entry.visibility ? (
-                <StatusChip size="sm" label={entry.visibility} />
-              ) : null}
-              {entry.version ? (
-                <StatusChip size="sm" label={`v${entry.version}`} />
-              ) : null}
-            </HStack>
-          );
-        }}
-      />
-    </VStack>
-  );
+			<DataViewList
+				spec={DocsIndexDataView}
+				items={filteredEntries}
+				emptyState={<Muted>No reference docs match your filters.</Muted>}
+				onSelect={(entry) => {
+					if (entry.route) {
+						window.location.assign(entry.route);
+					}
+				}}
+				renderActions={(entry) => {
+					return (
+						<HStack gap="xs" justify="end">
+							{entry.kind ? <StatusChip size="sm" label={entry.kind} /> : null}
+							{entry.visibility ? (
+								<StatusChip size="sm" label={entry.visibility} />
+							) : null}
+							{entry.version ? (
+								<StatusChip size="sm" label={`v${entry.version}`} />
+							) : null}
+						</HStack>
+					);
+				}}
+			/>
+		</VStack>
+	);
 }

package/src/components/docs/reference/DocsReferenceIndexPage.tsx

@@ -2,6 +2,6 @@ import { listGeneratedDocs } from '../generated/loader';
 import { DocsReferenceIndexClient } from './DocsReferenceIndexClient';
 
 export async function DocsReferenceIndexPage() {
-  const entries = await listGeneratedDocs();
-  return <DocsReferenceIndexClient entries={entries} />;
+	const entries = await listGeneratedDocs();
+	return <DocsReferenceIndexClient entries={entries} />;
 }

package/src/components/docs/reference/DocsReferencePage.tsx

@@ -2,10 +2,10 @@ import type { DocsIndexEntry } from '../generated/docs-index.generated';
 import { DocsReferenceContent } from './DocsReferenceContent';
 
 interface DocsReferencePageProps {
-  entry: DocsIndexEntry;
-  content: string;
+	entry: DocsIndexEntry;
+	content: string;
 }
 
 export function DocsReferencePage({ entry, content }: DocsReferencePageProps) {
-  return <DocsReferenceContent entry={entry} content={content} />;
+	return <DocsReferenceContent entry={entry} content={content} />;
 }