@venn-lang/stdlib 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vinicius Borges
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# @venn-lang/stdlib
+
+> The one list of standard-library plugins, plus the fake port implementations the tooling runs them with.
+
+The Venn kernel knows no verbs. Every namespace a `.vn` file can `use` comes from a plugin, and this
+package is where the set of them is named. The CLI runs that list, and the language server reads it
+for completion, hover, highlighting and `venn check`. Adding a plugin to the standard library touches
+this package and nothing else.
+
+## Usage
+
+```ts
+import { createNodeHost } from "@venn-lang/contracts/node";
+import { parse } from "@venn-lang/core";
+import { createMemorySink, createRunner } from "@venn-lang/runtime";
+import { allPlugins, stdlibPortBindings } from "@venn-lang/stdlib";
+
+const { ast, problems } = parse(source, { uri: "flow.vn" });
+if (problems.length > 0) {
+  throw new Error(problems.map((one) => `${one.code} ${one.title}`).join("\n"));
+}
+
+const runner = createRunner({
+  host: createNodeHost(),
+  plugins: allPlugins,
+  sink: createMemorySink(),
+  ports: stdlibPortBindings,
+});
+
+const result = await runner.run(ast);
+```
+
+The flow being run is ordinary Venn source. It declares the namespaces it wants with `use`, and every
+one of them resolves because the whole stdlib is loaded:
+
+```ruby
+module demo.stdlib
+
+use "venn/data"
+use "venn/auth"
+use "venn/db"
+use "venn/assert"
+
+flow "Stdlib showcase" {
+  step "auth builds a bearer header" {
+    const header = auth.bearer "tok123"
+    expect header.Authorization == "Bearer tok123"
+  }
+
+  step "deterministic fake data" {
+    const roll = data.range 1 10
+    expect roll >= 1
+  }
+
+  step "in-memory database" {
+    db.seed { users: [{ id: 1 }, { id: 2 }] }
+    const rows = db.query "SELECT * FROM users"
+    expect rows.len == 2
+  }
+}
+```
+
+## API
+
+| Export | Type | What it is |
+| --- | --- | --- |
+| `allPlugins` | `PluginDefinition[]` | Every stdlib plugin, in load order. Hand it to `createRunner`, `buildRegistry` or `createTypeCatalog`. |
+| `stdlibPortBindings` | `PortBinding[]` | One implementation per stdlib port, fake where a real one would touch the network. Hand it to `createRunner` as `ports`. |
+
+## The plugins
+
+Nineteen plugins, each contributing one namespace. Namespaces are unique across the list, so no
+plugin can shadow another.
+
+| Package | Namespace | Requires | What it contributes |
+| --- | --- | --- | --- |
+| [`@venn-lang/http`](../std-http) | `http` | `net` | Request verbs, response matchers and a nominal `Response` type. |
+| [`@venn-lang/assert`](../std-assert) | `assert` | | Matchers only. `expect` is kernel; the words after it come from here. |
+| [`@venn-lang/data`](../std-data) | `data` | | Deterministic test-data generators. Pure, no port. |
+| [`@venn-lang/crypto`](../std-crypto) | `crypto` | | Digests, encodings, password hashing and JSON Web Tokens. |
+| [`@venn-lang/env`](../std-env) | `env` | | The name only. `env.NAME` is a read, filled from the `[env.*]` tables of `venn.toml`. |
+| [`@venn-lang/fmt`](../std-fmt) | `fmt` | | Value to text: JSON, tables, YAML, CSV, XML. Pure. |
+| [`@venn-lang/io`](../std-io) | `io` | `io` | A script's standard input, output and arguments. |
+| [`@venn-lang/mock`](../std-mock) | `mock` | | In-process mocking, feature flags and a virtual clock. |
+| [`@venn-lang/auth`](../std-auth) | `auth` | `net` | Token and header builders, plus an OAuth2 client port. |
+| [`@venn-lang/notify`](../std-notify) | `notify` | `net` | Notification dispatch through the Notifier port. |
+| [`@venn-lang/ws`](../std-ws) | `ws` | `net` | Connect, send, expect and close over a WebSocket. |
+| [`@venn-lang/mqtt`](../std-mqtt) | `mqtt` | `net` | Connect, publish, subscribe and expect over MQTT. |
+| [`@venn-lang/graphql`](../std-graphql) | `gql` | `net` | Query, mutate and subscribe, with matchers on the response. |
+| [`@venn-lang/grpc`](../std-grpc) | `grpc` | `net` | Call, stream and reflect. |
+| [`@venn-lang/mail`](../std-mail) | `mail` | `net` | Inbox verbs over the MailClient port. |
+| [`@venn-lang/db`](../std-db) | `db` | `net` | Table verbs over the DbClient port. |
+| [`@venn-lang/browser`](../std-browser) | `browser` | `net` | Actions, matchers and a browser resource. |
+| [`@venn-lang/load`](../std-load) | `load` | `net` | Load-profile builders and a runner that yields metrics. |
+| [`@venn-lang/artifacts`](../std-artifacts) | `artifacts` | `fs` | Store references to traces, videos, HARs and screenshots. |
+
+`requires` is negotiated against the host's capabilities before anything runs. A host that does not
+offer `net` fails to load `@venn-lang/http` with a readable diagnostic, not with a `TypeError` halfway
+through a test.
+
+Two tests in this package hold the list to its word: every plugin has a name and a unique namespace,
+every verb carries a signature, and every type reference points at something a plugin actually
+publishes. A dangling reference would otherwise degrade to `dynamic` in silence and the editor would
+simply forget what it knew.
+
+## The port bindings
+
+`stdlibPortBindings` binds each port once. Real third-party integrations are out of scope for this
+repository, so most implementations are the test double that ships alongside the port.
+
+| Port | Implementation | From |
+| --- | --- | --- |
+| `AuthClientPort` | `createFakeAuthClient()` | [`@venn-lang/auth`](../std-auth) |
+| `HttpServerPort` | `createMemoryServer()` | [`@venn-lang/http`](../std-http) |
+| `CryptoEnginePort` | `createWebCryptoEngine()` | [`@venn-lang/crypto`](../std-crypto) |
+| `NotifierPort` | `createFakeNotifier()` | [`@venn-lang/notify`](../std-notify) |
+| `WsClientPort` | `createFakeWsClient({ incoming: [] })` | [`@venn-lang/ws`](../std-ws) |
+| `MqttClientPort` | `createFakeMqttClient()` | [`@venn-lang/mqtt`](../std-mqtt) |
+| `GqlClientPort` | `createFakeGqlClient()` | [`@venn-lang/graphql`](../std-graphql) |
+| `GrpcClientPort` | `createFakeGrpcClient()` | [`@venn-lang/grpc`](../std-grpc) |
+| `MailClientPort` | `createFakeMailClient()` | [`@venn-lang/mail`](../std-mail) |
+| `DbClientPort` | `createFakeDbClient()` | [`@venn-lang/db`](../std-db) |
+| `BrowserDriverPort` | `createFakeBrowserDriver()` | [`@venn-lang/browser`](../std-browser) |
+| `PreviewProviderPort` | `createNonePreviewProvider()` | [`@venn-lang/browser`](../std-browser) |
+| `LoadRunnerPort` | `createFakeLoadRunner()` | [`@venn-lang/load`](../std-load) |
+| `ArtifactStorePort` | `createMemoryArtifactStore()` | [`@venn-lang/artifacts`](../std-artifacts) |
+| `ConsolePort` | `createMemoryConsole()` | [`@venn-lang/contracts`](../contracts) |
+
+Crypto is the exception: it is pure computation rather than a side effect, so the real Web Crypto
+engine is bound and always was.
+
+`HttpClientPort` is deliberately absent. The one plugin with a real client leaves the choice to the
+host, so a test can inject a fake and the CLI can inject `fetch`.
+
+### Overriding a binding
+
+Bindings are resolved by port id and the last one wins, so a host appends its own after the stdlib's:
+
+```ts
+const ports = [
+  { port: HttpClientPort, impl: createFetchClient() },
+  ...stdlibPortBindings,
+  { port: HttpServerPort, impl: createNodeServer() },
+];
+```
+
+That is exactly what the CLI does. `venn test` runs with a real HTTP client, a real Node server and a
+real console, and every other port on its fake, which is why the stdlib example above runs offline.
+
+## See also
+
+- [`@venn-lang/runtime`](../runtime) executes a document against these plugins and ports.
+- [`@venn-lang/sdk`](../sdk) is how each of these plugins is defined, and how a third-party one is.
+- [`@venn-lang/cli`](../cli) assembles the Node host and picks the real implementations.

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { PluginDefinition } from "@venn-lang/sdk";
+import { PortBinding } from "@venn-lang/runtime";
+//#region src/plugins.d.ts
+/**
+ * Every plugin the tooling loads, as one list.
+ *
+ * The CLI runs them; the language server reads their actions and matchers for
+ * completion, hover and highlighting. One list, so the two never disagree about
+ * what the stdlib is.
+ */
+declare const allPlugins: PluginDefinition[];
+//#endregion
+//#region src/port-bindings.d.ts
+/**
+ * A fake implementation for every stdlib port.
+ *
+ * Real third-party integrations are out of scope for this repository, so these
+ * stand in for them. Crypto is the exception noted below. `@venn-lang/http`'s client
+ * is real too (fetch), but the CLI binds it separately so a test can put a fake
+ * in its place.
+ */
+declare const stdlibPortBindings: PortBinding[];
+//#endregion
+export { allPlugins, stdlibPortBindings };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/plugins.ts","../src/port-bindings.ts"],"mappings":";;;;;;;;;;cA4Ba,YAAY;;;;;;;;;;;cCCZ,oBAAoB"}

package/dist/index.js

@@ -0,0 +1,125 @@
+import { ArtifactStorePort, artifactsPlugin, createMemoryArtifactStore } from "@venn-lang/artifacts";
+import { assertPlugin } from "@venn-lang/assert";
+import { AuthClientPort, authPlugin, createFakeAuthClient } from "@venn-lang/auth";
+import { BrowserDriverPort, PreviewProviderPort, browserPlugin, createFakeBrowserDriver, createNonePreviewProvider } from "@venn-lang/browser";
+import { CryptoEnginePort, createWebCryptoEngine, cryptoPlugin } from "@venn-lang/crypto";
+import { dataPlugin } from "@venn-lang/data";
+import { DbClientPort, createFakeDbClient, dbPlugin } from "@venn-lang/db";
+import { envPlugin } from "@venn-lang/env";
+import { fmtPlugin } from "@venn-lang/fmt";
+import { GqlClientPort, createFakeClient, gqlPlugin } from "@venn-lang/graphql";
+import { GrpcClientPort, createFakeClient as createFakeClient$1, grpcPlugin } from "@venn-lang/grpc";
+import { HttpServerPort, createMemoryServer, httpPlugin } from "@venn-lang/http";
+import { ioPlugin } from "@venn-lang/io";
+import { LoadRunnerPort, createFakeLoadRunner, loadPlugin } from "@venn-lang/load";
+import { MailClientPort, createFakeMailClient, mailPlugin } from "@venn-lang/mail";
+import { mockPlugin } from "@venn-lang/mock";
+import { MqttClientPort, createFakeMqttClient, mqttPlugin } from "@venn-lang/mqtt";
+import { NotifierPort, createFakeNotifier, notifyPlugin } from "@venn-lang/notify";
+import { WsClientPort, createFakeWsClient, wsPlugin } from "@venn-lang/ws";
+import { ConsolePort, createMemoryConsole } from "@venn-lang/contracts";
+//#region src/plugins.ts
+/**
+* Every plugin the tooling loads, as one list.
+*
+* The CLI runs them; the language server reads their actions and matchers for
+* completion, hover and highlighting. One list, so the two never disagree about
+* what the stdlib is.
+*/
+const allPlugins = [
+	httpPlugin,
+	assertPlugin,
+	dataPlugin,
+	cryptoPlugin,
+	envPlugin,
+	fmtPlugin,
+	ioPlugin,
+	mockPlugin,
+	authPlugin,
+	notifyPlugin,
+	wsPlugin,
+	mqttPlugin,
+	gqlPlugin,
+	grpcPlugin,
+	mailPlugin,
+	dbPlugin,
+	browserPlugin,
+	loadPlugin,
+	artifactsPlugin
+];
+//#endregion
+//#region src/port-bindings.ts
+/**
+* A fake implementation for every stdlib port.
+*
+* Real third-party integrations are out of scope for this repository, so these
+* stand in for them. Crypto is the exception noted below. `@venn-lang/http`'s client
+* is real too (fetch), but the CLI binds it separately so a test can put a fake
+* in its place.
+*/
+const stdlibPortBindings = [
+	{
+		port: AuthClientPort,
+		impl: createFakeAuthClient()
+	},
+	{
+		port: HttpServerPort,
+		impl: createMemoryServer()
+	},
+	{
+		port: CryptoEnginePort,
+		impl: createWebCryptoEngine()
+	},
+	{
+		port: NotifierPort,
+		impl: createFakeNotifier()
+	},
+	{
+		port: WsClientPort,
+		impl: createFakeWsClient({ incoming: [] })
+	},
+	{
+		port: MqttClientPort,
+		impl: createFakeMqttClient()
+	},
+	{
+		port: GqlClientPort,
+		impl: createFakeClient()
+	},
+	{
+		port: GrpcClientPort,
+		impl: createFakeClient$1()
+	},
+	{
+		port: MailClientPort,
+		impl: createFakeMailClient()
+	},
+	{
+		port: DbClientPort,
+		impl: createFakeDbClient()
+	},
+	{
+		port: BrowserDriverPort,
+		impl: createFakeBrowserDriver()
+	},
+	{
+		port: PreviewProviderPort,
+		impl: createNonePreviewProvider()
+	},
+	{
+		port: LoadRunnerPort,
+		impl: createFakeLoadRunner()
+	},
+	{
+		port: ArtifactStorePort,
+		impl: createMemoryArtifactStore()
+	},
+	{
+		port: ConsolePort,
+		impl: createMemoryConsole()
+	}
+];
+//#endregion
+export { allPlugins, stdlibPortBindings };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createFakeGqlClient","createFakeGrpcClient"],"sources":["../src/plugins.ts","../src/port-bindings.ts"],"sourcesContent":["import { artifactsPlugin } from \"@venn-lang/artifacts\";\nimport { assertPlugin } from \"@venn-lang/assert\";\nimport { authPlugin } from \"@venn-lang/auth\";\nimport { browserPlugin } from \"@venn-lang/browser\";\nimport { cryptoPlugin } from \"@venn-lang/crypto\";\nimport { dataPlugin } from \"@venn-lang/data\";\nimport { dbPlugin } from \"@venn-lang/db\";\nimport { envPlugin } from \"@venn-lang/env\";\nimport { fmtPlugin } from \"@venn-lang/fmt\";\nimport { gqlPlugin } from \"@venn-lang/graphql\";\nimport { grpcPlugin } from \"@venn-lang/grpc\";\nimport { httpPlugin } from \"@venn-lang/http\";\nimport { ioPlugin } from \"@venn-lang/io\";\nimport { loadPlugin } from \"@venn-lang/load\";\nimport { mailPlugin } from \"@venn-lang/mail\";\nimport { mockPlugin } from \"@venn-lang/mock\";\nimport { mqttPlugin } from \"@venn-lang/mqtt\";\nimport { notifyPlugin } from \"@venn-lang/notify\";\nimport type { PluginDefinition } from \"@venn-lang/sdk\";\nimport { wsPlugin } from \"@venn-lang/ws\";\n\n/**\n * Every plugin the tooling loads, as one list.\n *\n * The CLI runs them; the language server reads their actions and matchers for\n * completion, hover and highlighting. One list, so the two never disagree about\n * what the stdlib is.\n */\nexport const allPlugins: PluginDefinition[] = [\n  httpPlugin,\n  assertPlugin,\n  dataPlugin,\n  cryptoPlugin,\n  envPlugin,\n  fmtPlugin,\n  ioPlugin,\n  mockPlugin,\n  authPlugin,\n  notifyPlugin,\n  wsPlugin,\n  mqttPlugin,\n  gqlPlugin,\n  grpcPlugin,\n  mailPlugin,\n  dbPlugin,\n  browserPlugin,\n  loadPlugin,\n  artifactsPlugin,\n];\n","import { ArtifactStorePort, createMemoryArtifactStore } from \"@venn-lang/artifacts\";\nimport { AuthClientPort, createFakeAuthClient } from \"@venn-lang/auth\";\nimport {\n  BrowserDriverPort,\n  createFakeBrowserDriver,\n  createNonePreviewProvider,\n  PreviewProviderPort,\n} from \"@venn-lang/browser\";\nimport { ConsolePort, createMemoryConsole } from \"@venn-lang/contracts\";\nimport { CryptoEnginePort, createWebCryptoEngine } from \"@venn-lang/crypto\";\nimport { createFakeDbClient, DbClientPort } from \"@venn-lang/db\";\nimport { createFakeClient as createFakeGqlClient, GqlClientPort } from \"@venn-lang/graphql\";\nimport { createFakeClient as createFakeGrpcClient, GrpcClientPort } from \"@venn-lang/grpc\";\nimport { createMemoryServer, HttpServerPort } from \"@venn-lang/http\";\nimport { createFakeLoadRunner, LoadRunnerPort } from \"@venn-lang/load\";\nimport { createFakeMailClient, MailClientPort } from \"@venn-lang/mail\";\nimport { createFakeMqttClient, MqttClientPort } from \"@venn-lang/mqtt\";\nimport { createFakeNotifier, NotifierPort } from \"@venn-lang/notify\";\nimport type { PortBinding } from \"@venn-lang/runtime\";\nimport { createFakeWsClient, WsClientPort } from \"@venn-lang/ws\";\n\n/**\n * A fake implementation for every stdlib port.\n *\n * Real third-party integrations are out of scope for this repository, so these\n * stand in for them. Crypto is the exception noted below. `@venn-lang/http`'s client\n * is real too (fetch), but the CLI binds it separately so a test can put a fake\n * in its place.\n */\nexport const stdlibPortBindings: PortBinding[] = [\n  { port: AuthClientPort, impl: createFakeAuthClient() },\n  { port: HttpServerPort, impl: createMemoryServer() },\n  // Crypto is pure computation, not a side effect, so the real engine always.\n  { port: CryptoEnginePort, impl: createWebCryptoEngine() },\n  { port: NotifierPort, impl: createFakeNotifier() },\n  { port: WsClientPort, impl: createFakeWsClient({ incoming: [] }) },\n  { port: MqttClientPort, impl: createFakeMqttClient() },\n  { port: GqlClientPort, impl: createFakeGqlClient() },\n  { port: GrpcClientPort, impl: createFakeGrpcClient() },\n  { port: MailClientPort, impl: createFakeMailClient() },\n  { port: DbClientPort, impl: createFakeDbClient() },\n  { port: BrowserDriverPort, impl: createFakeBrowserDriver() },\n  { port: PreviewProviderPort, impl: createNonePreviewProvider() },\n  { port: LoadRunnerPort, impl: createFakeLoadRunner() },\n  { port: ArtifactStorePort, impl: createMemoryArtifactStore() },\n  // A recording console, so a run without the CLI still has somewhere to write.\n  // The CLI binds the real streams over this one.\n  { port: ConsolePort, impl: createMemoryConsole() },\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,MAAa,aAAiC;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;;;;;;;;;ACnBA,MAAa,qBAAoC;CAC/C;EAAE,MAAM;EAAgB,MAAM,qBAAqB;CAAE;CACrD;EAAE,MAAM;EAAgB,MAAM,mBAAmB;CAAE;CAEnD;EAAE,MAAM;EAAkB,MAAM,sBAAsB;CAAE;CACxD;EAAE,MAAM;EAAc,MAAM,mBAAmB;CAAE;CACjD;EAAE,MAAM;EAAc,MAAM,mBAAmB,EAAE,UAAU,CAAC,EAAE,CAAC;CAAE;CACjE;EAAE,MAAM;EAAgB,MAAM,qBAAqB;CAAE;CACrD;EAAE,MAAM;EAAe,MAAMA,iBAAoB;CAAE;CACnD;EAAE,MAAM;EAAgB,MAAMC,mBAAqB;CAAE;CACrD;EAAE,MAAM;EAAgB,MAAM,qBAAqB;CAAE;CACrD;EAAE,MAAM;EAAc,MAAM,mBAAmB;CAAE;CACjD;EAAE,MAAM;EAAmB,MAAM,wBAAwB;CAAE;CAC3D;EAAE,MAAM;EAAqB,MAAM,0BAA0B;CAAE;CAC/D;EAAE,MAAM;EAAgB,MAAM,qBAAqB;CAAE;CACrD;EAAE,MAAM;EAAmB,MAAM,0BAA0B;CAAE;CAG7D;EAAE,MAAM;EAAa,MAAM,oBAAoB;CAAE;AACnD"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@venn-lang/stdlib",
+  "version": "0.1.0",
+  "description": "The one list of standard-library plugins, plus the fake port implementations the tooling runs them with.",
+  "keywords": [
+    "venn",
+    "testing",
+    "e2e",
+    "stdlib",
+    "standard-library"
+  ],
+  "homepage": "https://github.com/venn-lang/venn/tree/main/packages/stdlib#readme",
+  "bugs": "https://github.com/venn-lang/venn/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/venn-lang/venn.git",
+    "directory": "packages/stdlib"
+  },
+  "license": "MIT",
+  "author": "Vinicius Borges",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.suite.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@venn-lang/artifacts": "0.1.0",
+    "@venn-lang/assert": "0.1.0",
+    "@venn-lang/auth": "0.1.0",
+    "@venn-lang/browser": "0.1.0",
+    "@venn-lang/contracts": "0.1.0",
+    "@venn-lang/data": "0.1.0",
+    "@venn-lang/db": "0.1.0",
+    "@venn-lang/crypto": "0.1.0",
+    "@venn-lang/fmt": "0.1.0",
+    "@venn-lang/grpc": "0.1.0",
+    "@venn-lang/http": "0.1.0",
+    "@venn-lang/graphql": "0.1.0",
+    "@venn-lang/io": "0.1.0",
+    "@venn-lang/load": "0.1.0",
+    "@venn-lang/mail": "0.1.0",
+    "@venn-lang/mock": "0.1.0",
+    "@venn-lang/mqtt": "0.1.0",
+    "@venn-lang/notify": "0.1.0",
+    "@venn-lang/runtime": "0.1.0",
+    "@venn-lang/types": "0.1.0",
+    "@venn-lang/env": "0.1.0",
+    "@venn-lang/sdk": "0.1.0",
+    "@venn-lang/ws": "0.1.0"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+// The one list of stdlib plugins, plus the fake port bindings they run with.
+// Adding a plugin touches this package and nothing else.
+
+export { allPlugins } from "./plugins.js";
+export { stdlibPortBindings } from "./port-bindings.js";

