@metalsmith/collections 1.2.1 → 1.3.0

package/README.md

@@ -36,9 +36,12 @@ yarn add @metalsmith/collections
 Pass options to `@metalsmith/collections` in the plugin chain:
 
 ```js
-const Metalsmith = require('metalsmith')
-const markdown = require('@metalsmith/markdown')
-const collections = require('@metalsmith/collections')
+import Metalsmith from 'metalsmith'
+import markdown from '@metalsmith/markdown'
+import collections from '@metalsmith/collections'
+import { dirname } from 'path'
+
+const __dirname = dirname(new URL(import.meta.url).pathname)
 
 // defaults, only create collections based on file metadata
 Metalsmith(__dirname)
@@ -323,8 +326,8 @@ Add the `@metalsmith/collections` key to your `metalsmith.json` `plugins` key:
 
 [npm-badge]: https://img.shields.io/npm/v/@metalsmith/collections.svg
 [npm-url]: https://www.npmjs.com/package/@metalsmith/collections
-[ci-badge]: https://app.travis-ci.com/metalsmith/collections.svg?branch=master
-[ci-url]: https://app.travis-ci.com/metalsmith/collections
+[ci-badge]: https://github.com/metalsmith/collections/actions/workflows/test.yml/badge.svg
+[ci-url]: https://github.com/metalsmith/collections/actions/workflows/test.yml
 [metalsmith-badge]: https://img.shields.io/badge/metalsmith-plugin-green.svg?longCache=true
 [metalsmith-url]: http://metalsmith.io
 [codecov-badge]: https://img.shields.io/coveralls/github/metalsmith/collections

package/lib/index.cjs

@@ -0,0 +1,221 @@
+'use strict';
+
+var get = require('lodash.get');
+var readMetadata = require('read-metadata');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var get__default = /*#__PURE__*/_interopDefaultLegacy(get);
+
+function sortBy(key) {
+  let getKey = x => x[key];
+
+  if (key.includes('.')) {
+    getKey = x => get__default["default"](x, key);
+  }
+
+  return function defaultSort(a, b) {
+    a = getKey(a);
+    b = getKey(b);
+    if (!a && !b) return 0;
+    if (!a) return -1;
+    if (!b) return 1;
+    if (b > a) return -1;
+    if (a > b) return 1;
+    return 0;
+  };
+} // for backwards-compatibility only, date makes as little sense as "pubdate" or any custom key
+
+
+const defaultSort = sortBy('date');
+
+const defaultFilter = () => true;
+/**
+ * @typedef {Object} CollectionConfig
+ * @property {string|string[]} pattern - One or more glob patterns to match files to a collection
+ * @property {string|(a,b) => 0|1|-1} sortBy - A key to sort by (e.g. `date`,`title`, ..) or a custom sort function
+ * @property {number} limit - Limit the amount of items in a collection to `limit`
+ * @property {boolean} refer - Adds `next` and `previous` keys to file metadata of matched files
+ * @property {boolean} reverse - Whether to invert the sorting function results (asc/descending)
+ * @property {Function} filterBy - A function that gets a `Metalsmith.File` as first argument and returns `true` for every file to include in the collection
+ * @property {Object|string} metadata - An object with metadata to attach to the collection, or a `json`/`yaml`filepath string to load data from (relative to `Metalsmith.directory`)
+ */
+
+/** @type {CollectionConfig} */
+
+
+const defaultOptions = {
+  pattern: null,
+  reverse: false,
+  metadata: null,
+  limit: Infinity,
+  refer: true,
+  sortBy: defaultSort,
+  filterBy: defaultFilter
+};
+/**
+ * Normalize options
+ * @param {Object.<string,CollectionConfig>} options
+ */
+
+function normalizeOptions(options) {
+  options = options || {};
+
+  for (const config in options) {
+    let normalized = options[config];
+
+    if (typeof normalized === 'string' || Array.isArray(normalized)) {
+      normalized = {
+        pattern: normalized
+      };
+    }
+
+    normalized = Object.assign({}, defaultOptions, normalized);
+
+    if (typeof normalized.metadata === 'string') {
+      normalized.metadata = readMetadata.sync(normalized.metadata);
+    }
+
+    if (typeof normalized.sortBy === 'string') {
+      normalized.sortBy = sortBy(normalized.sortBy);
+    }
+
+    options[config] = normalized;
+  }
+
+  return options;
+}
+/**
+ * Add `collections` of files to the global metadata as a sorted array.
+ * @example
+ * metalsmith.use(collections({
+ *   posts: 'posts/*.md',
+ *   portfolio: {
+ *     pattern: 'portfolio/*.md',
+ *     metadata: { title: 'My portfolio' },
+ *     sortBy: 'order'
+ *   }
+ * }))
+ *
+ * @param {Object.<string,CollectionConfig|string>} options
+ * @return {import('metalsmith').Plugin}
+ */
+
+
+function initializeCollections(options) {
+  options = normalizeOptions(options);
+  const collectionNames = Object.keys(options);
+  const mappedCollections = collectionNames.map(name => {
+    return Object.assign({
+      name: name
+    }, options[name]);
+  });
+  return function collections(files, metalsmith, done) {
+    const metadata = metalsmith.metadata();
+    const fileNames = Object.keys(files);
+    const debug = metalsmith.debug('@metalsmith/collections');
+    metadata.collections = {};
+    fileNames.forEach(filePath => {
+      // add path property to file metadata for convenience
+      // this is for backward-compatibility only and is pretty useless
+      const file = files[filePath];
+      file.path = file.path || filePath; // dynamically add collections with default options when encountered in file metadata,
+      // and not explicitly defined in plugin options
+
+      if (file.collection) {
+        (Array.isArray(file.collection) ? file.collection : [file.collection]).forEach(name => {
+          if (!collectionNames.includes(name)) {
+            collectionNames.push(name);
+            const normalized = Object.assign({}, defaultOptions);
+            mappedCollections.push(Object.assign({
+              name
+            }, normalized));
+          }
+        });
+      }
+    });
+    debug('Identified %s collections: %s', mappedCollections.length, collectionNames.join());
+    mappedCollections.forEach(collection => {
+      const {
+        pattern,
+        filterBy,
+        sortBy,
+        reverse,
+        refer,
+        limit
+      } = collection;
+      const name = collection.name;
+      const matches = [];
+      debug('Processing collection %s with options %s:', name, collection); // first match by pattern if provided
+
+      if (pattern) {
+        matches.push.apply(matches, metalsmith.match(pattern, fileNames).map(filepath => {
+          const data = files[filepath]; // pattern-matched files might or might not have a "collection" property defined in front-matter
+          // and might also be included in multiple collections
+
+          if (!data.collection) {
+            data.collection = [];
+          } else if (typeof data.collection === 'string') {
+            data.collection = [data.collection];
+          }
+
+          if (!data.collection.includes(collection.name)) {
+            data.collection = [...data.collection, collection.name];
+          }
+
+          return data;
+        }));
+      } // next match by "collection" key, but only push if the files haven't been added through pattern matching first
+
+
+      matches.push.apply(matches, Object.values(files).filter(file => {
+        const patternMatched = matches.includes(file);
+        const isInCollection = Array.isArray(file.collection) ? file.collection.includes(collection.name) : file.collection === collection.name;
+        return !patternMatched && isInCollection;
+      }));
+
+      if (Object.prototype.hasOwnProperty.call(metadata, name)) {
+        debug('Warning: overwriting previously set metadata property %s', name);
+      } // apply sort, reverse, filter, limit options in this order
+
+
+      metadata[name] = matches.sort(sortBy);
+
+      if (reverse) {
+        metadata[name].reverse();
+      }
+
+      metadata[name] = metadata[name].filter(filterBy).slice(0, limit);
+
+      if (collection.metadata) {
+        metadata[name].metadata = collection.metadata;
+      }
+
+      if (refer) {
+        if (reverse) {
+          metadata[name].forEach((file, i) => {
+            Object.assign(file, {
+              next: i > 0 ? metadata[name][i - 1] : null,
+              previous: i < metadata[name].length - 1 ? metadata[name][i + 1] : null
+            });
+          });
+        } else {
+          metadata[name].forEach((file, i) => {
+            Object.assign(file, {
+              previous: i > 0 ? metadata[name][i - 1] : null,
+              next: i < metadata[name].length - 1 ? metadata[name][i + 1] : null
+            });
+          });
+        }
+      }
+
+      metadata.collections[name] = metadata[name];
+      debug('Added %s files to collection %s', metadata[name].length, name);
+    });
+    done();
+  };
+}
+
+initializeCollections.defaults = defaultOptions;
+
+module.exports = initializeCollections;

package/lib/index.d.ts

@@ -0,0 +1,55 @@
+import Metalsmith from "metalsmith";
+
+export default initializeCollections;
+export type CollectionConfig = {
+    /**
+     * - One or more glob patterns to match files to a collection
+     */
+    pattern: string | string[];
+    /**
+     * - A key to sort by (e.g. `date`,`title`, ..) or a custom sort function
+     */
+    sortBy: string | ((a: any, b: any) => 0 | 1 | -1);
+    /**
+     * - Limit the amount of items in a collection to `limit`
+     */
+    limit: number;
+    /**
+     * - Adds `next` and `previous` keys to file metadata of matched files
+     */
+    refer: boolean;
+    /**
+     * - Whether to invert the sorting function results (asc/descending)
+     */
+    reverse: boolean;
+    /**
+     * - A function that gets a `Metalsmith.File` as first argument and returns `true` for every file to include in the collection
+     */
+    filterBy: Function;
+    /**
+     * - An object with metadata to attach to the collection, or a `json`/`yaml`filepath string to load data from (relative to `Metalsmith.directory`)
+     */
+    metadata: any | string;
+};
+/**
+ * Add `collections` of files to the global metadata as a sorted array.
+ * @example
+ * metalsmith.use(collections({
+ *   posts: 'posts/*.md',
+ *   portfolio: {
+ *     pattern: 'portfolio/*.md',
+ *     metadata: { title: 'My portfolio' },
+ *     sortBy: 'order'
+ *   }
+ * }))
+ *
+ * @param {Object.<string,CollectionConfig|string>} options
+ */
+declare function initializeCollections(options: {
+    [x: string]: CollectionConfig | string;
+}): Metalsmith.Plugin;
+declare namespace initializeCollections {
+    export { defaultOptions as defaults };
+}
+
+declare const defaultOptions: CollectionConfig;

package/lib/index.js

@@ -1,11 +1,29 @@
-const debug = require('debug')('@metalsmith/collections')
-const multimatch = require('multimatch')
-const loadMetadata = require('read-metadata').sync
-const get = require('lodash.get')
-// for backwards-compatibility only, date makes as little sense as "pubdate" or any custom key
-const defaultSort = sortBy('date')
-const defaultFilter = () => true
+import get from 'lodash.get';
+import { sync } from 'read-metadata';
 
+function sortBy(key) {
+  let getKey = x => x[key];
+
+  if (key.includes('.')) {
+    getKey = x => get(x, key);
+  }
+
+  return function defaultSort(a, b) {
+    a = getKey(a);
+    b = getKey(b);
+    if (!a && !b) return 0;
+    if (!a) return -1;
+    if (!b) return 1;
+    if (b > a) return -1;
+    if (a > b) return 1;
+    return 0;
+  };
+} // for backwards-compatibility only, date makes as little sense as "pubdate" or any custom key
+
+
+const defaultSort = sortBy('date');
+
+const defaultFilter = () => true;
 /**
  * @typedef {Object} CollectionConfig
  * @property {string|string[]} pattern - One or more glob patterns to match files to a collection
@@ -18,6 +36,8 @@ const defaultFilter = () => true
  */
 
 /** @type {CollectionConfig} */
+
+
 const defaultOptions = {
   pattern: null,
   reverse: false,
@@ -26,170 +46,170 @@ const defaultOptions = {
   refer: true,
   sortBy: defaultSort,
   filterBy: defaultFilter
-}
-
-function sortBy(key) {
-  let getKey = (x) => x[key]
-  if (key.includes('.')) {
-    getKey = (x) => get(x, key)
-  }
-  return function defaultSort(a, b) {
-    a = getKey(a)
-    b = getKey(b)
-    if (!a && !b) return 0
-    if (!a) return -1
-    if (!b) return 1
-    if (b > a) return -1
-    if (a > b) return 1
-    return 0
-  }
-}
-
+};
 /**
  * Normalize options
  * @param {Object.<string,CollectionConfig>} options
  */
+
 function normalizeOptions(options) {
-  options = options || {}
+  options = options || {};
 
   for (const config in options) {
-    let normalized = options[config]
+    let normalized = options[config];
+
     if (typeof normalized === 'string' || Array.isArray(normalized)) {
-      normalized = { pattern: normalized }
+      normalized = {
+        pattern: normalized
+      };
     }
-    normalized = Object.assign({}, defaultOptions, normalized)
+
+    normalized = Object.assign({}, defaultOptions, normalized);
+
     if (typeof normalized.metadata === 'string') {
-      normalized.metadata = loadMetadata(normalized.metadata)
+      normalized.metadata = sync(normalized.metadata);
     }
+
     if (typeof normalized.sortBy === 'string') {
-      normalized.sortBy = sortBy(normalized.sortBy)
+      normalized.sortBy = sortBy(normalized.sortBy);
     }
-    options[config] = normalized
+
+    options[config] = normalized;
   }
 
-  return options
+  return options;
 }
-
 /**
- * Metalsmith plugin that adds `collections` of files to the global
- * metadata as a sorted array.
+ * Add `collections` of files to the global metadata as a sorted array.
+ * @example
+ * metalsmith.use(collections({
+ *   posts: 'posts/*.md',
+ *   portfolio: {
+ *     pattern: 'portfolio/*.md',
+ *     metadata: { title: 'My portfolio' },
+ *     sortBy: 'order'
+ *   }
+ * }))
  *
  * @param {Object.<string,CollectionConfig|string>} options
  * @return {import('metalsmith').Plugin}
  */
-function initializeCollections(options) {
-  options = normalizeOptions(options)
-  const collectionNames = Object.keys(options)
-  const mappedCollections = collectionNames.map((name) => {
-    return Object.assign({ name: name }, options[name])
-  })
 
-  return function collections(files, metalsmith, done) {
-    const metadata = metalsmith.metadata()
-    const fileNames = Object.keys(files)
 
-    metadata.collections = {}
-
-    fileNames.forEach((filePath) => {
+function initializeCollections(options) {
+  options = normalizeOptions(options);
+  const collectionNames = Object.keys(options);
+  const mappedCollections = collectionNames.map(name => {
+    return Object.assign({
+      name: name
+    }, options[name]);
+  });
+  return function collections(files, metalsmith, done) {
+    const metadata = metalsmith.metadata();
+    const fileNames = Object.keys(files);
+    const debug = metalsmith.debug('@metalsmith/collections');
+    metadata.collections = {};
+    fileNames.forEach(filePath => {
       // add path property to file metadata for convenience
       // this is for backward-compatibility only and is pretty useless
-      const file = files[filePath]
-      file.path = file.path || filePath
-
-      // dynamically add collections with default options when encountered in file metadata,
+      const file = files[filePath];
+      file.path = file.path || filePath; // dynamically add collections with default options when encountered in file metadata,
       // and not explicitly defined in plugin options
+
       if (file.collection) {
-        ;(Array.isArray(file.collection) ? file.collection : [file.collection]).forEach((name) => {
+        (Array.isArray(file.collection) ? file.collection : [file.collection]).forEach(name => {
           if (!collectionNames.includes(name)) {
-            collectionNames.push(name)
-            const normalized = Object.assign({}, defaultOptions)
-            mappedCollections.push(Object.assign({ name }, normalized))
+            collectionNames.push(name);
+            const normalized = Object.assign({}, defaultOptions);
+            mappedCollections.push(Object.assign({
+              name
+            }, normalized));
           }
-        })
+        });
       }
-    })
+    });
+    debug('Identified %s collections: %s', mappedCollections.length, collectionNames.join());
+    mappedCollections.forEach(collection => {
+      const {
+        pattern,
+        filterBy,
+        sortBy,
+        reverse,
+        refer,
+        limit
+      } = collection;
+      const name = collection.name;
+      const matches = [];
+      debug('Processing collection %s with options %s:', name, collection); // first match by pattern if provided
 
-    debug('Identified %s collections: %s', mappedCollections.length, collectionNames.join())
+      if (pattern) {
+        matches.push.apply(matches, metalsmith.match(pattern, fileNames).map(filepath => {
+          const data = files[filepath]; // pattern-matched files might or might not have a "collection" property defined in front-matter
+          // and might also be included in multiple collections
+
+          if (!data.collection) {
+            data.collection = [];
+          } else if (typeof data.collection === 'string') {
+            data.collection = [data.collection];
+          }
+
+          if (!data.collection.includes(collection.name)) {
+            data.collection = [...data.collection, collection.name];
+          }
 
-    mappedCollections.forEach((collection) => {
-      const { pattern, filterBy, sortBy, reverse, refer, limit } = collection
-      const name = collection.name
-      const matches = []
-      debug('Processing collection %s with options %s:', name, collection)
+          return data;
+        }));
+      } // next match by "collection" key, but only push if the files haven't been added through pattern matching first
 
-      // first match by pattern if provided
-      if (pattern) {
-        matches.push.apply(
-          matches,
-          multimatch(fileNames, pattern).map((filepath) => {
-            const data = files[filepath]
-            // pattern-matched files might or might not have a "collection" property defined in front-matter
-            // and might also be included in multiple collections
-            if (!data.collection) {
-              data.collection = []
-            } else if (typeof data.collection === 'string') {
-              data.collection = [data.collection]
-            }
-            if (!data.collection.includes(collection.name)) {
-              data.collection = [...data.collection, collection.name]
-            }
-            return data
-          })
-        )
-      }
 
-      // next match by "collection" key, but only push if the files haven't been added through pattern matching first
-      matches.push.apply(
-        matches,
-        Object.values(files).filter((file) => {
-          const patternMatched = matches.includes(file)
-          const isInCollection = Array.isArray(file.collection)
-            ? file.collection.includes(collection.name)
-            : file.collection === collection.name
-          return !patternMatched && isInCollection
-        })
-      )
+      matches.push.apply(matches, Object.values(files).filter(file => {
+        const patternMatched = matches.includes(file);
+        const isInCollection = Array.isArray(file.collection) ? file.collection.includes(collection.name) : file.collection === collection.name;
+        return !patternMatched && isInCollection;
+      }));
 
       if (Object.prototype.hasOwnProperty.call(metadata, name)) {
-        debug('Warning: overwriting previously set metadata property %s', name)
-      }
-      // apply sort, reverse, filter, limit options in this order
-      metadata[name] = matches.sort(sortBy)
+        debug('Warning: overwriting previously set metadata property %s', name);
+      } // apply sort, reverse, filter, limit options in this order
+
+
+      metadata[name] = matches.sort(sortBy);
 
       if (reverse) {
-        metadata[name].reverse()
+        metadata[name].reverse();
       }
 
-      metadata[name] = metadata[name].filter(filterBy).slice(0, limit)
+      metadata[name] = metadata[name].filter(filterBy).slice(0, limit);
 
       if (collection.metadata) {
-        metadata[name].metadata = collection.metadata
+        metadata[name].metadata = collection.metadata;
       }
+
       if (refer) {
         if (reverse) {
           metadata[name].forEach((file, i) => {
             Object.assign(file, {
               next: i > 0 ? metadata[name][i - 1] : null,
               previous: i < metadata[name].length - 1 ? metadata[name][i + 1] : null
-            })
-          })
+            });
+          });
         } else {
           metadata[name].forEach((file, i) => {
             Object.assign(file, {
               previous: i > 0 ? metadata[name][i - 1] : null,
               next: i < metadata[name].length - 1 ? metadata[name][i + 1] : null
-            })
-          })
+            });
+          });
         }
       }
 
-      metadata.collections[name] = metadata[name]
-      debug('Added %s files to collection %s', metadata[name].length, name)
-    })
-    done()
-  }
+      metadata.collections[name] = metadata[name];
+      debug('Added %s files to collection %s', metadata[name].length, name);
+    });
+    done();
+  };
 }
 
-initializeCollections.defaults = defaultOptions
+initializeCollections.defaults = defaultOptions;
 
-module.exports = initializeCollections
+export { initializeCollections as default };

package/package.json

@@ -15,26 +15,35 @@
     "type": "git",
     "url": "https://github.com/metalsmith/collections.git"
   },
-  "version": "1.2.1",
+  "version": "1.3.0",
   "license": "MIT",
-  "main": "lib/index.js",
+  "source": "src/index.js",
+  "main": "lib/index.cjs",
+  "module": "lib/index.js",
+  "type": "module",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    "import": "./lib/index.js",
+    "require": "./lib/index.cjs"
+  },
   "dependencies": {
-    "debug": "^4.3.3",
     "lodash.get": "^4.4.2",
-    "multimatch": "^4.0.0",
     "read-metadata": "^1.0.0"
   },
   "devDependencies": {
-    "auto-changelog": "^2.3.0",
+    "auto-changelog": "^2.4.0",
     "coveralls": "^3.1.1",
-    "eslint": "^8.8.0",
-    "eslint-config-prettier": "^8.3.0",
-    "metalsmith": "^2.3.0",
-    "mocha": "^7.2.0",
-    "nodemon": "^1.18.4",
+    "eslint": "^8.20.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-node": "^11.1.0",
+    "metalsmith": "^2.5.0",
+    "microbundle": "^0.15.0",
+    "mocha": "^9.2.2",
+    "nodemon": "^2.0.19",
     "nyc": "^15.1.0",
-    "prettier": "^2.5.1",
-    "release-it": "^14.12.4"
+    "prettier": "^2.7.1",
+    "release-it": "^15.2.0"
   },
   "directories": {
     "lib": "lib",
@@ -45,21 +54,24 @@
   ],
   "scripts": {
     "changelog": "auto-changelog -u --starting-date 2021-12-01 --sort-commits date-desc --commit-limit false --ignore-commit-pattern '(dev|Release|Merge)'",
-    "test": "nyc mocha",
     "coverage": "nyc report --reporter=text-lcov > ./coverage.info",
-    "coveralls": "npm run coverage && cat ./coverage.info | coveralls",
     "format": "prettier --write \"**/*.{yml,md,js,json}\"",
-    "lint": "eslint --cache --fix-dry-run \"**/*.js\"",
+    "format:check": "prettier --list-different \"**/*.{yml,md,js,json}\"",
+    "lint": "eslint --fix .",
+    "lint:check": "eslint --fix-dry-run .",
     "dev": "nodemon --exec 'npm test'",
-    "release": "release-it ."
+    "release": "release-it .",
+    "build": "microbundle --target node --no-sourcemap -f cjs,esm --strict --generateTypes=false",
+    "pretest": "npm run build",
+    "test": "nyc mocha"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "metalsmith": "^2.3.0"
+    "metalsmith": "^2.5.0"
   },
   "engines": {
-    "node": ">=8"
+    "node": ">=12"
   }
 }

package/CHANGELOG.md

@@ -1,89 +0,0 @@
-### Changelog
-#### [v1.2.1](https://github.com/metalsmith/collections/compare/v1.2.1...v1.2.0) / 2022-02-03
-
-- Fixes [`#99`](https://github.com/metalsmith/collections/issues/99): collection key on file metadata - no dupes, no nested arrays
-- Fixes regression: incorrect previous & next refs when reverse: true
-- Fixes typo's in README
-#### [v1.2.0](https://github.com/metalsmith/collections/compare/v1.2.0...v1.1.0) / 2022-01-29
-
-- Feature: sortBy now also understands nested metadata properties, e.g. `sortBy: 'meta.display.order'`
-- Fixed JSDoc typo that made type hints unavailable
-- Documented limit & refer options
-- Improved README.md with more elaborate examples
-- Refactored to cleaner code
-- Removed dependencies: `extend`,`uniq`
-- Added dependency `lodash.get`
-- Added core-plugin tests
-- Updated devDependencies release-it, prettier, eslint
-
-#### [v1.1.0](https://github.com/metalsmith/collections/compare/v1.0.0...v1.1.0) / 2021-15-12
-
-- Added standardised code formatting and QA [`#86`](https://github.com/metalsmith/collections/pull/86)
-- Updated History with v1 PRs [`#85`](https://github.com/metalsmith/collections/pull/85)
-- Added better JSDoc types, return named plugin function [`3aa3443`](https://github.com/metalsmith/collections/commit/3aa3443802c2f814c90cf39c7b43de8fc3d3ff13)
-- Updated multimatch to 4.0.0, debug to 4.3.3 [`71d6f65`](https://github.com/metalsmith/collections/commit/71d6f65b9ec5572196e17dfebf5cff2361853f9d)
-
-# [1.0.0][] / 2018-10-17
-
-- Fixed API and merged many PRs
-- Allow metadata-based filtering with `filterBy` option
-- removed unused module
-- Add documentation: `sortBy` can be a function
-- display only matching files when debugging
-- assign data.path where undefined
-- Clear collections
-- Added multiple collections syntax to Readme.md
-
-#### [0.7.0][] / 2015-02-07
-
-- Allow front matter and pattern collections.
-- Added the ability to limit the size of a collection
-- Allow collections through metadata alone
-- add ability to disable next/previous references
-
-#### [0.6.0][] / 2014-08-12
-
-- Added the ability to set multiple collections
-
-#### [0.5.1][] / 2014-08-05
-
-- Fixed bug with require statement
-
-#### [0.5.0][] / 2014-08-04
-
-- Added the ability to add metadata to collections
-
-#### [0.4.1][] - May 4, 2014
-
-- fix empty collections
-
-#### [0.4.0][] - March 25, 2014
-
-- add option for `sortBy` to be a sorting function
-
-#### [0.3.0][] - March 24, 2014
-
-- add `collection` property to each file for pattern matches
-
-#### [0.2.0][] - March 20, 2014
-
-- add collections dictionary to global metadata
-
-#### [0.1.0][] - March 6, 2014
-
-- add matching by pattern
-- add shorthand for pattern matching
-- add previous and next references
-
-#### [0.0.3][] - February 6, 2014
-
-- add debug statements
-- swap to `extend` from `defaults` to avoid cloning
-
-#### [0.0.2][] - February 6, 2014
-
-- swap to `merge` to not act on clones
-
-#### [0.0.1][] - February 5, 2014
-
-:sparkles: