@lingfan-engine/create 0.0.0-stage → 0.1.4

package/template/overlays/vue/src/vite-env.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="vite/client" />
+
+/**
+ * 字体清单的宿主侧声明（脚手架工程自带，与 vite.config 的虚拟模块对应）。
+ */
+declare module "virtual:story-fonts" {
+  /** 字体清单条目：file = 资源文件名，name = 字体名（文件名去扩展名） */
+  export interface StoryFontEntry {
+    file: string;
+    name: string;
+  }
+  /** 构建期扫描 Resources/Fonts 的字体清单（与 stories:build 注册表同源） */
+  export const storyFonts: readonly StoryFontEntry[];
+}
+
+/** 单文件组件的模块声明：`vue-tsc` 之外的工具读到 `.vue` 时不至于整片报错 */
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+  const component: DefineComponent<
+    Record<string, never>,
+    Record<string, never>
+  >;
+  export default component;
+}

package/template/overlays/vue/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "moduleResolution": "bundler",
+    "types": ["vite/client"],
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*.ts", "src/**/*.vue"]
+}

package/template/overlays/vue/vite.config.ts

@@ -0,0 +1,67 @@
+/**
+ * Vite 配置（Vue 形态）：在骨架配置上多一个 Vue 插件，其余逐项保留。
+ *
+ * 资源根仍是无条件镜像 `Resources`——纯 Web 工程就是「浏览器游戏模式」的交付正例，
+ * 不引入壳侧的开关判定（那属于 Tauri 壳的交付形态，见引擎仓库 `apps/playground`）。
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import vue from "@vitejs/plugin-vue";
+import { defineConfig, type Plugin } from "vite";
+
+/** 字体文件扩展名集合（与 stories-build 的字体名注册表同口径） */
+const FONT_EXTENSIONS = [".ttf", ".otf", ".woff", ".woff2"] as const;
+
+/** 字体清单条目：file = 资源文件名，name = 字体名（文件名去扩展名） */
+interface StoryFontEntry {
+  file: string;
+  name: string;
+}
+
+/** Resources/Fonts 扫描：点文件与未知扩展名跳过，文件名字典序稳定 */
+function scanFonts(fontsDir: string): readonly StoryFontEntry[] {
+  if (!existsSync(fontsDir)) return [];
+  return readdirSync(fontsDir)
+    .filter((file) => {
+      const dot = file.lastIndexOf(".");
+      return (
+        dot > 0 &&
+        (FONT_EXTENSIONS as readonly string[]).includes(
+          file.slice(dot).toLowerCase(),
+        )
+      );
+    })
+    .sort()
+    .map((file) => ({ file, name: file.slice(0, file.lastIndexOf(".")) }));
+}
+
+/** 字体清单虚拟模块：构建期扫描 Resources/Fonts，与 stories:build 的注册表同源 */
+function storyFontsVirtual(): Plugin {
+  const moduleId = "virtual:story-fonts";
+  const fontsDir = fileURLToPath(new URL("./Resources/Fonts", import.meta.url));
+  return {
+    name: "story-fonts",
+    resolveId(id) {
+      if (id === moduleId) return `\0${moduleId}`;
+      return null;
+    },
+    load(id) {
+      if (id === `\0${moduleId}`) {
+        return `export const storyFonts = ${JSON.stringify(scanFonts(fontsDir))};`;
+      }
+      return null;
+    },
+  };
+}
+
+/** 脚手架工程的 Vite 配置（Vue 形态） */
+export default defineConfig({
+  // 项目资源根即静态根：故事里的逻辑路径 `Audio/x.mp3` 解析为 `/Audio/x.mp3`，
+  // 开发与打包产物一致，不依赖进程工作目录。资源根之外无隐式查找路径。
+  publicDir: "Resources",
+
+  // 宿主端口与 Tauri 约定一致；换平台壳时只改这里
+  server: { port: 1420, strictPort: true },
+
+  plugins: [vue(), storyFontsVirtual()],
+});

package/template/pack-template.ps1

