@composy/website-vanilla
v0.0.2
Published
Vanilla website application built on LDesign website core
Downloads
34
Maintainers
Readme
@composy/website-vanilla
基于 LDesign Website Core 的 Vanilla 网站应用,同时发布可复用的 npm API。应用运行与 npm 包构建共用一个 Submodule:src/main.ts 是本地站点入口,src/index.ts 是包入口。
目录
src/core/:网站启动、认证与运行时集成。src/apps/default/:默认网站场景。src/types/:公开类型入口。.ldesign/:Builder、Launcher、TypeScript 与 ESLint 的权威配置。- Vite 依赖缓存按工作区路径隔离在系统临时目录,不写入 Submodule。
开发与验证
pnpm install
pnpm dev
pnpm build # Launcher 构建站点,Builder 构建 npm 包
pnpm build:app # 只构建站点到 dist/
pnpm build:lib # 构建并检查 es/、esm/、lib/、dist/ 发布产物
pnpm preview
pnpm type-check
pnpm lint:check
pnpm format:checkLauncher 默认开发端口为 3000、预览端口为 4173。开发服务器将 /api 代理到 API_TARGET,默认值为 http://localhost:37217。
npm 使用
import { createWebsiteVanillaApp } from '@composy/website-vanilla'
import '@composy/website-vanilla/style.css'
createWebsiteVanillaApp({ selector: '#app' })分层入口还包括 @composy/website-vanilla/core、@composy/website-vanilla/apps/default 与 @composy/website-vanilla/types。
浏览器 UMD
UMD 包会引用构建配置标记为 external 的 LDesign 依赖,因此不能视为零依赖的独立脚本。普通 npm/ESM 使用方式由 package exports 提供;直接加载 UMD 时,调用方需要确保 external 依赖可用。
登录 API
默认网站提供 NestAPI 登录与会话恢复能力。请求使用同源 /api/v1;CSRF 初始化通过 /api/health 握手。开发时可用 API_TARGET 覆盖本地 API 地址。
