@zlooks.cn/cli 1.0.5 → 1.0.6

package/dist/command/index.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import { readFileSync } from 'node:fs';
+import { execFile } from 'node:child_process';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
+import { promisify } from 'node:util';
 import { Command } from 'commander';
 import { completeDeployment, getDeploymentPath, rollbackDeployment, startDeployment, statusDeployment, } from '../deploy.js';
 import { inspectDeployment } from '../doctor.js';
@@ -11,6 +13,8 @@ import { installOperation, databaseOperation, restartOperation, serviceListOpera
 import { confirm, isPromptCancellation, selectMany } from '../prompt.js';
 import { getSetupPaths, setupOperation } from '../setup.js';
 import { executeFile } from '../system.js';
+import { createBlogThemeScaffold, verifyBlogThemeProject } from '../theme-authoring.js';
+const execFileAsync = promisify(execFile);
 const manifest = readManifest();
 const defaultEnvironment = getSetupPaths(homedir()).environment;
 const deploymentPath = getDeploymentPath(homedir());
@@ -117,6 +121,59 @@ program.command('doctor')
     if (!result.ok)
         process.exitCode = 1;
 });
+const theme = program.command('theme').description('Create and verify third-party Blog themes');
+theme.command('create')
+    .description('Create a complete runnable Blog theme scaffold')
+    .argument('<theme-id>', 'Lowercase kebab-case theme identity')
+    .argument('[destination]', 'New project directory')
+    .requiredOption('--display-name <name>', 'Human-readable theme name')
+    .option('--description <text>', 'Theme description')
+    .action(async (themeId, destination, options) => {
+    const result = await createBlogThemeScaffold({
+        themeId,
+        displayName: options.displayName,
+        ...(options.description ? { description: options.description } : {}),
+        destination: resolve(process.cwd(), destination ?? `zlooks-theme-${themeId}-server`),
+    });
+    runtime.write(`${JSON.stringify(result)}\n`);
+});
+theme.command('verify')
+    .description('Run platform-owned structure, test, typecheck, build, and RSC verification gates')
+    .argument('[root]', 'Theme project directory', '.')
+    .option('--json', 'Write one machine-readable JSON result')
+    .action(async (root, options) => {
+    const result = await verifyBlogThemeProject({ root: resolve(process.cwd(), root) }, {
+        run: async (command, args, runOptions) => {
+            try {
+                const completed = await execFileAsync(command, [...args], {
+                    cwd: runOptions.cwd,
+                    encoding: 'utf8',
+                    maxBuffer: 10 * 1024 * 1024,
+                    timeout: 10 * 60 * 1000,
+                    killSignal: 'SIGKILL',
+                });
+                return { exitCode: 0, output: completed.stdout };
+            }
+            catch (error) {
+                if (error && typeof error === 'object') {
+                    const failure = error;
+                    return {
+                        exitCode: typeof failure.code === 'number' ? failure.code : 1,
+                        output: `${typeof failure.stdout === 'string' ? failure.stdout : ''}${typeof failure.stderr === 'string' ? failure.stderr : ''}` || (error instanceof Error ? error.message : String(error)),
+                    };
+                }
+                return { exitCode: 1, output: String(error) };
+            }
+        },
+    });
+    if (options.json)
+        runtime.write(`${JSON.stringify(result)}\n`);
+    else
+        for (const check of result.checks)
+            runtime.write(`${check.ok ? 'PASS' : 'FAIL'}\t${check.id}\t${check.detail}\n`);
+    if (!result.ok)
+        process.exitCode = 1;
+});
 program.action(() => program.outputHelp());
 try {
     await program.parseAsync(process.argv);

package/dist/command/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"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"}

package/dist/theme-authoring.d.ts

