nexmap4
v1.2.2
Published
Standalone nexMap4 package built from source-owned map and runtime data.
Readme
nexMap4
nexMap4 is a standalone Nexus package with a single-package build target.
Pathing is designed around one computed route and two execution modes: a hybrid server-assisted mode that uses Achaea's path track where eligible, and a pure client-stepped mode that preserves room-by-room automation opportunities inside nexMap4. The active mode is a user-configurable nexMap4 setting.
Implementation uses the source-owned data checked into src/assets and
src/nexmap/data. Sibling legacy repositories and deleted rebuild artifacts are
not implementation inputs.
The production Nexus artifact is one minified JavaScript bundle, dist/nexmap4.min.js,
published from this repository and imported into the Nexus client. Localhost development now
runs through a standard Vite app shell that mounts the same nexMap4 tab container used by the
production bootstrap. nexMap4 is not a workspace or monorepo. It follows the same single-root
solution pattern used by nexSys4 and nexGui4: one package, one root src/, one root tests/,
and one root Vite/Vitest toolchain.
Layout
src/index.js: root public API surface for internal imports and testssrc/main.jsx: localhost React/Vite entry that mounts the playground shellsrc/App.jsx: localhost React shell that renders the production nexMap4 tab through the Nexus-style FlexLayout overridesrc/nexmap/bootstrap/bootstrapNexusEntry.js: single Nexus bundle entry used by Vite buildsrc/nexmap/bootstrap/bootstrapPlayground.js: mock-host playground bootstrap for localhost testingsrc/nexmap/*: nexMap4 runtime modules under one coherent source treetests/hostEventHarness.js: synthetic host-event fixture loader and replay harnesstests/fixtures/host-events/: synthetic event fixtures used before deferred runtime traces existtests/: root test tree for unit, integration, and perf suites
Runtime behavior now lives in the source tree and is covered by the root test suite.
Design Docs
- Architecture Charter
- Non-Goals
- External Dependencies
- Master Design
- Command Surface
- Renderer Visual Parity
Commands
npm run dev
npm run build
npm run build:watch
npm test
npm run lint