# Beeview Map SDK

Beeview Map SDK is a WebGL JavaScript SDK for indoor street-view rendering, navigation, and map integration.

## Installation

```bash
npm install @mapxus/mapxus-visual
```

## Quick start

```js
import { Viewer } from "@mapxus/mapxus-visual";
import "@mapxus/mapxus-visual/dist/mapxus-visual.css";

const viewer = new Viewer({
  container: "beeview",
  component: {
    marker: true,
    popup: true,
    navigation: true,
  },
});
```

## Built-in documentation (for local developer/AI reading)

The main SDK package includes generated markdown docs directly.

Expected docs paths in `node_modules/@mapxus/mapxus-visual/docs/`:

- `api-reference.md`
- `types.md`
- `examples.md`

## Local development

### Build SDK bundle

```bash
npm install
npm run build
```

### Run local demo server

```bash
npm start
# or: npm run start:dev
```

Use workflow-specific commands:

```bash
# SDK development (watch compile + watch bundle + demo server)
npm start

# Demo preview only (no TypeScript/Rollup watch)
npm run start:demo

# Server only (expects dist assets already built)
npm run serve
```

For environment switching and local auth setup details, see `demo/SETUP.md`.

### Validate public exports

```bash
npm run check-exports
```

## Local Demo Server CSP Report-Only

Optional: enable CSP report-only headers in the local demo server (useful for CSP validation/scanning):

```bash
CSP_REPORT_ONLY=1 npm run serve
```

## License

BSD-3-Clause
