afformative 0.6.2 → 0.7.0-beta.1

package/README.md

@@ -11,11 +11,11 @@ A standardized way to format values in your React components.
 </h3>
 
 <p align="center">
-Afformative helps UI component libraries visualise arbitrary data in a reusable, plug-and-play fashion. Formatting dates and enumeration translations in your select fields and data grids has never been easier.
+Afformative helps UI component libraries display arbitrary data in a reusable, plug-and-play fashion. Formatting dates and enum translations in your select fields and data grids has never been easier.
 </p>
 
 <p align="center">
-  <a href="https://github.com/wafflepie/affomative/blob/master/LICENSE">
+  <a href="https://github.com/wafflepie/afformative/blob/master/LICENSE">
     <img src="https://flat.badgen.net/badge/license/MIT/blue" alt="MIT License" />
   </a>
 
@@ -26,94 +26,113 @@ Afformative helps UI component libraries visualise arbitrary data in a reusable,
 
 ## Installation
 
-Use either of these commands, depending on the package manager you prefer:
+Use one of these commands, depending on your preferred package manager:
 
 ```sh
 yarn add afformative
 
+pnpm add afformative
+
 npm i afformative
 ```
 
 ## Quick Start
 
-I'll try not to bore you too much, I promise.
-
-### The Holy Standard
+A formatter is an object with `format`, `stringify`, and `compare` methods. Formatters must be created using the `createFormatter` function.
 
-> Thou shalt not format thy values without afformative.
+`createFormatter` accepts a single object parameter. `format` is the only required property, but specifying `stringify` is recommended in most cases.
 
-A formatter is an object with a `format` method. Formatters should be created solely using the `makeFormatter` factory.
+```tsx
+import { createFormatter } from "afformative"
+import { ReactNode } from "react"
 
-```js
-import { makeFormatter } from "afformative"
-
-const upperCaseFormatter = makeFormatter(value => value.toUpperCase())
+const dateFormatter = createFormatter<Date, ReactNode>({
+  format: value => <time dateTime={value.toISOString()}>{value.toLocaleDateString()}</time>,
+  stringify: value => value.toLocaleDateString(),
+})
 
-upperCaseFormatter.format("foo") // "FOO"
+dateFormatter.format(new Date()) // <time dateTime="2026-05-30T09:17:26.263Z">30/05/2026</time>
+dateFormatter.formatAsString(new Date()) // "30/05/2026"
 ```
 
-Consume formatters in your UI component library using a conventional `formatter` prop.
+Consume formatters in your UI component library via a conventional `formatter` prop.
 
-```js
-import { makeFormatter } from "afformative"
+```tsx
+import { Formatter } from "afformative"
+import { ReactNode } from "react"
 
-// This is usually the best default formatter.
-const identityFormatter = makeFormatter(value => value)
-
-const Select = ({ formatter = identityFormatter, items, ...otherProps }) => (
-  <select {...otherProps}>
-    {items.map(item => {
-      const text = formatter.format(item)
+interface ListProps<TItem> {
+  formatter: Formatter<TItem, ReactNode>
+  items: TItem[]
+}
 
-      return (
-        <option key={item} value={item}>
-          {text}
-        </option>
-      )
-    })}
-  </select>
+const List = <TItem extends unknown>({ formatter, items }: ListProps<TItem>) => (
+  <ul>
+    {items.map(item => (
+      <li key={formatter.stringify(item)}>{formatter.format(item)}</li>
+    ))}
+  </ul>
 )
 ```
 
-### Usage Context
-
-Although formatters can render icons or custom translation components, we often need to access primitive data instead of React elements.
+The `stringify` method is useful when you need a plain string representation of a value. For example, a combobox component can use it to match items against the user's typed input.
 
-> Lexicographic sorting of items based on translations is a typical real world example, especially when you are using a custom React component for visualising the translation keys alongside the actual translations.
+## Compare
 
-This is where usage suggestions comes into play. Suggestions can be used to tell formatters that a value needs to be rendered with some special care. For example, pass `"primitive"` to tell a formatter that it should return a primitive value, such as a string.
+Every formatter exposes a `compare` method, which can be used to sort values. The default implementation compares the return values of `stringify` via `localeCompare`. In the following example, `Amount` objects are sorted first by currency, then by value.
 
-```js
-import { makeFormatter } from "afformative"
+```tsx
+import { createFormatter } from "afformative"
+import { ReactNode } from "react"
 
-const booleanFormatter = makeFormatter((value, usageSuggestions) => {
-  if (usageSuggestions.includes("primitive")) {
-    return value ? "True" : "False"
-  }
+interface Amount {
+  currency: string
+  value: number
+}
 
-  return <Icon type={value ? "success" : "failure"} />
+const amountFormatter = createFormatter<Amount, ReactNode>({
+  format: ({ currency, value }) => (
+    <span className="currency">{`${currency} ${value.toFixed(2)}`}</span>
+  ),
+  stringify: ({ currency, value }) => `${currency} ${value.toFixed(2)}`,
+  compare: (a, b) => a.currency.localeCompare(b.currency) || a.value - b.value,
 })
 
-booleanFormatter.format(true) // <Icon type="success" />
-booleanFormatter.format(true, ["primitive"]) // "True"
+const amounts: Amount[] = [
+  { currency: "USD", value: 3 },
+  { currency: "EUR", value: 1 },
+  { currency: "EUR", value: 5 },
+  { currency: "USD", value: 2 },
+]
+
+amounts.sort(amountFormatter.compare)
+// [{ EUR, 1 }, { EUR, 5 }, { USD, 2 }, { USD, 3 }]
 ```
 
-All formatters also have the `formatAsPrimitive` method, which automatically passes the `"primitive"` suggestion in addition to all other suggestions.
+## Usage Context
 
-```js
-booleanFormatter.formatAsPrimitive(true) // "True"
-booleanFormatter.formatAsPrimitive(true, ["abbreviated"]) // "True"
-```
+You can pass an optional usage context object to all formatter methods. Let's use a dummy table component as an example.
+
+```tsx
+import { Formatter } from "afformative"
+import { ReactNode } from "react"
 
-You can also pass arbitrary data to formatters as the third argument: data context. Let's use a dummy table component as an example.
+interface TableFormatterUsageContext {
+  row: number[]
+  cellIndex: number
+}
+
+interface TableProps {
+  rows: number[][]
+  formatter: Formatter<number, ReactNode, TableFormatterUsageContext>
+}
 
-```js
-const Table = ({ rows, formatter = identityFormatter }) => (
+const Table = ({ rows, formatter }: TableProps) => (
   <table>
     {rows.map(row => (
       <tr>
         {row.map((cell, cellIndex) => (
-          <td>{formatter.format(cell, [], { row, cellIndex })}</td>
+          <td>{formatter.format(cell, { row, cellIndex })}</td>
         ))}
       </tr>
     ))}
@@ -121,72 +140,49 @@ const Table = ({ rows, formatter = identityFormatter }) => (
 )
 ```
 
-Data context allows the users of this table component to write purpose-built formatters, making it possible to take other values in the same row into account. For example, the following formatter would change the color of the cell value based on the previous value in the same row.
+Usage context allows the users of this table component to write purpose-built formatters, making it possible to take other values in the same row into account. For example, the following formatter would change the color of the cell value based on the previous value in the same row.
 
-```js
-const rowTrendFormatter = makeFormatter((value, suggestions, { row, cellIndex }) => {
-  if (cellIndex === 0) {
-    return <span>{value}</span>
-  }
+```tsx
+import { createFormatter } from "afformative"
+import { ReactNode } from "react"
 
-  const previousValue = row[cellIndex - 1]
+import { TableFormatterUsageContext } from "./Table"
 
-  return <span style={{ color: value >= previousValue ? "green" : "red" }}>{value}</span>
+const rowTrendFormatter = createFormatter<number, ReactNode, TableFormatterUsageContext>({
+  format: (value, { row, cellIndex }) => {
+    if (cellIndex === 0) {
+      return <span>{value}</span>
+    }
+
+    const previousValue = row[cellIndex - 1]
+
+    return <span style={{ color: value >= previousValue ? "green" : "red" }}>{value}</span>
+  },
 })
 ```
 
-Of course, this formatter only makes sense for our table component, nowhere else.
+This formatter only makes sense in the context of our table component.
 
-Because `row` and `cellIndex` are passed as the data context, the formatter still receives just the cell value as its first parameter! This allows us to pass other generic formatters (e.g. a currency formatter) to the table component without having to worry about the value structure.
+Because `row` and `cellIndex` are passed as the usage context, the formatter still receives only the cell value as its first parameter. This means generic formatters (e.g. a currency formatter) can be passed to the table component without any changes.
 
-### Accessing React Context Reliably
+## Accessing React Context
 
-Use hooks.
+Create formatters inside custom hooks to access React context values such as translations or application state.
 
-```js
-const useEnumFormatter = enumType => {
-  // `useSelector` is from `react-redux`, `useIntl` from `react-intl`.
-  // `makeSelectEnumTranslationKeys` is a made-up Redux selector factory.
-  const enumTranslationKeys = useSelector(makeSelectEnumTranslationKeys(enumType))
+```tsx
+const useEnumFormatter = (enumType: string): Formatter<string, ReactNode> => {
+  const enumTranslationKeys = useSelector(selectEnumTranslationKeys(enumType))
   const intl = useIntl()
 
   return useMemo(
     () =>
-      makeFormatter(value =>
-        intl.formatMessage({
-          defaultMessage: value,
-          id: enumTranslationKeys[value],
-        }),
+      createFormatter<string, ReactNode>(
+        value => <FormattedMessage defaultMessage={value} id={enumTranslationKeys[value]} />,
+        value => intl.formatMessage({ defaultMessage: value, id: enumTranslationKeys[value] }),
       ),
     [intl, enumTranslationKeys],
   )
 }
-
-const someEnumFormatter = useEnumFormatter("someEnum")
-```
-
-### Consuming Formatters
-
-As mentioned earlier, formatters should be passed to components using the conventional `formatter` prop. Alternatively, if you need to pass multiple formatters (e.g. in case of column definitions), pass an array of objects where each object has a `formatter` property.
-
-All formatters also expose the `wrap` method. You can use this method to alter the behaviour of the formatter for some specific values.
-
-```js
-const useSnowflakeAwareFormatter = formatter => {
-  const intl = useIntl()
-
-  return useMemo(
-    () =>
-      formatter.wrap((delegate, value) => {
-        if (isSnowflake(value)) {
-          return intl.formatMessage(messages.snowflake)
-        }
-
-        return delegate(value)
-      }),
-    [formatter, intl],
-  )
-}
 ```
 
 ## Changelog

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+//#region src/createFormatter.d.ts
+interface FormatterFormatDefinition<TInput, TOutput, TUsageContext extends object = object> {
+  (value: TInput, usageContext: Partial<TUsageContext>): TOutput;
+}
+interface FormatterFormat<TInput, TOutput, TUsageContext extends object = object> {
+  (value: TInput, usageContext?: Partial<TUsageContext>): TOutput;
+}
+interface FormatterStringifyDefinition<TInput, TUsageContext extends object = object> {
+  (value: TInput, usageContext: Partial<TUsageContext>): string;
+}
+interface FormatterStringify<TInput, TUsageContext extends object = object> {
+  (value: TInput, usageContext?: Partial<TUsageContext>): string;
+}
+interface FormatterCompareDefinition<TInput, TUsageContext extends object = object> {
+  (a: TInput, b: TInput, usageContext: Partial<TUsageContext>): number;
+}
+interface FormatterCompare<TInput, TUsageContext extends object = object> {
+  (a: TInput, b: TInput, usageContext?: Partial<TUsageContext>): number;
+}
+interface Formatter<TInput, TOutput, TUsageContext extends object = object> {
+  compare: FormatterCompare<TInput, TUsageContext>;
+  format: FormatterFormat<TInput, TOutput, TUsageContext>;
+  stringify: FormatterStringify<TInput, TUsageContext>;
+  name?: string;
+}
+interface CreateFormatterParam<TInput, TOutput, TUsageContext extends object = object> {
+  compare?: FormatterCompareDefinition<TInput, TUsageContext>;
+  format: FormatterFormatDefinition<TInput, TOutput, TUsageContext>;
+  stringify?: FormatterStringifyDefinition<TInput, TUsageContext>;
+}
+declare const createFormatter: <TInput, TOutput, TUsageContext extends object = object>(param: CreateFormatterParam<TInput, TOutput, TUsageContext>) => Formatter<TInput, TOutput, TUsageContext>;
+//#endregion
+export { CreateFormatterParam, Formatter, FormatterCompare, FormatterCompareDefinition, FormatterFormat, FormatterFormatDefinition, FormatterStringify, FormatterStringifyDefinition, createFormatter };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+//#region src/createFormatter.ts
+const createFormatter = (param) => {
+	const { format: formatParam, stringify: stringifyParam, compare: compareParam, ...rest } = param;
+	const format = (value, usageContext) => formatParam(value, usageContext ?? {});
+	const stringify = stringifyParam ? (value, usageContext) => stringifyParam(value, usageContext ?? {}) : (value, usageContext) => String(format(value, usageContext ?? {}));
+	return {
+		compare: compareParam ? (a, b, usageContext) => compareParam(a, b, usageContext ?? {}) : (a, b, usageContext) => stringify(a, usageContext ?? {}).localeCompare(stringify(b, usageContext ?? {})),
+		format,
+		stringify,
+		...rest
+	};
+};
+//#endregion
+export { createFormatter };

package/package.json

@@ -1,11 +1,6 @@
 {
   "name": "afformative",
-  "version": "0.6.2",
-  "license": "MIT",
-  "main": "dist/afformative.cjs.js",
-  "module": "dist/afformative.esm.js",
-  "unpkg": "dist/afformative.umd.js",
-  "types": "dist/types/index.d.ts",
+  "version": "0.7.0-beta.1",
   "description": "A standardized way to format values in your React components.",
   "keywords": [
     "react",
@@ -24,15 +19,43 @@
     "values"
   ],
   "repository": "https://github.com/wafflepie/afformative",
+  "license": "MIT",
   "contributors": [
-    "Vaclav Jancarik <vaclav.janc@gmail.com>"
+    "Vaclav Jancarik <hi@wafflepie.dev>"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
   ],
-  "dependencies": {
-    "@babel/runtime": "^7.12.1"
+  "scripts": {
+    "build": "tsdown",
+    "prepublishOnly": "pnpm run build",
+    "release": "bumpp",
+    "test": "pnpm test:prettier && pnpm run test:typescript && pnpm run test:eslint && pnpm run test:vitest",
+    "test:eslint": "eslint src",
+    "test:prettier": "prettier --check src",
+    "test:typescript": "tsc --noEmit",
+    "test:vitest": "vitest run"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.2",
+    "@typescript/native-preview": "^7.0.0-dev.20260527.2",
+    "bumpp": "^11.1.0",
+    "eslint": "^10.4.1",
+    "prettier": "^3.8.3",
+    "tsdown": "^0.22.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.60.0",
+    "vitest": "^4.1.7"
   },
+  "packageManager": "pnpm@11.5.0+sha512.dbfcc4f81cf48597afd4bc391ffdf12c11f1a9fb83a395bfa6b0a2d9cc2fd8ffebafdb1ccbd529632153f793904c2615b7f09fe1a345473fd1c35845172a8eb1",
   "publishConfig": {
     "access": "public"
-  },
-  "sideEffects": false,
-  "gitHead": "3e3b893eee2b69d29019b3683b9d1d719192a2b5"
+  }
 }

package/dist/afformative.cjs.js

@@ -1,73 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var _toConsumableArray = require('@babel/runtime/helpers/toConsumableArray');
-var _objectWithoutProperties = require('@babel/runtime/helpers/objectWithoutProperties');
-
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-var _toConsumableArray__default = /*#__PURE__*/_interopDefaultLegacy(_toConsumableArray);
-var _objectWithoutProperties__default = /*#__PURE__*/_interopDefaultLegacy(_objectWithoutProperties);
-
-// TODO: Update `FormatDefinition` type based on this snippet. Sadly, TypeScript cannot correctly
-// verify the return type of the format definition based on the suggestions, printing errors such
-// as `Type 'string' is not assignable to type '"primitive" extends TSuggestion ? string : string'`
-// which is, of course, nonsense. Same applies to `FormatChainDefinition`.
-//
-//   interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-//     <TSuggestion extends Suggestion>(
-//       value: TInput,
-//       usageSuggestions: TSuggestion[],
-//       dataContext: Partial<TDataContext>,
-//     ): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput
-//   }
-
-/**
- * Creates a new formatter.
- *
- * @param format Function used to format the value.
- * @param formatterOptions Additional options for the formatter.
- */
-var makeFormatter = function makeFormatter(format, formatterOptions) {
-  var formatter = function formatter(_ref) {
-    var _format;
-
-    var children = _ref.children,
-        _ref$suggestions = _ref.suggestions,
-        suggestions = _ref$suggestions === void 0 ? [] : _ref$suggestions,
-        dataContext = _objectWithoutProperties__default['default'](_ref, ["children", "suggestions"]);
-
-    return (_format = format(children, suggestions, dataContext)) !== null && _format !== void 0 ? _format : null;
-  };
-
-  formatter.displayName = formatterOptions === null || formatterOptions === void 0 ? void 0 : formatterOptions.displayName;
-
-  formatter.format = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, usageSuggestions, dataContext);
-  };
-
-  formatter.formatAsPrimitive = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, ["primitive"].concat(_toConsumableArray__default['default'](usageSuggestions)), dataContext);
-  };
-
-  formatter.wrap = function (nextFormat, nextFormatterOptions) {
-    var nextFormatter = makeFormatter(function (value, usageSuggestions, dataContext) {
-      var delegate = function delegate(delegatedValue, delegatedUsageSuggestions, delegatedDataContext) {
-        return formatter.format(delegatedValue, delegatedUsageSuggestions !== null && delegatedUsageSuggestions !== void 0 ? delegatedUsageSuggestions : usageSuggestions, delegatedDataContext !== null && delegatedDataContext !== void 0 ? delegatedDataContext : dataContext);
-      };
-
-      return nextFormat(delegate, value, usageSuggestions, dataContext);
-    }, nextFormatterOptions !== null && nextFormatterOptions !== void 0 ? nextFormatterOptions : formatterOptions);
-    nextFormatter.innerFormatter = formatter;
-    return nextFormatter;
-  };
-
-  return formatter;
-};
-
-exports.makeFormatter = makeFormatter;

