zeekayandHanzo Dev 98338a6c5e fix(docs): finish the half-done migration — dex docs could not install or build ...

The docs job died at INSTALL, before any of the rest was visible:

    postinstall: hanzo-mdx
    Error [ERR_MODULE_NOT_FOUND]: Cannot find package '@hanzo/docs-core'

This package was mid-migration to the @hanzo toolchain and several pieces were
simply never finished. Each one only became visible once the one before it was
fixed, so they are listed in the order they surfaced:

1. @hanzo/docs-core undeclared — @hanzo/mdx imports it, so postinstall crashed.
2. `hanzo-mdx` with NO ARGUMENTS reports "generated files" and writes nothing.
   It needs `source.config.ts .source`, the form luxfi/consensus uses. Both the
   build and postinstall scripts were bare.
3. zod ^3 — @hanzo/mdx 14.2.x calls `z.looseObject`, which is zod 4:
   `TypeError: z.looseObject is not a function`. Nothing in docs/ imports zod
   directly (0 files), so it exists only for this toolchain; moved to ^4.2.1,
   matching mpc which runs the same generator.
4. `import { docs } from "@/.source"` is a DIRECTORY import and the generator
   emits no index — it writes browser/dynamic/server.ts. Now "@/.source/server".
5. @hanzo/docs undeclared — next.config.mjs imports @hanzo/docs/mdx/next.
6. app/global.css imported `fumadocs-ui/style.css`, an upstream package that is
   not a dependency here. Now @hanzo/docs-ui/style.css, as consensus has it.
7. RootProvider, DocsLayout, DocsPage and defaultMdxComponents were imported
   from `@hanzo/ui`, which exports NONE of them — checked at runtime, all five
   names including `loader` come back undefined. That is the
   "Element type is invalid … got: undefined" build failure. They live in
   @hanzo/docs-ui, where consensus already gets them.
8. docs.toFumadocsSource() does not exist on the @hanzo runtime; loader now
   comes from @hanzo/docs/core/source with toSource().
9. react-day-picker, react-resizable-panels and flexsearch were undeclared
   peers. PINNED to what @hanzo/ui asks for (^9, ^2) — installing latest gives
   react-resizable-panels 4, where `PanelGroup` no longer exists.

Verified as a fresh checkout would run it, with node_modules and .source deleted:

    pnpm install --frozen-lockfile   OK   (was ERR_MODULE_NOT_FOUND)
    .source after install            generated by postinstall
    pnpm build                       OK

Co-authored-by: Hanzo Dev <[email protected]>

2026-08-02 06:46:33 -07:00

..

source.ts

fix(docs): finish the half-done migration — dex docs could not install or build

2026-08-02 06:46:33 -07:00