decap-cms-core 3.1.1 → 3.2.1

package/dist/esm/components/UI/ErrorBoundary.js

@@ -54,8 +54,8 @@ function buildIssueTemplate({
   let version = '';
   if (typeof DECAP_CMS_VERSION === 'string') {
     version = `decap-cms@${DECAP_CMS_VERSION}`;
-  } else if (typeof "3.0.2" === 'string') {
-    version = `decap-cms-app@${"3.0.2"}`;
+  } else if (typeof "3.0.4" === 'string') {
+    version = `decap-cms-app@${"3.0.4"}`;
   }
   const template = getIssueTemplate({
     version,

package/dist/esm/constants/configSchema.js

@@ -388,8 +388,7 @@ function getConfigSchema() {
               }
             },
             format: {
-              type: 'string',
-              enum: Object.keys(_formats.formatExtensions)
+              type: 'string'
             },
             extension: {
               type: 'string'

package/dist/esm/formats/formats.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.frontmatterFormats = exports.formatExtensions = exports.extensionFormatters = void 0;
+exports.getFormatExtensions = getFormatExtensions;
 exports.resolveFormat = resolveFormat;
 var _get2 = _interopRequireDefault(require("lodash/get"));
 var _immutable = require("immutable");
@@ -11,7 +12,13 @@ var _yaml = _interopRequireDefault(require("./yaml"));
 var _toml = _interopRequireDefault(require("./toml"));
 var _json = _interopRequireDefault(require("./json"));
 var _frontmatter = require("./frontmatter");
+var _registry = require("../lib/registry");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 const frontmatterFormats = ['yaml-frontmatter', 'toml-frontmatter', 'json-frontmatter'];
 exports.frontmatterFormats = frontmatterFormats;
 const formatExtensions = {
@@ -25,6 +32,9 @@ const formatExtensions = {
   'yaml-frontmatter': 'md'
 };
 exports.formatExtensions = formatExtensions;
+function getFormatExtensions() {
+  return _objectSpread(_objectSpread({}, formatExtensions), (0, _registry.getCustomFormatsExtensions)());
+}
 const extensionFormatters = {
   yml: _yaml.default,
   yaml: _yaml.default,
@@ -36,7 +46,7 @@ const extensionFormatters = {
 };
 exports.extensionFormatters = extensionFormatters;
 function formatByName(name, customDelimiter) {
-  return {
+  const formatters = _objectSpread({
     yml: _yaml.default,
     yaml: _yaml.default,
     toml: _toml.default,
@@ -45,7 +55,11 @@ function formatByName(name, customDelimiter) {
     'json-frontmatter': (0, _frontmatter.frontmatterJSON)(customDelimiter),
     'toml-frontmatter': (0, _frontmatter.frontmatterTOML)(customDelimiter),
     'yaml-frontmatter': (0, _frontmatter.frontmatterYAML)(customDelimiter)
-  }[name];
+  }, (0, _registry.getCustomFormatsFormatters)());
+  if (name in formatters) {
+    return formatters[name];
+  }
+  throw new Error(`No formatter available with name: ${name}`);
 }
 function frontmatterDelimiterIsList(frontmatterDelimiter) {
   return _immutable.List.isList(frontmatterDelimiter);

package/dist/esm/lib/registry.js

@@ -5,8 +5,12 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 exports.getBackend = getBackend;
+exports.getCustomFormats = getCustomFormats;
+exports.getCustomFormatsExtensions = getCustomFormatsExtensions;
+exports.getCustomFormatsFormatters = getCustomFormatsFormatters;
 exports.getEditorComponents = getEditorComponents;
 exports.getEventListeners = getEventListeners;
+exports.getFormatter = getFormatter;
 exports.getLocale = getLocale;
 exports.getMediaLibrary = getMediaLibrary;
 exports.getPreviewStyles = getPreviewStyles;
@@ -17,6 +21,7 @@ exports.getWidgetValueSerializer = getWidgetValueSerializer;
 exports.getWidgets = getWidgets;
 exports.invokeEvent = invokeEvent;
 exports.registerBackend = registerBackend;
+exports.registerCustomFormat = registerCustomFormat;
 exports.registerEditorComponent = registerEditorComponent;
 exports.registerEventListener = registerEventListener;
 exports.registerLocale = registerLocale;
@@ -60,7 +65,8 @@ const registry = {
   widgetValueSerializers: {},
   mediaLibraries: [],
   locales: {},
-  eventHandlers
+  eventHandlers,
+  formats: {}
 };
 var _default = {
   registerPreviewStyle,
@@ -86,7 +92,11 @@ var _default = {
   registerEventListener,
   removeEventListener,
   getEventListeners,
-  invokeEvent
+  invokeEvent,
+  registerCustomFormat,
+  getCustomFormats,
+  getCustomFormatsExtensions,
+  getCustomFormatsFormatters
 };
 /**
  * Preview Styles
@@ -319,4 +329,37 @@ function registerLocale(locale, phrases) {
 }
 function getLocale(locale) {
   return registry.locales[locale];
+}
+function registerCustomFormat(name, extension, formatter) {
+  registry.formats[name] = {
+    extension,
+    formatter
+  };
+}
+function getCustomFormats() {
+  return registry.formats;
+}
+function getCustomFormatsExtensions() {
+  return Object.entries(registry.formats).reduce(function (acc, [name, {
+    extension
+  }]) {
+    return _objectSpread(_objectSpread({}, acc), {}, {
+      [name]: extension
+    });
+  }, {});
+}
+
+/** @type {() => Record<string, unknown>} */
+function getCustomFormatsFormatters() {
+  return Object.entries(registry.formats).reduce(function (acc, [name, {
+    formatter
+  }]) {
+    return _objectSpread(_objectSpread({}, acc), {}, {
+      [name]: formatter
+    });
+  }, {});
+}
+function getFormatter(name) {
+  var _registry$formats$nam;
+  return (_registry$formats$nam = registry.formats[name]) === null || _registry$formats$nam === void 0 ? void 0 : _registry$formats$nam.formatter;
 }

package/dist/esm/reducers/collections.js

@@ -69,7 +69,11 @@ function collections(state = defaultState, action) {
 const selectors = {
   [_collectionTypes.FOLDER]: {
     entryExtension(collection) {
-      return (collection.get('extension') || (0, _get2.default)(_formats.formatExtensions, collection.get('format') || 'frontmatter')).replace(/^\./, '');
+      const ext = collection.get('extension') || (0, _get2.default)((0, _formats.getFormatExtensions)(), collection.get('format') || 'frontmatter');
+      if (!ext) {
+        throw new Error(`No extension found for format ${collection.get('format')}`);
+      }
+      return ext.replace(/^\./, '');
     },
     fields(collection) {
       return collection.get('fields');

package/index.d.ts

@@ -36,15 +36,7 @@ declare module 'decap-cms-core' {
     value: any;
   }
 
-  export type CmsCollectionFormatType =
-    | 'yml'
-    | 'yaml'
-    | 'toml'
-    | 'json'
-    | 'frontmatter'
-    | 'yaml-frontmatter'
-    | 'toml-frontmatter'
-    | 'json-frontmatter';
+  export type CmsCollectionFormatType = string;
 
   export type CmsAuthScope = 'repo' | 'public_repo';
 
@@ -501,6 +493,11 @@ declare module 'decap-cms-core' {
 
   export type CmsLocalePhrases = any; // TODO: type properly
 
+  export type Formatter = {
+    fromFile(content: string): unknown;
+    toFile(data: object, sortedKeys?: string[], comments?: Record<string, string>): string;
+  };
+
   export interface CmsRegistry {
     backends: {
       [name: string]: CmsRegistryBackend;
@@ -520,6 +517,9 @@ declare module 'decap-cms-core' {
     locales: {
       [name: string]: CmsLocalePhrases;
     };
+    formats: {
+      [name: string]: Formatter;
+    };
   }
 
   type GetAssetFunction = (asset: string) => {
@@ -579,6 +579,7 @@ declare module 'decap-cms-core' {
       serializer: CmsWidgetValueSerializer,
     ) => void;
     resolveWidget: (name: string) => CmsWidget | undefined;
+    registerCustomFormat: (name: string, extension: string, formatter: Formatter) => void;
   }
 
   export const DecapCmsCore: CMS;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "decap-cms-core",
   "description": "Decap CMS core application, see decap-cms package for the main distribution.",
-  "version": "3.1.1",
+  "version": "3.2.1",
   "repository": "https://github.com/decaporg/decap-cms/tree/master/packages/decap-cms-core",
   "bugs": "https://github.com/decaporg/decap-cms/issues",
   "module": "dist/esm/index.js",
@@ -98,5 +98,5 @@
     "@types/url-join": "^4.0.0",
     "redux-mock-store": "^1.5.3"
   },
-  "gitHead": "22632906a6d5bc2b889535d30fdf49cd8eb19883"
+  "gitHead": "25ef3074bd4fdc285f2245f1e10100316b3ff7db"
 }

package/src/components/Editor/EditorToolbar.js

@@ -451,6 +451,7 @@ export class EditorToolbar extends React.Component {
       <ToolbarDropdown
         dropdownTopOverlap="40px"
         dropdownWidth="150px"
+        key="td-publish-create"
         renderButton={() => (
           <PublishedToolbarButton>
             {isPersisting

package/src/components/Editor/__tests__/__snapshots__/EditorToolbar.spec.js.snap

@@ -200,7 +200,7 @@ exports[`EditorToolbar should render normal save button 1`] = `
     class="emotion-21 emotion-22"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -463,7 +463,7 @@ exports[`EditorToolbar should render normal save button 2`] = `
     class="emotion-21 emotion-22"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -695,7 +695,7 @@ exports[`EditorToolbar should render with default props 1`] = `
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -980,7 +980,7 @@ exports[`EditorToolbar should render with status=draft,useOpenAuthoring=false 1`
     class="emotion-23 emotion-24"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -1310,7 +1310,7 @@ exports[`EditorToolbar should render with status=draft,useOpenAuthoring=true 1`]
     class="emotion-30 emotion-31"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -1634,7 +1634,7 @@ exports[`EditorToolbar should render with status=pending_publish,useOpenAuthorin
     class="emotion-23 emotion-24"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -1946,7 +1946,7 @@ exports[`EditorToolbar should render with status=pending_publish,useOpenAuthorin
     class="emotion-28 emotion-29"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -2265,7 +2265,7 @@ exports[`EditorToolbar should render with status=pending_review,useOpenAuthoring
     class="emotion-23 emotion-24"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -2595,7 +2595,7 @@ exports[`EditorToolbar should render with status=pending_review,useOpenAuthoring
     class="emotion-30 emotion-31"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -2862,7 +2862,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -3064,7 +3064,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-16 emotion-17"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -3286,7 +3286,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -3513,7 +3513,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -3740,7 +3740,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div
@@ -3967,7 +3967,7 @@ exports[`EditorToolbar should render with workflow controls hasUnpublishedChange
     class="emotion-18 emotion-19"
   >
     <mock-link
-      classname="css-16gdrpq-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
+      classname="css-h6rugo-ToolbarSectionBackLink-toolbarSection e1d2l9mo8"
       to=""
     >
       <div

package/src/constants/configSchema.js

@@ -8,7 +8,7 @@ import {
 import ajvErrors from 'ajv-errors';
 import uuid from 'uuid/v4';
 
-import { formatExtensions, frontmatterFormats, extensionFormatters } from '../formats/formats';
+import { frontmatterFormats, extensionFormatters } from '../formats/formats';
 import { getWidgets } from '../lib/registry';
 import { I18N_STRUCTURE, I18N_FIELD } from '../lib/i18n';
 
@@ -231,7 +231,7 @@ function getConfigSchema() {
                 preview: { type: 'boolean' },
               },
             },
-            format: { type: 'string', enum: Object.keys(formatExtensions) },
+            format: { type: 'string' },
             extension: { type: 'string' },
             frontmatter_delimiter: {
               type: ['string', 'array'],

package/src/formats/__tests__/formats.spec.js

@@ -0,0 +1,87 @@
+import { Map } from 'immutable';
+
+import { extensionFormatters, resolveFormat } from '../formats';
+import { registerCustomFormat } from '../../lib/registry';
+
+describe('custom formats', () => {
+  const testEntry = {
+    collection: 'testCollection',
+    data: { x: 1 },
+    isModification: false,
+    label: 'testLabel',
+    mediaFiles: [],
+    meta: {},
+    newRecord: true,
+    partial: false,
+    path: 'testPath1',
+    raw: 'testRaw',
+    slug: 'testSlug',
+    author: 'testAuthor',
+    updatedOn: 'testUpdatedOn',
+  };
+  it('resolves builtint formats', () => {
+    const collection = Map({
+      name: 'posts',
+    });
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.yml' })).toEqual(
+      extensionFormatters.yml,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.yaml' })).toEqual(
+      extensionFormatters.yml,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.toml' })).toEqual(
+      extensionFormatters.toml,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.json' })).toEqual(
+      extensionFormatters.json,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.md' })).toEqual(
+      extensionFormatters.md,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.markdown' })).toEqual(
+      extensionFormatters.markdown,
+    );
+    expect(resolveFormat(collection, { ...testEntry, path: 'test.html' })).toEqual(
+      extensionFormatters.html,
+    );
+  });
+
+  it('resolves custom format', () => {
+    registerCustomFormat('txt-querystring', 'txt', {
+      fromFile: file => Object.fromEntries(new URLSearchParams(file)),
+      toFile: value => new URLSearchParams(value).toString(),
+    });
+
+    const collection = Map({
+      name: 'posts',
+      format: 'txt-querystring',
+    });
+
+    const formatter = resolveFormat(collection, { ...testEntry, path: 'test.txt' });
+
+    expect(formatter.toFile({ foo: 'bar' })).toEqual('foo=bar');
+    expect(formatter.fromFile('foo=bar')).toEqual({ foo: 'bar' });
+  });
+
+  it('can override existing formatters', () => {
+    // simplified version of a more realistic use case: using a different yaml library like js-yaml
+    // to make netlify-cms play nice with other tools that edit content and spit out yaml
+    registerCustomFormat('bad-yaml', 'yml', {
+      fromFile: file => Object.fromEntries(file.split('\n').map(line => line.split(': '))),
+      toFile: value =>
+        Object.entries(value)
+          .map(([k, v]) => `${k}: ${v}`)
+          .join('\n'),
+    });
+
+    const collection = Map({
+      name: 'posts',
+      format: 'bad-yaml',
+    });
+
+    const formatter = resolveFormat(collection, { ...testEntry, path: 'test.txt' });
+
+    expect(formatter.toFile({ a: 'b', c: 'd' })).toEqual('a: b\nc: d');
+    expect(formatter.fromFile('a: b\nc: d')).toEqual({ a: 'b', c: 'd' });
+  });
+});

package/src/formats/formats.ts

@@ -5,10 +5,12 @@ import yamlFormatter from './yaml';
 import tomlFormatter from './toml';
 import jsonFormatter from './json';
 import { FrontmatterInfer, frontmatterJSON, frontmatterTOML, frontmatterYAML } from './frontmatter';
+import { getCustomFormatsExtensions, getCustomFormatsFormatters } from '../lib/registry';
 
 import type { Delimiter } from './frontmatter';
 import type { Collection, EntryObject, Format } from '../types/redux';
 import type { EntryValue } from '../valueObjects/Entry';
+import type { Formatter } from 'decap-cms-core';
 
 export const frontmatterFormats = ['yaml-frontmatter', 'toml-frontmatter', 'json-frontmatter'];
 
@@ -23,6 +25,10 @@ export const formatExtensions = {
   'yaml-frontmatter': 'md',
 };
 
+export function getFormatExtensions() {
+  return { ...formatExtensions, ...getCustomFormatsExtensions() };
+}
+
 export const extensionFormatters = {
   yml: yamlFormatter,
   yaml: yamlFormatter,
@@ -33,8 +39,8 @@ export const extensionFormatters = {
   html: FrontmatterInfer,
 };
 
-function formatByName(name: Format, customDelimiter?: Delimiter) {
-  return {
+function formatByName(name: Format, customDelimiter?: Delimiter): Formatter {
+  const formatters: Record<string, Formatter> = {
     yml: yamlFormatter,
     yaml: yamlFormatter,
     toml: tomlFormatter,
@@ -43,7 +49,12 @@ function formatByName(name: Format, customDelimiter?: Delimiter) {
     'json-frontmatter': frontmatterJSON(customDelimiter),
     'toml-frontmatter': frontmatterTOML(customDelimiter),
     'yaml-frontmatter': frontmatterYAML(customDelimiter),
-  }[name];
+    ...getCustomFormatsFormatters(),
+  };
+  if (name in formatters) {
+    return formatters[name];
+  }
+  throw new Error(`No formatter available with name: ${name}`);
 }
 
 function frontmatterDelimiterIsList(

package/src/lib/__tests__/registry.spec.js

@@ -46,6 +46,21 @@ describe('registry', () => {
     });
   });
 
+  describe('registerCustomFormat', () => {
+    it('can register a custom format', () => {
+      const { getCustomFormats, registerCustomFormat } = require('../registry');
+
+      expect(Object.keys(getCustomFormats())).not.toContain('querystring');
+
+      registerCustomFormat('querystring', 'qs', {
+        fromFile: content => Object.fromEntries(new URLSearchParams(content)),
+        toFile: obj => new URLSearchParams(obj).toString(),
+      });
+
+      expect(Object.keys(getCustomFormats())).toContain('querystring');
+    });
+  });
+
   describe('eventHandlers', () => {
     const events = [
       'prePublish',

package/src/lib/registry.js

@@ -31,6 +31,7 @@ const registry = {
   mediaLibraries: [],
   locales: {},
   eventHandlers,
+  formats: {},
 };
 
 export default {
@@ -58,6 +59,10 @@ export default {
   removeEventListener,
   getEventListeners,
   invokeEvent,
+  registerCustomFormat,
+  getCustomFormats,
+  getCustomFormatsExtensions,
+  getCustomFormatsFormatters,
 };
 
 /**
@@ -280,3 +285,28 @@ export function registerLocale(locale, phrases) {
 export function getLocale(locale) {
   return registry.locales[locale];
 }
+
+export function registerCustomFormat(name, extension, formatter) {
+  registry.formats[name] = { extension, formatter };
+}
+
+export function getCustomFormats() {
+  return registry.formats;
+}
+
+export function getCustomFormatsExtensions() {
+  return Object.entries(registry.formats).reduce(function (acc, [name, { extension }]) {
+    return { ...acc, [name]: extension };
+  }, {});
+}
+
+/** @type {() => Record<string, unknown>} */
+export function getCustomFormatsFormatters() {
+  return Object.entries(registry.formats).reduce(function (acc, [name, { formatter }]) {
+    return { ...acc, [name]: formatter };
+  }, {});
+}
+
+export function getFormatter(name) {
+  return registry.formats[name]?.formatter;
+}

package/src/reducers/collections.ts

@@ -7,7 +7,7 @@ import { CONFIG_SUCCESS } from '../actions/config';
 import { FILES, FOLDER } from '../constants/collectionTypes';
 import { COMMIT_DATE, COMMIT_AUTHOR } from '../constants/commitProps';
 import { INFERABLE_FIELDS, IDENTIFIER_FIELDS, SORTABLE_FIELDS } from '../constants/fieldInference';
-import { formatExtensions } from '../formats/formats';
+import { getFormatExtensions } from '../formats/formats';
 import { selectMediaFolder } from './entries';
 import { summaryFormatter } from '../lib/formatters';
 
@@ -46,10 +46,14 @@ function collections(state = defaultState, action: ConfigAction) {
 const selectors = {
   [FOLDER]: {
     entryExtension(collection: Collection) {
-      return (
+      const ext =
         collection.get('extension') ||
-        get(formatExtensions, collection.get('format') || 'frontmatter')
-      ).replace(/^\./, '');
+        get(getFormatExtensions(), collection.get('format') || 'frontmatter');
+      if (!ext) {
+        throw new Error(`No extension found for format ${collection.get('format')}`);
+      }
+
+      return ext.replace(/^\./, '');
     },
     fields(collection: Collection) {
       return collection.get('fields');

package/src/types/redux.ts

@@ -599,7 +599,7 @@ type i18n = StaticallyTypedRecord<{
   default_locale: string;
 }>;
 
-export type Format = keyof typeof formatExtensions;
+export type Format = keyof typeof formatExtensions | string;
 
 type CollectionObject = {
   name: string;