package/dist/afformative.esm.js

@@ -1,64 +0,0 @@
-import _toConsumableArray from '@babel/runtime/helpers/esm/toConsumableArray';
-import _objectWithoutProperties from '@babel/runtime/helpers/esm/objectWithoutProperties';
-
-// TODO: Update `FormatDefinition` type based on this snippet. Sadly, TypeScript cannot correctly
-// verify the return type of the format definition based on the suggestions, printing errors such
-// as `Type 'string' is not assignable to type '"primitive" extends TSuggestion ? string : string'`
-// which is, of course, nonsense. Same applies to `FormatChainDefinition`.
-//
-//   interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-//     <TSuggestion extends Suggestion>(
-//       value: TInput,
-//       usageSuggestions: TSuggestion[],
-//       dataContext: Partial<TDataContext>,
-//     ): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput
-//   }
-
-/**
- * Creates a new formatter.
- *
- * @param format Function used to format the value.
- * @param formatterOptions Additional options for the formatter.
- */
-var makeFormatter = function makeFormatter(format, formatterOptions) {
-  var formatter = function formatter(_ref) {
-    var _format;
-
-    var children = _ref.children,
-        _ref$suggestions = _ref.suggestions,
-        suggestions = _ref$suggestions === void 0 ? [] : _ref$suggestions,
-        dataContext = _objectWithoutProperties(_ref, ["children", "suggestions"]);
-
-    return (_format = format(children, suggestions, dataContext)) !== null && _format !== void 0 ? _format : null;
-  };
-
-  formatter.displayName = formatterOptions === null || formatterOptions === void 0 ? void 0 : formatterOptions.displayName;
-
-  formatter.format = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, usageSuggestions, dataContext);
-  };
-
-  formatter.formatAsPrimitive = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, ["primitive"].concat(_toConsumableArray(usageSuggestions)), dataContext);
-  };
-
-  formatter.wrap = function (nextFormat, nextFormatterOptions) {
-    var nextFormatter = makeFormatter(function (value, usageSuggestions, dataContext) {
-      var delegate = function delegate(delegatedValue, delegatedUsageSuggestions, delegatedDataContext) {
-        return formatter.format(delegatedValue, delegatedUsageSuggestions !== null && delegatedUsageSuggestions !== void 0 ? delegatedUsageSuggestions : usageSuggestions, delegatedDataContext !== null && delegatedDataContext !== void 0 ? delegatedDataContext : dataContext);
-      };
-
-      return nextFormat(delegate, value, usageSuggestions, dataContext);
-    }, nextFormatterOptions !== null && nextFormatterOptions !== void 0 ? nextFormatterOptions : formatterOptions);
-    nextFormatter.innerFormatter = formatter;
-    return nextFormatter;
-  };
-
-  return formatter;
-};
-
-export { makeFormatter };

