<?php
// +----------------------------------------------------------------------
// | YwxApp 框架文件清单
// | 以数组方式列出框架发行包包含的所有文件（与 package_framework.php 口径一致）
// | 用法：
// |   $files = require __DIR__ . '/framework_files.php';   // 返回相对路径数组
// |   print_r($files);
// +----------------------------------------------------------------------

/**
 * 框架发行的目录范围（与 scripts/package_framework.php 的 includeDirs 一致）。
 * 注意：addon/ 属于插件体系，不在框架包内。
 */
const FRAMEWORK_DIRS = ['app', 'config', 'extend', 'ywxapp', 'public', 'route'];

/**
 * 排除规则（相对路径，基于项目根）：
 *  - public/uploads       上传目录
 *  - public/static/<插件名>  插件静态资源（运行时发布，不入库）
 *  - config/database.php  数据库私密配置
 *  - config/ywxapp.php    框架配置（含版本号等，安装/升级时不应覆盖）
 */
const FRAMEWORK_EXCLUDES = [
    'public/uploads',
    'public/addons',
    'config/database.php',
    'config/ywxapp.php',
];

/**
 * 递归收集框架文件相对路径。
 * @return string[] 形如 ['app/backend/controller/Admin.php', 'config/app.php', ...]
 */
function frameworkFiles(): array
{
    $root = dirname(__DIR__); // scripts/ 的上一级 = 项目根
    $files = [];

    // 自动发现插件静态资源（addon/ 下每个子目录对应 public/static/<插件名>/），从清单中剔除
    $addonStatic = [];
    $addonRoot = $root . DIRECTORY_SEPARATOR . 'addon';
    if (is_dir($addonRoot)) {
        foreach (array_diff(scandir($addonRoot), ['.', '..']) as $entry) {
            if (is_dir($addonRoot . DIRECTORY_SEPARATOR . $entry)) {
                $addonStatic[] = 'public/static/' . $entry . '/';
            }
        }
    }

    $isExcluded = static function (string $rel) use ($root, $addonStatic): bool {
        // 顶层排除项
        if (in_array($rel, FRAMEWORK_EXCLUDES, true)) {
            return true;
        }
        // addon/ 下的任何内容都不属于框架包
        if (strpos($rel, 'addon/') === 0) {
            return true;
        }
        // 上传目录整体排除
        if (strpos($rel, 'public/uploads/') === 0) {
            return true;
        }
        // 插件静态资源（public/static/<插件名>/）整体排除
        foreach ($addonStatic as $staticPrefix) {
            if (strpos($rel, $staticPrefix) === 0) {
                return true;
            }
        }
        // 跳过 .git / 运行时目录（防御性）
        if (preg_match('#(^|/)(\.git|runtime|vendor)(/|$)#', $rel)) {
            return true;
        }
        return false;
    };

    $scan = static function (string $dir, string $prefix) use (&$scan, $root, &$files, $isExcluded): void {
        if (!is_dir($dir)) {
            return;
        }
        foreach (scandir($dir) as $name) {
            if ($name === '.' || $name === '..') {
                continue;
            }
            $rel = $prefix === '' ? $name : $prefix . '/' . $name;
            if ($isExcluded($rel)) {
                continue;
            }
            $abs = $root . DIRECTORY_SEPARATOR . $rel;
            if (is_dir($abs)) {
                $scan($abs, $rel);
            } elseif (is_file($abs)) {
                $files[] = $rel;
            }
        }
    };

    foreach (FRAMEWORK_DIRS as $d) {
        $scan($root . DIRECTORY_SEPARATOR . $d, $d);
    }

    sort($files);
    return $files;
}

// 作为数组返回：直接 require 本文件即可得到框架所有文件的相对路径数组
return frameworkFiles();