Registry / web-framework / vite-plugin-mars3d

vite-plugin-mars3d

library4.2.2jsnpmunverified

A Vite plugin for integrating Mars3D (a 3D GIS platform built on Cesium) into Vite projects. Current stable version 4.2.2, updated 2024-08-13. Provides seamless integration by handling Vite-specific configurations, copy assets, and optional CDN usage. Enables faster HMR and optimized builds for Mars3D applications. Key differentiators: easy setup, TypeScript support, and compatibility with latest Vite versions (v4+).

web-framework

npm install vite-plugin-mars3d

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-MARS3D

vite-plugin-mars3d

web-frameworkjavascriptv4.2.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

mars3dPlugin

✓ import mars3dPlugin from 'vite-plugin-mars3d'

✗ const mars3dPlugin = require('vite-plugin-mars3d')

Package is ESM-only; no CommonJS export.

defineConfig

✓ import { defineConfig } from 'vite'

✗ import { defineConfig } from 'vite-plugin-mars3d'

defineConfig is from Vite, not this plugin.

type Plugin

✓ import { Plugin } from 'vite'

✗ import { Plugin } from 'vite-plugin-mars3d'

Plugin type is from Vite, not this plugin.

Basic setup of vite-plugin-mars3d in Vite config, enabling Mars3D integration.

// vite.config.ts import { defineConfig } from 'vite'; import mars3dPlugin from 'vite-plugin-mars3d'; export default defineConfig({ plugins: [mars3dPlugin()], });

Debug

Known issues

breakingv4.0+ drops support for Node.js 14 and Vite 3.x.

fix

Upgrade to Node.js 16+ and Vite 4+.

affects: >=4.0

deprecatedOption 'useCDN' replaced by 'cdn' in v4.0.

fix

Replace 'useCDN: true' with 'cdn: true'.

affects: >=4.0

gotchaPlugin must be listed first in plugins array to work correctly.

fix

Ensure mars3dPlugin() is the first element in plugins array.

affects: >=1.0

gotchaWhen using TypeScript, ensure 'vite-plugin-mars3d' is included in tsconfig 'types' array for intellisense.

fix

Add to tsconfig.json: "types": ["vite-plugin-mars3d"]

affects: >=3.0

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-mars3d'

Missing package installation.

fix

Run npm install vite-plugin-mars3d --save-dev

TypeError: mars3dPlugin is not a function

Incorrect import: using CommonJS require instead of ESM import.

fix

Use import mars3dPlugin from 'vite-plugin-mars3d'

[plugin:vite-plugin-mars3d] Failed to resolve import "mars3d" from "xxx"

Mars3D dependency not installed or incorrectly resolved.

fix

Ensure mars3d is installed: npm install mars3d

Upgrade

Version history

4.2.2latest on npm

Audit

Dependencies

viterequiredPlugin runs as a Vite plugin, requires Vite v2+.

Agent activity

7 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/marsgis/vite-plugin-mars3d ↗

packagehttps://www.npmjs.com/package/vite-plugin-mars3d ↗

homepagehttps://mars3d.cn ↗