create-lumal-admin 0.0.1-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lumal contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# create-lumal-admin
+
+`create-lumal-admin` 是 Lumal 的轻量后台基座脚手架，用于生成通过公开包入口消费 `@lumal/core`、`@lumal/icons` 和 `@lumal/icons-vue` 的 Vue 应用。
+
+## 使用
+
+```bash
+pnpm create lumal-admin my-admin
+pnpm create lumal-admin my-admin-http --api-mode http
+```
+
+`--api-mode local` 是默认模式，保留浏览器内请求示例；`--api-mode http` 会额外生成接口环境变量、标准请求客户端、登录刷新示例和 `API-CONTRACT.md`，但不会生成完整业务后端。
+
+生成后执行：
+
+```bash
+cd my-admin
+pnpm install
+pnpm dev
+```
+
+## 生成内容
+
+- Vue 3 + TypeScript + Vite。
+- Element Plus 作为 UI 基础。
+- `@lumal/core/theme-chalk/index.scss`、`@lumal/core/style.css` 和 SCSS 样式入口。
+- `createLumalAdmin` 应用启动代码。
+- `LumalLayout` 后台布局壳和 `LumalRouterView` 路由出口，采用路由驱动标签模式：固定首页页签、`routeTabResolver` 按导航动态追加页签、`tabStorageKey` 会话级持久化、标签刷新重载视图。
+- 登录页、会话状态、权限菜单和路由守卫。
+- 工作台、受保护业务占位页、403 与独立 404 页面。
+- 主题切换、布局与标签偏好持久化、全局设置抽屉。
+- `createRequestClient` 请求封装示例。
+- Element Plus、Vue 和 Lumal 公共能力的明确 vendor 分包配置。
+
+脚手架生成的项目只通过 `@lumal/core`、`@lumal/icons`、`@lumal/icons-vue` 等公开包入口消费能力，不依赖 monorepo 内部源码路径。
+
+脚手架不会生成用户、角色、菜单、字典、配置等完整系统管理业务；这些应由具体项目按自身接口和权限模型实现。

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { basename, resolve } from 'node:path';
+import process from 'node:process';
+import { createLumalAdminProject } from './scaffold.js';
+/***********************参数解析*********************/
+function resolveApiMode(argv) {
+    const inline = argv.find(argument => argument.startsWith('--api-mode='))?.split('=')[1];
+    const optionIndex = argv.indexOf('--api-mode');
+    const value = inline ?? (optionIndex >= 0 ? argv[optionIndex + 1] : undefined) ?? 'local';
+    if (value !== 'http' && value !== 'local')
+        throw new Error('--api-mode 仅支持 local 或 http');
+    return value;
+}
+function resolveTargetDir(argv) {
+    const target = argv.slice(2).find(argument => !argument.startsWith('--') && argument !== 'http' && argument !== 'local');
+    return resolve(process.cwd(), target ?? 'lumal-admin');
+}
+/***********************命令执行*********************/
+async function main() {
+    const targetDir = resolveTargetDir(process.argv);
+    const result = await createLumalAdminProject({
+        apiMode: resolveApiMode(process.argv),
+        name: basename(targetDir),
+        targetDir,
+    });
+    console.log(`已创建 Lumal Admin 项目：${result.targetDir}`);
+    console.log('下一步：');
+    console.log(`  cd ${result.targetDir}`);
+    console.log('  pnpm install');
+    console.log('  pnpm dev');
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`创建失败：${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEvD,kDAAkD;AAClD,SAAS,cAAc,CAAC,IAAc;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAA;IACzF,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;QACvC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAChD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAc;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,CAAC,CAAA;IACxH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,IAAI,aAAa,CAAC,CAAA;AACxD,CAAC;AAED,kDAAkD;AAClD,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;QAC3C,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;QACrC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC;QACzB,SAAS;KACV,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IACrD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACnB,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC7B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;AAC3B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAA;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createLumalAdminProject, } from './scaffold.js';
+export type { CreateLumalAdminProjectOptions, CreateLumalAdminProjectResult, } from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GACxB,MAAM,eAAe,CAAA;AACtB,YAAY,EACV,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createLumalAdminProject, } from './scaffold.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,GACxB,MAAM,eAAe,CAAA"}

package/dist/scaffold.d.ts

@@ -0,0 +1,12 @@
+export interface CreateLumalAdminProjectOptions {
+    apiMode?: 'http' | 'local';
+    name: string;
+    targetDir: string;
+}
+export interface CreateLumalAdminProjectResult {
+    targetDir: string;
+    createdFiles: string[];
+}
+/***********************公开 API*********************/
+export declare function createLumalAdminProject(options: CreateLumalAdminProjectOptions): Promise<CreateLumalAdminProjectResult>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAwkDD,oDAAoD;AACpD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAexC"}