Files
6f0dfd20c5 docs: complete tooling story (pb2zap + zap2pb), zip server, ZAP-only production case (#1)
* docs: tools section (pb2zap, zap2pb), zip server page, ZAP-only production story

- content/docs/tools/: new Tooling nav group — the complete pb<->ZAP
  interop boundary. pb2zap (go/ast codemod off protobuf), zap2pb
  (the one sanctioned protobuf import: Marshal/Unmarshal/Equal/
  AppendMessage, v0.2.0), and the migration path over the existing
  schema/codegen pages.
- content/docs/zip.mdx: the ZAP-native application server — one
  Listen verb (ZAP primary, HTTP secondary), typed handlers with
  REST/OpenAPI/MCP projections, Mount composition, and the
  hanzoai/cloud case: sub-1,000-line compose root hosting ~75K LOC
  of subsystems (76:1).
- why-zap: scrub the unmeasured benchmark tables (per the
  benchmarks-page policy), replace with mechanism arguments and the
  ZAP-only-in-production account: zero gRPC, protobuf confined to
  the four-function zap2pb boundary at the OTLP edge.
- ecosystem: add zip/pb2zap/zap2pb rows; quick-start + index: link
  the new pages, drop the unmeasured 5-20x claim.

* fix(build): alias MDX collections to regenerated docs/, drop frozen .docs snapshot

next.config.mjs and tsconfig.json pointed @hanzo/docs-mdx:collections/*
at .docs/ — a snapshot frozen on Jun 1 — while the MDX plugin
regenerates docs/ on every build. Result: no page added since the
snapshot (schema, codegen, rpc, capabilities, and this PR%27s tools/zip)
was ever emitted; the site silently served 37 routes instead of 45.
Alias both resolvers at docs/ and remove .docs.

---------

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-07 17:58:42 -07:00

12 lines
4.1 KiB
TypeScript

// @ts-nocheck
import { browser } from '@hanzo/docs-mdx/runtime/browser';
import type * as Config from '../source.config';
const create = browser<typeof Config, import("@hanzo/docs-mdx/runtime/types").InternalTypeConfig & {
DocData: {
}
}>();
const browserCollections = {
docs: create.doc("docs", {"api.mdx": () => import("../content/docs/api.mdx?collection=docs"), "architecture.mdx": () => import("../content/docs/architecture.mdx?collection=docs"), "benchmarks.mdx": () => import("../content/docs/benchmarks.mdx?collection=docs"), "capabilities.mdx": () => import("../content/docs/capabilities.mdx?collection=docs"), "codegen.mdx": () => import("../content/docs/codegen.mdx?collection=docs"), "consensus.mdx": () => import("../content/docs/consensus.mdx?collection=docs"), "ecosystem.mdx": () => import("../content/docs/ecosystem.mdx?collection=docs"), "gateway.mdx": () => import("../content/docs/gateway.mdx?collection=docs"), "index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "post-quantum.mdx": () => import("../content/docs/post-quantum.mdx?collection=docs"), "protocol.mdx": () => import("../content/docs/protocol.mdx?collection=docs"), "quick-start.mdx": () => import("../content/docs/quick-start.mdx?collection=docs"), "rpc.mdx": () => import("../content/docs/rpc.mdx?collection=docs"), "schema.mdx": () => import("../content/docs/schema.mdx?collection=docs"), "transports.mdx": () => import("../content/docs/transports.mdx?collection=docs"), "why-zap.mdx": () => import("../content/docs/why-zap.mdx?collection=docs"), "zip.mdx": () => import("../content/docs/zip.mdx?collection=docs"), "protocols/a2a.mdx": () => import("../content/docs/protocols/a2a.mdx?collection=docs"), "protocols/acp.mdx": () => import("../content/docs/protocols/acp.mdx?collection=docs"), "protocols/fix.mdx": () => import("../content/docs/protocols/fix.mdx?collection=docs"), "protocols/http.mdx": () => import("../content/docs/protocols/http.mdx?collection=docs"), "protocols/index.mdx": () => import("../content/docs/protocols/index.mdx?collection=docs"), "protocols/mcp.mdx": () => import("../content/docs/protocols/mcp.mdx?collection=docs"), "protocols/native.mdx": () => import("../content/docs/protocols/native.mdx?collection=docs"), "protocols/rns.mdx": () => import("../content/docs/protocols/rns.mdx?collection=docs"), "protocols/ws.mdx": () => import("../content/docs/protocols/ws.mdx?collection=docs"), "sdks/c.mdx": () => import("../content/docs/sdks/c.mdx?collection=docs"), "sdks/cpp.mdx": () => import("../content/docs/sdks/cpp.mdx?collection=docs"), "sdks/csharp.mdx": () => import("../content/docs/sdks/csharp.mdx?collection=docs"), "sdks/erlang.mdx": () => import("../content/docs/sdks/erlang.mdx?collection=docs"), "sdks/go.mdx": () => import("../content/docs/sdks/go.mdx?collection=docs"), "sdks/haskell.mdx": () => import("../content/docs/sdks/haskell.mdx?collection=docs"), "sdks/index.mdx": () => import("../content/docs/sdks/index.mdx?collection=docs"), "sdks/java.mdx": () => import("../content/docs/sdks/java.mdx?collection=docs"), "sdks/ocaml.mdx": () => import("../content/docs/sdks/ocaml.mdx?collection=docs"), "sdks/python.mdx": () => import("../content/docs/sdks/python.mdx?collection=docs"), "sdks/rust.mdx": () => import("../content/docs/sdks/rust.mdx?collection=docs"), "sdks/typescript.mdx": () => import("../content/docs/sdks/typescript.mdx?collection=docs"), "tools/index.mdx": () => import("../content/docs/tools/index.mdx?collection=docs"), "tools/pb2zap.mdx": () => import("../content/docs/tools/pb2zap.mdx?collection=docs"), "tools/zap2pb.mdx": () => import("../content/docs/tools/zap2pb.mdx?collection=docs"), "examples/capability-mailbox.mdx": () => import("../content/docs/examples/capability-mailbox.mdx?collection=docs"), "examples/index.mdx": () => import("../content/docs/examples/index.mdx?collection=docs"), "examples/multi-lang-conformance.mdx": () => import("../content/docs/examples/multi-lang-conformance.mdx?collection=docs"), "examples/pq-rns-roundtrip.mdx": () => import("../content/docs/examples/pq-rns-roundtrip.mdx?collection=docs"), }),
};
export default browserCollections;