package/dist/afformative.umd.js

@@ -1,140 +0,0 @@
-(function (global, factory) {
-typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-typeof define === 'function' && define.amd ? define(['exports'], factory) :
-(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.Afformative = {}));
-}(this, (function (exports) { 'use strict';
-
-function _arrayLikeToArray(arr, len) {
-  if (len == null || len > arr.length) len = arr.length;
-
-  for (var i = 0, arr2 = new Array(len); i < len; i++) {
-    arr2[i] = arr[i];
-  }
-
-  return arr2;
-}
-
-function _arrayWithoutHoles(arr) {
-  if (Array.isArray(arr)) return _arrayLikeToArray(arr);
-}
-
-function _iterableToArray(iter) {
-  if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
-}
-
-function _unsupportedIterableToArray(o, minLen) {
-  if (!o) return;
-  if (typeof o === "string") return _arrayLikeToArray(o, minLen);
-  var n = Object.prototype.toString.call(o).slice(8, -1);
-  if (n === "Object" && o.constructor) n = o.constructor.name;
-  if (n === "Map" || n === "Set") return Array.from(o);
-  if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen);
-}
-
-function _nonIterableSpread() {
-  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
-
-function _toConsumableArray(arr) {
-  return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread();
-}
-
-function _objectWithoutPropertiesLoose(source, excluded) {
-  if (source == null) return {};
-  var target = {};
-  var sourceKeys = Object.keys(source);
-  var key, i;
-
-  for (i = 0; i < sourceKeys.length; i++) {
-    key = sourceKeys[i];
-    if (excluded.indexOf(key) >= 0) continue;
-    target[key] = source[key];
-  }
-
-  return target;
-}
-
-function _objectWithoutProperties(source, excluded) {
-  if (source == null) return {};
-  var target = _objectWithoutPropertiesLoose(source, excluded);
-  var key, i;
-
-  if (Object.getOwnPropertySymbols) {
-    var sourceSymbolKeys = Object.getOwnPropertySymbols(source);
-
-    for (i = 0; i < sourceSymbolKeys.length; i++) {
-      key = sourceSymbolKeys[i];
-      if (excluded.indexOf(key) >= 0) continue;
-      if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
-      target[key] = source[key];
-    }
-  }
-
-  return target;
-}
-
-// TODO: Update `FormatDefinition` type based on this snippet. Sadly, TypeScript cannot correctly
-// verify the return type of the format definition based on the suggestions, printing errors such
-// as `Type 'string' is not assignable to type '"primitive" extends TSuggestion ? string : string'`
-// which is, of course, nonsense. Same applies to `FormatChainDefinition`.
-//
-//   interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-//     <TSuggestion extends Suggestion>(
-//       value: TInput,
-//       usageSuggestions: TSuggestion[],
-//       dataContext: Partial<TDataContext>,
-//     ): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput
-//   }
-
-/**
- * Creates a new formatter.
- *
- * @param format Function used to format the value.
- * @param formatterOptions Additional options for the formatter.
- */
-var makeFormatter = function makeFormatter(format, formatterOptions) {
-  var formatter = function formatter(_ref) {
-    var _format;
-
-    var children = _ref.children,
-        _ref$suggestions = _ref.suggestions,
-        suggestions = _ref$suggestions === void 0 ? [] : _ref$suggestions,
-        dataContext = _objectWithoutProperties(_ref, ["children", "suggestions"]);
-
-    return (_format = format(children, suggestions, dataContext)) !== null && _format !== void 0 ? _format : null;
-  };
-
-  formatter.displayName = formatterOptions === null || formatterOptions === void 0 ? void 0 : formatterOptions.displayName;
-
-  formatter.format = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, usageSuggestions, dataContext);
-  };
-
-  formatter.formatAsPrimitive = function (value) {
-    var usageSuggestions = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-    var dataContext = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
-    return format(value, ["primitive"].concat(_toConsumableArray(usageSuggestions)), dataContext);
-  };
-
-  formatter.wrap = function (nextFormat, nextFormatterOptions) {
-    var nextFormatter = makeFormatter(function (value, usageSuggestions, dataContext) {
-      var delegate = function delegate(delegatedValue, delegatedUsageSuggestions, delegatedDataContext) {
-        return formatter.format(delegatedValue, delegatedUsageSuggestions !== null && delegatedUsageSuggestions !== void 0 ? delegatedUsageSuggestions : usageSuggestions, delegatedDataContext !== null && delegatedDataContext !== void 0 ? delegatedDataContext : dataContext);
-      };
-
-      return nextFormat(delegate, value, usageSuggestions, dataContext);
-    }, nextFormatterOptions !== null && nextFormatterOptions !== void 0 ? nextFormatterOptions : formatterOptions);
-    nextFormatter.innerFormatter = formatter;
-    return nextFormatter;
-  };
-
-  return formatter;
-};
-
-exports.makeFormatter = makeFormatter;
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-})));

