@svp-labs/talos 0.0.0 → 0.1.0

package/dist/langs/php/install.js

@@ -0,0 +1,52 @@
+import { join } from 'node:path';
+import { componentDir, fileExists, inRepo } from './paths.js';
+import { requireNewestPhp } from './runtime.js';
+import { EngineError } from '../../core/check.js';
+import { ExecError } from '../../exec/exec.js';
+const HOUR = 60 * 60 * 1000;
+const COMPOSER_INSTALL = [
+    'install',
+    '--no-interaction',
+    '--no-progress',
+    '--prefer-dist',
+    '--no-ansi',
+];
+/**
+ * Composer runs plugins and scripts as root only when this is set. The gate runs the project's
+ * code anyway (its tests), and Pest and Infection need their plugins, so a root container gets
+ * what an ordinary runner gets.
+ */
+const ENV = {
+    COMPOSER_ALLOW_SUPERUSER: '1',
+    COMPOSER_NO_INTERACTION: '1',
+    NO_COLOR: '1',
+};
+function detail(result) {
+    return `${result.stderr}\n${result.stdout}`.trim().split('\n').slice(-15).join('\n');
+}
+/**
+ * Installs a component's dependencies into `vendor/` with Composer, only ever from composer.lock,
+ * dev dependencies included, since the checks run the dev tools; never on a PHP that isn't the
+ * newest release of its cycle.
+ */
+export async function install(ctx) {
+    const dir = componentDir(ctx);
+    const where = inRepo(ctx.component.root, '.');
+    if (!(await fileExists(join(dir, 'composer.lock')))) {
+        throw new EngineError(`${where} has no composer.lock: Talos installs PHP dependencies only from a lockfile`);
+    }
+    await requireNewestPhp(ctx.exec, dir);
+    let result;
+    try {
+        result = await ctx.exec('composer', COMPOSER_INSTALL, { cwd: dir, env: ENV, timeoutMs: HOUR });
+    }
+    catch (error) {
+        if (!(error instanceof ExecError))
+            throw error;
+        throw new EngineError(`composer is needed to install ${where}: ${error.message}`);
+    }
+    if (result.code !== 0) {
+        throw new EngineError(`composer install failed in ${where}:\n${detail(result)}`);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/langs/php/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/langs/php/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,SAAS,EAAmB,MAAM,oBAAoB,CAAC;AAEhE,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE5B,MAAM,gBAAgB,GAAG;IACvB,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,eAAe;IACf,WAAW;CACZ,CAAC;AAEF;;;;GAIG;AACH,MAAM,GAAG,GAAqC;IAC5C,wBAAwB,EAAE,GAAG;IAC7B,uBAAuB,EAAE,GAAG;IAC5B,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,SAAS,MAAM,CAAC,MAAkB;IAChC,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAmB;IAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,WAAW,CACnB,GAAG,KAAK,6EAA6E,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC;YAAE,MAAM,KAAK,CAAC;QAC/C,MAAM,IAAI,WAAW,CAAC,iCAAiC,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,WAAW,CAAC,8BAA8B,KAAK,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/langs/php/neon.js

@@ -0,0 +1,41 @@
+const INDENT = '    ';
+/** NEON reads JSON's double-quoted strings, escapes included, so every string is quoted. */
+function scalar(value) {
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    return value === null ? 'null' : String(value);
+}
+function key(name) {
+    return /^[A-Za-z_][\w.-]*!?$/.test(name) ? name : JSON.stringify(name);
+}
+function isList(value) {
+    return Array.isArray(value);
+}
+function isScalar(value) {
+    return value === null || typeof value !== 'object';
+}
+/** The value written on its key's own line, or undefined when it needs a block of its own. */
+function inline(value) {
+    if (isScalar(value))
+        return scalar(value);
+    if (isList(value))
+        return value.length === 0 ? '[]' : undefined;
+    return Object.keys(value).length === 0 ? '{}' : undefined;
+}
+function entry(head, value, depth) {
+    const short = inline(value);
+    if (short !== undefined)
+        return [`${head} ${short}`];
+    return isScalar(value) ? [] : [head, ...lines(value, depth + 1)];
+}
+function lines(value, depth) {
+    const pad = INDENT.repeat(depth);
+    if (isList(value))
+        return value.flatMap((item) => entry(`${pad}-`, item, depth));
+    return Object.entries(value).flatMap(([name, item]) => entry(`${pad}${key(name)}:`, item, depth));
+}
+/** A mapping written as block-style NEON, four spaces per level. */
+export function toNeon(value) {
+    return `${lines(value, 0).join('\n')}\n`;
+}
+//# sourceMappingURL=neon.js.map

package/dist/langs/php/neon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon.js","sourceRoot":"","sources":["../../../src/langs/php/neon.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,GAAG,MAAM,CAAC;AAEtB,4FAA4F;AAC5F,SAAS,MAAM,CAAC,KAAiB;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,MAAM,CAAC,KAAgB;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAgB;IAChC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,8FAA8F;AAC9F,SAAS,MAAM,CAAC,KAAgB;IAC9B,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,KAAgB,EAAE,KAAa;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,KAAK,CAAC,KAAyB,EAAE,KAAa;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AAC3C,CAAC"}

package/dist/langs/php/paths.js

@@ -0,0 +1,78 @@
+import { access } from 'node:fs/promises';
+import { isAbsolute, join, posix, relative, resolve } from 'node:path';
+import { EngineError } from '../../core/check.js';
+import { underRoot } from '../../repo/facts.js';
+/** The component a check runs for, which the engine sets for every component check. */
+export function component(ctx) {
+    const found = ctx.component;
+    if (found !== undefined)
+        return found;
+    throw new EngineError('a PHP check ran with no component');
+}
+/** The component's directory, absolute. */
+export function componentDir(place) {
+    return resolve(place.root, place.component.root);
+}
+/** A component's root as `talos.yml` may write it, normalised: no trailing slash, `.` for none. */
+function rootOf(root) {
+    const normal = posix.normalize(`${root}/`);
+    return normal === './' || normal === '/' ? '.' : normal.slice(0, -1);
+}
+/** A repository-relative path made relative to the component's root, or undefined outside it. */
+export function inComponent(root, path) {
+    const base = rootOf(root);
+    if (base === '.')
+        return path;
+    return path.startsWith(`${base}/`) ? path.slice(base.length + 1) : undefined;
+}
+/** A component-relative path made repository-relative. */
+export function inRepo(root, path) {
+    return posix.join(rootOf(root), path);
+}
+/** A path a tool printed (absolute, or relative to the component) made repository-relative. */
+export function fromTool(place, file) {
+    const repo = isAbsolute(file) ? relative(place.root, file) : file;
+    const posixPath = repo.replaceAll('\\', '/');
+    return isAbsolute(file) ? posixPath : inRepo(place.component.root, posixPath);
+}
+/** A component-relative path made absolute. */
+export function absolute(place, path) {
+    return join(componentDir(place), ...path.split('/'));
+}
+/** PHP that Talos checks: no Blade template (Blade is not PHP) and nothing Composer installed. */
+export function isCheckedPhp(path) {
+    return path.endsWith('.php') && !path.endsWith('.blade.php') && !path.startsWith('vendor/');
+}
+/** The component's tracked PHP sources, relative to its root. */
+export function phpFiles(ctx) {
+    const root = component(ctx).root;
+    return underRoot(ctx.facts.matching('**/*.php'), root)
+        .map((file) => inComponent(root, file))
+        .filter((file) => file !== undefined && isCheckedPhp(file));
+}
+const TEST_DIRS = new Set(['tests', 'test']);
+/** Test code as PHPUnit and Pest lay it out: a tests directory, or a file named `*Test.php`. */
+export function isTestPath(path) {
+    const parts = path.split('/');
+    if (parts.slice(0, -1).some((part) => TEST_DIRS.has(part)))
+        return true;
+    return (parts.at(-1) ?? '').endsWith('Test.php');
+}
+/** The component's shipped PHP, relative to its root: everything that isn't test code. */
+export function shippedFiles(ctx) {
+    return phpFiles(ctx).filter((file) => !isTestPath(file));
+}
+/** Whether the component tracks a file at this component-relative path. */
+export function tracks(ctx, path) {
+    return ctx.facts.files.includes(inRepo(component(ctx).root, path));
+}
+export async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/langs/php/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/langs/php/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAqC,WAAW,EAAW,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAShD,uFAAuF;AACvF,MAAM,UAAU,SAAS,CAAC,GAAuC;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,IAAI,WAAW,CAAC,mCAAmC,CAAC,CAAC;AAC7D,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,YAAY,CAAC,KAAwC;IACnE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,mGAAmG;AACnG,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IAC3C,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,IAAY;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,KAAwC,EAAE,IAAY;IAC7E,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAChF,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,QAAQ,CAAC,KAAwC,EAAE,IAAY;IAC7E,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC9F,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,QAAQ,CAAC,GAA8C;IACrE,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;SACnD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACtC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7C,gGAAgG;AAChG,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACnD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,GAA8C;IACzE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,MAAM,CAAC,GAA8C,EAAE,IAAY;IACjF,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/langs/php/pest.js

@@ -0,0 +1,91 @@
+import { mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { componentDir, fileExists, inComponent, phpFiles, shippedFiles } from './paths.js';
+import { bind, runVendorTool, tail } from './run.js';
+import { topLevel } from './scope.js';
+import { EngineError } from '../../core/check.js';
+/**
+ * Pest's JUnit names each test's `file` as `path::test name`; the protocol wants the path alone,
+ * as PHPUnit writes it.
+ */
+export function normalizeJunit(xml) {
+    return xml.replaceAll(/ file="([^"]*)"/g, (_match, file) => {
+        const [path = file] = file.split('::');
+        return ` file="${path}"`;
+    });
+}
+/** Whether a component-relative path is one of `full` (component-relative) or under it. */
+function under(path, full) {
+    return full.some((entry) => {
+        let end = entry.length;
+        while (end > 0 && entry[end - 1] === '/')
+            end -= 1;
+        const dir = entry.slice(0, end);
+        return path === dir || path.startsWith(`${dir}/`);
+    });
+}
+/**
+ * The test files a request names, relative to the component: the rerun's files, or for the
+ * per-commit suite every `*Test.php` outside `tests.full`. Undefined means the whole suite as
+ * phpunit.xml declares it; an empty list means nothing to run.
+ */
+export function testPaths(ctx, request) {
+    const root = ctx.component.root;
+    const local = (paths) => paths
+        .map((path) => inComponent(root, path))
+        .filter((path) => path !== undefined);
+    if (request.files !== undefined)
+        return local(request.files);
+    const full = local(ctx.config.tests.full);
+    if (request.suite === 'all' || full.length === 0)
+        return undefined;
+    return phpFiles(ctx).filter((file) => file.endsWith('Test.php') && !under(file, full));
+}
+/**
+ * Coverage of shipped code only: each top-level directory holding shipped PHP is a coverage
+ * filter, whatever phpunit.xml's `<source>` says (config-strength reports its exclusions).
+ */
+export function coverageArgs(ctx, clover) {
+    const { dirs } = topLevel(shippedFiles(ctx));
+    return ['--coverage-clover', clover, ...dirs.flatMap((dir) => ['--coverage-filter', dir])];
+}
+async function run(ctx, request) {
+    const bound = bind(ctx);
+    const paths = testPaths(bound, request);
+    if (paths?.length === 0)
+        return { exitCode: 0, output: '', junit: [] };
+    const dir = await mkdtemp(join(ctx.scratch, 'pest-'));
+    const junit = join(dir, 'junit.xml');
+    const clover = join(dir, 'clover.xml');
+    const base = componentDir(bound);
+    const args = ['--colors=never', '--do-not-cache-result', '--log-junit', junit];
+    const result = await runVendorTool(bound, 'pest', [
+        ...args,
+        ...(request.coverage ? coverageArgs(bound, clover) : ['--no-coverage']),
+        ...(paths ?? []),
+    ], {
+        env: { XDEBUG_MODE: request.coverage ? 'coverage' : 'off' },
+        ini: request.coverage
+            ? { 'pcov.enabled': '1', 'pcov.directory': base }
+            : { 'pcov.enabled': '0' },
+    });
+    if (!(await fileExists(junit))) {
+        throw new EngineError(`pest wrote no JUnit report (exit ${result.code}):\n${tail(result)}`);
+    }
+    await writeFile(junit, normalizeJunit(await readFile(junit, 'utf8')));
+    const output = `${result.stdout}\n${result.stderr}`;
+    if (!request.coverage)
+        return { exitCode: result.code, output, junit: [{ path: junit, base }] };
+    if (!(await fileExists(clover))) {
+        throw new EngineError('pest wrote no coverage report: the PHP running it needs pcov or Xdebug');
+    }
+    return {
+        exitCode: result.code,
+        output,
+        junit: [{ path: junit, base }],
+        coverage: { path: clover, base, format: 'clover' },
+    };
+}
+/** Pest, which runs PHPUnit tests too, for the shared tests and coverage checks. */
+export const pestRunner = { run };
+//# sourceMappingURL=pest.js.map

