@contractspec/bundle.library 3.8.11 → 3.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-build.log +290 -282
- package/CHANGELOG.md +68 -0
- package/dist/application/index.js +11 -11
- package/dist/application/mcp/cliMcp.js +6 -6
- package/dist/application/mcp/cliMcp.onboarding.d.ts +4 -0
- package/dist/application/mcp/cliMcp.onboarding.js +2 -0
- package/dist/application/mcp/cliMcp.test.d.ts +1 -0
- package/dist/application/mcp/contractsMcp.js +2 -2
- package/dist/application/mcp/contractsMcp.test.d.ts +1 -0
- package/dist/application/mcp/contractsMcpAdoptionTools.d.ts +3 -0
- package/dist/application/mcp/contractsMcpAdoptionTools.js +2 -0
- package/dist/application/mcp/contractsMcpResources.js +1 -1
- package/dist/application/mcp/contractsMcpTools.js +1 -1
- package/dist/application/mcp/contractsMcpTypes.d.ts +16 -0
- package/dist/application/mcp/index.js +11 -11
- package/dist/components/docs/DocsIndexPage.js +1 -1
- package/dist/components/docs/docsManifest.js +1 -1
- package/dist/components/docs/examples/DocsExamplesPage.js +1 -17
- package/dist/components/docs/examples/ExampleShowcasePage.d.ts +1 -1
- package/dist/components/docs/examples/ExampleShowcasePage.js +2 -17
- package/dist/components/docs/examples/exampleShowcaseData.d.ts +2 -2
- package/dist/components/docs/examples/exampleShowcaseData.js +2 -17
- package/dist/components/docs/examples/exampleShowcaseData.test.d.ts +1 -0
- package/dist/components/docs/examples/index.js +2 -17
- package/dist/components/docs/getting-started/CLIPage.js +5 -4
- package/dist/components/docs/getting-started/DataViewTutorialPage.js +44 -67
- package/dist/components/docs/getting-started/StartHerePage.js +4 -2
- package/dist/components/docs/getting-started/index.js +56 -76
- package/dist/components/docs/guides/GuideConnectInRepoPage.js +29 -4
- package/dist/components/docs/guides/GuideHostBuilderWorkbenchPage.js +21 -6
- package/dist/components/docs/guides/GuideReleaseCapsulesPage.d.ts +1 -0
- package/dist/components/docs/guides/GuideReleaseCapsulesPage.js +16 -0
- package/dist/components/docs/guides/GuidesIndexPage.js +1 -1
- package/dist/components/docs/guides/index.d.ts +1 -0
- package/dist/components/docs/guides/index.js +93 -39
- package/dist/components/docs/index.js +572 -421
- package/dist/components/docs/libraries/LibrariesContractsPage.js +43 -18
- package/dist/components/docs/libraries/LibrariesDesignSystemPage.js +43 -31
- package/dist/components/docs/libraries/LibrariesOverviewPage.js +1 -1
- package/dist/components/docs/libraries/LibrariesUIKitPage.js +42 -16
- package/dist/components/docs/libraries/LibrariesUIKitWebPage.d.ts +1 -0
- package/dist/components/docs/libraries/LibrariesUIKitWebPage.js +47 -0
- package/dist/components/docs/libraries/index.d.ts +1 -0
- package/dist/components/docs/libraries/index.js +221 -113
- package/dist/components/docs/specs/SpecsBuilderControlPlanePage.js +18 -3
- package/dist/components/docs/specs/SpecsConnectPage.js +4 -2
- package/dist/components/docs/specs/SpecsDataViewsPage.js +39 -32
- package/dist/components/docs/specs/index.js +65 -41
- package/dist/index.js +583 -432
- package/dist/node/application/index.js +11 -11
- package/dist/node/application/mcp/cliMcp.js +6 -6
- package/dist/node/application/mcp/cliMcp.onboarding.js +1 -0
- package/dist/node/application/mcp/contractsMcp.js +2 -2
- package/dist/node/application/mcp/contractsMcpAdoptionTools.js +1 -0
- package/dist/node/application/mcp/contractsMcpResources.js +1 -1
- package/dist/node/application/mcp/contractsMcpTools.js +1 -1
- package/dist/node/application/mcp/index.js +11 -11
- package/dist/node/components/docs/DocsIndexPage.js +1 -1
- package/dist/node/components/docs/docsManifest.js +1 -1
- package/dist/node/components/docs/examples/DocsExamplesPage.js +1 -17
- package/dist/node/components/docs/examples/ExampleShowcasePage.js +2 -17
- package/dist/node/components/docs/examples/exampleShowcaseData.js +2 -17
- package/dist/node/components/docs/examples/index.js +2 -17
- package/dist/node/components/docs/getting-started/CLIPage.js +5 -4
- package/dist/node/components/docs/getting-started/DataViewTutorialPage.js +44 -67
- package/dist/node/components/docs/getting-started/StartHerePage.js +4 -2
- package/dist/node/components/docs/getting-started/index.js +56 -76
- package/dist/node/components/docs/guides/GuideConnectInRepoPage.js +29 -4
- package/dist/node/components/docs/guides/GuideHostBuilderWorkbenchPage.js +21 -6
- package/dist/node/components/docs/guides/GuideReleaseCapsulesPage.js +15 -0
- package/dist/node/components/docs/guides/GuidesIndexPage.js +1 -1
- package/dist/node/components/docs/guides/index.js +93 -39
- package/dist/node/components/docs/index.js +572 -421
- package/dist/node/components/docs/libraries/LibrariesContractsPage.js +43 -18
- package/dist/node/components/docs/libraries/LibrariesDesignSystemPage.js +43 -31
- package/dist/node/components/docs/libraries/LibrariesOverviewPage.js +1 -1
- package/dist/node/components/docs/libraries/LibrariesUIKitPage.js +42 -16
- package/dist/node/components/docs/libraries/LibrariesUIKitWebPage.js +46 -0
- package/dist/node/components/docs/libraries/index.js +221 -113
- package/dist/node/components/docs/specs/SpecsBuilderControlPlanePage.js +18 -3
- package/dist/node/components/docs/specs/SpecsConnectPage.js +4 -2
- package/dist/node/components/docs/specs/SpecsDataViewsPage.js +39 -32
- package/dist/node/components/docs/specs/index.js +65 -41
- package/dist/node/index.js +583 -432
- package/package.json +66 -17
- package/src/application/mcp/cliMcp.onboarding.ts +297 -0
- package/src/application/mcp/cliMcp.test.ts +99 -0
- package/src/application/mcp/cliMcp.ts +30 -3
- package/src/application/mcp/contractsMcp.test.ts +65 -0
- package/src/application/mcp/contractsMcpAdoptionTools.ts +131 -0
- package/src/application/mcp/contractsMcpResources.ts +49 -0
- package/src/application/mcp/contractsMcpTools.ts +2 -0
- package/src/application/mcp/contractsMcpTypes.ts +16 -0
- package/src/components/docs/docsManifest.ts +12 -0
- package/src/components/docs/examples/DocsExamplesPage.tsx +6 -14
- package/src/components/docs/examples/ExampleShowcasePage.tsx +22 -18
- package/src/components/docs/examples/exampleShowcaseData.test.ts +22 -0
- package/src/components/docs/examples/exampleShowcaseData.ts +75 -50
- package/src/components/docs/generated/docs-index._common.json +2008 -1691
- package/src/components/docs/generated/docs-index.agent-console.json +377 -377
- package/src/components/docs/generated/docs-index.ai-chat-assistant.json +17 -17
- package/src/components/docs/generated/docs-index.ai-chat.json +105 -105
- package/src/components/docs/generated/docs-index.ai-support-bot.json +9 -9
- package/src/components/docs/generated/docs-index.analytics-dashboard.json +169 -169
- package/src/components/docs/generated/docs-index.app-config.json +137 -137
- package/src/components/docs/generated/docs-index.artisan-knowledge-product.json +17 -17
- package/src/components/docs/generated/docs-index.artisan-payments-stripe.json +33 -33
- package/src/components/docs/generated/docs-index.audit-trail.json +49 -49
- package/src/components/docs/generated/docs-index.calendar-google.json +9 -9
- package/src/components/docs/generated/docs-index.content-generation.json +9 -9
- package/src/components/docs/generated/docs-index.control-plane.json +17 -17
- package/src/components/docs/generated/docs-index.crm-pipeline.json +161 -161
- package/src/components/docs/generated/docs-index.data-grid-showcase.json +25 -17
- package/src/components/docs/generated/docs-index.defineExample.json +9 -9
- package/src/components/docs/generated/docs-index.email-gmail.json +9 -9
- package/src/components/docs/generated/docs-index.feature-flags.json +217 -217
- package/src/components/docs/generated/docs-index.files.json +177 -177
- package/src/components/docs/generated/docs-index.generated.ts +20 -20
- package/src/components/docs/generated/docs-index.harness-lab.json +9 -9
- package/src/components/docs/generated/docs-index.health.json +97 -97
- package/src/components/docs/generated/docs-index.identity-rbac.json +313 -313
- package/src/components/docs/generated/docs-index.in-app-docs.json +9 -9
- package/src/components/docs/generated/docs-index.integration-hub.json +265 -265
- package/src/components/docs/generated/docs-index.integration-posthog.json +9 -9
- package/src/components/docs/generated/docs-index.integration-stripe.json +9 -9
- package/src/components/docs/generated/docs-index.integration-supabase.json +9 -9
- package/src/components/docs/generated/docs-index.jobs.json +137 -137
- package/src/components/docs/generated/docs-index.kb-update-pipeline.json +129 -129
- package/src/components/docs/generated/docs-index.knowledge-canon.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-ambient-coach.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-crm-onboarding.json +49 -49
- package/src/components/docs/generated/docs-index.learning-journey-duo-drills.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-platform-tour.json +49 -49
- package/src/components/docs/generated/docs-index.learning-journey-quest-challenges.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-registry.json +33 -33
- package/src/components/docs/generated/docs-index.learning-journey-studio-onboarding.json +49 -49
- package/src/components/docs/generated/docs-index.learning-journey-ui-coaching.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-ui-gamified.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-ui-onboarding.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey-ui-shared.json +9 -9
- package/src/components/docs/generated/docs-index.learning-journey.json +241 -217
- package/src/components/docs/generated/docs-index.learning-patterns.json +9 -9
- package/src/components/docs/generated/docs-index.lifecycle-cli.json +9 -9
- package/src/components/docs/generated/docs-index.lifecycle-dashboard.json +9 -9
- package/src/components/docs/generated/docs-index.locale-jurisdiction-gate.json +65 -57
- package/src/components/docs/generated/docs-index.manifest.json +432 -432
- package/src/components/docs/generated/docs-index.marketplace.json +337 -337
- package/src/components/docs/generated/docs-index.meeting-recorder-providers.json +9 -9
- package/src/components/docs/generated/docs-index.meeting-recorder.json +49 -49
- package/src/components/docs/generated/docs-index.messaging-agent-actions.json +17 -17
- package/src/components/docs/generated/docs-index.metrics.json +201 -201
- package/src/components/docs/generated/docs-index.minimal.json +17 -17
- package/src/components/docs/generated/docs-index.mobile-demo-tasks.json +33 -33
- package/src/components/docs/generated/docs-index.notifications.json +65 -65
- package/src/components/docs/generated/docs-index.openbanking-powens.json +9 -9
- package/src/components/docs/generated/docs-index.openbanking.json +65 -65
- package/src/components/docs/generated/docs-index.opencode-cli.json +17 -17
- package/src/components/docs/generated/docs-index.personalization.json +9 -9
- package/src/components/docs/generated/docs-index.platform-acp.json +137 -137
- package/src/components/docs/generated/docs-index.platform-agent.json +201 -185
- package/src/components/docs/generated/docs-index.platform-context.json +121 -105
- package/src/components/docs/generated/docs-index.platform-control-plane.json +321 -321
- package/src/components/docs/generated/docs-index.platform-database.json +89 -89
- package/src/components/docs/generated/docs-index.platform-docs.json +161 -153
- package/src/components/docs/generated/docs-index.platform-harness.json +177 -177
- package/src/components/docs/generated/docs-index.platform-integrations.json +329 -329
- package/src/components/docs/generated/docs-index.platform-knowledge.json +57 -57
- package/src/components/docs/generated/docs-index.platform-provider-ranking.json +217 -185
- package/src/components/docs/generated/docs-index.pocket-family-office.json +129 -129
- package/src/components/docs/generated/docs-index.policy-safe-knowledge-assistant.json +9 -9
- package/src/components/docs/generated/docs-index.product-intent.json +9 -9
- package/src/components/docs/generated/docs-index.project-management-sync.json +9 -9
- package/src/components/docs/generated/docs-index.saas-boilerplate.json +209 -209
- package/src/components/docs/generated/docs-index.service-business-os.json +193 -193
- package/src/components/docs/generated/docs-index.team-hub.json +185 -185
- package/src/components/docs/generated/docs-index.unknown.json +521 -521
- package/src/components/docs/generated/docs-index.versioned-knowledge-base.json +81 -81
- package/src/components/docs/generated/docs-index.video-api-showcase.json +33 -33
- package/src/components/docs/generated/docs-index.video-docs-terminal.json +9 -9
- package/src/components/docs/generated/docs-index.video-marketing-clip.json +9 -9
- package/src/components/docs/generated/docs-index.visualization-showcase.json +17 -17
- package/src/components/docs/generated/docs-index.voice-providers.json +9 -9
- package/src/components/docs/generated/docs-index.wealth-snapshot.json +153 -153
- package/src/components/docs/generated/docs-index.workflow-system.json +433 -433
- package/src/components/docs/generated/docs-index.workspace-cli.json +9 -9
- package/src/components/docs/getting-started/CLIPage.tsx +10 -2
- package/src/components/docs/getting-started/DataViewTutorialPage.tsx +63 -70
- package/src/components/docs/getting-started/StartHerePage.tsx +10 -9
- package/src/components/docs/guides/GuideConnectInRepoPage.tsx +52 -3
- package/src/components/docs/guides/GuideHostBuilderWorkbenchPage.tsx +55 -6
- package/src/components/docs/guides/GuideReleaseCapsulesPage.tsx +147 -0
- package/src/components/docs/guides/GuidesIndexPage.tsx +7 -0
- package/src/components/docs/guides/index.ts +1 -0
- package/src/components/docs/libraries/LibrariesContractsPage.tsx +72 -27
- package/src/components/docs/libraries/LibrariesDesignSystemPage.tsx +67 -61
- package/src/components/docs/libraries/LibrariesOverviewPage.tsx +7 -1
- package/src/components/docs/libraries/LibrariesUIKitPage.tsx +63 -25
- package/src/components/docs/libraries/LibrariesUIKitWebPage.tsx +115 -0
- package/src/components/docs/libraries/index.ts +1 -0
- package/src/components/docs/specs/SpecsBuilderControlPlanePage.tsx +58 -3
- package/src/components/docs/specs/SpecsConnectPage.tsx +30 -0
- package/src/components/docs/specs/SpecsDataViewsPage.tsx +63 -42
|
@@ -1,17 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
bun run --cwd packages/apps/web-landing dev
|
|
4
|
-
|
|
5
|
-
# Open in the browser
|
|
6
|
-
# 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
|
|
7
|
-
bun run --cwd packages/examples/ai-chat-assistant test
|
|
8
|
-
bun run --cwd packages/apps/web-landing dev
|
|
9
|
-
|
|
10
|
-
# Open in the browser
|
|
11
|
-
# 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
|
|
12
|
-
bun run --cwd packages/examples/messaging-agent-actions test
|
|
13
|
-
bun run --cwd packages/examples/messaging-agent-actions proof
|
|
14
|
-
bun run --cwd packages/apps/web-landing dev
|
|
15
|
-
|
|
16
|
-
# Open in the browser
|
|
17
|
-
# http://localhost:3000/sandbox?template=messaging-agent-actions`}};function r(o){return m[o]}import{ButtonLink as n,CodeBlock as p}from"@contractspec/lib.design-system";import d from"@contractspec/lib.ui-link";import{getExample as g}from"@contractspec/module.examples";import{FileCode2 as u,Play as f,TerminalSquare as h}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function y({exampleKey:o}){let t=r(o),s=g(o);if(!t||!s)return null;let i=s.meta.title??s.meta.key,c=s.meta.summary??s.meta.description??"",l=s.entrypoints.packageName;return a("div",{className:"space-y-10",children:[a("section",{className:"space-y-5",children:[e("p",{className:"editorial-kicker",children:"Meetup-ready example"}),e("h1",{className:"editorial-title max-w-5xl",children:i}),e("p",{className:"editorial-subtitle",children:t.lead}),e("p",{className:"editorial-copy max-w-4xl",children:c}),a("div",{className:"flex flex-wrap gap-3",children:[e(n,{href:t.sandboxHref,children:"Open sandbox"}),e(n,{href:t.referenceHref,variant:"outline",children:"Generated reference"})]})]}),a("section",{className:"grid gap-5 lg:grid-cols-3",children:[a("article",{className:"editorial-panel space-y-4",children:[a("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(f,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Sandbox preview"})]}),e("p",{className:"editorial-copy text-sm",children:"Load the same public browser surface used for the prepared live demo."}),e(n,{href:t.sandboxHref,size:"sm",children:"Open preview"})]}),a("article",{className:"editorial-panel space-y-4",children:[a("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(u,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Reference docs"})]}),e("p",{className:"editorial-copy text-sm",children:"Inspect the generated contract-facing material instead of relying on marketing summaries."}),e(n,{href:t.referenceHref,size:"sm",variant:"outline",children:"Open reference"})]}),a("article",{className:"editorial-panel space-y-4",children:[a("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(h,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Package context"})]}),e("p",{className:"editorial-copy text-sm",children:"Use the agent-facing package page for fast repo orientation, then jump to the source directory."}),e("p",{className:"rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",children:l}),a("div",{className:"flex flex-wrap gap-2",children:[e(n,{href:t.llmsHref,size:"sm",variant:"outline",children:"LLMS page"}),e(n,{href:t.repoHref,size:"sm",variant:"outline",children:"GitHub source"})]})]})]}),a("section",{className:"editorial-panel space-y-5",children:[a("div",{className:"space-y-2",children:[e("p",{className:"editorial-kicker",children:"Talk commands"}),e("h2",{className:"editorial-panel-title",children:"Exact local commands for the meetup lane"}),e("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."})]}),e(p,{language:"bash",filename:`${o}-meetup-runbook`,code:t.localCommands}),a("p",{className:"text-muted-foreground text-sm",children:["For the full fallback order and safe live-edit workflow, use"," ",e(d,{href:"https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",children:"the meetup runbook"}),"."]})]})]})}export{y as ExampleShowcasePage};
|
|
1
|
+
import{buildExampleDocsHref as m,buildExampleReferenceHref as p,getExamplePreviewHref as d,getPublicExample as g}from"@contractspec/module.examples";var f={"agent-console":"Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.","ai-chat-assistant":"Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.","data-grid-showcase":"Canonical table example for the full ContractSpec stack: declarative DataView contract, shared controller, raw web primitive, native-first primitive, and the composed design-system wrapper.","messaging-agent-actions":"Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations."},u={"agent-console":"/docs/reference/agent-console/agent-console","ai-chat-assistant":"/docs/reference/ai-chat-assistant/assistant.search","data-grid-showcase":"/docs/reference/data-grid-showcase/data-grid-showcase","messaging-agent-actions":"/docs/reference/messaging-agent-actions/messaging.agentActions.process"};function c(r){let a=g(r);if(!a)return;let o=a.entrypoints.packageName.replace("@contractspec/example.",""),n=m(r),i=d(r);return{key:r,lead:f[r]??a.meta.summary??a.meta.description??"Public ContractSpec reference example.",sandboxHref:i,referenceHref:u[r]??p(r),llmsHref:`/llms/${a.entrypoints.packageName.replace("@contractspec/","")}`,repoHref:`https://github.com/lssm-tech/contractspec/tree/main/packages/examples/${o}`,localCommands:h(o,n,i)}}function h(r,a,o){let n=[`bun run --cwd packages/examples/${r} build`,"bun run --cwd packages/apps/web-landing dev","","# Open in the browser",`# http://localhost:3000${a}`];if(o)n.push(`# http://localhost:3000${o}`);return n.join(`
|
|
2
|
+
`)}import{ButtonLink as s,CodeBlock as b}from"@contractspec/lib.design-system";import N from"@contractspec/lib.ui-link";import{getExample as v}from"@contractspec/module.examples";import{FileCode2 as k,Play as w,TerminalSquare as y}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function R({exampleKey:r}){let a=c(r),o=v(r);if(!a||!o)return null;let n=o.meta.title??o.meta.key,i=o.meta.summary??o.meta.description??"",l=o.entrypoints.packageName;return t("div",{className:"space-y-10",children:[t("section",{className:"space-y-5",children:[e("p",{className:"editorial-kicker",children:"Meetup-ready example"}),e("h1",{className:"editorial-title max-w-5xl",children:n}),e("p",{className:"editorial-subtitle",children:a.lead}),e("p",{className:"editorial-copy max-w-4xl",children:i}),t("div",{className:"flex flex-wrap gap-3",children:[a.sandboxHref?e(s,{href:a.sandboxHref,children:"Open sandbox"}):null,e(s,{href:a.referenceHref,variant:"outline",children:"Generated reference"})]})]}),t("section",{className:"grid gap-5 lg:grid-cols-3",children:[a.sandboxHref?t("article",{className:"editorial-panel space-y-4",children:[t("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(w,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Sandbox preview"})]}),e("p",{className:"editorial-copy text-sm",children:"Load the same public browser surface used for the prepared live demo."}),e(s,{href:a.sandboxHref,size:"sm",children:"Open preview"})]}):null,t("article",{className:"editorial-panel space-y-4",children:[t("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(k,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Reference docs"})]}),e("p",{className:"editorial-copy text-sm",children:"Inspect the generated contract-facing material instead of relying on marketing summaries."}),e(s,{href:a.referenceHref,size:"sm",variant:"outline",children:"Open reference"})]}),t("article",{className:"editorial-panel space-y-4",children:[t("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(y,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Package context"})]}),e("p",{className:"editorial-copy text-sm",children:"Use the agent-facing package page for fast repo orientation, then jump to the source directory."}),e("p",{className:"rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",children:l}),t("div",{className:"flex flex-wrap gap-2",children:[e(s,{href:a.llmsHref,size:"sm",variant:"outline",children:"LLMS page"}),e(s,{href:a.repoHref,size:"sm",variant:"outline",children:"GitHub source"})]})]})]}),t("section",{className:"editorial-panel space-y-5",children:[t("div",{className:"space-y-2",children:[e("p",{className:"editorial-kicker",children:"Talk commands"}),e("h2",{className:"editorial-panel-title",children:"Exact local commands for the meetup lane"}),e("p",{className:"editorial-copy text-sm",children:"Build the example package, then launch the web shell and open the prepared docs or sandbox route."})]}),e(b,{language:"bash",filename:`${r}-meetup-runbook`,code:a.localCommands}),t("p",{className:"text-muted-foreground text-sm",children:["For the full fallback order and safe live-edit workflow, use"," ",e(N,{href:"https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",children:"the meetup runbook"}),"."]})]})]})}export{R as ExampleShowcasePage};
|
|
@@ -1,17 +1,2 @@
|
|
|
1
|
-
var
|
|
2
|
-
|
|
3
|
-
bun run --cwd packages/apps/web-landing dev
|
|
4
|
-
|
|
5
|
-
# Open in the browser
|
|
6
|
-
# 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
|
|
7
|
-
bun run --cwd packages/examples/ai-chat-assistant test
|
|
8
|
-
bun run --cwd packages/apps/web-landing dev
|
|
9
|
-
|
|
10
|
-
# Open in the browser
|
|
11
|
-
# 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
|
|
12
|
-
bun run --cwd packages/examples/messaging-agent-actions test
|
|
13
|
-
bun run --cwd packages/examples/messaging-agent-actions proof
|
|
14
|
-
bun run --cwd packages/apps/web-landing dev
|
|
15
|
-
|
|
16
|
-
# Open in the browser
|
|
17
|
-
# http://localhost:3000/sandbox?template=messaging-agent-actions`}};function s(e){return a[e]}export{s as getExampleShowcaseData};
|
|
1
|
+
import{buildExampleDocsHref as r,buildExampleReferenceHref as o,getExamplePreviewHref as c,getPublicExample as i}from"@contractspec/module.examples";var l={"agent-console":"Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.","ai-chat-assistant":"Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.","data-grid-showcase":"Canonical table example for the full ContractSpec stack: declarative DataView contract, shared controller, raw web primitive, native-first primitive, and the composed design-system wrapper.","messaging-agent-actions":"Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations."},g={"agent-console":"/docs/reference/agent-console/agent-console","ai-chat-assistant":"/docs/reference/ai-chat-assistant/assistant.search","data-grid-showcase":"/docs/reference/data-grid-showcase/data-grid-showcase","messaging-agent-actions":"/docs/reference/messaging-agent-actions/messaging.agentActions.process"};function d(e){let a=i(e);if(!a)return;let t=a.entrypoints.packageName.replace("@contractspec/example.",""),s=r(e),n=c(e);return{key:e,lead:l[e]??a.meta.summary??a.meta.description??"Public ContractSpec reference example.",sandboxHref:n,referenceHref:g[e]??o(e),llmsHref:`/llms/${a.entrypoints.packageName.replace("@contractspec/","")}`,repoHref:`https://github.com/lssm-tech/contractspec/tree/main/packages/examples/${t}`,localCommands:p(t,s,n)}}function p(e,a,t){let s=[`bun run --cwd packages/examples/${e} build`,"bun run --cwd packages/apps/web-landing dev","","# Open in the browser",`# http://localhost:3000${a}`];if(t)s.push(`# http://localhost:3000${t}`);return s.join(`
|
|
2
|
+
`)}export{d as getExampleShowcaseData};
|
|
@@ -1,17 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
bun run --cwd packages/apps/web-landing dev
|
|
4
|
-
|
|
5
|
-
# Open in the browser
|
|
6
|
-
# 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
|
|
7
|
-
bun run --cwd packages/examples/ai-chat-assistant test
|
|
8
|
-
bun run --cwd packages/apps/web-landing dev
|
|
9
|
-
|
|
10
|
-
# Open in the browser
|
|
11
|
-
# 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
|
|
12
|
-
bun run --cwd packages/examples/messaging-agent-actions test
|
|
13
|
-
bun run --cwd packages/examples/messaging-agent-actions proof
|
|
14
|
-
bun run --cwd packages/apps/web-landing dev
|
|
15
|
-
|
|
16
|
-
# Open in the browser
|
|
17
|
-
# http://localhost:3000/sandbox?template=messaging-agent-actions`}};function i(t){return h[t]}import{ExampleCatalogDataView as d}from"@contractspec/lib.contracts-spec/docs";import{ButtonLink as m,DataViewList as b,StatusChip as k}from"@contractspec/lib.design-system";import{HStack as N,VStack as p}from"@contractspec/lib.ui-kit-web/ui/stack";import{H1 as v,Muted as g}from"@contractspec/lib.ui-kit-web/ui/typography";import{listExamples as w}from"@contractspec/module.examples";import{jsx as o,jsxs as l}from"react/jsx-runtime";function H(t){return`/docs/reference/${t}/${t}`}function y(t){return i(t)?.sandboxHref?`/docs/examples/${t}`:H(t)}function P(){let t=w().map((a)=>{let c=a.meta.title??a.meta.key;return{id:a.meta.key,title:c,summary:a.meta.summary??a.meta.description,route:y(a.meta.key),tags:a.meta.tags,sandboxEnabled:a.surfaces.sandbox.enabled}}).sort((a,c)=>a.title.localeCompare(c.title)),s={...d,view:{...d.view,kind:"list"}};return l(p,{gap:"xl",children:[l(p,{gap:"sm",children:[o(v,{children:"Examples"}),o(g,{children:"Reference implementations for real ContractSpec surfaces. Use them to study adoption patterns, inspect generated artifacts, and validate the OSS workflow against runnable systems."})]}),o(b,{spec:s,items:t,emptyState:o(g,{children:"No examples available."}),renderActions:(a)=>{return l(N,{gap:"xs",justify:"end",children:[a.sandboxEnabled?o(m,{href:`/sandbox?template=${a.id}`,size:"sm",variant:"outline",children:"Sandbox"}):null,o(m,{href:a.route,size:"sm",children:"Reference"}),a.tags?.[0]?o(k,{size:"sm",label:a.tags[0]}):null]})}})]})}import{ButtonLink as r,CodeBlock as E}from"@contractspec/lib.design-system";import L from"@contractspec/lib.ui-link";import{getExample as S}from"@contractspec/module.examples";import{FileCode2 as z,Play as O,TerminalSquare as B}from"lucide-react";import{jsx as e,jsxs as n}from"react/jsx-runtime";function C({exampleKey:t}){let s=i(t),a=S(t);if(!s||!a)return null;let c=a.meta.title??a.meta.key,f=a.meta.summary??a.meta.description??"",u=a.entrypoints.packageName;return n("div",{className:"space-y-10",children:[n("section",{className:"space-y-5",children:[e("p",{className:"editorial-kicker",children:"Meetup-ready example"}),e("h1",{className:"editorial-title max-w-5xl",children:c}),e("p",{className:"editorial-subtitle",children:s.lead}),e("p",{className:"editorial-copy max-w-4xl",children:f}),n("div",{className:"flex flex-wrap gap-3",children:[e(r,{href:s.sandboxHref,children:"Open sandbox"}),e(r,{href:s.referenceHref,variant:"outline",children:"Generated reference"})]})]}),n("section",{className:"grid gap-5 lg:grid-cols-3",children:[n("article",{className:"editorial-panel space-y-4",children:[n("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(O,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Sandbox preview"})]}),e("p",{className:"editorial-copy text-sm",children:"Load the same public browser surface used for the prepared live demo."}),e(r,{href:s.sandboxHref,size:"sm",children:"Open preview"})]}),n("article",{className:"editorial-panel space-y-4",children:[n("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(z,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Reference docs"})]}),e("p",{className:"editorial-copy text-sm",children:"Inspect the generated contract-facing material instead of relying on marketing summaries."}),e(r,{href:s.referenceHref,size:"sm",variant:"outline",children:"Open reference"})]}),n("article",{className:"editorial-panel space-y-4",children:[n("div",{className:"flex items-center gap-3",children:[e("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:e(B,{size:18})}),e("h2",{className:"font-semibold text-xl",children:"Package context"})]}),e("p",{className:"editorial-copy text-sm",children:"Use the agent-facing package page for fast repo orientation, then jump to the source directory."}),e("p",{className:"rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",children:u}),n("div",{className:"flex flex-wrap gap-2",children:[e(r,{href:s.llmsHref,size:"sm",variant:"outline",children:"LLMS page"}),e(r,{href:s.repoHref,size:"sm",variant:"outline",children:"GitHub source"})]})]})]}),n("section",{className:"editorial-panel space-y-5",children:[n("div",{className:"space-y-2",children:[e("p",{className:"editorial-kicker",children:"Talk commands"}),e("h2",{className:"editorial-panel-title",children:"Exact local commands for the meetup lane"}),e("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."})]}),e(E,{language:"bash",filename:`${t}-meetup-runbook`,code:s.localCommands}),n("p",{className:"text-muted-foreground text-sm",children:["For the full fallback order and safe live-edit workflow, use"," ",e(L,{href:"https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",children:"the meetup runbook"}),"."]})]})]})}export{C as ExampleShowcasePage,P as DocsExamplesPage};
|
|
1
|
+
import{ExampleCatalogDataView as d}from"@contractspec/lib.contracts-spec/docs";import{ButtonLink as m,DataViewList as h,StatusChip as b}from"@contractspec/lib.design-system";import{HStack as N,VStack as p}from"@contractspec/lib.ui-kit-web/ui/stack";import{H1 as v,Muted as g}from"@contractspec/lib.ui-kit-web/ui/typography";import{buildExampleDocsHref as w,listPublicExamples as k}from"@contractspec/module.examples";import{jsx as i,jsxs as l}from"react/jsx-runtime";function y(){let r=k().map((e)=>{let n=e.meta.title??e.meta.key;return{id:e.meta.key,title:n,summary:e.meta.summary??e.meta.description,route:w(e.meta.key),tags:e.meta.tags,sandboxEnabled:e.surfaces.sandbox.enabled}}).sort((e,n)=>e.title.localeCompare(n.title)),t={...d,view:{...d.view,kind:"list"}};return l(p,{gap:"xl",children:[l(p,{gap:"sm",children:[i(v,{children:"Examples"}),i(g,{children:"Reference implementations for real ContractSpec surfaces. Use them to study adoption patterns, inspect generated artifacts, and validate the OSS workflow against runnable systems."})]}),i(h,{spec:t,items:r,emptyState:i(g,{children:"No examples available."}),renderActions:(e)=>{return l(N,{gap:"xs",justify:"end",children:[e.sandboxEnabled?i(m,{href:`/sandbox?template=${e.id}`,size:"sm",variant:"outline",children:"Sandbox"}):null,i(m,{href:e.route,size:"sm",children:"Reference"}),e.tags?.[0]?i(b,{size:"sm",label:e.tags[0]}):null]})}})]})}import{buildExampleDocsHref as E,buildExampleReferenceHref as H,getExamplePreviewHref as P,getPublicExample as L}from"@contractspec/module.examples";var S={"agent-console":"Primary meetup path for autonomous agents: typed tools, agent configs, run history, and execution logs in one regenerable surface.","ai-chat-assistant":"Secondary meetup path for MCP-aware assistants: reasoning, sources, suggestions, and a minimal contract-backed search tool.","data-grid-showcase":"Canonical table example for the full ContractSpec stack: declarative DataView contract, shared controller, raw web primitive, native-first primitive, and the composed design-system wrapper.","messaging-agent-actions":"Live messaging lane for the meetup: inbound Slack, WhatsApp, or Telegram messages route through fixed intents, allowlisted actions, and deterministic confirmations."},R={"agent-console":"/docs/reference/agent-console/agent-console","ai-chat-assistant":"/docs/reference/ai-chat-assistant/assistant.search","data-grid-showcase":"/docs/reference/data-grid-showcase/data-grid-showcase","messaging-agent-actions":"/docs/reference/messaging-agent-actions/messaging.agentActions.process"};function f(r){let t=L(r);if(!t)return;let e=t.entrypoints.packageName.replace("@contractspec/example.",""),n=E(r),c=P(r);return{key:r,lead:S[r]??t.meta.summary??t.meta.description??"Public ContractSpec reference example.",sandboxHref:c,referenceHref:R[r]??H(r),llmsHref:`/llms/${t.entrypoints.packageName.replace("@contractspec/","")}`,repoHref:`https://github.com/lssm-tech/contractspec/tree/main/packages/examples/${e}`,localCommands:C(e,n,c)}}function C(r,t,e){let n=[`bun run --cwd packages/examples/${r} build`,"bun run --cwd packages/apps/web-landing dev","","# Open in the browser",`# http://localhost:3000${t}`];if(e)n.push(`# http://localhost:3000${e}`);return n.join(`
|
|
2
|
+
`)}import{ButtonLink as s,CodeBlock as z}from"@contractspec/lib.design-system";import B from"@contractspec/lib.ui-link";import{getExample as D}from"@contractspec/module.examples";import{FileCode2 as O,Play as $,TerminalSquare as F}from"lucide-react";import{jsx as a,jsxs as o}from"react/jsx-runtime";function A({exampleKey:r}){let t=f(r),e=D(r);if(!t||!e)return null;let n=e.meta.title??e.meta.key,c=e.meta.summary??e.meta.description??"",u=e.entrypoints.packageName;return o("div",{className:"space-y-10",children:[o("section",{className:"space-y-5",children:[a("p",{className:"editorial-kicker",children:"Meetup-ready example"}),a("h1",{className:"editorial-title max-w-5xl",children:n}),a("p",{className:"editorial-subtitle",children:t.lead}),a("p",{className:"editorial-copy max-w-4xl",children:c}),o("div",{className:"flex flex-wrap gap-3",children:[t.sandboxHref?a(s,{href:t.sandboxHref,children:"Open sandbox"}):null,a(s,{href:t.referenceHref,variant:"outline",children:"Generated reference"})]})]}),o("section",{className:"grid gap-5 lg:grid-cols-3",children:[t.sandboxHref?o("article",{className:"editorial-panel space-y-4",children:[o("div",{className:"flex items-center gap-3",children:[a("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:a($,{size:18})}),a("h2",{className:"font-semibold text-xl",children:"Sandbox preview"})]}),a("p",{className:"editorial-copy text-sm",children:"Load the same public browser surface used for the prepared live demo."}),a(s,{href:t.sandboxHref,size:"sm",children:"Open preview"})]}):null,o("article",{className:"editorial-panel space-y-4",children:[o("div",{className:"flex items-center gap-3",children:[a("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:a(O,{size:18})}),a("h2",{className:"font-semibold text-xl",children:"Reference docs"})]}),a("p",{className:"editorial-copy text-sm",children:"Inspect the generated contract-facing material instead of relying on marketing summaries."}),a(s,{href:t.referenceHref,size:"sm",variant:"outline",children:"Open reference"})]}),o("article",{className:"editorial-panel space-y-4",children:[o("div",{className:"flex items-center gap-3",children:[a("div",{className:"rounded-full border border-border/80 bg-background/85 p-2",children:a(F,{size:18})}),a("h2",{className:"font-semibold text-xl",children:"Package context"})]}),a("p",{className:"editorial-copy text-sm",children:"Use the agent-facing package page for fast repo orientation, then jump to the source directory."}),a("p",{className:"rounded-[18px] border border-border/70 bg-background/75 px-4 py-3 font-mono text-sm",children:u}),o("div",{className:"flex flex-wrap gap-2",children:[a(s,{href:t.llmsHref,size:"sm",variant:"outline",children:"LLMS page"}),a(s,{href:t.repoHref,size:"sm",variant:"outline",children:"GitHub source"})]})]})]}),o("section",{className:"editorial-panel space-y-5",children:[o("div",{className:"space-y-2",children:[a("p",{className:"editorial-kicker",children:"Talk commands"}),a("h2",{className:"editorial-panel-title",children:"Exact local commands for the meetup lane"}),a("p",{className:"editorial-copy text-sm",children:"Build the example package, then launch the web shell and open the prepared docs or sandbox route."})]}),a(z,{language:"bash",filename:`${r}-meetup-runbook`,code:t.localCommands}),o("p",{className:"text-muted-foreground text-sm",children:["For the full fallback order and safe live-edit workflow, use"," ",a(B,{href:"https://github.com/lssm-tech/contractspec/blob/main/docs/meetup-agent-examples-runbook.md",children:"the meetup runbook"}),"."]})]})]})}export{A as ExampleShowcasePage,y as DocsExamplesPage};
|
|
@@ -1,14 +1,15 @@
|
|
|
1
|
-
import{CodeBlock as c,InstallCommand as
|
|
1
|
+
import{CodeBlock as c,InstallCommand as n}from"@contractspec/lib.design-system";import o from"@contractspec/lib.ui-link";import{ChevronRight as i}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function p(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-2",children:[e("h1",{className:"font-bold text-4xl",children:"ContractSpec CLI"}),e("p",{className:"text-lg text-muted-foreground",children:"Command-line interface for creating, building, and validating contract specifications with AI-powered code generation."})]}),a("div",{className:"space-y-6",children:[a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Installation"}),e(n,{package:"contractspec",dev:!0})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Quick Start"}),e(c,{language:"bash",code:`# Initialize project
|
|
2
|
+
contractspec onboard
|
|
2
3
|
bunx contractspec init
|
|
3
4
|
|
|
4
5
|
# Create a spec
|
|
5
6
|
contractspec create --type operation
|
|
6
7
|
|
|
7
8
|
# Generate code
|
|
8
|
-
contractspec
|
|
9
|
+
contractspec generate
|
|
9
10
|
|
|
10
11
|
# Validate
|
|
11
|
-
contractspec validate
|
|
12
|
+
contractspec validate`})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Commands"}),e("div",{className:"grid gap-4",children:[{name:"onboard",description:"Primary OSS onboarding flow that recommends tracks, examples, and repo-local guides",usage:"contractspec onboard [track...] [--example <key>] [--dry-run] [--json]"},{name:"create",description:"Interactive wizard to create contract specifications",usage:"contractspec create [--type operation] [--ai]"},{name:"build",description:"Generate implementation code from contract specs using AI agents",usage:"contractspec build <spec-file> [--agent-mode claude-code]"},{name:"validate",description:"Validate contract specifications and implementations",usage:"contractspec validate <spec-file> [--check-implementation]"},{name:"list",description:"List all contract specifications in the project",usage:"contractspec list [--type operation] [--json]"},{name:"watch",description:"Watch specs and auto-regenerate on changes",usage:"contractspec watch [--build] [--validate]"},{name:"sync",description:"Sync contracts by building all discovered specs",usage:"contractspec sync [--dry-run]"},{name:"ci",description:"Run all validation checks for CI/CD pipelines",usage:"contractspec ci [--format sarif] [--output results.sarif]"},{name:"deps",description:"Analyze contract dependencies and relationships",usage:"contractspec deps [--circular] [--format dot]"},{name:"diff",description:"Compare contract specifications and show differences",usage:"contractspec diff <spec1> <spec2> [--breaking]"}].map((t)=>a("div",{className:"card-subtle space-y-2 p-4",children:[e("h3",{className:"font-bold font-mono text-violet-400",children:t.name}),e("p",{className:"text-muted-foreground text-sm",children:t.description}),e(c,{language:"bash",code:t.usage,showCopyButton:!1})]},t.name))})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"AI Agent Modes"}),e("p",{className:"text-muted-foreground",children:"The CLI supports multiple AI agent modes for different use cases:"}),a("div",{className:"grid gap-3 md:grid-cols-2",children:[a("div",{className:"card-subtle p-4",children:[e("h4",{className:"font-bold",children:"simple"}),e("p",{className:"text-muted-foreground text-sm",children:"Direct LLM API calls, fast and straightforward. Best for rapid prototyping."})]}),a("div",{className:"card-subtle p-4",children:[e("h4",{className:"font-bold",children:"claude-code"}),e("p",{className:"text-muted-foreground text-sm",children:"Extended thinking with Claude. Best for production-quality code."})]}),a("div",{className:"card-subtle p-4",children:[e("h4",{className:"font-bold",children:"openai-codex"}),e("p",{className:"text-muted-foreground text-sm",children:"GPT-4o/o1 models. Excellent for algorithms and optimization."})]}),a("div",{className:"card-subtle p-4",children:[e("h4",{className:"font-bold",children:"cursor"}),e("p",{className:"text-muted-foreground text-sm",children:"Leverages Cursor agentic capabilities. Requires Cursor environment."})]})]})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"CI/CD Integration"}),e("p",{className:"text-muted-foreground",children:"Run all validation checks in CI/CD with machine-readable output:"}),e(c,{language:"yaml",filename:".github/workflows/validate.yml",code:`- name: Validate Contracts
|
|
12
13
|
run: contractspec ci --format sarif --output results.sarif
|
|
13
14
|
|
|
14
15
|
- name: Upload SARIF
|
|
@@ -22,4 +23,4 @@ contractspec validate src/contracts/mySpec.ts`})]}),a("div",{className:"space-y-
|
|
|
22
23
|
"operations": "interactions/commands|queries",
|
|
23
24
|
"events": "events"
|
|
24
25
|
}
|
|
25
|
-
}`})]})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[a(o,{href:"/docs/getting-started/tools/vscode",className:"btn-primary",children:["Next: VS Code Extension ",e(
|
|
26
|
+
}`})]})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[a(o,{href:"/docs/getting-started/tools/vscode",className:"btn-primary",children:["Next: VS Code Extension ",e(i,{size:16})]}),e(o,{href:"/docs/getting-started/tools",className:"btn-ghost",children:"Back to Tools"})]})]})}export{p as CLIPage};
|
|
@@ -1,17 +1,4 @@
|
|
|
1
|
-
import{CodeBlock as a}from"@contractspec/lib.design-system";import i from"@contractspec/lib.ui-link";import{ChevronRight as
|
|
2
|
-
|
|
3
|
-
export const ListTransactions = defineQuery({
|
|
4
|
-
meta: {
|
|
5
|
-
key: 'billing.listTransactions',
|
|
6
|
-
version: '1.0.0',
|
|
7
|
-
description: 'Fetch customer transaction history',
|
|
8
|
-
},
|
|
9
|
-
io: {
|
|
10
|
-
input: /* pagination + filters */,
|
|
11
|
-
output: /* array of transactions */,
|
|
12
|
-
},
|
|
13
|
-
policy: { auth: 'user' },
|
|
14
|
-
});`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"2. Define the DataView spec"}),e("p",{className:"text-muted-foreground",children:"Wrap your query with presentation metadata:"}),e(a,{language:"typescript",filename:"lib/specs/billing/transaction-history.data-view.ts",code:`import { defineDataView } from '@contractspec/lib.contracts-spec';
|
|
1
|
+
import{CodeBlock as a}from"@contractspec/lib.design-system";import i from"@contractspec/lib.ui-link";import{ChevronRight as n}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";var s=`import { defineDataView } from '@contractspec/lib.contracts-spec/data-views';
|
|
15
2
|
import { ListTransactions } from './list-transactions';
|
|
16
3
|
|
|
17
4
|
export const TransactionHistory = defineDataView({
|
|
@@ -19,68 +6,58 @@ export const TransactionHistory = defineDataView({
|
|
|
19
6
|
key: 'billing.transactionHistory',
|
|
20
7
|
version: '1.0.0',
|
|
21
8
|
entity: 'transaction',
|
|
9
|
+
title: 'Transaction History',
|
|
22
10
|
description: 'Customer payment history',
|
|
23
|
-
|
|
24
|
-
context: 'Account dashboard',
|
|
11
|
+
domain: 'billing',
|
|
25
12
|
owners: ['team-billing'],
|
|
26
|
-
stability: 'stable',
|
|
27
13
|
tags: ['payments'],
|
|
14
|
+
stability: 'stable',
|
|
28
15
|
},
|
|
29
16
|
source: {
|
|
30
|
-
primary:
|
|
17
|
+
primary: {
|
|
18
|
+
key: ListTransactions.meta.key,
|
|
19
|
+
version: ListTransactions.meta.version,
|
|
20
|
+
},
|
|
31
21
|
},
|
|
32
22
|
view: {
|
|
33
|
-
kind: '
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
{
|
|
48
|
-
key: 'amount',
|
|
49
|
-
label: 'Amount',
|
|
50
|
-
dataPath: 'amount',
|
|
51
|
-
format: 'currency',
|
|
52
|
-
sortable: true
|
|
53
|
-
},
|
|
54
|
-
{
|
|
55
|
-
key: 'status',
|
|
56
|
-
label: 'Status',
|
|
57
|
-
dataPath: 'status',
|
|
58
|
-
format: 'badge'
|
|
59
|
-
},
|
|
60
|
-
],
|
|
61
|
-
filters: [
|
|
62
|
-
{
|
|
63
|
-
key: 'status',
|
|
64
|
-
label: 'Status',
|
|
65
|
-
field: 'status',
|
|
66
|
-
type: 'enum',
|
|
67
|
-
options: [
|
|
68
|
-
{ value: 'succeeded', label: 'Paid' },
|
|
69
|
-
{ value: 'pending', label: 'Pending' },
|
|
70
|
-
{ value: 'failed', label: 'Failed' },
|
|
71
|
-
],
|
|
72
|
-
},
|
|
73
|
-
{
|
|
74
|
-
key: 'dateRange',
|
|
75
|
-
label: 'Date Range',
|
|
76
|
-
field: 'createdAt',
|
|
77
|
-
type: 'dateRange',
|
|
23
|
+
kind: 'table',
|
|
24
|
+
executionMode: 'client',
|
|
25
|
+
selection: 'multiple',
|
|
26
|
+
columnVisibility: true,
|
|
27
|
+
columnResizing: true,
|
|
28
|
+
columnPinning: true,
|
|
29
|
+
rowExpansion: {
|
|
30
|
+
fields: ['notes', 'renewalDate', 'lastActivityAt'],
|
|
31
|
+
},
|
|
32
|
+
initialState: {
|
|
33
|
+
pageSize: 4,
|
|
34
|
+
hiddenColumns: ['notes'],
|
|
35
|
+
pinnedColumns: {
|
|
36
|
+
left: ['account'],
|
|
78
37
|
},
|
|
38
|
+
sorting: [{ field: 'arr', desc: true }],
|
|
39
|
+
},
|
|
40
|
+
fields: [
|
|
41
|
+
{ key: 'account', label: 'Account', dataPath: 'account', sortable: true },
|
|
42
|
+
{ key: 'owner', label: 'Owner', dataPath: 'owner', sortable: true },
|
|
43
|
+
{ key: 'status', label: 'Status', dataPath: 'status', sortable: true },
|
|
44
|
+
{ key: 'notes', label: 'Notes', dataPath: 'notes' },
|
|
79
45
|
],
|
|
80
|
-
defaultSort: { field: 'date', direction: 'desc' },
|
|
81
|
-
pagination: { pageSize: 25 },
|
|
82
46
|
},
|
|
83
|
-
})
|
|
47
|
+
});`;function c(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Display Data with DataViews"}),e("p",{className:"text-lg text-muted-foreground",children:"Define a filterable, sortable transaction history view that works across web and mobile without duplicating UI code."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"1. Define the underlying query"}),e("p",{className:"text-muted-foreground",children:"First, create a query operation to fetch the data:"}),e(a,{language:"typescript",filename:"lib/specs/billing/list-transactions.ts",code:`import { defineQuery } from '@contractspec/lib.contracts-spec';
|
|
48
|
+
|
|
49
|
+
export const ListTransactions = defineQuery({
|
|
50
|
+
meta: {
|
|
51
|
+
key: 'billing.listTransactions',
|
|
52
|
+
version: '1.0.0',
|
|
53
|
+
description: 'Fetch customer transaction history',
|
|
54
|
+
},
|
|
55
|
+
io: {
|
|
56
|
+
input: /* pagination + filters */,
|
|
57
|
+
output: /* array of transactions */,
|
|
58
|
+
},
|
|
59
|
+
policy: { auth: 'user' },
|
|
60
|
+
});`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"2. Define the DataView spec"}),e("p",{className:"text-muted-foreground",children:"Wrap your query with presentation metadata:"}),e(a,{language:"typescript",filename:"lib/specs/billing/transaction-history.data-view.ts",code:s}),t("p",{className:"text-muted-foreground text-sm",children:["The live version of this pattern is available in the canonical"," ",e(i,{href:"/docs/examples/data-grid-showcase",className:"text-[color:var(--rust)] underline underline-offset-4",children:"Data Grid Showcase"}),"."]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"3. Render on the frontend"}),e("p",{className:"text-muted-foreground",children:"Use the runtime renderer in your React or React Native app:"}),e(a,{language:"tsx",filename:"app/dashboard/transactions/page.tsx",code:`'use client';
|
|
84
61
|
|
|
85
62
|
import { DataViewRenderer } from '@contractspec/lib.design-system';
|
|
86
63
|
import { TransactionHistory } from '@/lib/specs/billing/transaction-history.data-view';
|
|
@@ -105,4 +82,4 @@ export function TransactionsPage() {
|
|
|
105
82
|
/>
|
|
106
83
|
</div>
|
|
107
84
|
);
|
|
108
|
-
}`})]}),t("div",{className:"card-subtle space-y-4 p-6",children:[e("h3",{className:"font-bold",children:"Why DataViews?"}),t("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[e("li",{children:"Same spec renders on web (React) and mobile (React Native)"}),e("li",{children:"Filters, sorting, and pagination handled automatically"}),e("li",{children:"Format rules (currency, dates, badges) applied consistently"}),e("li",{children:"Export to CSV/PDF using the same spec"}),e("li",{children:"A/B test different layouts without touching the backend"})]})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[t(i,{href:"/docs/libraries/data-views",className:"btn-primary",children:["DataView API Reference ",e(
|
|
85
|
+
}`})]}),t("div",{className:"card-subtle space-y-4 p-6",children:[e("h3",{className:"font-bold",children:"Why DataViews?"}),t("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[e("li",{children:"Same spec renders on web (React) and mobile (React Native)"}),e("li",{children:"Filters, sorting, and pagination handled automatically"}),e("li",{children:"Column visibility, pinning, resizing, and row expansion stay contract-driven"}),e("li",{children:"Format rules (currency, dates, badges) applied consistently"}),e("li",{children:"Export to CSV/PDF using the same spec"}),e("li",{children:"A/B test different layouts without touching the backend"})]})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[t(i,{href:"/docs/libraries/data-views",className:"btn-primary",children:["DataView API Reference ",e(n,{size:16})]}),e(i,{href:"/docs/specs/workflows",className:"btn-ghost",children:"Next: Workflows"})]})]})}export{c as DataViewTutorialPage};
|
|
@@ -1,2 +1,4 @@
|
|
|
1
|
-
import{CodeBlock as
|
|
2
|
-
|
|
1
|
+
import{CodeBlock as t,InstallCommand as c}from"@contractspec/lib.design-system";import o from"@contractspec/lib.ui-link";import{ChevronRight as l}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function d(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-2",children:[e("h1",{className:"font-bold text-4xl",children:"Start here"}),e("p",{className:"text-lg text-muted-foreground",children:"A fast onboarding path from install to your first generated contract."})]}),a("div",{className:"space-y-6",children:[a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Install the CLI"}),e(c,{package:"contractspec",dev:!0})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Generate repo-local guidance"}),e(t,{language:"bash",filename:"start-here-onboard",code:`contractspec onboard
|
|
2
|
+
# optional focused track
|
|
3
|
+
contractspec onboard knowledge --example knowledge-canon`})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Initialize your project"}),e(t,{language:"bash",filename:"start-here-init",code:"bunx contractspec init"})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Author your first contract"}),e(t,{language:"bash",filename:"start-here-create",code:"contractspec create --type operation"})]}),a("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"Generate implementation"}),e(t,{language:"bash",filename:"start-here-build",code:`contractspec generate
|
|
4
|
+
contractspec validate`})]})]}),a("div",{className:"flex flex-wrap items-center gap-3 pt-2",children:[a(o,{href:"/docs/getting-started/hello-world",className:"btn-primary",children:["Next: Hello World ",e(l,{size:16})]}),e(o,{href:"/docs/getting-started/troubleshooting",className:"btn-ghost",children:"Troubleshooting"}),e(o,{href:"/docs/getting-started/compatibility",className:"btn-ghost",children:"Compatibility"})]})]})}export{d as StartHerePage};
|