npm - create-swdg-frontend - Versions diffs - 0.1.7 → 0.2.0 - Mend

create-swdg-frontend 0.1.7 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (440) hide show

package/template/src/views/examples/guide/index.vue ADDED Viewed

@@ -0,0 +1,42 @@
+<template>
+  <div class="shell-page guide-page">
+    <header class="example-toolbar">
+      <button
+        type="button"
+        class="shell-btn shell-btn--ghost guide-toolbar__back"
+        @click="goHome"
+      >
+        ← 首页
+      </button>
+      <span class="example-toolbar__title">项目使用指南 · 幻灯片模式</span>
+    </header>
+    <OnboardingDeck fullscreen />
+  </div>
+</template>
+<script setup lang="ts">
+import { useRouter } from 'vue-router';
+import OnboardingDeck from '@components/OnboardingDeck/index.vue';
+const router = useRouter();
+const goHome = () => {
+  router.push('/');
+};
+</script>
+<style scoped>
+.guide-page {
+  min-height: 100vh;
+  background: #f8fafc;
+}
+.guide-toolbar__back {
+  background: #f1f5f9;
+  color: var(--shell-text);
+}
+.guide-toolbar__back:hover {
+  background: #e2e8f0;
+}
+</style>

package/template/src/views/examples/test/index.vue ADDED Viewed

@@ -0,0 +1,63 @@
+<template>
+  <div class="shell-page">
+    <header class="example-toolbar">
+      <button type="button" class="shell-btn shell-btn--ghost" @click="goHome">
+        ← 首页
+      </button>
+      <span class="example-toolbar__title">开发示例 · Store / Alert</span>
+    </header>
+    <div class="example-panel">
+      <div class="example-panel__card">
+        <span class="shell-badge">不会进入生产构建</span>
+        <h1>计数器示例</h1>
+        <p class="example-panel__counter">{{ counter.count }}</p>
+        <div class="example-panel__actions">
+          <button
+            type="button"
+            class="shell-btn shell-btn--primary"
+            @click="handleInc"
+          >
+            +1 并弹出 Alert
+          </button>
+          <button
+            type="button"
+            class="shell-btn shell-btn--ghost"
+            @click="goHome"
+          >
+            返回首页
+          </button>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+<script setup lang="ts">
+import { useRouter } from 'vue-router';
+import { useAlert } from '@composables/useAlert';
+import { useCounterStore } from '@stores/useCounter';
+const router = useRouter();
+const alert = useAlert();
+const counter = useCounterStore();
+const goHome = () => {
+  router.push('/');
+};
+const handleInc = () => {
+  counter.inc();
+  alert(`counter: ${counter.count}`, 'info');
+};
+</script>
+<style scoped>
+.example-toolbar .shell-btn--ghost {
+  background: #f1f5f9;
+  color: var(--shell-text);
+}
+.example-toolbar .shell-btn--ghost:hover {
+  background: #e2e8f0;
+}
+</style>

package/template/src/views/index.vue CHANGED Viewed

@@ -1,9 +1,8 @@
 <template>
-  <div class="iot-ground-water-monitoring-system">
+  <div class="shell-page">
     <Header />
     <Body />
   </div>
 </template>
-<script setup lang="ts"></script>
-<style scoped></style>
+<script setup lang="ts"></script>

package/template/tests/README.md CHANGED Viewed

@@ -1,6 +1,7 @@
 # tests
 测试目录示例：
 - unit：单元测试（Vitest）
 - e2e：端到端测试（可用 Playwright）
 - utils：测试工具函数

package/template/tests/unit/onboardingSlides.test.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { onboardingSlides } from '@/data/onboardingSlides';
+describe('onboardingSlides', () => {
+  it('has unique ids and non-empty titles', () => {
+    const ids = onboardingSlides.map((s) => s.id);
+    expect(new Set(ids).size).toBe(ids.length);
+    for (const slide of onboardingSlides) {
+      expect(slide.title.length).toBeGreaterThan(0);
+      expect(slide.blocks.length).toBeGreaterThan(0);
+    }
+  });
+  it('includes core topics for release onboarding', () => {
+    const idSet = new Set(onboardingSlides.map((s) => s.id));
+    expect(idSet.has('quickstart')).toBe(true);
+    expect(idSet.has('routes')).toBe(true);
+    expect(idSet.has('gis')).toBe(true);
+  });
+});

