@aspruyt/xfg 3.7.6 → 3.8.0

package/dist/output/settings-report.js

@@ -0,0 +1,300 @@
+import { appendFileSync } from "node:fs";
+import chalk from "chalk";
+import { formatPropertyTree, } from "../settings/rulesets/formatter.js";
+// =============================================================================
+// Helpers
+// =============================================================================
+function formatValue(val) {
+    if (val === null)
+        return "null";
+    if (val === undefined)
+        return "undefined";
+    if (typeof val === "string")
+        return `"${val}"`;
+    if (typeof val === "boolean")
+        return val ? "true" : "false";
+    return String(val);
+}
+function formatRulesetConfig(config, indent) {
+    const lines = [];
+    function renderObject(obj, currentIndent) {
+        for (const [k, v] of Object.entries(obj)) {
+            renderValue(k, v, currentIndent);
+        }
+    }
+    function renderValue(key, value, currentIndent) {
+        const pad = "    ".repeat(currentIndent);
+        if (value === null || value === undefined)
+            return;
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                lines.push(chalk.green(`${pad}+ ${key}: []`));
+            }
+            else if (value.every((v) => typeof v !== "object")) {
+                lines.push(chalk.green(`${pad}+ ${key}: [${value.map((v) => (typeof v === "string" ? `"${v}"` : String(v))).join(", ")}]`));
+            }
+            else {
+                lines.push(chalk.green(`${pad}+ ${key}:`));
+                for (let i = 0; i < value.length; i++) {
+                    const item = value[i];
+                    if (typeof item === "object" && item !== null) {
+                        const obj = item;
+                        const typeLabel = "type" in obj ? ` (${obj.type})` : "";
+                        lines.push(chalk.green(`${pad}    + [${i}]${typeLabel}:`));
+                        renderObject(obj, currentIndent + 2);
+                    }
+                    else {
+                        lines.push(chalk.green(`${pad}    + ${formatValue(item)}`));
+                    }
+                }
+            }
+        }
+        else if (typeof value === "object") {
+            lines.push(chalk.green(`${pad}+ ${key}:`));
+            renderObject(value, currentIndent + 1);
+        }
+        else {
+            lines.push(chalk.green(`${pad}+ ${key}: ${formatValue(value)}`));
+        }
+    }
+    for (const [key, value] of Object.entries(config)) {
+        if (key === "name")
+            continue; // Name is in the header
+        renderValue(key, value, indent);
+    }
+    return lines;
+}
+function formatSummary(totals) {
+    const parts = [];
+    const settingsTotal = totals.settings.add + totals.settings.change;
+    const rulesetsTotal = totals.rulesets.create + totals.rulesets.update + totals.rulesets.delete;
+    if (settingsTotal > 0) {
+        const settingWord = settingsTotal === 1 ? "setting" : "settings";
+        const actions = [];
+        if (totals.settings.add > 0)
+            actions.push(`${totals.settings.add} to add`);
+        if (totals.settings.change > 0)
+            actions.push(`${totals.settings.change} to change`);
+        parts.push(`${settingsTotal} ${settingWord} (${actions.join(", ")})`);
+    }
+    if (rulesetsTotal > 0) {
+        const rulesetWord = rulesetsTotal === 1 ? "ruleset" : "rulesets";
+        const actions = [];
+        if (totals.rulesets.create > 0)
+            actions.push(`${totals.rulesets.create} to create`);
+        if (totals.rulesets.update > 0)
+            actions.push(`${totals.rulesets.update} to update`);
+        if (totals.rulesets.delete > 0)
+            actions.push(`${totals.rulesets.delete} to delete`);
+        parts.push(`${rulesetsTotal} ${rulesetWord} (${actions.join(", ")})`);
+    }
+    if (parts.length === 0) {
+        return "No changes";
+    }
+    return `Plan: ${parts.join(", ")}`;
+}
+// =============================================================================
+// CLI Formatter
+// =============================================================================
+export function formatSettingsReportCLI(report) {
+    const lines = [];
+    for (const repo of report.repos) {
+        if (repo.settings.length === 0 &&
+            repo.rulesets.length === 0 &&
+            !repo.error) {
+            continue;
+        }
+        // Repo header
+        lines.push(chalk.yellow(`~ ${repo.repoName}`));
+        // Settings
+        for (const setting of repo.settings) {
+            // Skip settings where both values are undefined
+            if (setting.oldValue === undefined && setting.newValue === undefined) {
+                continue;
+            }
+            if (setting.action === "add") {
+                lines.push(chalk.green(`    + ${setting.name}: ${formatValue(setting.newValue)}`));
+            }
+            else {
+                lines.push(chalk.yellow(`    ~ ${setting.name}: ${formatValue(setting.oldValue)} → ${formatValue(setting.newValue)}`));
+            }
+        }
+        // Rulesets
+        for (const ruleset of repo.rulesets) {
+            if (ruleset.action === "create") {
+                lines.push(chalk.green(`    + ruleset "${ruleset.name}"`));
+                if (ruleset.config) {
+                    lines.push(...formatRulesetConfig(ruleset.config, 2));
+                }
+            }
+            else if (ruleset.action === "update") {
+                lines.push(chalk.yellow(`    ~ ruleset "${ruleset.name}"`));
+                if (ruleset.propertyDiffs && ruleset.propertyDiffs.length > 0) {
+                    const treeLines = formatPropertyTree(ruleset.propertyDiffs);
+                    for (const line of treeLines) {
+                        lines.push(`        ${line}`);
+                    }
+                }
+            }
+            else if (ruleset.action === "delete") {
+                lines.push(chalk.red(`    - ruleset "${ruleset.name}"`));
+            }
+        }
+        // Error
+        if (repo.error) {
+            lines.push(chalk.red(`    Error: ${repo.error}`));
+        }
+        lines.push(""); // Blank line between repos
+    }
+    // Summary
+    lines.push(formatSummary(report.totals));
+    return lines;
+}
+// =============================================================================
+// Markdown Formatter
+// =============================================================================
+function formatValuePlain(val) {
+    if (val === null)
+        return "null";
+    if (val === undefined)
+        return "undefined";
+    if (typeof val === "string")
+        return `"${val}"`;
+    if (typeof val === "boolean")
+        return val ? "true" : "false";
+    return String(val);
+}
+function formatRulesetConfigPlain(config, indent) {
+    const lines = [];
+    function renderObject(obj, currentIndent) {
+        for (const [k, v] of Object.entries(obj)) {
+            renderValue(k, v, currentIndent);
+        }
+    }
+    function renderValue(key, value, currentIndent) {
+        const pad = "    ".repeat(currentIndent);
+        if (value === null || value === undefined)
+            return;
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                lines.push(`${pad}+ ${key}: []`);
+            }
+            else if (value.every((v) => typeof v !== "object")) {
+                lines.push(`${pad}+ ${key}: [${value.map((v) => (typeof v === "string" ? `"${v}"` : String(v))).join(", ")}]`);
+            }
+            else {
+                lines.push(`${pad}+ ${key}:`);
+                for (let i = 0; i < value.length; i++) {
+                    const item = value[i];
+                    if (typeof item === "object" && item !== null) {
+                        const obj = item;
+                        const typeLabel = "type" in obj ? ` (${obj.type})` : "";
+                        lines.push(`${pad}    + [${i}]${typeLabel}:`);
+                        renderObject(obj, currentIndent + 2);
+                    }
+                    else {
+                        lines.push(`${pad}    + ${formatValuePlain(item)}`);
+                    }
+                }
+            }
+        }
+        else if (typeof value === "object") {
+            lines.push(`${pad}+ ${key}:`);
+            renderObject(value, currentIndent + 1);
+        }
+        else {
+            lines.push(`${pad}+ ${key}: ${formatValuePlain(value)}`);
+        }
+    }
+    for (const [key, value] of Object.entries(config)) {
+        if (key === "name")
+            continue;
+        renderValue(key, value, indent);
+    }
+    return lines;
+}
+export function formatSettingsReportMarkdown(report, dryRun) {
+    const lines = [];
+    // Title
+    const titleSuffix = dryRun ? " (Dry Run)" : "";
+    lines.push(`## Repository Settings Summary${titleSuffix}`);
+    lines.push("");
+    // Dry-run warning
+    if (dryRun) {
+        lines.push("> [!WARNING]");
+        lines.push("> This was a dry run — no changes were applied");
+        lines.push("");
+    }
+    // Diff block
+    const diffLines = [];
+    for (const repo of report.repos) {
+        if (repo.settings.length === 0 &&
+            repo.rulesets.length === 0 &&
+            !repo.error) {
+            continue;
+        }
+        diffLines.push(`~ ${repo.repoName}`);
+        for (const setting of repo.settings) {
+            // Skip settings where both values are undefined
+            if (setting.oldValue === undefined && setting.newValue === undefined) {
+                continue;
+            }
+            if (setting.action === "add") {
+                diffLines.push(`    + ${setting.name}: ${formatValuePlain(setting.newValue)}`);
+            }
+            else {
+                diffLines.push(`    ~ ${setting.name}: ${formatValuePlain(setting.oldValue)} → ${formatValuePlain(setting.newValue)}`);
+            }
+        }
+        for (const ruleset of repo.rulesets) {
+            if (ruleset.action === "create") {
+                diffLines.push(`    + ruleset "${ruleset.name}"`);
+                if (ruleset.config) {
+                    diffLines.push(...formatRulesetConfigPlain(ruleset.config, 2));
+                }
+            }
+            else if (ruleset.action === "update") {
+                diffLines.push(`    ~ ruleset "${ruleset.name}"`);
+                if (ruleset.propertyDiffs && ruleset.propertyDiffs.length > 0) {
+                    for (const diff of ruleset.propertyDiffs) {
+                        const path = diff.path.join(".");
+                        if (diff.action === "add") {
+                            diffLines.push(`        + ${path}: ${formatValuePlain(diff.newValue)}`);
+                        }
+                        else if (diff.action === "change") {
+                            diffLines.push(`        ~ ${path}: ${formatValuePlain(diff.oldValue)} → ${formatValuePlain(diff.newValue)}`);
+                        }
+                        else if (diff.action === "remove") {
+                            diffLines.push(`        - ${path}`);
+                        }
+                    }
+                }
+            }
+            else if (ruleset.action === "delete") {
+                diffLines.push(`    - ruleset "${ruleset.name}"`);
+            }
+        }
+        if (repo.error) {
+            diffLines.push(`    ! Error: ${repo.error}`);
+        }
+    }
+    if (diffLines.length > 0) {
+        lines.push("```diff");
+        lines.push(...diffLines);
+        lines.push("```");
+        lines.push("");
+    }
+    // Summary
+    lines.push(`**${formatSummary(report.totals)}**`);
+    return lines.join("\n");
+}
+// =============================================================================
+// File Writer
+// =============================================================================
+export function writeSettingsReportSummary(report, dryRun) {
+    const summaryPath = process.env.GITHUB_STEP_SUMMARY;
+    if (!summaryPath)
+        return;
+    const markdown = formatSettingsReportMarkdown(report, dryRun);
+    appendFileSync(summaryPath, "\n" + markdown + "\n");
+}

package/dist/{summary-utils.d.ts → output/summary-utils.d.ts}

@@ -1,7 +1,7 @@
-import { ProcessorResult } from "./repository-processor.js";
-import { RepoConfig } from "./config.js";
+import type { ProcessorResult } from "../sync/index.js";
+import { RepoConfig } from "../config/index.js";
 import { MergeOutcome, FileChanges, RepoResult } from "./github-summary.js";
-import { DiffStats } from "./diff-utils.js";
+import { DiffStats } from "../sync/diff-utils.js";
 /**
  * Determine merge outcome from repo config and processor result
  */

package/dist/output/sync-report.d.ts

@@ -0,0 +1,24 @@
+export interface SyncReport {
+    repos: RepoFileChanges[];
+    totals: {
+        files: {
+            create: number;
+            update: number;
+            delete: number;
+        };
+    };
+}
+export interface RepoFileChanges {
+    repoName: string;
+    files: FileChange[];
+    prUrl?: string;
+    mergeOutcome?: "manual" | "auto" | "force" | "direct";
+    error?: string;
+}
+export interface FileChange {
+    path: string;
+    action: "create" | "update" | "delete";
+}
+export declare function formatSyncReportCLI(report: SyncReport): string[];
+export declare function formatSyncReportMarkdown(report: SyncReport, dryRun: boolean): string;
+export declare function writeSyncReportSummary(report: SyncReport, dryRun: boolean): void;

