npm - create-yss-spec - Versions diffs - 3.3.8 → 3.4.1 - Mend

create-yss-spec 3.3.8 → 3.4.1

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 (628) hide show

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore ADDED Viewed

@@ -0,0 +1,6 @@
+node_modules/
+packages/dist/
+.env.local
+.env.*.local
+.npmrc
+.yss/

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/micro-config.json ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "name": "__MICROAPP_NAME__",
+  "activeRule": "__BASE_ROUTE__",
+  "bridgeVersion": 1
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/orval.config.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import { defineConfig } from 'orval';
2	+ export default defineConfig({ api: { input: './openapi/openapi.json', output: { target: './packages/src/api/generated/client.ts', schemas: './packages/src/api/generated/model', client: 'axios', mode: 'single', override: { mutator: { path: './packages/src/api/mutator.ts', name: 'customInstance' } } } } });

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/package.json ADDED Viewed

@@ -0,0 +1,30 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.15.0",
+  "engines": {
+    "node": ">=22.12.0",
+    "pnpm": ">=10.15.0 <11"
+  },
+  "scripts": {
+    "dev": "pnpm -C packages dev",
+    "build": "pnpm -C packages build",
+    "build:standalone": "pnpm -C packages build:standalone",
+    "preview": "pnpm -C packages preview",
+    "lint": "pnpm lint:check",
+    "lint:check": "eslint packages/src packages/vite.config.ts orval.config.ts --ext .ts,.vue --max-warnings 0",
+    "lint:fix": "pnpm lint:check --fix",
+    "type-check": "pnpm -C packages type-check",
+    "generate:api": "orval --config orval.config.ts"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "8.70.0",
+    "@typescript-eslint/eslint-plugin": "8.70.0",
+    "eslint": "8.57.1",
+    "eslint-plugin-vue": "9.33.0",
+    "@types/node": "20.19.43",
+    "orval": "6.31.0",
+    "typescript": "5.9.3"
+  }
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.development ADDED Viewed

	@@ -0,0 +1 @@
1	+ VITE_STANDALONE_LAYOUT=true

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.example ADDED Viewed

@@ -0,0 +1,5 @@
+VITE_PUBLIC_BASE=/
+VITE_API_BASE_URL=/api
+VITE_PROXY_TARGET=http://localhost:8084
+VITE_PORT=8081
+VITE_DEV_ORIGIN=http://localhost:8081

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production ADDED Viewed

	@@ -0,0 +1 @@
1	+ VITE_STANDALONE_LAYOUT=false

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/.env.production.standalone ADDED Viewed

	@@ -0,0 +1 @@
1	+ VITE_STANDALONE_LAYOUT=true

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/index.html ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ <!doctype html>
2	+ <html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><link rel="icon" type="image/svg+xml" href="/favicon.svg"><title>__APP_NAME__</title></head><body><div id="app"></div><script type="module" src="/src/main.ts"></script></body></html>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/package.json ADDED Viewed

@@ -0,0 +1,34 @@
+{
+  "name": "__MICROAPP_NAME__",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:standalone": "vite build --mode production.standalone",
+    "preview": "vite preview",
+    "type-check": "vue-tsc --noEmit"
+  },
+  "dependencies": {
+    "vue": "3.5.20",
+    "vue-router": "4.6.4",
+    "pinia": "2.3.1",
+    "ant-design-vue": "4.2.6",
+    "@ant-design/icons-vue": "7.0.1",
+    "@yss-ui/components": "1.6.0",
+    "@yss-ui/hooks": "1.1.3",
+    "@yss-ui/utils": "1.0.6",
+    "@formily/core": "2.3.7",
+    "@formily/vue": "2.3.7",
+    "axios": "1.20.0",
+    "dayjs": "1.11.23"
+  },
+  "devDependencies": {
+    "vite": "6.0.5",
+    "@vitejs/plugin-vue": "6.0.8",
+    "vite-plugin-qiankun": "1.0.15",
+    "less": "4.9.1",
+    "vue-tsc": "3.3.11",
+    "@vue/tsconfig": "0.9.1"
+  }
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/public/favicon.svg ADDED Viewed

	@@ -0,0 +1 @@