package/template/tests/unit/router.utils.test.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { describe, expect, it } from 'vitest';
+import { filePathToRoute, isExampleRoute } from '@/router/routeUtils';
+describe('routeUtils', () => {
+  it('detects example routes', () => {
+    expect(isExampleRoute('../views/examples/test/index.vue')).toBe(true);
+    expect(isExampleRoute('../views/_examples/foo/index.vue')).toBe(true);
+    expect(isExampleRoute('../views/Dashboard/index.vue')).toBe(false);
+  });
+  it('maps view paths to hash routes', () => {
+    expect(filePathToRoute('../views/index.vue')).toBe('');
+    expect(filePathToRoute('../views/UserList/index.vue')).toBe('/user-list');
+    expect(filePathToRoute('../views/examples/test/index.vue')).toBe(
+      '/examples/test'
+    );
+    expect(filePathToRoute('../views/system/RoleManage/index.vue')).toBe(
+      '/system/role-manage'
+    );
+  });
+});

package/template/tests/unit/scaffold.lib.test.ts ADDED Viewed

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest';
+import {
+  isValidPackageName,
+  parseYesNo,
+} from '../../create-swdg/lib/prompts.js';
+import { parseArgv } from '../../create-swdg/lib/argv.js';
+describe('prompts', () => {
+  it('parseYesNo respects default', () => {
+    expect(parseYesNo('', true)).toBe(true);
+    expect(parseYesNo('', false)).toBe(false);
+    expect(parseYesNo('y', false)).toBe(true);
+    expect(parseYesNo('no', true)).toBe(false);
+  });
+  it('validates npm package names', () => {
+    expect(isValidPackageName('my-app')).toBe(true);
+    expect(isValidPackageName('My-App')).toBe(false);
+    expect(isValidPackageName('@scope/pkg')).toBe(false);
+    expect(isValidPackageName('')).toBe(false);
+  });
+});
+describe('parseArgv', () => {
+  it('parses project name and flags', () => {
+    const parsed = parseArgv([
+      'my-app',
+      '--no-gis',
+      '--no-install',
+      '--pm',
+      'npm',
+    ]);
+    expect(parsed.targetDir).toBe('my-app');
+    expect(parsed.shouldIncludeGis).toBe(false);
+    expect(parsed.shouldInstall).toBe(false);
+    expect(parsed.pm).toBe('npm');
+  });
+  it('parses --pm=value form', () => {
+    const parsed = parseArgv(['demo', '--pm=yarn', '--gis']);
+    expect(parsed.pm).toBe('yarn');
+    expect(parsed.shouldIncludeGis).toBe(true);
+  });
+});

package/template/tests/unit/useFeatureGis.test.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { describe, expect, it } from 'vitest';
+import { resolveFeatureGis } from '@composables/useFeatureGis';
+describe('resolveFeatureGis', () => {
+  it('honours explicit true/false', () => {
+    expect(resolveFeatureGis('true', false)).toBe(true);
+    expect(resolveFeatureGis('false', true)).toBe(false);
+  });
+  it('falls back to dev mode when unset', () => {
+    expect(resolveFeatureGis(undefined, true)).toBe(true);
+    expect(resolveFeatureGis(undefined, false)).toBe(false);
+  });
+});

package/template/tsconfig.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "compilerOptions": {
     "module": "ESNext",
     "target": "ESNext",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "allowSyntheticDefaultImports": true,
     "strict": true,
     "strictNullChecks": false,
@@ -10,22 +10,21 @@
     "outDir": "./dist",
     "rootDir": ".",
     "composite": true,
-    "baseUrl": ".", // This must be set if you're using 'paths'
     "paths": {
-      "@/*": ["src/*"],
-      "@assets/*": ["src/assets/*"],
-      "@style/*": ["src/styles/*"],
-      "@stores/*": ["src/stores/*"],
-      "@router/*": ["src/router/*"],
-      "@api/*": ["src/api/*"],
-      "@utils/*": ["src/utils/*"],
-      "@components/*": ["src/components/*"],
-      "@interface/*": ["interface/*"],
-      "@types/*": ["types/*"],
-      "@views/*": ["src/views/*"],
-      "@composables/*": ["src/utils/composables/*"],
-      "@directive/*": ["src/directive/*"],
-      "@layout/*": ["src/layout/*"]
+      "@/*": ["./src/*"],
+      "@assets/*": ["./src/assets/*"],
+      "@style/*": ["./src/styles/*"],
+      "@stores/*": ["./src/stores/*"],
+      "@router/*": ["./src/router/*"],
+      "@api/*": ["./src/api/*"],
+      "@utils/*": ["./src/utils/*"],
+      "@components/*": ["./src/components/*"],
+      "@interface/*": ["./interface/*"],
+      "@types/*": ["./types/*"],
+      "@views/*": ["./src/views/*"],
+      "@composables/*": ["./src/utils/composables/*"],
+      "@directive/*": ["./src/directive/*"],
+      "@layout/*": ["./src/layout/*"]
     },
     "types": [],
     "isolatedModules": true,
@@ -45,7 +44,8 @@
     "./src/vue-shim.d.ts",
     "./src/**/*.vue",
     "interface/**/*.ts",
-    "types/**/*.d.ts"
+    "types/**/*.d.ts",
+    "types/env.d.ts"
   ],
   "exclude": ["**/node_modules/**", "**/dist/**"]
 }