package/dist/output/sync-report.js

@@ -0,0 +1,99 @@
+// src/output/sync-report.ts
+import { appendFileSync } from "node:fs";
+import chalk from "chalk";
+function formatSummary(totals) {
+    const total = totals.files.create + totals.files.update + totals.files.delete;
+    if (total === 0) {
+        return "No changes";
+    }
+    const parts = [];
+    if (totals.files.create > 0)
+        parts.push(`${totals.files.create} to create`);
+    if (totals.files.update > 0)
+        parts.push(`${totals.files.update} to update`);
+    if (totals.files.delete > 0)
+        parts.push(`${totals.files.delete} to delete`);
+    const fileWord = total === 1 ? "file" : "files";
+    return `Plan: ${total} ${fileWord} (${parts.join(", ")})`;
+}
+export function formatSyncReportCLI(report) {
+    const lines = [];
+    for (const repo of report.repos) {
+        if (repo.files.length === 0 && !repo.error) {
+            continue;
+        }
+        // Repo header
+        lines.push(chalk.yellow(`~ ${repo.repoName}`));
+        // Files
+        for (const file of repo.files) {
+            if (file.action === "create") {
+                lines.push(chalk.green(`    + ${file.path}`));
+            }
+            else if (file.action === "update") {
+                lines.push(chalk.yellow(`    ~ ${file.path}`));
+            }
+            else if (file.action === "delete") {
+                lines.push(chalk.red(`    - ${file.path}`));
+            }
+        }
+        // Error
+        if (repo.error) {
+            lines.push(chalk.red(`    Error: ${repo.error}`));
+        }
+        lines.push(""); // Blank line between repos
+    }
+    // Summary
+    lines.push(formatSummary(report.totals));
+    return lines;
+}
+export function formatSyncReportMarkdown(report, dryRun) {
+    const lines = [];
+    // Title
+    const titleSuffix = dryRun ? " (Dry Run)" : "";
+    lines.push(`## Config Sync Summary${titleSuffix}`);
+    lines.push("");
+    // Dry-run warning
+    if (dryRun) {
+        lines.push("> [!WARNING]");
+        lines.push("> This was a dry run — no changes were applied");
+        lines.push("");
+    }
+    // Diff block
+    const diffLines = [];
+    for (const repo of report.repos) {
+        if (repo.files.length === 0 && !repo.error) {
+            continue;
+        }
+        diffLines.push(`~ ${repo.repoName}`);
+        for (const file of repo.files) {
+            if (file.action === "create") {
+                diffLines.push(`    + ${file.path}`);
+            }
+            else if (file.action === "update") {
+                diffLines.push(`    ~ ${file.path}`);
+            }
+            else if (file.action === "delete") {
+                diffLines.push(`    - ${file.path}`);
+            }
+        }
+        if (repo.error) {
+            diffLines.push(`    ! Error: ${repo.error}`);
+        }
+    }
+    if (diffLines.length > 0) {
+        lines.push("```diff");
+        lines.push(...diffLines);
+        lines.push("```");
+        lines.push("");
+    }
+    // Summary
+    lines.push(`**${formatSummary(report.totals)}**`);
+    return lines.join("\n");
+}
+export function writeSyncReportSummary(report, dryRun) {
+    const summaryPath = process.env.GITHUB_STEP_SUMMARY;
+    if (!summaryPath)
+        return;
+    const markdown = formatSyncReportMarkdown(report, dryRun);
+    appendFileSync(summaryPath, "\n" + markdown + "\n");
+}