package/dist/afformative.umd.min.js

@@ -1 +0,0 @@
-!function(t,r){"object"==typeof exports&&"undefined"!=typeof module?r(exports):"function"==typeof define&&define.amd?define(["exports"],r):r((t="undefined"!=typeof globalThis?globalThis:t||self).Afformative={})}(this,(function(t){"use strict";function r(t,r){(null==r||r>t.length)&&(r=t.length);for(var e=0,n=Array(r);r>e;e++)n[e]=t[e];return n}function e(t){return function(t){if(Array.isArray(t))return r(t)}(t)||function(t){if("undefined"!=typeof Symbol&&null!=t[Symbol.iterator]||null!=t["@@iterator"])return Array.from(t)}(t)||function(t,e){if(t){if("string"==typeof t)return r(t,e);var n=Object.prototype.toString.call(t).slice(8,-1);return"Object"===n&&t.constructor&&(n=t.constructor.name),"Map"===n||"Set"===n?Array.from(t):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?r(t,e):void 0}}(t)||function(){throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}function n(t,r){if(null==t)return{};var e,n,o=function(t,r){if(null==t)return{};var e,n,o={},i=Object.keys(t);for(n=0;i.length>n;n++)0>r.indexOf(e=i[n])&&(o[e]=t[e]);return o}(t,r);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);for(n=0;i.length>n;n++)0>r.indexOf(e=i[n])&&Object.prototype.propertyIsEnumerable.call(t,e)&&(o[e]=t[e])}return o}t.makeFormatter=function t(r,o){var i=function(t){var e,o=t.children,i=t.suggestions,u=void 0===i?[]:i,l=n(t,["children","suggestions"]);return null!==(e=r(o,u,l))&&void 0!==e?e:null};return i.displayName=null==o?void 0:o.displayName,i.format=function(t){var e=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[],n=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};return r(t,e,n)},i.formatAsPrimitive=function(t){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:[],o=arguments.length>2&&void 0!==arguments[2]?arguments[2]:{};return r(t,["primitive"].concat(e(n)),o)},i.wrap=function(r,e){var n=t((function(t,e,n){return r((function(t,r,o){return i.format(t,null!=r?r:e,null!=o?o:n)}),t,e,n)}),null!=e?e:o);return n.innerFormatter=i,n},i},Object.defineProperty(t,"__esModule",{value:!0})}));

package/dist/types/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./makeFormatter";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/types/makeFormatter.d.ts

