[Feature request] Asset Sync variant to sync only assets used by a world

[rikmarais]

Either as a separate tool or as an option to the Asset Sync, allow the tool to "find all image paths used by this world and compendiums" and then sync only those files.

This is an alternative to the full Asset Sync and prevents long sync times for large amounts of assets when the intent is to sync only the assets required by a specific world.

--- Possible alternative ---
Before Asset Sync begins, allow the user to set filters to exclude or include specific path prefixes starting from the root of the Assets Library.

This will allow the users to exclude syncing assets for specific premium packages that would be downloaded by Foundry at install time anyway.

It would also allow users to backup specific directories from their assets library while avoiding other directories that they already have backed up, which could otherwise make the sync take substantially longer.

WIP design

function filterFiles(files, include = [], exclude = []) {
    return files.filter(file => {
        const shouldInclude = include.some(prefix => file.startsWith(prefix));
        const shouldExclude = exclude.some(prefix => file.startsWith(prefix));
        return (include.length === 0 || shouldInclude) && !shouldExclude;
    });
}

// Usage:
const allFiles = ['path/to/file1', 'path/to/file2', 'path/to/file3'];
const includePrefixes = ['path/to'];
const excludePrefixes = ['path/to/file2'];

const filteredFiles = filterFiles(allFiles, includePrefixes, excludePrefixes);
console.log(filteredFiles);  // Output: ['path/to/file1', 'path/to/file3']

[rikmarais]

#13 allows for partial asset sync but does not restrict to only assets of the specific world.