@@ -0,0 +1,36 @@
+export interface CreateBlogThemeScaffoldOptions {
+    readonly destination: string;
+    readonly themeId: string;
+    readonly displayName: string;
+    readonly description?: string;
+}
+export interface BlogThemeScaffoldResult {
+    readonly destination: string;
+    readonly packageName: string;
+    readonly themeId: string;
+}
+export interface BlogThemeVerificationCheck {
+    readonly id: string;
+    readonly ok: boolean;
+    readonly detail: string;
+}
+export interface BlogThemeVerificationResult {
+    readonly ok: boolean;
+    readonly stage: 'PRECHECK' | 'SCAFFOLDED' | 'LOCAL_VERIFIED';
+    readonly checks: readonly BlogThemeVerificationCheck[];
+}
+export interface BlogThemeVerificationRuntime {
+    readonly run: (command: string, args: readonly string[], options: {
+        readonly cwd: string;
+    }) => Promise<{
+        readonly exitCode: number;
+        readonly output: string;
+    }>;
+}
+export declare function createBlogThemeScaffold(options: CreateBlogThemeScaffoldOptions): Promise<BlogThemeScaffoldResult>;
+export declare function verifyBlogThemeProject(options: {
+    readonly root: string;
+}, runtime: BlogThemeVerificationRuntime): Promise<BlogThemeVerificationResult>;
+export declare function inspectInstalledThemePeers(root: string): Promise<BlogThemeVerificationCheck>;
+export declare function inspectBlogThemeProject(root: string): Promise<readonly BlogThemeVerificationCheck[]>;
+//# sourceMappingURL=theme-authoring.d.ts.map

package/dist/theme-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-authoring.d.ts","sourceRoot":"","sources":["../src/theme-authoring.ts"],"names":[],"mappings":"AA2CA,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,GAAG,gBAAgB,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,CACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CA4BlC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAClC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAsCtC;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CA0BlG;AAsDD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,0BAA0B,EAAE,CAAC,CAuE1G"}

package/dist/theme-authoring.js

