create-super-admin 0.0.0-bootstrap.0

package/README.md

@@ -0,0 +1,9 @@
+# create-super-admin
+
+Create a frontend-first Super Admin starter project.
+
+```bash
+npm create super-admin@next my-admin
+```
+
+The generated project consumes published `@super-admin-org/*` package artifacts and runs with mock data by default.

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,4 @@
+#!/usr/bin/env node
+import { runCreateSuperAdmin } from './run-create-super-admin.js';
+const exitCode = await runCreateSuperAdmin(process.argv.slice(2));
+process.exitCode = exitCode;

package/dist/generate-starter.d.ts

@@ -0,0 +1,9 @@
+import type { StarterGenerationInput } from './parse-args.js';
+export type GenerateStarterOptions = {
+    sourceRoot?: string;
+};
+export type GenerateStarterResult = {
+    targetDirectory: string;
+};
+export declare function generateStarter(input: StarterGenerationInput, options?: GenerateStarterOptions): Promise<GenerateStarterResult>;
+//# sourceMappingURL=generate-starter.d.ts.map

package/dist/generate-starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-starter.d.ts","sourceRoot":"","sources":["../src/generate-starter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAoB7D,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAkKD,wBAAsB,eAAe,CACnC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC"}

package/dist/generate-starter.js