package/dist/langs/php/pest.js.map

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

package/dist/langs/php/phpmd-config.js

@@ -0,0 +1,58 @@
+import { escapeXml } from '../../core/xml.js';
+export const PHPMD_BASE = 'phpmd.xml';
+export const PHPMD_PROJECT = 'phpmd.project.xml';
+/** Rules the base sets its own limits on, excluded from their rule set's blanket reference. */
+const LIMITS = [
+    { rule: 'CyclomaticComplexity', properties: { maximum: '12' } },
+    { rule: 'ExcessiveParameterList', properties: { maximum: '4' } },
+    { rule: 'ExcessiveMethodLength', properties: { maximum: '60', 'ignore-whitespace': 'true' } },
+    { rule: 'ExcessiveClassLength', properties: { maximum: '400', 'ignore-whitespace': 'true' } },
+];
+function limit(entry) {
+    const properties = Object.entries(entry.properties).map(([name, value]) => `            <property name="${name}" value="${value}"/>`);
+    return [
+        `    <rule ref="rulesets/codesize.xml/${entry.rule}">`,
+        '        <properties>',
+        ...properties,
+        '        </properties>',
+        '    </rule>',
+    ];
+}
+/**
+ * The PHPMD ruleset: cleancode, codesize, design, naming and unusedcode in full, codesize's
+ * limits set to the standard ones, then the project's extension. PHPMD 3's limits are maxima:
+ * it reports a value above `maximum`. `note` is the generated-file note, empty for the gate's copy.
+ */
+export function renderPhpmd(note, project) {
+    const head = note === '' ? [] : [`<!-- ${note} -->`];
+    return [
+        ...head,
+        '<ruleset name="Talos">',
+        '    <description>Five PHPMD rule sets in full, at the standard limits.</description>',
+        '    <!-- StaticAccess forbids every static call, enum cases and named constructors too. -->',
+        '    <rule ref="rulesets/cleancode.xml">',
+        '        <exclude name="StaticAccess"/>',
+        '    </rule>',
+        '    <rule ref="rulesets/codesize.xml">',
+        ...LIMITS.map((entry) => `        <exclude name="${entry.rule}"/>`),
+        '    </rule>',
+        ...LIMITS.flatMap((entry) => limit(entry)),
+        '    <rule ref="rulesets/design.xml"/>',
+        '    <rule ref="rulesets/naming.xml"/>',
+        '    <rule ref="rulesets/unusedcode.xml"/>',
+        ...(project === undefined ? [] : [`    <rule ref="${escapeXml(project)}"/>`]),
+        '</ruleset>',
+        '',
+    ].join('\n');
+}
+/** The extension `talos adopt` writes once: a ruleset of the project's own, empty to start. */
+export function initialPhpmdProject() {
+    return [
+        `<!-- This project's additions to ${PHPMD_BASE}, which may only tighten it. -->`,
+        '<ruleset name="Project">',
+        '    <description>Rules this project adds to the Talos base.</description>',
+        '</ruleset>',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=phpmd-config.js.map

package/dist/langs/php/phpmd-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phpmd-config.js","sourceRoot":"","sources":["../../../src/langs/php/phpmd-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAEjD,+FAA+F;AAC/F,MAAM,MAAM,GAA8E;IACxF,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAC/D,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;IAChE,EAAE,IAAI,EAAE,uBAAuB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE;IAC7F,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,EAAE,EAAE;CAC9F,CAAC;AAEF,SAAS,KAAK,CAAC,KAA8B;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CACrD,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,+BAA+B,IAAI,YAAY,KAAK,KAAK,CAC7E,CAAC;IACF,OAAO;QACL,wCAAwC,KAAK,CAAC,IAAI,IAAI;QACtD,sBAAsB;QACtB,GAAG,UAAU;QACb,uBAAuB;QACvB,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAA2B;IACnE,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC;IACrD,OAAO;QACL,GAAG,IAAI;QACP,wBAAwB;QACxB,sFAAsF;QACtF,6FAA6F;QAC7F,yCAAyC;QACzC,wCAAwC;QACxC,aAAa;QACb,wCAAwC;QACxC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,0BAA0B,KAAK,CAAC,IAAI,KAAK,CAAC;QACnE,aAAa;QACb,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,uCAAuC;QACvC,uCAAuC;QACvC,2CAA2C;QAC3C,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7E,YAAY;QACZ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,oCAAoC,UAAU,kCAAkC;QAChF,0BAA0B;QAC1B,2EAA2E;QAC3E,YAAY;QACZ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/langs/php/phpmd.js

@@ -0,0 +1,80 @@
+import { writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { absolute, fileExists, fromTool, isTestPath, phpFiles } from './paths.js';
+import { PHPMD_PROJECT, renderPhpmd } from './phpmd-config.js';
+import { failed, jsonFrom, runVendorTool, sentence } from './run.js';
+import { EngineError } from '../../core/check.js';
+const violation = z.object({
+    beginLine: z.number().int(),
+    endLine: z.number().int(),
+    description: z.string(),
+    rule: z.string(),
+});
+const report = z.object({
+    files: z.array(z.object({ file: z.string(), violations: z.array(violation) })).default([]),
+    errors: z.array(z.object({ fileName: z.string(), message: z.string() })).default([]),
+});
+/** The size limits test code is exempt from, as in every other language. */
+const SIZE_RULES = new Set([
+    'ExcessiveMethodLength',
+    'ExcessiveClassLength',
+    'NcssMethodCount',
+    'NcssTypeCount',
+    'NcssConstructorCount',
+]);
+/**
+ * PHPMD's JSON report as findings. A file PHPMD can't parse is a finding of its own, so a file
+ * in syntax its parser doesn't know yet is never left out of linting in silence. `toRepo` makes
+ * PHPMD's absolute paths repository-relative; test files keep no size findings.
+ */
+export function parsePhpmdJson(json, toRepo) {
+    const parsed = report.safeParse(json);
+    if (!parsed.success)
+        throw new EngineError('PHPMD printed JSON Talos cannot read');
+    const violations = parsed.data.files.flatMap(({ file, violations: found }) => {
+        const path = toRepo(file);
+        return found
+            .filter((v) => !(SIZE_RULES.has(v.rule) && isTestPath(path)))
+            .map((v) => ({
+            rule: `phpmd/${v.rule}`,
+            message: sentence(v.description),
+            location: { file: path, line: v.beginLine, endLine: Math.max(v.beginLine, v.endLine) },
+        }));
+    });
+    const errors = parsed.data.errors.map((e) => ({
+        rule: 'phpmd/parse-error',
+        message: sentence(`PHPMD could not read this file: ${e.message.replace(/ in file: .*$/, '')}`),
+        location: { file: toRepo(e.fileName), line: 1 },
+    }));
+    return dedupe([...violations, ...errors]);
+}
+/** The base and an extension can hold the same rule; one violation is one finding. */
+function dedupe(findings) {
+    const seen = new Set();
+    return findings.filter((f) => {
+        const id = JSON.stringify([f.rule, f.message, f.location]);
+        if (seen.has(id))
+            return false;
+        seen.add(id);
+        return true;
+    });
+}
+/**
+ * PHPMD over every checked file with the base ruleset as Talos renders it, which references the
+ * project's extension by absolute path when there is one.
+ */
+export async function phpmd(ctx) {
+    const files = phpFiles(ctx);
+    const project = absolute(ctx, PHPMD_PROJECT);
+    const ruleset = join(ctx.scratch, 'phpmd.xml');
+    await writeFile(ruleset, renderPhpmd('', (await fileExists(project)) ? project : undefined));
+    const list = join(ctx.scratch, 'phpmd-files.txt');
+    await writeFile(list, `${files.map((file) => absolute(ctx, file)).join('\n')}\n`);
+    const args = ['analyze', '--format=json', `--ruleset=${ruleset}`, `--input-file=${list}`];
+    const result = await runVendorTool(ctx, 'phpmd', [...args, '--no-progress', '--no-ansi']);
+    if (!result.stdout.trimStart().startsWith('{'))
+        throw failed('phpmd analyze', result);
+    return parsePhpmdJson(jsonFrom(result.stdout, 'phpmd'), (file) => fromTool(ctx, file));
+}
+//# sourceMappingURL=phpmd.js.map

package/dist/langs/php/phpmd.js.map

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

package/dist/langs/php/phpstan-config.js

@@ -0,0 +1,100 @@
+import { join } from 'node:path';
+import { toNeon } from './neon.js';
+import { componentDir, fileExists } from './paths.js';
+import { notInstalled } from './run.js';
+import { generatedHeader } from '../../configs/header.js';
+export const PHPSTAN_BASE = 'phpstan.neon';
+export const PHPSTAN_PROJECT = 'phpstan.project.neon';
+/** The extensions every PHP component's analysis includes, in this order. */
+const EXTENSIONS = [
+    { pkg: 'phpstan/phpstan-strict-rules', file: 'phpstan/phpstan-strict-rules/rules.neon' },
+    {
+        pkg: 'tomasvotruba/cognitive-complexity',
+        file: 'tomasvotruba/cognitive-complexity/config/extension.neon',
+    },
+    { pkg: 'shipmonk/dead-code-detector', file: 'shipmonk/dead-code-detector/rules.neon' },
+    { pkg: 'pestphp/pest-plugin-phpstan', file: 'pestphp/pest-plugin-phpstan/extension.neon' },
+];
+/** Laravel's rules, for a component that is a Laravel application. */
+const LARASTAN = {
+    pkg: 'larastan/larastan',
+    file: 'larastan/larastan/extension.neon',
+};
+export const TYPE_COVERAGE = {
+    pkg: 'tomasvotruba/type-coverage',
+    file: 'tomasvotruba/type-coverage/config/extension.neon',
+};
+/**
+ * Level max, every stricter-analysis switch PHPStan has turned the strict way, strict-rules in
+ * full, and the limits. Checked exceptions stay off: TypeScript, which sets the bar, has none.
+ */
+export const PHPSTAN_PARAMETERS = {
+    level: 'max',
+    checkBenevolentUnionTypes: true,
+    checkDynamicProperties: true,
+    checkExplicitMixedMissingReturn: true,
+    checkFunctionNameCase: true,
+    checkImplicitMixed: true,
+    checkInternalClassCaseSensitivity: true,
+    checkMissingCallableSignature: true,
+    checkMissingOverrideMethodAttribute: true,
+    checkStrictPrintfPlaceholderTypes: true,
+    checkTooWideParameterOutInProtectedAndPublicMethods: true,
+    checkTooWideReturnTypesInProtectedAndPublicMethods: true,
+    checkTooWideThrowTypesInProtectedAndPublicMethods: true,
+    checkUninitializedProperties: true,
+    inferPrivatePropertyTypeFromConstructor: false,
+    polluteScopeWithAlwaysIterableForeach: false,
+    polluteScopeWithBlock: false,
+    polluteScopeWithLoopInitialAssignments: false,
+    rememberPossiblyImpureFunctionValues: false,
+    reportAlwaysTrueInLastCondition: true,
+    reportAnyTypeWideningInVarTag: true,
+    reportIgnoresWithoutComments: true,
+    reportMaybesInMethodSignatures: true,
+    reportMaybesInPropertyPhpDocTypes: true,
+    reportNonIntStringArrayKey: true,
+    reportPossiblyNonexistentConstantArrayOffset: true,
+    reportPossiblyNonexistentGeneralArrayOffset: true,
+    reportStaticMethodSignatures: true,
+    reportUnmatchedIgnoredErrors: true,
+    reportWrongPhpDocTypeInVarTag: true,
+    treatPhpDocTypesAsCertain: true,
+    strictRules: { allRules: true },
+    cognitive_complexity: { function: 15 },
+    shipmonkDeadCode: { reportTransitivelyDeadMethodAsSeparateError: true },
+};
+/** The extensions a component's analysis includes: Larastan only in a Laravel application. */
+export function extensionsFor(laravel) {
+    return laravel ? [...EXTENSIONS, LARASTAN] : [...EXTENSIONS];
+}
+/** The committed base: vendor paths relative to it, and the project's extension last. */
+export function renderPhpstanBase(version, laravel) {
+    const includes = [
+        ...extensionsFor(laravel).map((extension) => `vendor/${extension.file}`),
+        PHPSTAN_PROJECT,
+    ];
+    return (generatedHeader('#', version, PHPSTAN_PROJECT) +
+        toNeon({ includes, parameters: PHPSTAN_PARAMETERS }));
+}
+/**
+ * The base as the gate runs it, from a scratch directory: absolute includes, each extension
+ * checked to be installed, and the project's file only when it exists.
+ */
+export async function gateIncludes(place, options) {
+    const dir = componentDir(place);
+    const extensions = [...extensionsFor(options.laravel), ...(options.extra ?? [])];
+    const includes = [];
+    for (const extension of extensions) {
+        const file = join(dir, 'vendor', ...extension.file.split('/'));
+        if (!(await fileExists(file)))
+            throw notInstalled(place, extension.pkg);
+        if (!options.installed.has(extension.pkg))
+            includes.push(file);
+    }
+    const project = join(dir, PHPSTAN_PROJECT);
+    if (options.project && (await fileExists(project)))
+        includes.push(project);
+    return includes;
+}
+//# sourceMappingURL=phpstan-config.js.map

package/dist/langs/php/phpstan-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phpstan-config.js","sourceRoot":"","sources":["../../../src/langs/php/phpstan-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAgB,MAAM,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAKtD,6EAA6E;AAC7E,MAAM,UAAU,GAAyB;IACvC,EAAE,GAAG,EAAE,8BAA8B,EAAE,IAAI,EAAE,yCAAyC,EAAE;IACxF;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,yDAAyD;KAChE;IACD,EAAE,GAAG,EAAE,6BAA6B,EAAE,IAAI,EAAE,wCAAwC,EAAE;IACtF,EAAE,GAAG,EAAE,6BAA6B,EAAE,IAAI,EAAE,4CAA4C,EAAE;CAC3F,CAAC;AAEF,sEAAsE;AACtE,MAAM,QAAQ,GAAc;IAC1B,GAAG,EAAE,mBAAmB;IACxB,IAAI,EAAE,kCAAkC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,GAAG,EAAE,4BAA4B;IACjC,IAAI,EAAE,kDAAkD;CACzD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,KAAK,EAAE,KAAK;IACZ,yBAAyB,EAAE,IAAI;IAC/B,sBAAsB,EAAE,IAAI;IAC5B,+BAA+B,EAAE,IAAI;IACrC,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,IAAI;IACxB,iCAAiC,EAAE,IAAI;IACvC,6BAA6B,EAAE,IAAI;IACnC,mCAAmC,EAAE,IAAI;IACzC,iCAAiC,EAAE,IAAI;IACvC,mDAAmD,EAAE,IAAI;IACzD,kDAAkD,EAAE,IAAI;IACxD,iDAAiD,EAAE,IAAI;IACvD,4BAA4B,EAAE,IAAI;IAClC,uCAAuC,EAAE,KAAK;IAC9C,qCAAqC,EAAE,KAAK;IAC5C,qBAAqB,EAAE,KAAK;IAC5B,sCAAsC,EAAE,KAAK;IAC7C,oCAAoC,EAAE,KAAK;IAC3C,+BAA+B,EAAE,IAAI;IACrC,6BAA6B,EAAE,IAAI;IACnC,4BAA4B,EAAE,IAAI;IAClC,8BAA8B,EAAE,IAAI;IACpC,iCAAiC,EAAE,IAAI;IACvC,0BAA0B,EAAE,IAAI;IAChC,4CAA4C,EAAE,IAAI;IAClD,2CAA2C,EAAE,IAAI;IACjD,4BAA4B,EAAE,IAAI;IAClC,4BAA4B,EAAE,IAAI;IAClC,6BAA6B,EAAE,IAAI;IACnC,yBAAyB,EAAE,IAAI;IAC/B,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC/B,oBAAoB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IACtC,gBAAgB,EAAE,EAAE,2CAA2C,EAAE,IAAI,EAAE;CACxE,CAAC;AAEF,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;AAC/D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,OAAgB;IACjE,MAAM,QAAQ,GAAG;QACf,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,SAAS,CAAC,IAAI,EAAE,CAAC;QACxE,eAAe;KAChB,CAAC;IACF,OAAO,CACL,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC;QAC9C,MAAM,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC,CACrD,CAAC;AACJ,CAAC;AAYD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwC,EACxC,OAAoB;IAEpB,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YAAE,MAAM,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACxE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,OAAO,QAAQ,CAAC;AAClB,CAAC"}