@@ -0,0 +1,491 @@
+import { randomUUID } from 'node:crypto';
+import { readdir, readFile, rename, rm, stat, writeFile, mkdir, mkdtemp } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { basename, dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { satisfies, valid as validSemver } from 'semver';
+import { parse as parseYaml } from 'yaml';
+import { parseZlooksPackageManifest } from './package-manifest.js';
+const THEME_ID_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const THIRD_PARTY_THEME_PACKAGE_PATTERN = /^zlooks-theme-[a-z][a-z0-9]*(?:-[a-z0-9]+)*-server$/;
+const REQUIRED_ROUTES = [
+    '/',
+    '/posts/[slug]',
+    '/archives',
+    '/pages/[slug]',
+    '/categories/[slug]',
+    '/tags/[slug]',
+    '/friends',
+];
+const REQUIRED_FILES = [
+    'package.json',
+    'pnpm-workspace.yaml',
+    'hile-rsc.json',
+    'tsconfig.json',
+    'tsconfig.runtime.json',
+    'src/command/index.ts',
+    'src/identity.ts',
+    'src/services/blog-theme.boot.ts',
+    'src/plugin/page.tsx',
+    'src/plugin/blog-frame.tsx',
+    'src/plugin/blog-interactions.tsx',
+    'src/plugin/theme.css',
+    'test/theme-contract.test.ts',
+];
+const LOCAL_GATES = [
+    ['install', '--frozen-lockfile=false'],
+    ['run', 'test'],
+    ['run', 'typecheck'],
+    ['run', 'build'],
+    ['run', 'verify:rsc'],
+];
+export async function createBlogThemeScaffold(options) {
+    const themeId = parseThemeId(options.themeId);
+    const displayName = parseRequiredText(options.displayName, 'displayName', 100);
+    const description = parseRequiredText(options.description ?? `${displayName} Zlooks 博客主题`, 'description', 500);
+    const destination = resolve(options.destination);
+    const packageName = `zlooks-theme-${themeId}-server`;
+    await assertDestinationAbsent(destination);
+    const temporary = join(dirname(destination), `.${basename(destination)}.tmp-${randomUUID()}`);
+    await mkdir(temporary, { recursive: false });
+    try {
+        await copyTemplate(new URL('../templates/blog-theme/', import.meta.url), temporary, {
+            '__THEME_ID__': themeId,
+            '__PACKAGE_NAME__': packageName,
+            '__DISPLAY_NAME_JSON__': JSON.stringify(displayName),
+            '__DESCRIPTION_JSON__': JSON.stringify(description),
+            ...await themeSdkVersions(),
+        });
+        await rename(temporary, destination);
+    }
+    catch (error) {
+        await rm(temporary, { recursive: true, force: true });
+        throw error;
+    }
+    return Object.freeze({ destination, packageName, themeId });
+}
+export async function verifyBlogThemeProject(options, runtime) {
+    const root = resolve(options.root);
+    const checks = await inspectBlogThemeProject(root);
+    if (checks.some((check) => !check.ok)) {
+        return Object.freeze({ ok: false, stage: 'PRECHECK', checks });
+    }
+    const executed = [...checks];
+    for (const args of LOCAL_GATES) {
+        const id = `command.${args.slice(1).join('.') || args[0]}`;
+        const result = await runtime.run('pnpm', args, { cwd: root });
+        executed.push(Object.freeze({
+            id,
+            ok: result.exitCode === 0,
+            detail: result.exitCode === 0 ? `pnpm ${args.join(' ')} passed` : boundedOutput(result.output),
+        }));
+        if (result.exitCode !== 0) {
+            return Object.freeze({ ok: false, stage: 'SCAFFOLDED', checks: executed });
+        }
+        if (args[0] === 'install') {
+            const compatible = await inspectInstalledThemePeers(root);
+            executed.push(compatible);
+            if (!compatible.ok)
+                return Object.freeze({ ok: false, stage: 'SCAFFOLDED', checks: executed });
+        }
+    }
+    const finalChecks = [
+        ...await inspectBlogThemeProject(root),
+        await inspectInstalledThemePeers(root),
+    ].map((check) => ({ ...check, id: `final.${check.id}` }));
+    executed.push(...finalChecks);
+    if (finalChecks.some((check) => !check.ok))
+        return Object.freeze({ ok: false, stage: 'SCAFFOLDED', checks: executed });
+    const artifact = await inspectProducedArtifact(root, runtime);
+    executed.push(artifact);
+    if (!artifact.ok)
+        return Object.freeze({ ok: false, stage: 'SCAFFOLDED', checks: executed });
+    const packed = await inspectPackedTheme(root, runtime);
+    executed.push(packed);
+    if (!packed.ok)
+        return Object.freeze({ ok: false, stage: 'SCAFFOLDED', checks: executed });
+    return Object.freeze({ ok: true, stage: 'LOCAL_VERIFIED', checks: executed });
+}
+export async function inspectInstalledThemePeers(root) {
+    try {
+        const readInstalled = async (name) => JSON.parse(await readFile(join(root, 'node_modules', name, 'package.json'), 'utf8'));
+        const ui = await readInstalled('@zlooks.cn/ui');
+        const theme = await readInstalled('@zlooks.cn/blog-theme');
+        const requirements = {
+            antd: ui.peerDependencies?.antd,
+            react: ui.peerDependencies?.react,
+            'react-dom': ui.peerDependencies?.['react-dom'],
+            'react-server-dom-webpack': ui.peerDependencies?.react,
+            '@hile/rsc': theme.dependencies?.['@hile/rsc'],
+        };
+        for (const [name, range] of Object.entries(requirements)) {
+            if (!range)
+                throw new Error(`Installed SDK is missing its ${name} compatibility contract`);
+            const installed = await readInstalled(name);
+            if (!satisfies(installed.version, range)) {
+                const prefix = name === 'antd' ? '--save-exact' : '--save-prefix=^';
+                throw new Error(`${name}@${installed.version} does not satisfy the SDK contract ${range}. Resolve a compatible version with pnpm add ${prefix} ${name}@${range}, preserve pnpm-lock.yaml, and rerun verification.`);
+            }
+        }
+        return { id: 'installed.compatible', ok: true, detail: 'Installed Ant Design, React and Hile versions match SDK compatibility contracts' };
+    }
+    catch (error) {
+        return { id: 'installed.compatible', ok: false, detail: boundedOutput(error instanceof Error ? error.message : String(error)) };
+    }
+}
+async function inspectProducedArtifact(root, runtime) {
+    try {
+        const result = await runtime.run('pnpm', ['exec', 'hile-rsc', 'verify'], { cwd: root });
+        const verified = JSON.parse(result.output);
+        if (result.exitCode !== 0 || verified.valid !== true || verified.pluginId !== 'blog')
+            throw new Error('Direct Hile RSC verification did not confirm a valid Blog artifact');
+        const builds = await readdir(join(root, '.hile-rsc'), { withFileTypes: true });
+        if (builds.length !== 1 || !builds[0].isDirectory() || builds[0].name.startsWith('.'))
+            throw new Error('.hile-rsc must contain exactly one production build and no development state');
+        const prefix = `.hile-rsc/${builds[0].name}`;
+        const manifest = JSON.parse(await readFile(join(root, prefix, 'plugin.json'), 'utf8'));
+        if (!REQUIRED_ROUTES.every((path) => manifest.routes?.some((route) => route.path === path)))
+            throw new Error('The compiled artifact is missing required Blog routes');
+        return { id: 'artifact.verified', ok: true, detail: 'Direct Hile verification confirms one immutable Blog build with all seven routes' };
+    }
+    catch (error) {
+        return { id: 'artifact.verified', ok: false, detail: boundedOutput(error instanceof Error ? error.message : String(error)) };
+    }
+}
+async function inspectPackedTheme(root, runtime) {
+    const destination = await mkdtemp(join(tmpdir(), 'zlooks-theme-pack-'));
+    try {
+        const result = await runtime.run('npm', ['pack', '--ignore-scripts', '--json', '--pack-destination', destination], { cwd: root });
+        if (result.exitCode !== 0)
+            throw new Error(result.output || 'npm pack failed');
+        const output = JSON.parse(result.output);
+        if (output.length !== 1 || basename(output[0].filename) !== output[0].filename)
+            throw new Error('npm pack returned an invalid tarball');
+        const tarball = await stat(join(destination, output[0].filename));
+        if (!tarball.isFile() || tarball.size === 0)
+            throw new Error('npm pack produced no tarball');
+        const packed = new Set(output[0].files.map(({ path }) => path));
+        const manifest = JSON.parse(await readFile(join(root, 'package.json'), 'utf8'));
+        const expected = ['package.json', ...Object.values(manifest.bin), ...await regularFiles(root, '.hile-rsc'), ...await regularFiles(root, 'dist')];
+        if (!expected.some((path) => path.endsWith('.boot.js')))
+            throw new Error('The compiled service has no boot file');
+        const missing = expected.filter((path) => !packed.has(path.replace(/^\.\//, '')));
+        if (missing.length)
+            throw new Error(`Tarball is missing build files: ${missing.join(', ')}`);
+        const unexpected = [...packed].filter((path) => !path.startsWith('dist/') && !path.startsWith('.hile-rsc/') && !/^(?:package\.json|readme(?:\.[^/]*)?|licen[cs]e(?:\.[^/]*)?)$/i.test(path));
+        if (unexpected.length)
+            throw new Error(`Tarball contains non-runtime files: ${unexpected.join(', ')}`);
+        return { id: 'package.packed', ok: true, detail: `Real npm tarball contains all ${expected.length} required metadata and build files; test archive removed` };
+    }
+    catch (error) {
+        return { id: 'package.packed', ok: false, detail: boundedOutput(error instanceof Error ? error.message : String(error)) };
+    }
+    finally {
+        await rm(destination, { recursive: true, force: true });
+    }
+}
+async function regularFiles(root, directory) {
+    const files = [];
+    for (const entry of await readdir(join(root, directory), { withFileTypes: true })) {
+        const path = `${directory}/${entry.name}`;
+        if (entry.isDirectory())
+            files.push(...await regularFiles(root, path));
+        else if (entry.isFile())
+            files.push(path);
+        else
+            throw new Error(`Build output must contain regular files only: ${path}`);
+    }
+    return files;
+}
+export async function inspectBlogThemeProject(root) {
+    const files = new Map();
+    const fileChecks = await Promise.all(REQUIRED_FILES.map(async (path) => {
+        try {
+            const content = await readFile(join(root, path), 'utf8');
+            files.set(path, content);
+            return { id: `file.${path}`, ok: content.length > 0, detail: `${path} is present` };
+        }
+        catch {
+            return { id: `file.${path}`, ok: false, detail: `${path} is missing` };
+        }
+    }));
+    const checks = [...fileChecks];
+    checks.push(validateManifest(files.get('package.json')));
+    checks.push(validateWorkspace(files.get('pnpm-workspace.yaml')));
+    checks.push(validateRoutes(files.get('hile-rsc.json')));
+    let source = '';
+    try {
+        const sourcePaths = (await regularFiles(root, 'src')).filter((path) => /\.[cm]?[jt]sx?$/.test(path));
+        source = (await Promise.all(sourcePaths.map((path) => readFile(join(root, path), 'utf8')))).join('\n');
+        checks.push({ id: 'source.inspectable', ok: true, detail: `Inspected all ${sourcePaths.length} production source files` });
+    }
+    catch (error) {
+        checks.push({ id: 'source.inspectable', ok: false, detail: error instanceof Error ? error.message : String(error) });
+    }
+    checks.push(markerCheck('runtime.sdk', source, [
+        'defineBlogTheme',
+        'createBlogThemeBootService',
+        'createServiceBackedBlogThemeDataLoader',
+    ]));
+    checks.push(markerCheck('routes.exports', files.get('src/plugin/page.tsx') ?? '', [
+        'BlogHomePage',
+        'BlogPostPage',
+        'BlogArchivePage',
+        'BlogSinglePagePage',
+        'BlogCategoryPage',
+        'BlogTagPage',
+        'BlogFriendLinksPage',
+    ]));
+    checks.push(markerCheck('interactions.complete', files.get('src/plugin/blog-interactions.tsx') ?? '', [
+        'searchPosts',
+        'likePost',
+        'unlikePost',
+        'listComments',
+        'createComment',
+    ]));
+    const unsafeAntdClientImport = /import\s*\{[^}]*\b(?:App|Button)\b[^}]*\}\s*from\s*['"]antd['"]/s.test(source);
+    checks.push(markerCheck('ui.shell-complete', source, [
+        'ZlooksShellProvider', 'ZlooksSiteConfigProvider', 'ZlooksUserAccess',
+        'useZlooksNavigation', 'useZlooksTheme', 'setMode', 'onLogout', 'legal.registrations', 'legal.copyright',
+    ]));
+    checks.push(Object.freeze({
+        id: 'ui.rsc-compatible',
+        ok: source.includes('@zlooks.cn/ui/button') && !unsafeAntdClientImport,
+        detail: source.includes('@zlooks.cn/ui/button') && !unsafeAntdClientImport
+            ? 'Buttons use the Hile-compatible shared UI boundary'
+            : 'Import ZlooksButton from @zlooks.cn/ui/button and use @zlooks.cn/ui/app instead of importing App or Button from the Ant Design root barrel',
+    }));
+    checks.push(Object.freeze({
+        id: 'markdown.safe',
+        ok: !source.includes('dangerouslySetInnerHTML') && source.includes('react-markdown'),
+        detail: !source.includes('dangerouslySetInnerHTML') && source.includes('react-markdown')
+            ? 'Markdown uses a structured renderer without raw HTML injection'
+            : 'Use react-markdown and remove dangerouslySetInnerHTML',
+    }));
+    checks.push(Object.freeze({
+        id: 'styles.bound',
+        ok: (files.get('src/plugin/blog-frame.tsx') ?? '').includes("./theme.css"),
+        detail: 'The Client Boundary must import ./theme.css',
+    }));
+    return Object.freeze(checks);
+}
+function validateManifest(source) {
+    try {
+        const raw = JSON.parse(source ?? '');
+        const parsed = parseZlooksPackageManifest(raw);
+        if (!THIRD_PARTY_THEME_PACKAGE_PATTERN.test(parsed.name) || parsed.name.startsWith('@zlooks.cn/')) {
+            throw new Error('Third-party themes must use zlooks-theme-<themeId>-server without the @zlooks.cn scope');
+        }
+        if (parsed.kind !== 'theme')
+            throw new Error('zlooks.kind must be theme');
+        const expectedThemeId = parsed.name.slice('zlooks-theme-'.length, -'-server'.length);
+        if (raw.zlooks?.themeId !== expectedThemeId) {
+            throw new Error(`zlooks.themeId must be ${expectedThemeId} so package and runtime identity match`);
+        }
+        if (raw.private !== false)
+            throw new Error('Third-party theme package must set private=false');
+        if (!Array.isArray(raw.files) || !raw.files.includes('dist') || !raw.files.includes('.hile-rsc')) {
+            throw new Error('files must publish dist and .hile-rsc');
+        }
+        if (!Array.isArray(raw.zlooks?.nodeConditions) || !raw.zlooks.nodeConditions.includes('react-server')) {
+            throw new Error('zlooks.nodeConditions must include react-server');
+        }
+        const scripts = requireRecord(raw.scripts, 'scripts');
+        for (const script of ['test', 'typecheck', 'build', 'verify:rsc']) {
+            if (typeof scripts[script] !== 'string' || scripts[script].trim().length === 0) {
+                throw new Error(`package.json must define ${script}`);
+            }
+        }
+        const runtimeScripts = {
+            dev: 'NODE_OPTIONS=--conditions=react-server hile start --dev --env-file ~/.zlooks.cn/.env',
+            start: 'NODE_OPTIONS=--conditions=react-server hile start --env-file ~/.zlooks.cn/.env',
+        };
+        for (const [script, expected] of Object.entries(runtimeScripts)) {
+            if (scripts[script] !== expected) {
+                throw new Error(`${script} must load the canonical ~/.zlooks.cn/.env through Hile`);
+            }
+        }
+        for (const [section, dependencies] of [
+            ['dependencies', raw.dependencies],
+            ['devDependencies', raw.devDependencies],
+            ['peerDependencies', raw.peerDependencies],
+            ['optionalDependencies', raw.optionalDependencies],
+        ]) {
+            if (dependencies === undefined)
+                continue;
+            for (const [name, version] of Object.entries(requireRecord(dependencies, section))) {
+                const valid = typeof version === 'string' && (name === 'antd'
+                    ? validSemver(version) !== null
+                    : version.startsWith('^') && validSemver(version.slice(1)) !== null);
+                if (!valid) {
+                    throw new Error(`${section}.${name} must use a caret npm version such as ^1.0.0, except antd must use an exact version; workspace:, file:, link:, tags, and paths are forbidden`);
+                }
+            }
+        }
+        assertPortableResolutionConfig(raw.pnpm, 'pnpm');
+        assertPortableResolutionConfig(raw.overrides, 'overrides');
+        assertPortableResolutionConfig(raw.resolutions, 'resolutions');
+        return Object.freeze({ id: 'manifest.deployable', ok: true, detail: `${parsed.name} is a deployable third-party theme` });
+    }
+    catch (error) {
+        return Object.freeze({
+            id: 'manifest.deployable',
+            ok: false,
+            detail: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function validateWorkspace(source) {
+    try {
+        const parsed = requireRecord(parseYaml(source ?? ''), 'pnpm-workspace.yaml');
+        for (const field of ['overrides', 'catalog', 'catalogs', 'packageExtensions', 'patchedDependencies']) {
+            assertPortableResolutionConfig(parsed[field], field);
+        }
+        const packages = parsed.packages;
+        const allowBuilds = requireRecord(parsed.allowBuilds, 'allowBuilds');
+        const ok = Array.isArray(packages)
+            && packages.length === 1
+            && packages[0] === '.'
+            && allowBuilds.esbuild === true;
+        return Object.freeze({
+            id: 'workspace.installable',
+            ok,
+            detail: ok
+                ? 'Standalone pnpm workspace permits the required esbuild install script'
+                : 'pnpm-workspace.yaml must contain packages: [.] and allowBuilds.esbuild: true',
+        });
+    }
+    catch (error) {
+        return Object.freeze({
+            id: 'workspace.installable',
+            ok: false,
+            detail: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function assertPortableResolutionConfig(value, field) {
+    if (typeof value === 'string') {
+        const specifier = value.trim();
+        if (/^(?:workspace:|file:|link:|portal:|patch:|\.\.?[\\/]|~[\\/]|[a-z]:[\\/])/i.test(specifier) || isAbsolute(specifier)) {
+            throw new Error(`${field} contains a non-portable local dependency; use published npm packages, not workspace:, file:, link:, or filesystem paths`);
+        }
+    }
+    else if (value && typeof value === 'object') {
+        for (const [key, child] of Object.entries(value))
+            assertPortableResolutionConfig(child, `${field}.${key}`);
+    }
+}
+function validateRoutes(source) {
+    try {
+        const parsed = JSON.parse(source ?? '');
+        const paths = Array.isArray(parsed.routes) ? parsed.routes.map(({ path }) => path) : [];
+        const ok = parsed.pluginId === 'blog'
+            && REQUIRED_ROUTES.every((path) => paths.includes(path))
+            && Array.isArray(parsed.styles)
+            && parsed.styles.includes('@zlooks.cn/ui/antd.css');
+        return Object.freeze({
+            id: 'routes.complete',
+            ok,
+            detail: ok ? 'All seven Blog routes and the shared Ant Design stylesheet are declared' : 'hile-rsc.json must declare pluginId blog, all seven routes, and @zlooks.cn/ui/antd.css',
+        });
+    }
+    catch {
+        return Object.freeze({ id: 'routes.complete', ok: false, detail: 'hile-rsc.json is invalid or missing' });
+    }
+}
+function markerCheck(id, source, markers) {
+    const missing = markers.filter((marker) => !source.includes(marker));
+    return Object.freeze({
+        id,
+        ok: missing.length === 0,
+        detail: missing.length === 0 ? `${id} is complete` : `Missing: ${missing.join(', ')}`,
+    });
+}
+async function assertDestinationAbsent(destination) {
+    try {
+        await stat(destination);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    throw new Error(`Destination is not empty or already exists: ${destination}`);
+}
+async function copyTemplate(sourceUrl, destination, replacements) {
+    const entries = await readdir(sourceUrl, { withFileTypes: true });
+    for (const entry of entries) {
+        const source = new URL(entry.name, sourceUrl);
+        const scaffoldName = entry.name.endsWith('.template') ? entry.name.slice(0, -'.template'.length) : entry.name;
+        const name = scaffoldName === '_gitignore' ? '.gitignore' : scaffoldName;
+        const target = join(destination, name);
+        if (entry.isDirectory()) {
+            await mkdir(target);
+            await copyTemplate(new URL(`${entry.name}/`, sourceUrl), target, replacements);
+            continue;
+        }
+        if (!entry.isFile())
+            throw new Error(`Unsupported scaffold entry: ${entry.name}`);
+        const content = (await readFile(source, 'utf8')).replace(/__[A-Z_]+__/g, (placeholder) => replacements[placeholder] ?? placeholder);
+        await writeFile(target, content, { encoding: 'utf8', flag: 'wx' });
+    }
+}
+async function themeSdkVersions() {
+    const packages = {
+        '__BLOG_SCHEMA_VERSION__': '@zlooks.cn/blog-schema',
+        '__BLOG_THEME_VERSION__': '@zlooks.cn/blog-theme',
+        '__GLOBAL_CONFIG_VERSION__': '@zlooks.cn/global-config-shared',
+        '__SERVICE_COMMAND_VERSION__': '@zlooks.cn/service-command',
+        '__UI_VERSION__': '@zlooks.cn/ui',
+    };
+    const versions = await Promise.all(Object.entries(packages).map(async ([placeholder, name]) => {
+        // Resolve metadata without evaluating React, Hile services, or SDK runtime code.
+        let directory = dirname(fileURLToPath(import.meta.resolve(name)));
+        for (let depth = 0; depth < 8; depth += 1) {
+            let manifest = {};
+            try {
+                manifest = JSON.parse(await readFile(join(directory, 'package.json'), 'utf8'));
+            }
+            catch (error) {
+                if (!isNodeError(error) || error.code !== 'ENOENT')
+                    throw error;
+            }
+            if (manifest.name === name && manifest.version && validSemver(manifest.version))
+                return [placeholder, manifest.version];
+            const parent = dirname(directory);
+            if (parent === directory)
+                break;
+            directory = parent;
+        }
+        throw new Error(`Cannot resolve the installed theme SDK version: ${name}. Reinstall the matching Zlooks CLI release.`);
+    }));
+    return Object.fromEntries(versions);
+}
+function parseThemeId(value) {
+    const parsed = value.trim();
+    if (!THEME_ID_PATTERN.test(parsed) || parsed.length > 50) {
+        throw new Error('themeId must be lowercase kebab-case, start with a letter, and contain at most 50 characters');
+    }
+    return parsed;
+}
+function parseRequiredText(value, field, maxLength) {
+    const parsed = value.trim();
+    if (parsed.length === 0 || parsed.length > maxLength) {
+        throw new Error(`${field} must contain 1-${maxLength} characters`);
+    }
+    return parsed;
+}
+function boundedOutput(value) {
+    const normalized = value.trim();
+    return normalized.length <= 2_000 ? normalized : `${normalized.slice(0, 500)}\n… output truncated …\n${normalized.slice(-1_450)}`;
+}
+function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+function requireRecord(value, field) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${field} must be an object`);
+    }
+    return value;
+}
+//# sourceMappingURL=theme-authoring.js.map