@@ -1,94 +0,0 @@
-declare type PrimitiveSuggestion = "primitive";
-declare type SemanticSuggestion = "abbreviated" | "icon" | "verbose";
-declare type Suggestion = PrimitiveSuggestion | SemanticSuggestion;
-interface FormatterOptions {
-    /** Formatter name, useful for debugging or advanced pattern matching. */
-    displayName?: string;
-}
-declare type DataContext = Record<string, any>;
-interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-    (
-    /** Value to format. */
-    value: TInput, 
-    /** Suggestions passed by the consumer of a formatter. */
-    usageSuggestions: Suggestion[], 
-    /** Additional data context to be used by the formatter. */
-    dataContext: Partial<TDataContext>): TOutput | TPrimitiveOutput;
-}
-interface FormatMethod<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-    <TSuggestion extends Suggestion>(
-    /** Value to format. */
-    value: TInput, 
-    /** Suggestions the formatter should take note of. */
-    usageSuggestions?: TSuggestion[], 
-    /** Additional data context the formatter might find useful. */
-    dataContext?: Partial<TDataContext>): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput;
-}
-interface FormatAsPrimitiveMethod<TInput, TPrimitiveOutput, TDataContext extends DataContext> {
-    (
-    /** Value to format. */
-    value: TInput, 
-    /** Suggestions the formatter should take note of in addition to `primitive`. */
-    usageSuggestions?: Suggestion[], 
-    /** Additional data context the formatter might find useful. */
-    dataContext?: Partial<TDataContext>): TPrimitiveOutput;
-}
-interface FormatChainDefinition<TInnerInput, TInnerOutput, TInnerPrimitiveInput, TInnerDataContext extends DataContext, TOuterInput, TOuterOutput, TOuterPrimitiveOutput, TOuterDataContext extends DataContext> {
-    (
-    /**
-     * The `formatter.format` method which can be used to delegate the formatting
-     * to the wrapped formatter. Delegation is simplified so if no suggestions or contextual
-     * props are passed, the original ones are used instead.
-     */
-    delegate: FormatMethod<TInnerInput, TInnerOutput, TInnerPrimitiveInput, TInnerDataContext>, 
-    /** Value to format. */
-    value: TOuterInput, 
-    /** Suggestions the formatter should take note of. */
-    usageSuggestions: Suggestion[], 
-    /** Additional data context the formatter might find useful. */
-    dataContext: Partial<TOuterDataContext>): TOuterOutput | TOuterPrimitiveOutput;
-}
-declare type FormatterProps<TInput, TDataContext extends DataContext> = {
-    /** Value to format. */
-    children: TInput;
-    /** Suggestions the formatter should take note of. */
-    suggestions?: Suggestion[];
-} & Partial<TDataContext>;
-export interface Formatter<TInput, TOutput, TPrimitiveOutput = TOutput, TDataContext extends DataContext = DataContext> {
-    /** Formatter name, useful for debugging or advanced pattern matching. */
-    displayName?: string;
-    /** Formats a value. */
-    format: FormatMethod<TInput, TOutput, TPrimitiveOutput, TDataContext>;
-    /** Formats a value with the `primitive` suggestion. */
-    formatAsPrimitive: FormatAsPrimitiveMethod<TInput, TPrimitiveOutput, TDataContext>;
-    /** The callee of the `.wrap` method used to produce this formatter. */
-    innerFormatter?: Formatter<any, any, any, any>;
-    /**
-     * Creates a new formatter from an existing one. Allows overriding of formatter behaviour
-     * for certain values.
-     */
-    wrap: <TNextInput = TInput, TNextOutput = TOutput, TNextPrimitiveOutput = TPrimitiveOutput, TNextDataContext extends DataContext = TDataContext>(
-    /**
-     * Function used to format the value. Has the same signature as the one passed
-     * to `makeFormatter`, except a `delegate` function is passed in the first position.
-     * This function can be used to delegate formatting to the original (inner) formatter.
-     */
-    nextFormat: FormatChainDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext, TNextInput, TNextOutput, TNextPrimitiveOutput, TNextDataContext>, 
-    /** New formatter options, replacing the original ones. */
-    nextFormatterOptions?: FormatterOptions) => Formatter<TNextInput, TNextOutput, TNextPrimitiveOutput, TNextDataContext>;
-    /**
-     * Backwards-compatible way to use the formatter as a React component.
-     *
-     * @deprecated Since v0.6.0. Prefer using the `Formatter.format` method instead.
-     */
-    (props: FormatterProps<TInput, TDataContext>): TOutput | TPrimitiveOutput | null;
-}
-/**
- * Creates a new formatter.
- *
- * @param format Function used to format the value.
- * @param formatterOptions Additional options for the formatter.
- */
-export declare const makeFormatter: <TInput, TOutput, TPrimitiveOutput = TOutput, TDataContext extends DataContext = DataContext>(format: FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext>, formatterOptions?: FormatterOptions | undefined) => Formatter<TInput, TOutput, TPrimitiveOutput, TDataContext>;
-export {};
-//# sourceMappingURL=makeFormatter.d.ts.map

package/dist/types/makeFormatter.d.ts.map

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

package/src/index.ts

@@ -1 +0,0 @@
-export * from "./makeFormatter"

package/src/makeFormatter.test.ts