package/src/plugins.ts

@@ -0,0 +1,49 @@
+import { artifactsPlugin } from "@venn-lang/artifacts";
+import { assertPlugin } from "@venn-lang/assert";
+import { authPlugin } from "@venn-lang/auth";
+import { browserPlugin } from "@venn-lang/browser";
+import { cryptoPlugin } from "@venn-lang/crypto";
+import { dataPlugin } from "@venn-lang/data";
+import { dbPlugin } from "@venn-lang/db";
+import { envPlugin } from "@venn-lang/env";
+import { fmtPlugin } from "@venn-lang/fmt";
+import { gqlPlugin } from "@venn-lang/graphql";
+import { grpcPlugin } from "@venn-lang/grpc";
+import { httpPlugin } from "@venn-lang/http";
+import { ioPlugin } from "@venn-lang/io";
+import { loadPlugin } from "@venn-lang/load";
+import { mailPlugin } from "@venn-lang/mail";
+import { mockPlugin } from "@venn-lang/mock";
+import { mqttPlugin } from "@venn-lang/mqtt";
+import { notifyPlugin } from "@venn-lang/notify";
+import type { PluginDefinition } from "@venn-lang/sdk";
+import { wsPlugin } from "@venn-lang/ws";
+
+/**
+ * Every plugin the tooling loads, as one list.
+ *
+ * The CLI runs them; the language server reads their actions and matchers for
+ * completion, hover and highlighting. One list, so the two never disagree about
+ * what the stdlib is.
+ */
+export const allPlugins: PluginDefinition[] = [
+  httpPlugin,
+  assertPlugin,
+  dataPlugin,
+  cryptoPlugin,
+  envPlugin,
+  fmtPlugin,
+  ioPlugin,
+  mockPlugin,
+  authPlugin,
+  notifyPlugin,
+  wsPlugin,
+  mqttPlugin,
+  gqlPlugin,
+  grpcPlugin,
+  mailPlugin,
+  dbPlugin,
+  browserPlugin,
+  loadPlugin,
+  artifactsPlugin,
+];