package/template/tsconfig.node.json CHANGED Viewed

@@ -7,5 +7,5 @@
     "allowSyntheticDefaultImports": true,
     "strict": true
   },
-  "include": ["vite.config.ts"]
+  "include": ["vite.config.ts", "scripts/vite-plugin-cesium-dev.ts"]
 }

package/template/types/env.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/// <reference types="vite/client" />
+interface ImportMetaEnv {
+  readonly VITE_DEMO_PROXY_TARGET?: string;
+  /** 脚手架启用 GIS 特性时设为 true */
+  readonly VITE_FEATURE_GIS?: string;
+  /** Cesium ion access token (https://cesium.com/ion/tokens) */
+  readonly VITE_CESIUM_ION_ACCESS_TOKEN?: string;
+}
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/template/vite.config.ts CHANGED Viewed

@@ -2,15 +2,26 @@ import { defineConfig, loadEnv } from 'vite';
 import vue from '@vitejs/plugin-vue';
 import AutoImport from 'unplugin-auto-import/vite';
 import Components from 'unplugin-vue-components/vite';
+import { viteStaticCopy } from 'vite-plugin-static-copy';
 import copyPlugin from 'rollup-plugin-copy';
 import path from 'path';
-import autoprefixer from 'autoprefixer';
+import { cesiumDevAssets } from './scripts/vite-plugin-cesium-dev';
+const cesiumSource = 'node_modules/cesium/Build/Cesium';
+/** 与 define.CESIUM_BASE_URL 一致，构建产物位于 dist/cesium/ */
+const cesiumBaseUrl = 'cesium';
 export default defineConfig(({ mode }) => {
   const env = loadEnv(mode, process.cwd(), '');
+  const isDev = mode === 'development';
+  // 开发：绝对路径 + 中间件挂载；生产：相对路径配合 base: './'
+  const cesiumBase = isDev ? `/${cesiumBaseUrl}/` : `./${cesiumBaseUrl}/`;
   return {
     base: './',
+    define: {
+      CESIUM_BASE_URL: JSON.stringify(cesiumBase),
+    },
     build: {
       sourcemap: true,
       emptyOutDir: false,
@@ -24,7 +35,20 @@ export default defineConfig(({ mode }) => {
       outDir: 'dist',
       assetsDir: 'assets',
     },
-    plugins: [vue(), AutoImport({}), Components({})],
+    plugins: [
+      vue(),
+      isDev ? cesiumDevAssets(`/${cesiumBaseUrl}`) : null,
+      viteStaticCopy({
+        targets: [
+          { src: `${cesiumSource}/ThirdParty`, dest: cesiumBaseUrl },
+          { src: `${cesiumSource}/Workers`, dest: cesiumBaseUrl },
+          { src: `${cesiumSource}/Assets`, dest: cesiumBaseUrl },
+          { src: `${cesiumSource}/Widgets`, dest: cesiumBaseUrl },
+        ],
+      }),
+      AutoImport({}),
+      Components({}),
+    ].filter(Boolean),
     resolve: {
       alias: {
         '@': path.resolve(__dirname, './src'),
@@ -49,9 +73,6 @@ export default defineConfig(({ mode }) => {
           javascriptEnabled: true,
         },
       },
-      postcss: {
-        plugins: [autoprefixer()],
-      },
     },
     server: {
       host: '0.0.0.0',

package/template/vitest.config.ts CHANGED Viewed

@@ -1,9 +1,22 @@
+import vue from '@vitejs/plugin-vue';
+import path from 'node:path';
 import { defineConfig } from 'vitest/config';
 export default defineConfig({
+  plugins: [vue()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+      '@composables': path.resolve(__dirname, './src/utils/composables'),
+      '@stores': path.resolve(__dirname, './src/stores'),
+      '@components': path.resolve(__dirname, './src/components'),
+      '@utils': path.resolve(__dirname, './src/utils'),
+    },
+  },
   test: {
     globals: true,
     environment: 'jsdom',
     setupFiles: ['./tests/setup.ts'],
+    include: ['tests/unit/**/*.test.ts'],
   },
 });

package/template/.env DELETED Viewed

	@@ -1 +0,0 @@
1	- VITE_DEMO_PROXY_TARGET=http://127.0.0.1:8888