@@ -1,159 +0,0 @@
-import { makeFormatter } from "./makeFormatter"
-
-const toUpperCase = (string: string) => string.toUpperCase()
-
-describe("makeFormatter", () => {
-  it("handles trivial formatting", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase)
-    expect(formatter.format("foo")).toBe("FOO")
-  })
-
-  it("accepts a `name` option", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase, { displayName: "UpperFormatter" })
-    expect(formatter.displayName).toBe("UpperFormatter")
-  })
-
-  it("passes `suggestions` to `format`", () => {
-    const formatter = makeFormatter<string, string>((value, suggestions) => {
-      if (suggestions.includes("abbreviated")) {
-        return value[0]
-      }
-
-      return value
-    })
-
-    expect(formatter.format("foo", ["abbreviated"])).toBe("f")
-    expect(formatter.format("foo", [])).toBe("foo")
-    expect(formatter.format("foo")).toBe("foo")
-  })
-
-  it("handles formatting with the `primitive` suggestion", () => {
-    type Structure = { value: string }
-
-    const formatter = makeFormatter<Structure, Structure, string>((value, suggestions) => {
-      if (suggestions.includes("primitive")) {
-        return value.value
-      }
-
-      return value
-    })
-
-    expect(formatter.format({ value: "foo" }, ["primitive"])).toBe("foo")
-    expect(formatter.formatAsPrimitive({ value: "foo" })).toBe("foo")
-    expect(formatter.formatAsPrimitive({ value: "foo" }, ["primitive"])).toBe("foo")
-  })
-
-  it("supports simple behavior wrapping", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase)
-
-    const wrappedFormatter = formatter.wrap((delegate, value) =>
-      value === "foo" ? "override" : delegate(value),
-    )
-
-    expect(wrappedFormatter.format("foo")).toBe("override")
-    expect(wrappedFormatter.format("bar")).toBe("BAR")
-  })
-
-  it("supports simple behavior wrapping with suggestions", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase)
-
-    const wrappedFormatter = formatter.wrap((delegate, value, suggestions) =>
-      value === "foo" && suggestions.includes("abbreviated") ? "f" : delegate(value),
-    )
-
-    expect(wrappedFormatter.format("foo")).toBe("FOO")
-    expect(wrappedFormatter.format("foo", ["abbreviated"])).toBe("f")
-    expect(wrappedFormatter.format("bar")).toBe("BAR")
-  })
-
-  it("supports simple behavior wrapping with the `primitive` suggestion", () => {
-    type Structure = { value: string }
-
-    const formatter = makeFormatter<string, string>(toUpperCase)
-
-    const wrappedFormatter = formatter.wrap<Structure, Structure, string>(
-      (delegate, value, suggestions) => (suggestions.includes("primitive") ? value.value : value),
-    )
-
-    expect(wrappedFormatter.format({ value: "foo" }, ["primitive"])).toBe("foo")
-    expect(wrappedFormatter.formatAsPrimitive({ value: "foo" })).toBe("foo")
-    expect(wrappedFormatter.formatAsPrimitive({ value: "foo" }, ["primitive"])).toBe("foo")
-  })
-
-  it("supports simple behavior wrapping with data context", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase)
-
-    interface WrappedDataContext {
-      forcedValue?: string
-    }
-
-    const wrappedFormatter = formatter.wrap(
-      (delegate, value, suggestions, { forcedValue }: WrappedDataContext) =>
-        forcedValue ?? delegate(value),
-    )
-
-    expect(wrappedFormatter.format("foo")).toBe("FOO")
-    expect(wrappedFormatter.format("foo", undefined, { forcedValue: "override" })).toBe("override")
-  })
-
-  it("passes the original suggestions when they are not passed manually to `format` when wrapping", () => {
-    const formatter = makeFormatter<string, string>((value, suggestions) => {
-      if (suggestions.includes("abbreviated")) {
-        return value[0]
-      }
-
-      return value
-    })
-
-    const wrappedFormatter = formatter.wrap((delegate, value) => delegate(value))
-    expect(wrappedFormatter.format("foo", ["abbreviated"])).toBe("f")
-  })
-
-  it("sets the `innerFormatter` static property when wrapping", () => {
-    const formatter = makeFormatter<string, string>(toUpperCase)
-    const wrappedFormatter = formatter.wrap((delegate, value) => delegate(value))
-    expect(wrappedFormatter.innerFormatter).toBe(formatter)
-  })
-
-  it("handles complex wrapping with structural changes", () => {
-    interface BasicDataContext {
-      index?: number
-    }
-
-    const basicFormatter = makeFormatter(
-      (value: string, suggestions, dataContext: BasicDataContext): string | undefined =>
-        value[dataContext.index ?? 0],
-    )
-
-    expect(basicFormatter.format("test", [], { index: 2 })).toBe("s")
-
-    interface ComplexStructure {
-      index: number
-      value: string
-    }
-
-    interface ComplexDataContext {
-      getIndex?: (structure: ComplexStructure) => number
-    }
-
-    const complexFormatter = basicFormatter.wrap(
-      (delegate, value: ComplexStructure, suggestions, dataContext: ComplexDataContext) =>
-        delegate(value.value, suggestions, { index: dataContext.getIndex?.(value) }),
-    )
-
-    expect(complexFormatter.format({ index: 3, value: "procrastination" })).toBe("p")
-
-    expect(
-      complexFormatter.format({ index: 3, value: "procrastination" }, [], {
-        getIndex: ({ index }) => index,
-      }),
-    ).toBe("c")
-
-    const boundComplexFormatter = complexFormatter.wrap(
-      (delegate, value, suggestions, dataContext) =>
-        delegate(value, suggestions, { ...dataContext, getIndex: ({ index }) => index }),
-    )
-
-    expect(boundComplexFormatter.format({ index: 2, value: "swag" })).toBe("a")
-  })
-})

package/src/makeFormatter.ts