package/dist/settings/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./rulesets/index.js";
+export * from "./repo-settings/index.js";

package/dist/settings/index.js

@@ -0,0 +1,4 @@
+// Rulesets
+export * from "./rulesets/index.js";
+// Repo settings
+export * from "./repo-settings/index.js";

package/dist/{repo-settings-diff.d.ts → settings/repo-settings/diff.d.ts}

@@ -1,5 +1,5 @@
-import type { GitHubRepoSettings } from "./config.js";
-import type { CurrentRepoSettings } from "./strategies/repo-settings-strategy.js";
+import type { GitHubRepoSettings } from "../../config/index.js";
+import type { CurrentRepoSettings } from "./types.js";
 export type RepoSettingsAction = "add" | "change" | "unchanged";
 export interface RepoSettingsChange {
     property: keyof GitHubRepoSettings;

package/dist/{repo-settings-plan-formatter.d.ts → settings/repo-settings/formatter.d.ts}

@@ -1,7 +1,9 @@
-import type { RepoSettingsChange } from "./repo-settings-diff.js";
+import type { RepoSettingsChange } from "./diff.js";
 export interface RepoSettingsPlanEntry {
     property: string;
     action: "add" | "change";
+    oldValue?: unknown;
+    newValue?: unknown;
 }
 export interface RepoSettingsPlanResult {
     lines: string[];

package/dist/{repo-settings-plan-formatter.js → settings/repo-settings/formatter.js}

@@ -54,12 +54,21 @@ export function formatRepoSettingsPlan(changes) {
         if (change.action === "add") {
             lines.push(chalk.green(`    + ${change.property}: ${formatValue(change.newValue)}`));
             adds++;
-            entries.push({ property: change.property, action: "add" });
+            entries.push({
+                property: change.property,
+                action: "add",
+                newValue: change.newValue,
+            });
         }
         else if (change.action === "change") {
             lines.push(chalk.yellow(`    ~ ${change.property}: ${formatValue(change.oldValue)} → ${formatValue(change.newValue)}`));
             changesCount++;
-            entries.push({ property: change.property, action: "change" });
+            entries.push({
+                property: change.property,
+                action: "change",
+                oldValue: change.oldValue,
+                newValue: change.newValue,
+            });
         }
     }
     return { lines, adds, changes: changesCount, warnings, entries };

package/dist/{strategies → settings/repo-settings}/github-repo-settings-strategy.d.ts

@@ -1,7 +1,7 @@
-import { ICommandExecutor } from "../command-executor.js";
-import { RepoInfo } from "../repo-detector.js";
-import type { GitHubRepoSettings } from "../config.js";
-import type { IRepoSettingsStrategy, RepoSettingsStrategyOptions, CurrentRepoSettings } from "./repo-settings-strategy.js";
+import { ICommandExecutor } from "../../shared/command-executor.js";
+import { RepoInfo } from "../../shared/repo-detector.js";
+import type { GitHubRepoSettings } from "../../config/index.js";
+import type { IRepoSettingsStrategy, RepoSettingsStrategyOptions, CurrentRepoSettings } from "./types.js";
 /**
  * GitHub Repository Settings Strategy.
  * Manages repository settings via GitHub REST API using `gh api` CLI.

package/dist/{strategies → settings/repo-settings}/github-repo-settings-strategy.js

@@ -1,6 +1,6 @@
-import { defaultExecutor } from "../command-executor.js";
-import { isGitHubRepo } from "../repo-detector.js";
-import { escapeShellArg } from "../shell-utils.js";
+import { defaultExecutor, } from "../../shared/command-executor.js";
+import { isGitHubRepo, } from "../../shared/repo-detector.js";
+import { escapeShellArg } from "../../shared/shell-utils.js";
 /**
  * Converts camelCase to snake_case.
  */

package/dist/settings/repo-settings/index.d.ts

@@ -0,0 +1,5 @@
+export { isRepoSettingsStrategy, type IRepoSettingsStrategy, type RepoSettingsStrategyOptions, type CurrentRepoSettings, } from "./types.js";
+export { RepoSettingsProcessor, type IRepoSettingsProcessor, type RepoSettingsProcessorOptions, type RepoSettingsProcessorResult, } from "./processor.js";
+export { diffRepoSettings, hasChanges, type RepoSettingsAction, type RepoSettingsChange, } from "./diff.js";
+export { formatRepoSettingsPlan, type RepoSettingsPlanResult, type RepoSettingsPlanEntry, } from "./formatter.js";
+export { GitHubRepoSettingsStrategy } from "./github-repo-settings-strategy.js";

package/dist/settings/repo-settings/index.js

@@ -0,0 +1,10 @@
+// Types
+export { isRepoSettingsStrategy, } from "./types.js";
+// Repo settings processor
+export { RepoSettingsProcessor, } from "./processor.js";
+// Repo settings diff
+export { diffRepoSettings, hasChanges, } from "./diff.js";
+// Repo settings formatter
+export { formatRepoSettingsPlan, } from "./formatter.js";
+// Repo settings strategies
+export { GitHubRepoSettingsStrategy } from "./github-repo-settings-strategy.js";

package/dist/{repo-settings-processor.d.ts → settings/repo-settings/processor.d.ts}

@@ -1,7 +1,7 @@
-import type { RepoConfig } from "./config.js";
-import type { RepoInfo } from "./repo-detector.js";
-import type { IRepoSettingsStrategy } from "./strategies/repo-settings-strategy.js";
-import { RepoSettingsPlanResult } from "./repo-settings-plan-formatter.js";
+import type { RepoConfig } from "../../config/index.js";
+import type { RepoInfo } from "../../shared/repo-detector.js";
+import type { IRepoSettingsStrategy } from "./types.js";
+import { RepoSettingsPlanResult } from "./formatter.js";
 export interface IRepoSettingsProcessor {
     process(repoConfig: RepoConfig, repoInfo: RepoInfo, options: RepoSettingsProcessorOptions): Promise<RepoSettingsProcessorResult>;
 }

package/dist/{repo-settings-processor.js → settings/repo-settings/processor.js}

@@ -1,9 +1,9 @@
-import { isGitHubRepo, getRepoDisplayName } from "./repo-detector.js";
-import { GitHubRepoSettingsStrategy } from "./strategies/github-repo-settings-strategy.js";
-import { diffRepoSettings, hasChanges } from "./repo-settings-diff.js";
-import { formatRepoSettingsPlan, } from "./repo-settings-plan-formatter.js";
-import { hasGitHubAppCredentials } from "./strategies/index.js";
-import { GitHubAppTokenManager } from "./github-app-token-manager.js";
+import { isGitHubRepo, getRepoDisplayName, } from "../../shared/repo-detector.js";
+import { GitHubRepoSettingsStrategy } from "./github-repo-settings-strategy.js";
+import { diffRepoSettings, hasChanges } from "./diff.js";
+import { formatRepoSettingsPlan } from "./formatter.js";
+import { hasGitHubAppCredentials } from "../../vcs/index.js";
+import { GitHubAppTokenManager } from "../../vcs/github-app-token-manager.js";
 export class RepoSettingsProcessor {
     strategy;
     tokenManager;
@@ -69,8 +69,14 @@ export class RepoSettingsProcessor {
                     planOutput,
                 };
             }
-            // Apply changes
-            await this.applyChanges(githubRepo, desiredSettings, strategyOptions);
+            // Apply changes - only send settings that actually changed
+            const changedSettings = changes.reduce((acc, change) => {
+                if (change.action !== "unchanged") {
+                    acc[change.property] = change.newValue;
+                }
+                return acc;
+            }, {});
+            await this.applyChanges(githubRepo, changedSettings, strategyOptions);
             return {
                 success: true,
                 repoName,

package/dist/{strategies/repo-settings-strategy.d.ts → settings/repo-settings/types.d.ts}

@@ -1,5 +1,5 @@
-import type { RepoInfo } from "../repo-detector.js";
-import type { GitHubRepoSettings } from "../config.js";
+import type { RepoInfo } from "../../shared/repo-detector.js";
+import type { GitHubRepoSettings } from "../../config/index.js";
 export interface RepoSettingsStrategyOptions {
     token?: string;
     host?: string;

package/dist/settings/rulesets/diff-algorithm.d.ts

@@ -0,0 +1,18 @@
+export type DiffAction = "add" | "change" | "remove";
+export interface PropertyDiff {
+    path: string[];
+    action: DiffAction;
+    oldValue?: unknown;
+    newValue?: unknown;
+}
+export declare function isObject(val: unknown): val is Record<string, unknown>;
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+export declare function isArrayOfObjects(arr: unknown[]): boolean;
+/**
+ * Recursively compute property-level diffs between two objects.
+ */
+export declare function computePropertyDiffs(current: Record<string, unknown>, desired: Record<string, unknown>, parentPath?: string[]): PropertyDiff[];
+/**
+ * Diff two arrays of objects by matching items on `type` field (or by index).
+ */
+export declare function diffObjectArrays(currentArr: unknown[], desiredArr: unknown[], parentPath: string[]): PropertyDiff[];