@playcraft/build 0.0.44 → 0.0.46

package/dist/base-builder.d.ts

@@ -30,6 +30,8 @@ export declare class BaseBuilder {
      * 根据构建工具路由到对应适配器
      */
     build(): Promise<BaseBuildOutput>;
+    private runPrebuildValidation;
+    private isPhaserValidationTarget;
     /**
      * 解析引擎类型和构建工具
      * 优先级：

package/dist/base-builder.js

@@ -1,4 +1,5 @@
 import { EngineDetector, PlayCanvasAdapter, GenericAdapter, PlayableScriptsAdapter } from './engines/index.js';
+import { formatValidationSummary, hasBlockingValidationErrors, runPlayableValidation, saveValidationReport, } from './validation/index.js';
 /**
  * 基础构建器 - 路由到不同构建工具适配器
  *
@@ -33,6 +34,7 @@ export class BaseBuilder {
         // 1. 确定引擎类型和构建工具
         const { engine, buildTool } = await this.resolveDetection();
         console.log(`[BaseBuilder] 使用引擎: ${engine}, 构建工具: ${buildTool}`);
+        await this.runPrebuildValidation(engine, buildTool);
         // 2. 根据构建工具路由到对应适配器
         let result;
         switch (buildTool) {
@@ -57,6 +59,48 @@ export class BaseBuilder {
         this._metadata = result.metadata;
         return result;
     }
+    async runPrebuildValidation(engine, buildTool) {
+        const validationOptions = this.options.validation;
+        if (validationOptions?.enabled === false || validationOptions?.sourcePrechecked || !validationOptions?.channel) {
+            return;
+        }
+        if (!this.isPhaserValidationTarget(engine, buildTool)) {
+            return;
+        }
+        const requestedStages = validationOptions.stages;
+        if (requestedStages && !requestedStages.includes('prebuild-source')) {
+            return;
+        }
+        const stages = ['prebuild-source'];
+        const report = await runPlayableValidation({
+            projectRoot: this.projectDir,
+            channel: validationOptions.channel,
+            engine,
+            buildTool,
+            buildChain: buildTool === 'playable-scripts'
+                ? 'devkit'
+                : buildTool === 'playcanvas-native'
+                    ? 'playcanvas-native'
+                    : 'generic',
+            sourceGlobs: validationOptions.sourceGlobs,
+        }, stages);
+        const summary = formatValidationSummary(report);
+        if (report.summary.status === 'pass') {
+            console.log(summary);
+        }
+        else {
+            console.warn(summary);
+        }
+        if (validationOptions.reportPath) {
+            await saveValidationReport(report, validationOptions.reportPath);
+        }
+        if (validationOptions.failOnError && hasBlockingValidationErrors(report)) {
+            throw new Error(`Prebuild validation failed for ${validationOptions.channel}`);
+        }
+    }
+    isPhaserValidationTarget(engine, buildTool) {
+        return engine === 'phaser' || buildTool === 'playable-scripts';
+    }
     /**
      * 解析引擎类型和构建工具
      * 优先级：

package/dist/engines/playable-scripts-adapter.d.ts

@@ -148,13 +148,18 @@ export declare class PlayableScriptsAdapter {
     private copyToOutputDir;
     /**
      * 是否对 playable-scripts 使用 --zip。
-     * Google/Facebook 等双格式渠道默认 HTML，与 CLI、Portal、GoogleAdapter 一致；仅 ZIP 的渠道仍强制 ZIP。
+     * 双格式渠道默认 HTML；仅在请求或配置显式选择 ZIP 时传递 --zip。
      */
     private isZipOutput;
     /**
      * 获取平台默认的文件名格式
      */
     private getPlatformFilename;
+    private runDevkitOutputValidation;
+    private getValidationChannels;
+    private isSupportedValidationChannel;
+    private pickArtifactForChannel;
+    private reportPathForChannel;
     private saveBuildMetadata;
     /**
      * 执行命令并设置超时

package/dist/engines/playable-scripts-adapter.js

@@ -3,6 +3,7 @@ import path from 'path';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { formatValidationSummary, hasBlockingValidationErrors, runPlayableValidation, saveValidationReport, } from '../validation/index.js';
 // ESM 兼容：获取当前模块的目录路径
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -92,6 +93,7 @@ export class PlayableScriptsAdapter {
         const outputs = await this.collectOutputs();
         // 7. 复制产物到 PlayCraft outputDir
         const files = await this.copyToOutputDir(outputs);
+        await this.runDevkitOutputValidation(files);
         // 7. 构建元数据
         const metadata = {
             mode: 'classic',
@@ -258,7 +260,7 @@ export class PlayableScriptsAdapter {
         // 输出目录 - 统一使用 dist，与 PlayCraft 标准一致
         const outputDir = config.outputDir ?? 'dist';
         args.push('--out-dir', outputDir);
-        // ZIP 输出：仅 ZIP-only 渠道、显式 config.zip、或构建请求 format=zip（如 Google / Facebook 选 ZIP）
+        // ZIP 输出：显式 config.zip 或构建请求 format=zip（如 Google / Facebook / TikTok 等选 ZIP）
         const isZipFormat = this.isZipOutput();
         if (isZipFormat) {
             args.push('--zip');
@@ -1201,25 +1203,13 @@ export class PlayableScriptsAdapter {
     }
     /**
      * 是否对 playable-scripts 使用 --zip。
-     * Google/Facebook 等双格式渠道默认 HTML，与 CLI、Portal、GoogleAdapter 一致；仅 ZIP 的渠道仍强制 ZIP。
+     * 双格式渠道默认 HTML；仅在请求或配置显式选择 ZIP 时传递 --zip。
      */
     isZipOutput() {
         const config = this.config ?? {};
-        const channels = config.channels ?? ['google'];
         if (config.zip === true) {
             return true;
         }
-        const zipOnlyPlatforms = new Set([
-            'tiktok',
-            'snapchat',
-            'liftoff',
-            'bigo',
-            'inmobi',
-            'mintegral',
-        ]);
-        if (channels.some((ch) => zipOnlyPlatforms.has(ch))) {
-            return true;
-        }
         const fmt = this.options.format;
         return fmt === 'zip';
     }
@@ -1248,6 +1238,94 @@ export class PlayableScriptsAdapter {
         return platformFileNames[channel] || 'index';
     }
     // ==================== 9. 保存元数据 ====================
+    async runDevkitOutputValidation(files) {
+        const validationOptions = this.options.validation;
+        if (validationOptions?.enabled === false) {
+            return;
+        }
+        const channels = this.getValidationChannels();
+        const artifacts = files.assets.filter((file) => file.endsWith('.html') || file.endsWith('.zip'));
+        if (channels.length === 0 || artifacts.length === 0) {
+            return;
+        }
+        const requestedStages = validationOptions?.stages;
+        for (const channel of channels) {
+            const artifact = this.pickArtifactForChannel(channel, artifacts);
+            if (!artifact) {
+                continue;
+            }
+            const isZip = artifact.toLowerCase().endsWith('.zip');
+            const stages = requestedStages ?? (isZip ? ['delivery-package'] : ['html-artifact']);
+            const report = await runPlayableValidation({
+                projectRoot: this.projectDir,
+                channel,
+                engine: 'phaser',
+                buildTool: 'playable-scripts',
+                buildChain: 'devkit',
+                htmlPath: isZip ? undefined : artifact,
+                packagePath: isZip ? artifact : undefined,
+                outputDir: this.options.outputDir,
+                sourceGlobs: validationOptions?.sourceGlobs,
+            }, stages);
+            const summary = formatValidationSummary(report);
+            if (report.summary.status === 'pass') {
+                console.log(summary);
+            }
+            else {
+                console.warn(summary);
+            }
+            if (validationOptions?.reportPath) {
+                await saveValidationReport(report, this.reportPathForChannel(validationOptions.reportPath, channel, channels.length));
+            }
+            if (validationOptions?.failOnError && hasBlockingValidationErrors(report)) {
+                throw new Error(`Playable validation failed for ${channel}`);
+            }
+        }
+    }
+    getValidationChannels() {
+        if (this.options.validation?.channel) {
+            return [this.options.validation.channel];
+        }
+        const channels = this.config?.channels ?? [];
+        return channels.filter((channel) => this.isSupportedValidationChannel(channel));
+    }
+    isSupportedValidationChannel(channel) {
+        const supported = [
+            'playcraft',
+            'facebook',
+            'snapchat',
+            'ironsource',
+            'applovin',
+            'google',
+            'tiktok',
+            'unity',
+            'liftoff',
+            'moloco',
+            'bigo',
+            'inmobi',
+            'adikteev',
+            'remerge',
+            'mintegral',
+        ];
+        return supported.includes(channel);
+    }
+    pickArtifactForChannel(channel, artifacts) {
+        if (artifacts.length === 1) {
+            return artifacts[0];
+        }
+        const direct = artifacts.find((artifact) => {
+            const normalized = artifact.replace(/\\/g, '/').toLowerCase();
+            return normalized.includes(`/${channel}/`) || normalized.includes(`-${channel}.`);
+        });
+        return direct ?? artifacts[0];
+    }
+    reportPathForChannel(reportPath, channel, channelCount) {
+        if (channelCount <= 1) {
+            return reportPath;
+        }
+        const parsed = path.parse(reportPath);
+        return path.join(parsed.dir, `${parsed.name}.${channel}${parsed.ext || '.json'}`);
+    }
     async saveBuildMetadata(metadata) {
         // 不再保存 .build-metadata.json 文件，元数据通过返回值传递
         console.log(`[PlayableScriptsAdapter] 构建完成（buildTool: playable-scripts, skipChannelBuild: true）`);

package/dist/index.d.ts

@@ -25,4 +25,5 @@ export { PLATFORM_CONFIGS } from './vite/platform-configs.js';
 export type { PlatformViteConfig } from './vite/platform-configs.js';
 export { AudioOptimizer } from './audio-optimizer.js';
 export type { AudioAssetInfo, AudioOptimizationReport, AudioOptimizerOptions } from './audio-optimizer.js';
+export * from './validation/index.js';
 export * from './types.js';

package/dist/index.js

@@ -23,4 +23,5 @@ export { PLATFORM_CONFIGS } from './vite/platform-configs.js';
 // 导出音频优化器
 export { AudioOptimizer } from './audio-optimizer.js';
 // 导出类型
+export * from './validation/index.js';
 export * from './types.js';

package/dist/platforms/bigo.js

@@ -8,7 +8,7 @@ export class BigoAdapter extends PlatformAdapter {
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // BIGO Ads 需要 BIGO JS-SDK
@@ -36,7 +36,7 @@ export class BigoAdapter extends PlatformAdapter {
     `;
         const sdkScript = `<script src="https://static-web.likeevideo.com/oss/material-ad/playable-ad-demo/bgy-mraid-sdk.js"></script>`;
         const fallbackScript = await this.minifyPlatformScript(bigoScriptCode, 'bigo-sdk');
-        const comment = `<!-- BIGO: ZIP格式, config.json含orientation, 使用BGY_MRAID.open() -->`;
+        const comment = `<!-- BIGO: HTML/ZIP format, config.json includes orientation when present, use BGY_MRAID.open() -->`;
         // 在 </head> 之前插入
         html = html.replace('</head>', `${sdkScript}${fallbackScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
@@ -71,8 +71,6 @@ export class BigoAdapter extends PlatformAdapter {
         };
     }
     validateOptions() {
-        if (this.options.format && this.options.format !== 'zip') {
-            console.warn('警告: BIGO Ads 要求 ZIP 格式');
-        }
+        // BIGO Ads supports both HTML and ZIP output in PlayCraft.
     }
 }

package/dist/platforms/inmobi.js

@@ -8,7 +8,7 @@ export class InMobiAdapter extends PlatformAdapter {
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // InMobi 需要 MRAID 支持
@@ -36,7 +36,7 @@ export class InMobiAdapter extends PlatformAdapter {
       };
     `;
         const inmobiScript = await this.minifyPlatformScript(inmobiScriptCode, 'inmobi-mraid');
-        const comment = `<!-- InMobi: ZIP格式, 使用mraid.open() -->`;
+        const comment = `<!-- InMobi: HTML/ZIP format, use mraid.open() -->`;
         // 在 </head> 之前插入平台特定的 API
         html = html.replace('</head>', `${inmobiScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
@@ -57,8 +57,6 @@ export class InMobiAdapter extends PlatformAdapter {
     `;
     }
     validateOptions() {
-        if (this.options.format && this.options.format !== 'zip') {
-            console.warn('警告: InMobi 要求 ZIP 格式');
-        }
+        // InMobi supports both HTML and ZIP output in PlayCraft.
     }
 }

package/dist/platforms/liftoff.js

@@ -8,7 +8,7 @@ export class LiftoffAdapter extends PlatformAdapter {
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // Liftoff 支持 MRAID 或 window.open
@@ -31,7 +31,7 @@ export class LiftoffAdapter extends PlatformAdapter {
       };
     `;
         const liftoffScript = await this.minifyPlatformScript(liftoffScriptCode, 'liftoff-mraid');
-        const comment = `<!-- Liftoff: ZIP格式, ASCII文件名, 使用mraid.open()或window.open() -->`;
+        const comment = `<!-- Liftoff: HTML/ZIP format, ASCII filenames recommended, use mraid.open() or window.open() -->`;
         // 在 </head> 之前插入
         html = html.replace('</head>', `${liftoffScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
@@ -47,8 +47,6 @@ export class LiftoffAdapter extends PlatformAdapter {
     `;
     }
     validateOptions() {
-        if (this.options.format && this.options.format !== 'zip') {
-            console.warn('警告: Liftoff 要求 ZIP 格式');
-        }
+        // Liftoff supports both HTML and ZIP output in PlayCraft.
     }
 }

package/dist/platforms/mintegral.js

@@ -4,11 +4,11 @@ export class MintegralAdapter extends PlatformAdapter {
         return 'Mintegral';
     }
     getSizeLimit() {
-        // Mintegral: 5MB (ZIP)
+        // Mintegral: 5MB
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // Mintegral 要求 charset 为 utf-8，确保存在
@@ -33,7 +33,7 @@ export class MintegralAdapter extends PlatformAdapter {
       window.HttpAPI = window.HttpAPI || { sendPoint: function() {} };
     `;
         const mintegralScript = await this.minifyPlatformScript(mintegralScriptCode, 'mintegral-sdk');
-        const comment = `<!-- Mintegral: ZIP格式, 5MB限制, 使用window.install()跳转, 支持横竖屏 -->`;
+        const comment = `<!-- Mintegral: HTML/ZIP format, 5MB limit, use window.install(), supports both orientations -->`;
         // 在 </head> 之前插入 polyfill 和注释，如果没有 </head> 则在文件开头插入
         if (html.includes('</head>')) {
             html = html.replace('</head>', `${mintegralScript}${comment}\n</head>`);
@@ -59,8 +59,6 @@ export class MintegralAdapter extends PlatformAdapter {
     `;
     }
     validateOptions() {
-        if (this.options.format && this.options.format !== 'zip') {
-            console.warn('警告: Mintegral 要求 ZIP 格式，将自动使用 ZIP');
-        }
+        // Mintegral supports both HTML and ZIP output in PlayCraft.
     }
 }

package/dist/platforms/snapchat.js

@@ -8,7 +8,7 @@ export class SnapchatAdapter extends PlatformAdapter {
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // Snapchat 需要 MRAID 2.0 和 snapchatCta 函数

package/dist/platforms/tiktok.js

@@ -8,7 +8,7 @@ export class TikTokAdapter extends PlatformAdapter {
         return 5 * 1024 * 1024;
     }
     getDefaultFormat() {
-        return 'zip';
+        return 'html';
     }
     async modifyHTML(html, assets) {
         // TikTok/Pangle 需要 Pangle JS-SDK
@@ -35,7 +35,7 @@ export class TikTokAdapter extends PlatformAdapter {
       };
     `;
         const pangleScript = await this.minifyPlatformScript(pangleScriptCode, 'pangle-sdk');
-        const comment = `<!-- TikTok/Pangle: ZIP格式, config.json含playable_orientation, 禁止mraid.js -->`;
+        const comment = `<!-- TikTok/Pangle: HTML/ZIP format, config.json includes playable_orientation when present, no mraid.js -->`;
         // 在 </head> 之前插入
         html = html.replace('</head>', `${pangleScript}${comment}</head>`);
         // 注入统一的 CTA 适配器
@@ -63,8 +63,6 @@ export class TikTokAdapter extends PlatformAdapter {
         };
     }
     validateOptions() {
-        if (this.options.format && this.options.format !== 'zip') {
-            console.warn('警告: TikTok/Pangle 要求 ZIP 格式');
-        }
+        // TikTok/Pangle supports both HTML and ZIP output in PlayCraft.
     }
 }

package/dist/types.d.ts

@@ -7,6 +7,16 @@ export interface StoreUrls {
     ios?: string;
     android?: string;
 }
+export interface ComplianceValidationOptions {
+    enabled?: boolean;
+    failOnError?: boolean;
+    channel?: Platform;
+    reportPath?: string;
+    sourcePrechecked?: boolean;
+    stages?: Array<'prebuild-source' | 'base-output' | 'html-artifact' | 'delivery-package' | 'runtime-manual' | 'external-validator'>;
+    sourceGlobs?: string[];
+    sourceDebug?: unknown;
+}
 export type BuildMode = 'classic' | 'esm';
 export type ESMMode = 'auto' | 'enabled' | 'disabled';
 export interface BuildOptions {
@@ -48,6 +58,7 @@ export interface BuildOptions {
     preserveESM?: boolean;
     forceIIFE?: boolean;
     storeUrls?: StoreUrls;
+    validation?: ComplianceValidationOptions;
     tracking?: {
         enabled?: boolean;
         adNetwork?: string;
@@ -208,6 +219,7 @@ export interface BaseBuildOptions {
     engine?: EngineType;
     /** 渠道产物格式（playable-scripts 阶段；与 Vite 阶段 format 对齐） */
     format?: OutputFormat;
+    validation?: ComplianceValidationOptions;
 }
 /**
  * 基础构建输出
@@ -268,4 +280,5 @@ export interface BuildOptions {
     forceIIFE?: boolean;
     engine?: EngineType;
     storeUrls?: StoreUrls;
+    validation?: ComplianceValidationOptions;
 }

package/dist/validation/html-validator.d.ts

@@ -0,0 +1,2 @@
+import type { ChannelRuleProfile, ValidationContext, ValidationResult } from './types.js';
+export declare function validateHtmlArtifact(context: ValidationContext, profile?: ChannelRuleProfile): Promise<ValidationResult[]>;

package/dist/validation/html-validator.js

@@ -0,0 +1,140 @@
+import fs from 'fs/promises';
+import { getRulesForStage } from './profiles.js';
+const RESOURCE_ATTR_RE = /\b(?:src|href|data)\s*=\s*["']([^"']+)["']/gi;
+const CSS_URL_RE = /url\(\s*["']?([^"')]+)["']?\s*\)/gi;
+export async function validateHtmlArtifact(context, profile) {
+    const rules = profile?.rules.filter((rule) => rule.stage === 'html-artifact')
+        ?? getRulesForStage(context.channel, 'html-artifact');
+    if (!context.htmlPath) {
+        return [missingHtmlResult(context.channel)];
+    }
+    let artifact;
+    try {
+        const [content, stat] = await Promise.all([
+            fs.readFile(context.htmlPath, 'utf-8'),
+            fs.stat(context.htmlPath),
+        ]);
+        artifact = {
+            path: context.htmlPath,
+            content,
+            size: stat.size,
+        };
+    }
+    catch (error) {
+        return [missingHtmlResult(context.channel, context.htmlPath, error)];
+    }
+    const results = [];
+    for (const rule of rules) {
+        if (!rule.detectable || !rule.check) {
+            continue;
+        }
+        results.push(evaluateHtmlRule(rule, artifact));
+    }
+    return results;
+}
+function missingHtmlResult(channel, htmlPath, error) {
+    return {
+        ruleId: `${channel}.html.entry.exists`,
+        channel,
+        stage: 'html-artifact',
+        severity: 'error',
+        status: 'fail',
+        message: htmlPath
+            ? `HTML artifact is not readable: ${htmlPath}`
+            : 'HTML artifact path is missing.',
+        recommendation: 'Pass the final channel HTML artifact path to the validation context.',
+        file: htmlPath,
+        evidence: error instanceof Error ? error.message : undefined,
+        owner: 'playcraft-build',
+        confidence: 'high',
+    };
+}
+function evaluateHtmlRule(rule, artifact) {
+    const check = rule.check;
+    switch (check.kind) {
+        case 'max-size':
+            return resultFromBoolean(rule, artifact.size <= check.maxBytes, artifact.path, `actual=${formatBytes(artifact.size)}, limit=${formatBytes(check.maxBytes)}`);
+        case 'external-resources': {
+            const externalResources = collectExternalResources(artifact.content)
+                .filter((url) => !isAllowedExternalResource(url, check.allowedPatterns));
+            return resultFromBoolean(rule, externalResources.length === 0, artifact.path, externalResources.slice(0, 20).join(', '));
+        }
+        case 'required-pattern': {
+            const regex = new RegExp(check.pattern, check.flags);
+            return resultFromBoolean(rule, regex.test(artifact.content), artifact.path, check.evidence ?? check.pattern);
+        }
+        case 'forbidden-pattern': {
+            const regex = new RegExp(check.pattern, check.flags);
+            const match = artifact.content.match(regex);
+            return resultFromBoolean(rule, !match, artifact.path, match?.[0] ?? check.evidence ?? check.pattern);
+        }
+        case 'single-html':
+            return resultFromBoolean(rule, collectLocalResourceReferences(artifact.content).length === 0, artifact.path, collectLocalResourceReferences(artifact.content).slice(0, 20).join(', '));
+    }
+}
+function resultFromBoolean(rule, passed, file, evidence) {
+    return {
+        ruleId: rule.id,
+        channel: rule.channel,
+        stage: rule.stage,
+        severity: rule.severity,
+        status: passed ? 'pass' : (rule.severity === 'error' ? 'fail' : 'warning'),
+        message: passed ? `${rule.title}: passed` : rule.title,
+        recommendation: rule.recommendation,
+        file,
+        evidence: evidence || undefined,
+        owner: rule.owner,
+        confidence: rule.confidence,
+    };
+}
+function collectExternalResources(html) {
+    return collectUrls(html).filter((url) => /^https?:\/\//i.test(url) || /^\/\//.test(url));
+}
+function collectLocalResourceReferences(html) {
+    return collectUrls(html).filter((url) => {
+        if (isInlineOrSpecialUrl(url))
+            return false;
+        if (/^https?:\/\//i.test(url) || /^\/\//.test(url))
+            return false;
+        return !url.startsWith('#');
+    });
+}
+function collectUrls(html) {
+    const urls = new Set();
+    for (const match of html.matchAll(RESOURCE_ATTR_RE)) {
+        if (match[1])
+            urls.add(match[1].trim());
+    }
+    for (const match of html.matchAll(CSS_URL_RE)) {
+        if (match[1])
+            urls.add(match[1].trim());
+    }
+    return Array.from(urls);
+}
+function isInlineOrSpecialUrl(url) {
+    return /^(data:|blob:|javascript:|mailto:|tel:|about:)/i.test(url);
+}
+function isAllowedExternalResource(url, allowedPatterns) {
+    if (!allowedPatterns || allowedPatterns.length === 0) {
+        return false;
+    }
+    return allowedPatterns.some((pattern) => {
+        if (url.includes(pattern))
+            return true;
+        try {
+            return new RegExp(pattern, 'i').test(url);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function formatBytes(bytes) {
+    if (!Number.isFinite(bytes))
+        return String(bytes);
+    const mb = bytes / 1024 / 1024;
+    if (mb >= 1)
+        return `${mb.toFixed(2)} MB`;
+    const kb = bytes / 1024;
+    return `${kb.toFixed(1)} KB`;
+}

package/dist/validation/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './profiles.js';
+export * from './html-validator.js';
+export * from './package-validator.js';
+export * from './reporter.js';
+export * from './source-scanner.js';
+export * from './validation-runner.js';
+export * from './zip-reader.js';

package/dist/validation/index.js

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './profiles.js';
+export * from './html-validator.js';
+export * from './package-validator.js';
+export * from './reporter.js';
+export * from './source-scanner.js';
+export * from './validation-runner.js';
+export * from './zip-reader.js';

package/dist/validation/package-validator.d.ts

@@ -0,0 +1,2 @@
+import type { ChannelRuleProfile, ValidationContext, ValidationResult } from './types.js';
+export declare function validateDeliveryPackage(context: ValidationContext, profile?: ChannelRuleProfile): Promise<ValidationResult[]>;