@@ -0,0 +1,65 @@
+# pack-template.ps1 — 把脚手架工程目录打包为 ZIP（排除依赖/产物/版本库/运行期存档）
+# 跨平台：PowerShell 7（pwsh）在 Windows / Linux / macOS 均可用。
+# 用法: pwsh -File pack-template.ps1 -SourceDir "./__PROJECT__" -OutputFile "./__PROJECT__.zip"
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$SourceDir,
+
+    [Parameter(Mandatory = $true)]
+    [string]$OutputFile
+)
+
+$ErrorActionPreference = 'Stop'
+
+# 路径分隔符归一（调用方可能传入反斜杠）
+$SourceDir = $SourceDir -replace '\\', '/'
+$OutputFile = $OutputFile -replace '\\', '/'
+
+# 排除目录：依赖、构建产物、版本库、运行期存档
+$excludeDirs = @('node_modules', 'dist', '.git', 'Saves')
+
+$sourcePath = Resolve-Path $SourceDir
+$sourceRoot = $sourcePath.Path
+
+$outputFull = [System.IO.Path]::GetFullPath($OutputFile)
+$outputDir = Split-Path $outputFull -Parent
+if ($outputDir -and -not (Test-Path $outputDir)) {
+    New-Item -ItemType Directory -Path $outputDir -Force | Out-Null
+}
+if (Test-Path $outputFull) { Remove-Item $outputFull -Force }
+
+$tempBase = if ($env:TEMP) { $env:TEMP }
+            elseif ($env:TMPDIR) { $env:TMPDIR }
+            else { [System.IO.Path]::GetTempPath() }
+$tempDir = Join-Path $tempBase "lingfan_template_$(Get-Random)"
+
+try {
+    New-Item -ItemType Directory -Path $tempDir -Force | Out-Null
+
+    Get-ChildItem -Path $sourceRoot -Recurse -Force | ForEach-Object {
+        $relative = $_.FullName.Substring($sourceRoot.Length).TrimStart('\', '/')
+        if (-not $relative) { return }
+
+        $segments = $relative -split '[\\/]'
+        foreach ($excluded in $excludeDirs) {
+            if ($segments -contains $excluded) { return }
+        }
+
+        $dest = Join-Path $tempDir $relative
+        if ($_.PSIsContainer) {
+            New-Item -ItemType Directory -Path $dest -Force | Out-Null
+        } else {
+            $destParent = Split-Path $dest -Parent
+            if (-not (Test-Path $destParent)) {
+                New-Item -ItemType Directory -Path $destParent -Force | Out-Null
+            }
+            Copy-Item -LiteralPath $_.FullName -Destination $dest -Force
+        }
+    }
+
+    Compress-Archive -Path (Join-Path $tempDir '*') -DestinationPath $outputFull -Force
+    Write-Host "已打包: $outputFull"
+}
+finally {
+    if (Test-Path $tempDir) { Remove-Item $tempDir -Recurse -Force }
+}

package/template/template-meta.json

@@ -0,0 +1,40 @@
+{
+  "version": "1.6.0",
+  "minEngineVersion": "0.1.0",
+  "placeholder": "__PROJECT__",
+  "frameworks": [
+    {
+      "id": "none",
+      "label": "原生（框架无关）",
+      "hint": "只用骨架，不叠加任何框架层"
+    },
+    {
+      "id": "vue",
+      "label": "Vue 3",
+      "hint": "页面结构换成单文件组件，装配与宿主不变"
+    },
+    {
+      "id": "react",
+      "label": "React",
+      "hint": "页面结构换成 JSX 组件，装配与宿主不变"
+    }
+  ],
+  "shells": [
+    {
+      "id": "browser",
+      "label": "浏览器",
+      "hint": "只生成 Web 端工程，用 vite 起本地服务"
+    },
+    {
+      "id": "miniprogram",
+      "label": "小程序（UniApp）",
+      "hint": "页面层换成 UniApp Vue 3 单文件组件，宿主装配走小程序端口"
+    },
+    {
+      "id": "tauri",
+      "label": "桌面（Tauri 2）",
+      "hint": "给浏览器形态再加一个桌面壳：存档落到应用数据目录，其余不变"
+    }
+  ],
+  "_comment": "模板版本唯一来源，独立于引擎版本：仅当 template/v1 内容真正变化时才手动 bump。placeholder 是目录/文件内的工程名占位符，生成时整体替换为工程名（对齐 _LingFanEngineTemplateTitle_ 占位符语义）。minEngineVersion 表示此模板要求的最低引擎版本。frameworks 与 shells 决定生成器会问什么、能叠哪些层，首项为缺省值；每一项的 id 对应 template/v1/overlays/<id> 目录（缺省层可以没有目录）。"
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.