@contractspec/bundle.library 1.11.1 → 1.13.0

package/dist/node/components/docs/libraries/LibrariesTestingPage.js

@@ -0,0 +1,159 @@
+// src/components/docs/libraries/LibrariesTestingPage.tsx
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesTestingPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "@contractspec/lib.testing"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Golden tests ensure new rollouts behave exactly like the traffic that inspired them. Record requests in production, replay them locally, and ship with confidence."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.testing"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Record traffic"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import {
+  TrafficRecorder,
+  InMemoryTrafficStore,
+} from '@contractspec/lib.testing/recorder';
+
+const recorder = new TrafficRecorder({
+  store: new InMemoryTrafficStore(),
+  sampleRate: 0.02,
+  sanitize: (snapshot) => ({
+    ...snapshot,
+    input: { ...snapshot.input, secret: undefined },
+  }),
+});
+
+await recorder.record({
+  operation: { name: 'orders.create', version: 6 },
+  input: payload,
+  output,
+  success: true,
+  tenantId: ctx.organizationId ?? undefined,
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Generate suites"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `import { GoldenTestGenerator } from '@contractspec/lib.testing';
+
+const generator = new GoldenTestGenerator();
+const code = generator.generate(snapshots, {
+  suiteName: 'orders.create golden path',
+  runnerImport: './tests/run-operation',
+  runnerFunction: 'runOrdersCommand',
+  framework: 'vitest',
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "CLI workflow"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "bash",
+            code: `contractspec test generate \\
+  --operation orders.create \\
+  --output tests/orders.create.golden.test.ts \\
+  --runner-import ./tests/run-operation \\
+  --runner-fn runOrdersCommand \\
+  --from-production \\
+  --days 7 \\
+  --sample-rate 0.05`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "grid gap-4 md:grid-cols-2",
+        children: [
+          {
+            title: "Framework agnostic",
+            description: "Vitest by default, Jest via `generateJestSuite`, or call `runGoldenTests` manually inside CI."
+          },
+          {
+            title: "Sanitize & sample",
+            description: "Scrub payloads before persistence and control sample rates per operation to stay within compliance limits."
+          }
+        ].map((card) => /* @__PURE__ */ jsxDEV("div", {
+          className: "card-subtle space-y-2 p-4",
+          children: [
+            /* @__PURE__ */ jsxDEV("h3", {
+              className: "text-lg font-semibold",
+              children: card.title
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV("p", {
+              className: "text-muted-foreground text-sm",
+              children: card.description
+            }, undefined, false, undefined, this)
+          ]
+        }, card.title, true, undefined, this))
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/resilience",
+            className: "btn-primary",
+            children: [
+              "Next: Resilience ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesTestingPage
+};

package/dist/node/components/docs/libraries/LibrariesUIKitPage.js

@@ -0,0 +1,247 @@
+// src/components/docs/libraries/LibrariesUIKitPage.tsx
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesUIKitPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "@contractspec/lib.ui-kit"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: [
+              "Universal UI components for React Native and Web, built on top of",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: "nativewind"
+              }, undefined, false, undefined, this),
+              " and ",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: "@rn-primitives"
+              }, undefined, false, undefined, this),
+              "."
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.ui-kit"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Key Features"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-muted-foreground list-inside list-disc space-y-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Universal"
+                  }, undefined, false, undefined, this),
+                  ": Components render natively on iOS/Android and as standard HTML on web"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Styled with NativeWind"
+                  }, undefined, false, undefined, this),
+                  ": Uses Tailwind CSS classes for styling"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Accessible"
+                  }, undefined, false, undefined, this),
+                  ": Leverages ",
+                  /* @__PURE__ */ jsxDEV("code", {
+                    children: "@rn-primitives"
+                  }, undefined, false, undefined, this),
+                  " ",
+                  "(Radix UI for Native)"
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: [
+                  /* @__PURE__ */ jsxDEV("strong", {
+                    children: "Atomic Design"
+                  }, undefined, false, undefined, this),
+                  ": Exports atoms, molecules, and organisms"
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Example Usage"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "tsx",
+            code: `import { Button } from '@contractspec/lib.ui-kit/ui/button';
+import { Text } from '@contractspec/lib.ui-kit/ui/text';
+import { Card, CardHeader, CardTitle, CardContent } from '@contractspec/lib.ui-kit/ui/card';
+
+export function MyComponent() {
+  return (
+    <Card className="w-full max-w-md">
+      <CardHeader>
+        <CardTitle>Welcome</CardTitle>
+      </CardHeader>
+      <CardContent className="gap-4">
+        <Text>This works on Web and Native.</Text>
+        <Button onPress={() => console.log('Clicked!')}>
+          Click me
+        </Button>
+      </CardContent>
+    </Card>
+  );
+}`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Core Components"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "grid gap-4 md:grid-cols-3",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-4",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "mb-2 font-semibold",
+                    children: "Form Controls"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("ul", {
+                    className: "text-muted-foreground space-y-1 text-sm",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Button"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Input"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Checkbox"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Switch"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Select"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-4",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "mb-2 font-semibold",
+                    children: "Layout"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("ul", {
+                    className: "text-muted-foreground space-y-1 text-sm",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Card"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Stack"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Separator"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Sheet"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "card-subtle p-4",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h3", {
+                    className: "mb-2 font-semibold",
+                    children: "Feedback"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("ul", {
+                    className: "text-muted-foreground space-y-1 text-sm",
+                    children: [
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Alert"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Skeleton"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Progress"
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: "Tooltip"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/schema",
+            className: "btn-ghost",
+            children: "Previous: Schema"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/design-system",
+            className: "btn-primary",
+            children: [
+              "Next: Design System ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesUIKitPage
+};

package/dist/node/components/docs/libraries/LibrariesWorkflowComposerPage.js

@@ -0,0 +1,108 @@
+// src/components/docs/libraries/LibrariesWorkflowComposerPage.tsx
+import { CodeBlock, InstallCommand } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function LibrariesWorkflowComposerPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Workflow Composer"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: "`@contractspec/lib.workflow-composer` injects tenant-/role-/device-specific steps into base WorkflowSpecs and keeps transitions valid."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Installation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(InstallCommand, {
+            package: "@contractspec/lib.workflow-composer"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Register extensions"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `const composer = new WorkflowComposer();
+
+composer.register({
+  workflow: 'billing.invoiceApproval',
+  tenantId: 'acme',
+  customSteps: [
+    {
+      after: 'validate-invoice',
+      inject: {
+        id: 'acme-legal',
+        type: 'human',
+        label: 'ACME Legal Review',
+      },
+      transitionTo: 'final-approval',
+    },
+  ],
+  hiddenSteps: ['internal-audit'],
+});`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Compose at runtime"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "typescript",
+            code: `const tenantWorkflow = composer.compose({
+  base: BaseInvoiceWorkflow,
+  tenantId: 'acme',
+});
+
+workflowRunner.execute(tenantWorkflow, ctx);`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries",
+            className: "btn-ghost",
+            children: "Back to Libraries"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/libraries/workflows",
+            className: "btn-primary",
+            children: [
+              "Next: Workflow Runtime ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  LibrariesWorkflowComposerPage
+};