@@ -1,214 +0,0 @@
-type PrimitiveSuggestion = "primitive"
-type SemanticSuggestion = "abbreviated" | "icon" | "verbose"
-type Suggestion = PrimitiveSuggestion | SemanticSuggestion
-
-interface FormatterOptions {
-  /** Formatter name, useful for debugging or advanced pattern matching. */
-  displayName?: string
-}
-
-type DataContext = Record<string, any>
-
-// TODO: Update `FormatDefinition` type based on this snippet. Sadly, TypeScript cannot correctly
-// verify the return type of the format definition based on the suggestions, printing errors such
-// as `Type 'string' is not assignable to type '"primitive" extends TSuggestion ? string : string'`
-// which is, of course, nonsense. Same applies to `FormatChainDefinition`.
-//
-//   interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-//     <TSuggestion extends Suggestion>(
-//       value: TInput,
-//       usageSuggestions: TSuggestion[],
-//       dataContext: Partial<TDataContext>,
-//     ): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput
-//   }
-
-interface FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-  (
-    /** Value to format. */
-    value: TInput,
-    /** Suggestions passed by the consumer of a formatter. */
-    usageSuggestions: Suggestion[],
-    /** Additional data context to be used by the formatter. */
-    dataContext: Partial<TDataContext>,
-  ): TOutput | TPrimitiveOutput
-}
-
-interface FormatMethod<TInput, TOutput, TPrimitiveOutput, TDataContext extends DataContext> {
-  <TSuggestion extends Suggestion>(
-    /** Value to format. */
-    value: TInput,
-    /** Suggestions the formatter should take note of. */
-    usageSuggestions?: TSuggestion[],
-    /** Additional data context the formatter might find useful. */
-    dataContext?: Partial<TDataContext>,
-  ): PrimitiveSuggestion extends TSuggestion ? TPrimitiveOutput : TOutput
-}
-
-interface FormatAsPrimitiveMethod<TInput, TPrimitiveOutput, TDataContext extends DataContext> {
-  (
-    /** Value to format. */
-    value: TInput,
-    /** Suggestions the formatter should take note of in addition to `primitive`. */
-    usageSuggestions?: Suggestion[],
-    /** Additional data context the formatter might find useful. */
-    dataContext?: Partial<TDataContext>,
-  ): TPrimitiveOutput
-}
-
-interface FormatChainDefinition<
-  TInnerInput,
-  TInnerOutput,
-  TInnerPrimitiveInput,
-  TInnerDataContext extends DataContext,
-  TOuterInput,
-  TOuterOutput,
-  TOuterPrimitiveOutput,
-  TOuterDataContext extends DataContext
-> {
-  (
-    /**
-     * The `formatter.format` method which can be used to delegate the formatting
-     * to the wrapped formatter. Delegation is simplified so if no suggestions or contextual
-     * props are passed, the original ones are used instead.
-     */
-    delegate: FormatMethod<TInnerInput, TInnerOutput, TInnerPrimitiveInput, TInnerDataContext>,
-    /** Value to format. */
-    value: TOuterInput,
-    /** Suggestions the formatter should take note of. */
-    usageSuggestions: Suggestion[],
-    /** Additional data context the formatter might find useful. */
-    dataContext: Partial<TOuterDataContext>,
-  ): TOuterOutput | TOuterPrimitiveOutput
-}
-
-type FormatterProps<TInput, TDataContext extends DataContext> = {
-  /** Value to format. */
-  children: TInput
-  /** Suggestions the formatter should take note of. */
-  suggestions?: Suggestion[]
-} & Partial<TDataContext>
-
-export interface Formatter<
-  TInput,
-  TOutput,
-  TPrimitiveOutput = TOutput,
-  TDataContext extends DataContext = DataContext
-> {
-  /** Formatter name, useful for debugging or advanced pattern matching. */
-  displayName?: string
-  /** Formats a value. */
-  format: FormatMethod<TInput, TOutput, TPrimitiveOutput, TDataContext>
-  /** Formats a value with the `primitive` suggestion. */
-  formatAsPrimitive: FormatAsPrimitiveMethod<TInput, TPrimitiveOutput, TDataContext>
-  /** The callee of the `.wrap` method used to produce this formatter. */
-  innerFormatter?: Formatter<any, any, any, any>
-  /**
-   * Creates a new formatter from an existing one. Allows overriding of formatter behaviour
-   * for certain values.
-   */
-  wrap: <
-    TNextInput = TInput,
-    TNextOutput = TOutput,
-    TNextPrimitiveOutput = TPrimitiveOutput,
-    TNextDataContext extends DataContext = TDataContext
-  >(
-    /**
-     * Function used to format the value. Has the same signature as the one passed
-     * to `makeFormatter`, except a `delegate` function is passed in the first position.
-     * This function can be used to delegate formatting to the original (inner) formatter.
-     */
-    nextFormat: FormatChainDefinition<
-      TInput,
-      TOutput,
-      TPrimitiveOutput,
-      TDataContext,
-      TNextInput,
-      TNextOutput,
-      TNextPrimitiveOutput,
-      TNextDataContext
-    >,
-    /** New formatter options, replacing the original ones. */
-    nextFormatterOptions?: FormatterOptions,
-  ) => Formatter<TNextInput, TNextOutput, TNextPrimitiveOutput, TNextDataContext>
-  /**
-   * Backwards-compatible way to use the formatter as a React component.
-   *
-   * @deprecated Since v0.6.0. Prefer using the `Formatter.format` method instead.
-   */
-  (props: FormatterProps<TInput, TDataContext>): TOutput | TPrimitiveOutput | null
-}
-
-/**
- * Creates a new formatter.
- *
- * @param format Function used to format the value.
- * @param formatterOptions Additional options for the formatter.
- */
-export const makeFormatter = <
-  TInput,
-  TOutput,
-  TPrimitiveOutput = TOutput,
-  TDataContext extends DataContext = DataContext
->(
-  format: FormatDefinition<TInput, TOutput, TPrimitiveOutput, TDataContext>,
-  formatterOptions?: FormatterOptions,
-): Formatter<TInput, TOutput, TPrimitiveOutput, TDataContext> => {
-  const formatter: Formatter<TInput, TOutput, TPrimitiveOutput, TDataContext> = ({
-    children,
-    suggestions = [],
-    ...dataContext
-  }) => format(children, suggestions, dataContext as any) ?? null
-
-  formatter.displayName = formatterOptions?.displayName
-
-  formatter.format = (value, usageSuggestions = [], dataContext = {}) =>
-    format(value, usageSuggestions, dataContext) as any
-
-  formatter.formatAsPrimitive = (value, usageSuggestions = [], dataContext = {}) =>
-    format(value, ["primitive", ...usageSuggestions], dataContext) as any
-
-  formatter.wrap = <
-    TNextInput,
-    TNextOutput,
-    TNextPrimitiveOutput,
-    TNextDataContext extends DataContext
-  >(
-    nextFormat: FormatChainDefinition<
-      TInput,
-      TOutput,
-      TPrimitiveOutput,
-      TDataContext,
-      TNextInput,
-      TNextOutput,
-      TNextPrimitiveOutput,
-      TNextDataContext
-    >,
-    nextFormatterOptions?: FormatterOptions,
-  ) => {
-    const nextFormatter: Formatter<
-      TNextInput,
-      TNextOutput,
-      TNextPrimitiveOutput,
-      TNextDataContext
-    > = makeFormatter((value, usageSuggestions, dataContext) => {
-      const delegate: FormatMethod<TInput, TOutput, TPrimitiveOutput, TDataContext> = (
-        delegatedValue,
-        delegatedUsageSuggestions,
-        delegatedDataContext,
-      ) =>
-        formatter.format(
-          delegatedValue,
-          delegatedUsageSuggestions ?? usageSuggestions,
-          (delegatedDataContext ?? dataContext) as any,
-        ) as any
-
-      return nextFormat(delegate, value, usageSuggestions, dataContext) as any
-    }, nextFormatterOptions ?? formatterOptions)
-
-    nextFormatter.innerFormatter = formatter
-
-    return nextFormatter
-  }
-
-  return formatter
-}

package/tsconfig.build.json

@@ -1,6 +0,0 @@
-{
-  "extends": "../../tsconfig.build.json",
-  "compilerOptions": {
-    "declarationDir": "./dist/types"
-  }
-}