@@ -0,0 +1,150 @@
+import { cp, mkdir, readFile, readdir, rename, rm, rmdir, writeFile } from 'node:fs/promises';
+import { dirname, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createAuthSession, createAuthSessionStore, createAuthTypes, createEnvDts, createGlobalPreferences, createI18nIndex, createIndexHtml, createLoginPage, createPackageJson, createPreferencesStore, createReadme, createSuperAdminConfig, createThemeRegistry, createTsconfig, createUsersApi, createViteConfig } from './templates.js';
+function getDefaultSourceRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+}
+function toPosixPath(path) {
+    return path.split(sep).join('/');
+}
+async function directoryEntries(path) {
+    try {
+        return await readdir(path, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+async function ensureTargetIsWritable(targetDirectory) {
+    const entries = await directoryEntries(targetDirectory);
+    if (!entries) {
+        return;
+    }
+    if (entries.length > 0) {
+        throw new Error(`Target directory is not empty: ${targetDirectory}`);
+    }
+}
+async function writeText(root, filePath, content) {
+    const target = resolve(root, filePath);
+    await mkdir(dirname(target), { recursive: true });
+    await writeFile(target, content);
+}
+function shouldSkipSourceFile(relativePath, context) {
+    if (relativePath.startsWith('api/reference/')) {
+        return true;
+    }
+    if (/\.(test|spec)\.(ts|tsx|js|mjs)$/.test(relativePath)) {
+        return true;
+    }
+    if (relativePath.endsWith('.tsbuildinfo')) {
+        return true;
+    }
+    if (!context.input.i18n.switcher && relativePath === 'i18n/locales/en-US.ts') {
+        return true;
+    }
+    return false;
+}
+function transformSourceText(relativePath, text, context) {
+    if (relativePath === 'env.d.ts') {
+        return createEnvDts();
+    }
+    if (relativePath === 'api/users.api.ts') {
+        return createUsersApi();
+    }
+    if (relativePath === 'modules/auth/LoginPage.vue') {
+        return createLoginPage();
+    }
+    if (relativePath === 'modules/auth/auth-session.ts') {
+        return createAuthSession();
+    }
+    if (relativePath === 'modules/auth/auth.types.ts') {
+        return createAuthTypes();
+    }
+    if (relativePath === 'stores/auth-session.store.ts') {
+        return createAuthSessionStore();
+    }
+    if (relativePath === 'stores/preferences.store.ts') {
+        return createPreferencesStore();
+    }
+    if (relativePath === 'i18n/index.ts') {
+        return createI18nIndex(context.input.i18n.installed);
+    }
+    if (relativePath === 'shell/preferences/GlobalPreferences.vue') {
+        return createGlobalPreferences({
+            includeLocaleSwitcher: context.input.i18n.switcher,
+            includeThemeSwitcher: context.input.themes.installed.length > 1
+        });
+    }
+    if (relativePath === 'super-admin/theme-registry.generated.ts') {
+        return createThemeRegistry(context.input.themes.installed, context.input.themes.default);
+    }
+    if (relativePath === 'styles/main.css') {
+        return text.replace('@source "../../../../packages/ui/src";', '@source "../../node_modules/@super-admin-org/ui/dist";');
+    }
+    return text;
+}
+async function copySourceDirectory(sourceDir, targetDir, context, currentDir = sourceDir) {
+    const entries = await readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const sourcePath = resolve(currentDir, entry.name);
+        const relativePath = toPosixPath(relative(sourceDir, sourcePath));
+        if (entry.isDirectory()) {
+            if (shouldSkipSourceFile(`${relativePath}/`, context)) {
+                continue;
+            }
+            await copySourceDirectory(sourceDir, targetDir, context, sourcePath);
+            continue;
+        }
+        if (!entry.isFile() || shouldSkipSourceFile(relativePath, context)) {
+            continue;
+        }
+        const targetPath = resolve(targetDir, relativePath);
+        await mkdir(dirname(targetPath), { recursive: true });
+        const text = await readFile(sourcePath, 'utf8');
+        await writeFile(targetPath, transformSourceText(relativePath, text, context));
+    }
+}
+async function writeGeneratedRootFiles(outputRoot, input, sourceAppDir) {
+    await cp(resolve(sourceAppDir, 'components.json'), resolve(outputRoot, 'components.json'));
+    await writeText(outputRoot, 'index.html', createIndexHtml(input.projectName));
+    await writeText(outputRoot, 'package.json', createPackageJson(input));
+    await writeText(outputRoot, 'README.md', createReadme(input.projectName, input.packageManager));
+    await writeText(outputRoot, 'super-admin.config.ts', createSuperAdminConfig(input));
+    await writeText(outputRoot, 'tsconfig.json', createTsconfig());
+    await writeText(outputRoot, 'vite.config.ts', createViteConfig());
+}
+async function materializeOutput(tempDirectory, targetDirectory) {
+    const targetEntries = await directoryEntries(targetDirectory);
+    if (targetEntries && targetEntries.length === 0) {
+        await rmdir(targetDirectory);
+    }
+    await rename(tempDirectory, targetDirectory);
+}
+export async function generateStarter(input, options = {}) {
+    const sourceRoot = options.sourceRoot ?? getDefaultSourceRoot();
+    const sourceAppDir = resolve(sourceRoot, 'apps/admin');
+    const targetDirectory = input.targetDirectory;
+    const tempDirectory = resolve(dirname(targetDirectory), `.${input.projectName}.tmp-${Date.now()}-${process.pid}`);
+    const context = {
+        input
+    };
+    await ensureTargetIsWritable(targetDirectory);
+    await rm(tempDirectory, { force: true, recursive: true });
+    await mkdir(tempDirectory, { recursive: true });
+    try {
+        await writeGeneratedRootFiles(tempDirectory, input, sourceAppDir);
+        await copySourceDirectory(resolve(sourceAppDir, 'src'), resolve(tempDirectory, 'src'), context);
+        await materializeOutput(tempDirectory, targetDirectory);
+    }
+    catch (error) {
+        await rm(tempDirectory, { force: true, recursive: true });
+        throw error;
+    }
+    return {
+        targetDirectory
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { generateStarter } from './generate-starter.js';
+export { parseCreateSuperAdminArgs } from './parse-args.js';
+export { runCreateSuperAdmin } from './run-create-super-admin.js';
+export type { GenerateStarterOptions, GenerateStarterResult } from './generate-starter.js';
+export type { ParseCreateSuperAdminArgsOptions, StarterGenerationInput } from './parse-args.js';
+export type { CreateSuperAdminIo } from './run-create-super-admin.js';
+export type { StarterLocaleId, StarterPackageManager, StarterThemeId } from './theme-options.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,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC1F,YAAY,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC/F,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AACrE,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { generateStarter } from './generate-starter.js';
+export { parseCreateSuperAdminArgs } from './parse-args.js';
+export { runCreateSuperAdmin } from './run-create-super-admin.js';

package/dist/parse-args.d.ts

@@ -0,0 +1,21 @@
+import type { StarterLocaleId, StarterPackageManager, StarterThemeId } from './theme-options.js';
+export type StarterGenerationInput = {
+    projectName: string;
+    packageName: string;
+    packageManager: StarterPackageManager;
+    targetDirectory: string;
+    themes: {
+        installed: StarterThemeId[];
+        default: StarterThemeId;
+    };
+    i18n: {
+        installed: StarterLocaleId[];
+        default: StarterLocaleId;
+        switcher: boolean;
+    };
+};
+export type ParseCreateSuperAdminArgsOptions = {
+    cwd?: string;
+};
+export declare function parseCreateSuperAdminArgs(argv: string[], options?: ParseCreateSuperAdminArgsOptions): StarterGenerationInput;
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEhG,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,qBAAqB,CAAA;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE;QACN,SAAS,EAAE,cAAc,EAAE,CAAA;QAC3B,OAAO,EAAE,cAAc,CAAA;KACxB,CAAA;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,eAAe,EAAE,CAAA;QAC5B,OAAO,EAAE,eAAe,CAAA;QACxB,QAAQ,EAAE,OAAO,CAAA;KAClB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,gCAAgC,GAAG;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAgHD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,gCAAqC,GAC7C,sBAAsB,CA0BxB"}

package/dist/parse-args.js

@@ -0,0 +1,104 @@
+import { basename, resolve } from 'node:path';
+import { isStarterPackageManager, isStarterThemeId, starterPackageManagers, starterThemeIds } from './theme-options.js';
+function readFlagValue(args, index, flag) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`${flag} requires a value.`);
+    }
+    return value;
+}
+function parseFlags(argv) {
+    const parsed = {
+        i18n: false
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === '--i18n') {
+            parsed.i18n = true;
+            continue;
+        }
+        if (arg === '--theme') {
+            parsed.theme = readFlagValue(argv, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg === '--themes') {
+            parsed.themes = readFlagValue(argv, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg === '--pm' || arg === '--package-manager') {
+            parsed.packageManager = readFlagValue(argv, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        if (parsed.project) {
+            throw new Error(`Unexpected extra argument: ${arg}`);
+        }
+        parsed.project = arg;
+    }
+    return parsed;
+}
+function normalizePackageName(project) {
+    const name = basename(project)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return name || 'super-admin-app';
+}
+function normalizeThemes(theme, themes) {
+    if (theme && themes) {
+        throw new Error('--theme and --themes are mutually exclusive.');
+    }
+    const rawThemes = (themes ? themes.split(',') : [theme ?? 'base']).map((item) => item.trim()).filter(Boolean);
+    const normalizedThemes = [];
+    for (const rawTheme of rawThemes) {
+        if (!isStarterThemeId(rawTheme)) {
+            throw new Error(`Unknown theme "${rawTheme}". Supported themes: ${starterThemeIds.join(', ')}`);
+        }
+        if (!normalizedThemes.includes(rawTheme)) {
+            normalizedThemes.push(rawTheme);
+        }
+    }
+    if (normalizedThemes.length === 0) {
+        throw new Error('At least one generated starter theme is required.');
+    }
+    return normalizedThemes;
+}
+function normalizePackageManager(packageManager) {
+    if (!packageManager) {
+        return 'pnpm';
+    }
+    if (!isStarterPackageManager(packageManager)) {
+        throw new Error(`Unsupported package manager "${packageManager}". Supported package managers: ${starterPackageManagers.join(', ')}`);
+    }
+    return packageManager;
+}
+export function parseCreateSuperAdminArgs(argv, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const flags = parseFlags(argv);
+    if (!flags.project) {
+        throw new Error('Usage: create-super-admin <project> [--theme base] [--themes base,cyberpunk] [--i18n] [--pm pnpm]');
+    }
+    const themes = normalizeThemes(flags.theme, flags.themes);
+    const projectName = basename(flags.project);
+    return {
+        projectName,
+        packageName: normalizePackageName(projectName),
+        packageManager: normalizePackageManager(flags.packageManager),
+        targetDirectory: resolve(cwd, flags.project),
+        themes: {
+            installed: themes,
+            default: themes[0] ?? 'base'
+        },
+        i18n: {
+            installed: flags.i18n ? ['zh-CN', 'en-US'] : ['zh-CN'],
+            default: 'zh-CN',
+            switcher: flags.i18n
+        }
+    };
+}

package/dist/run-create-super-admin.d.ts

@@ -0,0 +1,8 @@
+export type CreateSuperAdminIo = {
+    cwd?: string;
+    sourceRoot?: string;
+    stdout?: (message: string) => void;
+    stderr?: (message: string) => void;
+};
+export declare function runCreateSuperAdmin(argv: string[], io?: CreateSuperAdminIo): Promise<number>;
+//# sourceMappingURL=run-create-super-admin.d.ts.map

package/dist/run-create-super-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-create-super-admin.d.ts","sourceRoot":"","sources":["../src/run-create-super-admin.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC,CAAA;AAoBD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBtG"}

package/dist/run-create-super-admin.js

@@ -0,0 +1,33 @@
+import { generateStarter } from './generate-starter.js';
+import { parseCreateSuperAdminArgs } from './parse-args.js';
+function writeLine(writer, message) {
+    if (writer) {
+        writer(message);
+        return;
+    }
+    console.log(message);
+}
+function writeError(writer, message) {
+    if (writer) {
+        writer(message);
+        return;
+    }
+    console.error(message);
+}
+export async function runCreateSuperAdmin(argv, io = {}) {
+    try {
+        const input = parseCreateSuperAdminArgs(argv, {
+            cwd: io.cwd
+        });
+        await generateStarter(input, {
+            sourceRoot: io.sourceRoot
+        });
+        writeLine(io.stdout, `Created Super Admin starter at ${input.targetDirectory}`);
+        writeLine(io.stdout, `Next: cd ${input.projectName} && ${input.packageManager} install && ${input.packageManager} run dev`);
+        return 0;
+    }
+    catch (error) {
+        writeError(io.stderr, error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}

package/dist/templates.d.ts

@@ -0,0 +1,22 @@
+import type { StarterGenerationInput } from './parse-args.js';
+import type { StarterLocaleId, StarterThemeId } from './theme-options.js';
+export declare function createPackageJson(input: StarterGenerationInput): string;
+export declare function createIndexHtml(projectName: string): string;
+export declare function createViteConfig(): string;
+export declare function createTsconfig(): string;
+export declare function createReadme(projectName: string, packageManager: string): string;
+export declare function createSuperAdminConfig(input: StarterGenerationInput): string;
+export declare function createThemeRegistry(themes: StarterThemeId[], defaultTheme: StarterThemeId): string;
+export declare function createEnvDts(): string;
+export declare function createUsersApi(): string;
+export declare function createAuthTypes(): string;
+export declare function createAuthSession(): string;
+export declare function createAuthSessionStore(): string;
+export declare function createLoginPage(): string;
+export declare function createI18nIndex(locales: StarterLocaleId[]): string;
+export declare function createPreferencesStore(): string;
+export declare function createGlobalPreferences(options: {
+    includeThemeSwitcher: boolean;
+    includeLocaleSwitcher: boolean;
+}): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAQzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CA2CvE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAc3D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAezC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAoBvC;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBhF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAc5E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,YAAY,EAAE,cAAc,GAAG,MAAM,CAmBlG;AAED,wBAAgB,YAAY,IAAI,MAAM,CAyBrC;AAED,wBAAgB,cAAc,IAAI,MAAM,CA2DvC;AAED,wBAAgB,eAAe,IAAI,MAAM,CA6BxC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAiB1C;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAsC/C;AAED,wBAAgB,eAAe,IAAI,MAAM,CA6GxC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAkFlE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CA+L/C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAAE,oBAAoB,EAAE,OAAO,CAAC;IAAC,qBAAqB,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAuS1H"}