package/src/port-bindings.ts

@@ -0,0 +1,49 @@
+import { ArtifactStorePort, createMemoryArtifactStore } from "@venn-lang/artifacts";
+import { AuthClientPort, createFakeAuthClient } from "@venn-lang/auth";
+import {
+  BrowserDriverPort,
+  createFakeBrowserDriver,
+  createNonePreviewProvider,
+  PreviewProviderPort,
+} from "@venn-lang/browser";
+import { ConsolePort, createMemoryConsole } from "@venn-lang/contracts";
+import { CryptoEnginePort, createWebCryptoEngine } from "@venn-lang/crypto";
+import { createFakeDbClient, DbClientPort } from "@venn-lang/db";
+import { createFakeClient as createFakeGqlClient, GqlClientPort } from "@venn-lang/graphql";
+import { createFakeClient as createFakeGrpcClient, GrpcClientPort } from "@venn-lang/grpc";
+import { createMemoryServer, HttpServerPort } from "@venn-lang/http";
+import { createFakeLoadRunner, LoadRunnerPort } from "@venn-lang/load";
+import { createFakeMailClient, MailClientPort } from "@venn-lang/mail";
+import { createFakeMqttClient, MqttClientPort } from "@venn-lang/mqtt";
+import { createFakeNotifier, NotifierPort } from "@venn-lang/notify";
+import type { PortBinding } from "@venn-lang/runtime";
+import { createFakeWsClient, WsClientPort } from "@venn-lang/ws";
+
+/**
+ * A fake implementation for every stdlib port.
+ *
+ * Real third-party integrations are out of scope for this repository, so these
+ * stand in for them. Crypto is the exception noted below. `@venn-lang/http`'s client
+ * is real too (fetch), but the CLI binds it separately so a test can put a fake
+ * in its place.
+ */
+export const stdlibPortBindings: PortBinding[] = [
+  { port: AuthClientPort, impl: createFakeAuthClient() },
+  { port: HttpServerPort, impl: createMemoryServer() },
+  // Crypto is pure computation, not a side effect, so the real engine always.
+  { port: CryptoEnginePort, impl: createWebCryptoEngine() },
+  { port: NotifierPort, impl: createFakeNotifier() },
+  { port: WsClientPort, impl: createFakeWsClient({ incoming: [] }) },
+  { port: MqttClientPort, impl: createFakeMqttClient() },
+  { port: GqlClientPort, impl: createFakeGqlClient() },
+  { port: GrpcClientPort, impl: createFakeGrpcClient() },
+  { port: MailClientPort, impl: createFakeMailClient() },
+  { port: DbClientPort, impl: createFakeDbClient() },
+  { port: BrowserDriverPort, impl: createFakeBrowserDriver() },
+  { port: PreviewProviderPort, impl: createNonePreviewProvider() },
+  { port: LoadRunnerPort, impl: createFakeLoadRunner() },
+  { port: ArtifactStorePort, impl: createMemoryArtifactStore() },
+  // A recording console, so a run without the CLI still has somewhere to write.
+  // The CLI binds the real streams over this one.
+  { port: ConsolePort, impl: createMemoryConsole() },
+];