1	+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#3371ff"/><path d="M8 10h16M8 16h12M8 22h8" stroke="white" stroke-width="3"/></svg>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/App.vue ADDED Viewed

@@ -0,0 +1,15 @@
+<script setup lang="ts">
+import ThemeScope from '@/components/ThemeScope.vue';
+import zhCN from 'ant-design-vue/es/locale/zh_CN';
+import { useThemeStore } from '@/store/theme';
+const store = useThemeStore();
+defineProps<{ standalone: boolean; popupContainer: HTMLElement }>();
+</script>
+<template>
+  <a-config-provider :locale="zhCN" :theme="store.config" :get-popup-container="() => popupContainer">
+    <ThemeScope :container="popupContainer"><div class="yss-app-shell">
+      <header v-if="standalone" class="app-header"><strong>__APP_NAME__</strong><span class="theme-controls"><a-switch :checked="store.dark" checked-children="暗色" un-checked-children="浅色" @change="store.setDark(Boolean($event))" /><a-switch :checked="store.compact" checked-children="紧凑" un-checked-children="默认" @change="store.setCompact(Boolean($event))" /></span></header>
+      <main class="app-content"><router-view /></main>
+    </div></ThemeScope>
+  </a-config-provider>
+</template>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/api/mutator.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import axios, { type AxiosRequestConfig } from 'axios';
+/** 宿主认证可注入拦截器；骨架不假定 token 存储键或登录跳转。 */
+export const apiClient = axios.create({ baseURL: import.meta.env.VITE_API_BASE_URL || '', timeout: 10000 });
+export async function customInstance<T>(config: AxiosRequestConfig, options?: AxiosRequestConfig): Promise<T> {
+  const response = await apiClient.request<T>({ ...config, ...options });
+  return response.data;
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/components/ThemeScope.vue ADDED Viewed

@@ -0,0 +1,11 @@
+<script setup lang="ts">
+import { watchEffect } from 'vue';
+import { theme } from 'ant-design-vue';
+import { useThemeStore } from '@/store/theme';
+const props = defineProps<{ container: HTMLElement }>();
+const { token } = theme.useToken();
+const store = useThemeStore();
+// Runs inside ConfigProvider; Vue stops the watcher when this scope unmounts.
+watchEffect(() => store.syncContainer(props.container, token.value));
+</script>
+<template><slot /></template>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/config/theme.json ADDED Viewed

@@ -0,0 +1,41 @@
+{
+  "token": {
+    "colorPrimary": "#3371ff",
+    "colorSuccess": "#52c41a",
+    "colorWarning": "#faad14",
+    "colorError": "#f5222d",
+    "colorInfo": "#3371ff",
+    "colorTextBase": "#000000",
+    "colorBgBase": "#ffffff",
+    "colorBgLayout": "#f0f2f5",
+    "colorText": "rgba(0, 0, 0, 0.88)",
+    "colorTextSecondary": "rgba(0, 0, 0, 0.65)",
+    "colorBorder": "#d9d9d9",
+    "fontFamily": "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, \"Noto Sans\", sans-serif",
+    "fontSize": 14,
+    "borderRadius": 6,
+    "sizeUnit": 4,
+    "sizeStep": 4,
+    "controlHeight": 32,
+    "controlHeightSM": 24,
+    "controlHeightLG": 40,
+    "fontSizeSM": 12,
+    "borderRadiusSM": 4,
+    "borderRadiusLG": 8,
+    "padding": 16,
+    "paddingSM": 12,
+    "paddingXS": 8,
+    "paddingLG": 20
+  },
+  "algorithm": "default",
+  "components": {
+    "Card": {
+      "borderRadiusLG": 8,
+      "paddingLG": 20
+    }
+  },
+  "accessibility": {
+    "primaryControl": "#245bdb",
+    "primaryControlHover": "#2f68eb"
+  }
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/env.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ /// <reference types="vite/client" />

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/main.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import { createApp, type App as VueApp } from 'vue';
+import { createPinia } from 'pinia';
+import Antd from 'ant-design-vue';
+import { YButton } from '@yss-ui/components';
+import { renderWithQiankun, qiankunWindow } from 'vite-plugin-qiankun/dist/helper';
+import 'ant-design-vue/dist/reset.css';
+import '@yss-ui/components/dist/style.css';
+import './styles/index.less';
+import App from './App.vue';
+import { createAppRouter } from './router';
+import { useThemeStore } from './store/theme';
+import { setupMicroAppRouterBridge } from './utils/microAppRouterBridge';
+import { MICRO_APP_BRIDGE_VERSION, type MicroAppLifecycleProps } from './types/microAppBridge';
+let app: VueApp | undefined;
+let dispose: (() => void) | undefined;
+let applyTheme: ReturnType<typeof useThemeStore>['applyFromMain'] | undefined;
+function assertBridge(props: MicroAppLifecycleProps) {
+  if (props.bridgeVersion !== undefined && props.bridgeVersion !== MICRO_APP_BRIDGE_VERSION) throw new Error('Unsupported micro app bridge version');
+}
+async function mount(props: MicroAppLifecycleProps = {}) {
+  assertBridge(props);
+  if (app) throw new Error('Micro app is already mounted');
+  const host = props.container?.querySelector('#app') || (!props.container ? document.querySelector('#app') : null);
+  if (!host) throw new Error('Micro app mount container #app is missing');
+  const root = document.createElement('div'); root.className = 'yss-microapp-root'; host.appendChild(root);
+  const isMicro = Boolean(qiankunWindow.__POWERED_BY_QIANKUN__);
+  const router = createAppRouter(isMicro ? props.routerBase || '__BASE_ROUTE__' : '/');
+  const pinia = createPinia();
+  app = createApp(App, { standalone: !isMicro && import.meta.env.VITE_STANDALONE_LAYOUT !== 'false', popupContainer: root });
+  app.use(pinia).use(router).use(Antd);
+  app.component("YButton", YButton);
+  const store = useThemeStore(pinia); store.applyFromMain(props.themeConfig); applyTheme = store.applyFromMain;
+  const stopBridge = isMicro ? setupMicroAppRouterBridge({ router, appName: '__MICROAPP_NAME__', activeRule: props.routerBase || '__BASE_ROUTE__' }) : () => {};
+  dispose = () => { stopBridge(); router.options.history.destroy(); root.remove(); };
+  try { await router.isReady(); app.mount(root); } catch (error) { unmount(); throw error; }
+}
+function unmount() { app?.unmount(); dispose?.(); app = undefined; dispose = undefined; applyTheme = undefined; }
+function update(props: MicroAppLifecycleProps) { assertBridge(props); applyTheme?.(props.themeConfig); }
+renderWithQiankun({ bootstrap: async () => {}, mount, unmount, update });
+if (!qiankunWindow.__POWERED_BY_QIANKUN__) void mount();

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/router/index.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { createRouter, createWebHistory } from 'vue-router';
+import Welcome from '@/views/Welcome.vue';
+export function createAppRouter(base: string) {
+  return createRouter({ history: createWebHistory(base), routes: [
+    { path: '/', name: 'welcome', component: Welcome },
+    { path: '/:pathMatch(.*)*', name: 'not-found', component: () => import('@/views/NotFound.vue') },
+  ] });
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/store/theme.ts ADDED Viewed

@@ -0,0 +1,37 @@
+import { computed, ref } from 'vue';
+import { defineStore } from 'pinia';
+import { theme } from 'ant-design-vue';
+import type { ThemeConfig } from 'ant-design-vue/es/config-provider/context';
+import { applyYssTheme } from '@yss-ui/utils';
+import baseline from '@/config/theme.json';
+import type { MicroAppThemeConfigDto } from '@/types/microAppBridge';
+export const useThemeStore = defineStore('theme', () => {
+  const primary = ref(baseline.token.colorPrimary), dark = ref(false), compact = ref(false);
+  const config = computed<ThemeConfig>(() => {
+    const token: ThemeConfig['token'] = { ...baseline.token, colorPrimary: primary.value, colorInfo: primary.value };
+    if (dark.value) for (const key of ['colorTextBase', 'colorBgBase', 'colorText', 'colorTextSecondary', 'colorBorder', 'colorBgLayout'] as const) delete token[key];
+    return { token, algorithm: [dark.value ? theme.darkAlgorithm : theme.defaultAlgorithm, ...(compact.value ? [theme.compactAlgorithm] : [])], components: { ...baseline.components, Card: { ...baseline.components.Card, paddingLG: compact.value ? 16 : baseline.token.paddingLG }, Button: { colorPrimary: baseline.accessibility.primaryControl, colorPrimaryHover: baseline.accessibility.primaryControlHover } } };
+  });
+  function applyFromMain(dto?: MicroAppThemeConfigDto) {
+    const incoming = dto?.token?.colorPrimary;
+    if (typeof incoming === 'string' && /^#[0-9a-f]{6}$/i.test(incoming)) primary.value = incoming;
+    if (dto?.mode) { dark.value = dto.mode.dark; compact.value = dto.mode.compact; }
+  }
+  function syncContainer(container: HTMLElement, values: ReturnType<typeof theme.useToken>['token']['value']) {
+    // Only this micro application's own container is mutated; unmount removes it.
+      for (const [key, value] of Object.entries(values)) {
+        if (typeof value !== 'string' && typeof value !== 'number') continue;
+        const name = key.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+        const unit = typeof value === 'number' && /^(font-size|border-radius|control-height|padding|margin|size)(-|$)/.test(name) ? 'px' : '';
+        for (const prefix of ['brand', 'ant']) container.style.setProperty(`--${prefix}-${name}`, `${value}${unit}`);
+      }
+      const palette = applyYssTheme({ primary: primary.value, target: container, mirrorToLegacy: true });
+      container.style.setProperty('--vxe-ui-font-primary-lighten-color', palette.primary[5]);
+      container.style.setProperty('--vxe-ui-font-primary-darken-color', palette.primary[7]);
+      container.style.setProperty('--vxe-ui-font-primary-color', primary.value);
+      container.style.setProperty('--yss-card-padding', `${compact.value ? 16 : baseline.token.paddingLG}px`);
+      container.dataset.theme = dark.value ? 'dark' : 'light';
+  }
+  return { primary, dark, compact, config, applyFromMain, syncContainer, setDark: (value: boolean) => { dark.value = value; }, setCompact: (value: boolean) => { compact.value = value; } };
+});

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/styles/index.less ADDED Viewed

@@ -0,0 +1,6 @@
+.yss-microapp-root { min-height: 100vh; color: var(--brand-color-text); background: var(--brand-color-bg-layout); font: var(--brand-font-size) / 1.571 var(--brand-font-family); }
+.yss-microapp-root, .yss-microapp-root * { box-sizing: border-box; }
+.yss-microapp-root .app-header { padding: 16px 20px; background: var(--brand-color-bg-container); display: flex; align-items: center; justify-content: space-between; gap: 16px; }
+.yss-microapp-root .theme-controls { display: flex; gap: 12px; }
+.yss-microapp-root .app-content { padding: var(--yss-card-padding); }
+@media (max-width: 576px) { .yss-microapp-root .app-header { flex-wrap: wrap; } .yss-microapp-root .app-content { padding: 12px; } }

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/types/microAppBridge.ts ADDED Viewed

@@ -0,0 +1,28 @@
+/** 当前模板支持的门户桥接协议版本。 */
+export const MICRO_APP_BRIDGE_VERSION = 1 as const;
+/** 主题模式的可序列化描述。 */
+export interface MicroAppThemeModeDto {
+  readonly dark: boolean;
+  readonly compact: boolean;
+}
+/** 门户传入的只读主题 DTO；旧门户可以不提供 mode。 */
+export interface MicroAppThemeConfigDto {
+  readonly token?: Readonly<Record<string, unknown>>;
+  readonly components?: Readonly<Record<string, unknown>>;
+  readonly algorithm?: readonly unknown[];
+  readonly mode?: MicroAppThemeModeDto;
+}
+/** 微应用可识别的版本化桥接 Props；字段保持可选以兼容旧门户。 */
+export interface MicroAppBridgeProps {
+  readonly bridgeVersion?: typeof MICRO_APP_BRIDGE_VERSION;
+  readonly routerBase?: string;
+  readonly themeConfig?: MicroAppThemeConfigDto;
+}
+/** qiankun 生命周期额外提供的容器字段。 */
+export interface MicroAppLifecycleProps extends MicroAppBridgeProps {
+  readonly container?: Element | ShadowRoot;
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/utils/microAppRouterBridge.ts ADDED Viewed

@@ -0,0 +1,266 @@
+import { isNavigationFailure, NavigationFailureType, type Router } from 'vue-router';
+/** 主应用路由同步事件明细。 */
+interface MicroAppRouteSyncDetail {
+  appName?: string;
+  path?: string;
+}
+/** 路由同步失败原因。 */
+type MicroAppRouteSyncErrorReason = 'navigation' | 'chunk-load';
+/** 路由桥接初始化参数。 */
+interface MicroAppRouterBridgeOptions {
+  router: Router;
+  appName: string;
+  activeRule: string;
+}
+/** 可供恢复标记使用的最小存储接口。 */
+interface RecoveryStorage {
+  getItem: (key: string) => string | null;
+  setItem: (key: string, value: string) => void;
+  removeItem: (key: string) => void;
+}
+/** Vite 预加载错误事件。 */
+interface VitePreloadErrorEvent extends Event {
+  payload?: unknown;
+}
+/** 自动恢复结果。 */
+type ChunkRecoveryResult = 'not-chunk' | 'reloading' | 'exhausted';
+/** 旧 chunk 自动刷新标记前缀。 */
+const CHUNK_RELOAD_KEY_PREFIX = '__yss_micro_chunk_reload__';
+/**
+ * 规范化微应用激活前缀。
+ * @param activeRule 原始激活前缀
+ * @returns 无结尾斜杠的激活前缀
+ */
+function normalizeActiveRule(activeRule: string): string {
+  const withLeadingSlash = activeRule.startsWith('/') ? activeRule : `/${activeRule}`;
+  if (withLeadingSlash === '/') return '/';
+  return withLeadingSlash.replace(/\/+$/, '');
+}
+/**
+ * 将宿主地址解析为子应用完整路由。
+ * @param activeRule 微应用激活前缀
+ * @param locationLike 浏览器地址
+ * @returns 子应用路由；不属于当前微应用时返回 null
+ */
+export function resolveMicroAppFullPath(
+  activeRule: string,
+  locationLike: Pick<Location, 'pathname' | 'search' | 'hash'>
+): string | null {
+  const base = normalizeActiveRule(activeRule);
+  const { pathname, search, hash } = locationLike;
+  const matchesBase = base === '/' || pathname === base || pathname.startsWith(`${base}/`);
+  if (!matchesBase) return null;
+  const subPath = base === '/' ? pathname || '/' : pathname.slice(base.length) || '/';
+  return `${subPath}${search || ''}${hash || ''}`;
+}
+/**
+ * 将主应用事件中的地址解析为子应用完整路由。
+ * @param activeRule 微应用激活前缀
+ * @param path 主应用完整地址
+ * @param origin 当前页面 origin
+ * @returns 子应用路由；不属于当前微应用时返回 null
+ */
+export function resolveMicroAppEventPath(activeRule: string, path: string, origin: string): string | null {
+  try {
+    const url = new URL(path, origin);
+    if (url.origin !== origin) return null;
+    return resolveMicroAppFullPath(activeRule, url);
+  } catch {
+    return null;
+  }
+}
+/**
+ * 提取错误信息。
+ * @param error 未知错误
+ * @returns 可展示的错误信息
+ */
+function getErrorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  if (typeof error === 'string') return error;
+  if (error && typeof error === 'object' && 'message' in error) {
+    return String((error as { message?: unknown }).message || '');
+  }
+  return String(error || '未知错误');
+}
+/**
+ * 判断错误是否由旧 chunk 或动态导入资源失效导致。
+ * @param error 未知错误
+ * @returns 是否为可通过刷新恢复的资源错误
+ */
+export function isChunkLoadError(error: unknown): boolean {
+  const message = getErrorMessage(error);
+  return /ChunkLoadError|Loading chunk [\w-]+ failed|Failed to fetch dynamically imported module|Importing a module script failed|error loading dynamically imported module|Unable to preload CSS|JavaScript-or-Wasm module script|MIME type.*text\/html/i.test(
+    message
+  );
+}
+/**
+ * 创建当前路由的单次刷新标记。
+ * @param appName 微应用标识
+ * @param fullPath 子应用完整路由
+ * @returns sessionStorage 标记键
+ */
+export function createChunkReloadKey(appName: string, fullPath: string): string {
+  return `${CHUNK_RELOAD_KEY_PREFIX}:${appName}:${fullPath}`;
+}
+/**
+ * 预占当前路由的自动刷新机会。
+ * @param storage 会话存储
+ * @param key 刷新标记键
+ * @returns 本次是否允许刷新
+ */
+export function reserveChunkReload(storage: RecoveryStorage, key: string): boolean {
+  try {
+    if (storage.getItem(key)) return false;
+    storage.setItem(key, '1');
+    return true;
+  } catch {
+    return false;
+  }
+}
+/**
+ * 清理已成功路由的自动刷新标记。
+ * @param storage 会话存储
+ * @param key 刷新标记键
+ */
+function clearChunkReload(storage: RecoveryStorage, key: string): void {
+  try {
+    storage.removeItem(key);
+  } catch {
+    // 浏览器禁用会话存储时无需额外处理。
+  }
+}
+/**
+ * 获取当前宿主完整地址。
+ * @returns pathname、query 和 hash
+ */
+function getHostFullPath(): string {
+  return `${window.location.pathname}${window.location.search}${window.location.hash}`;
+}
+/**
+ * 安装 qiankun 子应用路由桥接和旧 chunk 恢复逻辑。
+ * @param options 路由桥接参数
+ * @returns 清理全部监听器的函数
+ */
+export function setupMicroAppRouterBridge(options: MicroAppRouterBridgeOptions): () => void {
+  const { router, appName, activeRule } = options;
+  let reloadScheduled = false;
+  let lastErrorSignature = '';
+  /** 向主应用报告无法自动恢复的路由错误。 */
+  const reportError = (reason: MicroAppRouteSyncErrorReason, error: unknown) => {
+    const message = getErrorMessage(error) || '微应用路由切换失败';
+    const path = getHostFullPath();
+    const signature = `${reason}:${path}:${message}`;
+    if (signature === lastErrorSignature) return;
+    lastErrorSignature = signature;
+    window.dispatchEvent(
+      new CustomEvent('microapp-route-sync-error', {
+        detail: { appName, path, reason, message },
+      })
+    );
+  };
+  /** 尝试通过单次刷新恢复旧 chunk 加载失败。 */
+  const recoverChunkError = (error: unknown, targetFullPath: string): ChunkRecoveryResult => {
+    if (!isChunkLoadError(error)) return 'not-chunk';
+    if (reloadScheduled) return 'reloading';
+    const key = createChunkReloadKey(appName, targetFullPath);
+    if (!reserveChunkReload(window.sessionStorage, key)) {
+      reportError('chunk-load', error);
+      return 'exhausted';
+    }
+    reloadScheduled = true;
+    window.location.reload();
+    return 'reloading';
+  };
+  /** 同步子应用路由，并显式处理导航失败。 */
+  const syncRouter = (targetFullPath: string) => {
+    if (router.currentRoute.value.fullPath === targetFullPath) return;
+    void router
+      .replace(targetFullPath)
+      .then(failure => {
+        if (!failure) return;
+        if (
+          isNavigationFailure(failure, NavigationFailureType.duplicated) ||
+          isNavigationFailure(failure, NavigationFailureType.cancelled)
+        ) {
+          return;
+        }
+        reportError('navigation', failure);
+      })
+      .catch((error: unknown) => {
+        if (recoverChunkError(error, targetFullPath) === 'not-chunk') {
+          reportError('navigation', error);
+        }
+      });
+  };
+  /** 从浏览器当前地址同步路由。 */
+  const syncRouterFromLocation = () => {
+    const targetFullPath = resolveMicroAppFullPath(activeRule, window.location);
+    if (targetFullPath) syncRouter(targetFullPath);
+  };
+  /** 处理主应用主动路由同步事件。 */
+  const handleMainAppRouteSync = (event: Event) => {
+    const detail = (event as CustomEvent<MicroAppRouteSyncDetail>).detail;
+    if (detail?.appName !== appName || !detail.path) return;
+    const targetFullPath = resolveMicroAppEventPath(activeRule, detail.path, window.location.origin);
+    if (targetFullPath) syncRouter(targetFullPath);
+  };
+  /** 处理 Vite 动态资源预加载错误。 */
+  const handlePreloadError = (event: Event) => {
+    const preloadEvent = event as VitePreloadErrorEvent;
+    const targetFullPath = resolveMicroAppFullPath(activeRule, window.location) || router.currentRoute.value.fullPath;
+    if (recoverChunkError(preloadEvent.payload ?? preloadEvent, targetFullPath) === 'reloading') {
+      event.preventDefault();
+    }
+  };
+  /** Vue Router 异步组件加载失败兜底。 */
+  const removeRouterError = router.onError(error => {
+    const targetFullPath = resolveMicroAppFullPath(activeRule, window.location) || router.currentRoute.value.fullPath;
+    if (recoverChunkError(error, targetFullPath) === 'not-chunk') {
+      reportError('navigation', error);
+    }
+  });
+  /** 成功进入目标页面后允许未来部署再次执行一次恢复刷新。 */
+  const removeAfterEach = router.afterEach((to, _from, failure) => {
+    if (failure) return;
+    clearChunkReload(window.sessionStorage, createChunkReloadKey(appName, to.fullPath));
+    lastErrorSignature = '';
+  });
+  window.addEventListener('popstate', syncRouterFromLocation);
+  window.addEventListener('microapp-route-sync', handleMainAppRouteSync);
+  window.addEventListener('vite:preloadError', handlePreloadError);
+  syncRouterFromLocation();
+  return () => {
+    window.removeEventListener('popstate', syncRouterFromLocation);
+    window.removeEventListener('microapp-route-sync', handleMainAppRouteSync);
+    window.removeEventListener('vite:preloadError', handlePreloadError);
+    removeRouterError();
+    removeAfterEach();
+  };
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/views/NotFound.vue ADDED Viewed

	@@ -0,0 +1 @@
1	+ <template><a-result status="404" title="页面不存在"><template #extra><router-link to="/">返回首页</router-link></template></a-result></template>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/src/views/Welcome.vue ADDED Viewed

	@@ -0,0 +1 @@
1	+ <template><a-card title="__APP_NAME__"><p>从这里开始配置应用。</p><a-space wrap><y-button type="primary">主要操作</y-button> <a-input placeholder="请输入内容" aria-label="示例输入" /></a-space></a-card></template>

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/tsconfig.json ADDED Viewed

@@ -0,0 +1,23 @@
+{
+  "extends": "@vue/tsconfig/tsconfig.dom.json",
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.vue",
+    "vite.config.ts"
+  ],
+  "compilerOptions": {
+    "strict": true,
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "noEmit": true,
+    "types": [
+      "vite/client"
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    }
+  }
+}

package/template/.codex/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/packages/vite.config.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { fileURLToPath, URL } from 'node:url';
+import { defineConfig, loadEnv } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import qiankun from 'vite-plugin-qiankun';
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, fileURLToPath(new URL('.', import.meta.url)));
+  const port = Number(env.VITE_PORT || 8081);
+  return {
+    base: env.VITE_PUBLIC_BASE || '/',
+    plugins: [vue(), qiankun('__MICROAPP_NAME__', { useDevMode: true })],
+    resolve: { alias: { '@': fileURLToPath(new URL('./src', import.meta.url)) }, dedupe: ['vue', 'ant-design-vue', '@ant-design/icons-vue', '@formily/core', '@formily/vue'] },
+    css: { preprocessorOptions: { less: { javascriptEnabled: true } } },
+    server: { host: '127.0.0.1', port, strictPort: true, cors: true, origin: env.VITE_DEV_ORIGIN || `http://localhost:${port}`, proxy: env.VITE_PROXY_TARGET ? { '/api': { target: env.VITE_PROXY_TARGET, changeOrigin: true } } : undefined },
+    build: { target: 'es2020', modulePreload: { polyfill: false } },
+  };
+});