afformative 0.7.0-beta.3 → 0.7.0-beta.5

package/README.md

@@ -38,6 +38,8 @@ npm i afformative
 
 ## Quick Start
 
+Afformative is framework-agnostic, but this section will assume usage with React.
+
 A formatter is an object with `format`, `stringify`, and `compare` methods. Formatters must be created using the `createFormatter` function.
 
 `createFormatter` accepts a single object parameter. `format` is the only required property, but specifying `stringify` is recommended in most cases.
@@ -49,6 +51,7 @@ import { ReactNode } from "react"
 const dateFormatter = createFormatter<Date, ReactNode>({
   format: value => <time dateTime={value.toISOString()}>{value.toLocaleDateString()}</time>,
   stringify: value => value.toLocaleDateString(),
+  compare: value => value.valueOf(),
 })
 
 dateFormatter.format(new Date()) // <time dateTime="2026-05-30T09:17:26.263Z">30/05/2026</time>
@@ -75,11 +78,36 @@ const List = <TItem extends unknown>({ formatter, items }: ListProps<TItem>) =>
 )
 ```
 
-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.
+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. The default implementation of `stringify` is simply `String(format(value))`.
+
+## Accessing State
+
+Create formatters inside hooks to access React context.
+
+```tsx
+const useEnumFormatter = (enumType: string): Formatter<string, ReactNode> => {
+  const enumTranslationKeys = useSelector(selectEnumTranslationKeys(enumType))
+  const intl = useIntl()
+
+  return useMemo(
+    () =>
+      createFormatter<string, ReactNode>({
+        format: value => (
+          <FormattedMessage defaultMessage={value} id={enumTranslationKeys[value]} />
+        ),
+        stringify: value =>
+          intl.formatMessage({ defaultMessage: value, id: enumTranslationKeys[value] }),
+      }),
+    [intl, enumTranslationKeys],
+  )
+}
+```
+
+## Comparing Values
 
-## Compare
+Every formatter exposes a `compare` method which can be directly passed to `Array.prototype.sort`. The default implementation compares the return values of `stringify` via `localeCompare`.
 
-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.
+In the following example, `Amount` objects are sorted first by currency, then by value.
 
 ```tsx
 import { createFormatter } from "afformative"
@@ -109,22 +137,22 @@ amounts.sort(amountFormatter.compare)
 // [{ EUR, 1 }, { EUR, 5 }, { USD, 2 }, { USD, 3 }]
 ```
 
-## Usage Context
+## Formatter Context
 
-You can pass an optional usage context object to all formatter methods. Let's use a dummy table component as an example.
+You can pass context to all formatter methods. Let's use a dummy table component as an example.
 
 ```tsx
 import { Formatter } from "afformative"
 import { ReactNode } from "react"
 
-interface TableFormatterUsageContext {
+interface TableFormatterContext {
   row: number[]
   cellIndex: number
 }
 
 interface TableProps {
   rows: number[][]
-  formatter: Formatter<number, ReactNode, TableFormatterUsageContext>
+  formatter: Formatter<number, ReactNode, TableFormatterContext>
 }
 
 const Table = ({ rows, formatter }: TableProps) => (
@@ -140,17 +168,19 @@ const Table = ({ rows, formatter }: TableProps) => (
 )
 ```
 
-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.
+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.
 
 ```tsx
 import { createFormatter } from "afformative"
 import { ReactNode } from "react"
 
-import { TableFormatterUsageContext } from "./Table"
+import { TableFormatterContext } from "./Table"
 
-const rowTrendFormatter = createFormatter<number, ReactNode, TableFormatterUsageContext>({
-  format: (value, { row, cellIndex }) => {
-    if (cellIndex === 0) {
+const rowTrendFormatter = createFormatter<number, ReactNode, TableFormatterContext>({
+  format: (value, { row, cellIndex } = {}) => {
+    if (!cellIndex || !row) {
       return <span>{value}</span>
     }
 
@@ -163,28 +193,33 @@ const rowTrendFormatter = createFormatter<number, ReactNode, TableFormatterUsage
 
 This formatter only makes sense in the context of our table component.
 
-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.
+Because `row` and `cellIndex` are passed as 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.
+
+## Formatter Meta
 
-## Accessing React Context
+As explained above, context can be used to pass information from the consumer to the formatter. The `meta` property can be used to pass information from the formatter to the consumer instead. The base `FormatterMeta` interface is extensible via declaration merging.
 
-Create formatters inside custom hooks to access React context values such as translations or application state.
+For example, formatters can explicily mark themselves as print-friendly. Consumers may then decide to use `stringify` instead of `format` based on this flag.
 
 ```tsx
-const useEnumFormatter = (enumType: string): Formatter<string, ReactNode> => {
-  const enumTranslationKeys = useSelector(selectEnumTranslationKeys(enumType))
-  const intl = useIntl()
+declare module "afformative" {
+  interface FormatterMeta<TInput, TOutput, TContext> {
+    isPrintFriendly?: boolean
+  }
+}
 
-  return useMemo(
-    () =>
-      createFormatter<string, ReactNode>({
-        format: value => (
-          <FormattedMessage defaultMessage={value} id={enumTranslationKeys[value]} />
-        ),
-        stringify: value =>
-          intl.formatMessage({ defaultMessage: value, id: enumTranslationKeys[value] }),
-      }),
-    [intl, enumTranslationKeys],
-  )
+const colorfulFormatter = createFormatter<string, ReactNode>({
+  format: value => <Colorful>{value}</Colorful>,
+  stringify: value => value,
+})
+
+interface PrinterProps {
+  content: string
+  formatter: Formatter<string, ReactNode>
+}
+
+const Printer = ({ content, formatter }: PrinterProps) => {
+  return formatter.meta?.isPrintFriendly ? formatter.format(content) : formatter.stringify(content)
 }
 ```
 

package/dist/index.cjs

@@ -1,14 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#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 ?? {}));
+	const { compare: compareParam, format, meta, stringify: stringifyParam } = param;
+	const stringify = stringifyParam ?? ((value, ctx) => String(format(value, ctx)));
 	return {
-		compare: compareParam ? (a, b, usageContext) => compareParam(a, b, usageContext ?? {}) : (a, b, usageContext) => stringify(a, usageContext ?? {}).localeCompare(stringify(b, usageContext ?? {})),
+		compare: compareParam ?? ((a, b, ctx) => stringify(a, ctx).localeCompare(stringify(b, ctx))),
 		format,
-		stringify,
-		...rest
+		meta,
+		stringify
 	};
 };
 //#endregion

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/createFormatter.ts"],"sourcesContent":["export interface FormatterFormatDefinition<TInput, TOutput, TUsageContext extends object = object> {\n  (value: TInput, usageContext: Partial<TUsageContext>): TOutput\n}\n\nexport interface FormatterFormat<TInput, TOutput, TUsageContext extends object = object> {\n  (value: TInput, usageContext?: Partial<TUsageContext>): TOutput\n}\n\nexport interface FormatterStringifyDefinition<TInput, TUsageContext extends object = object> {\n  (value: TInput, usageContext: Partial<TUsageContext>): string\n}\n\nexport interface FormatterStringify<TInput, TUsageContext extends object = object> {\n  (value: TInput, usageContext?: Partial<TUsageContext>): string\n}\n\nexport interface FormatterCompareDefinition<TInput, TUsageContext extends object = object> {\n  (a: TInput, b: TInput, usageContext: Partial<TUsageContext>): number\n}\n\nexport interface FormatterCompare<TInput, TUsageContext extends object = object> {\n  (a: TInput, b: TInput, usageContext?: Partial<TUsageContext>): number\n}\n\nexport interface Formatter<TInput, TOutput, TUsageContext extends object = object> {\n  compare: FormatterCompare<TInput, TUsageContext>\n  format: FormatterFormat<TInput, TOutput, TUsageContext>\n  stringify: FormatterStringify<TInput, TUsageContext>\n  name?: string\n}\n\nexport interface CreateFormatterParam<TInput, TOutput, TUsageContext extends object = object> {\n  compare?: FormatterCompareDefinition<TInput, TUsageContext>\n  format: FormatterFormatDefinition<TInput, TOutput, TUsageContext>\n  stringify?: FormatterStringifyDefinition<TInput, TUsageContext>\n}\n\nexport const createFormatter = <TInput, TOutput, TUsageContext extends object = object>(\n  param: CreateFormatterParam<TInput, TOutput, TUsageContext>,\n): Formatter<TInput, TOutput, TUsageContext> => {\n  const { format: formatParam, stringify: stringifyParam, compare: compareParam, ...rest } = param\n\n  const format: FormatterFormat<TInput, TOutput, TUsageContext> = (value, usageContext) =>\n    formatParam(value, usageContext ?? {})\n\n  const stringify: FormatterStringify<TInput, TUsageContext> = stringifyParam\n    ? (value, usageContext) => stringifyParam(value, usageContext ?? {})\n    : (value, usageContext) => String(format(value, usageContext ?? {}))\n\n  const compare: FormatterCompare<TInput, TUsageContext> = compareParam\n    ? (a, b, usageContext) => compareParam(a, b, usageContext ?? {})\n    : (a, b, usageContext) =>\n        stringify(a, usageContext ?? {}).localeCompare(stringify(b, usageContext ?? {}))\n\n  return {\n    compare,\n    format,\n    stringify,\n    ...rest,\n  }\n}\n"],"mappings":";;AAqCA,MAAa,mBACX,UAC8C;CAC9C,MAAM,EAAE,QAAQ,aAAa,WAAW,gBAAgB,SAAS,cAAc,GAAG,SAAS;CAE3F,MAAM,UAA2D,OAAO,iBACtE,YAAY,OAAO,gBAAgB,CAAC,CAAC;CAEvC,MAAM,YAAuD,kBACxD,OAAO,iBAAiB,eAAe,OAAO,gBAAgB,CAAC,CAAC,KAChE,OAAO,iBAAiB,OAAO,OAAO,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAOrE,OAAO;EACL,SANuD,gBACpD,GAAG,GAAG,iBAAiB,aAAa,GAAG,GAAG,gBAAgB,CAAC,CAAC,KAC5D,GAAG,GAAG,iBACL,UAAU,GAAG,gBAAgB,CAAC,CAAC,EAAE,cAAc,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC;EAInF;EACA;EACA,GAAG;CACL;AACF"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/createFormatter.ts"],"sourcesContent":["export interface FormatterFormat<TInput, TOutput, TContext = unknown> {\n  (value: TInput, ctx?: TContext): TOutput\n}\n\nexport interface FormatterStringify<TInput, TContext = unknown> {\n  (value: TInput, ctx?: TContext): string\n}\n\nexport interface FormatterCompare<TInput, TContext = unknown> {\n  (a: TInput, b: TInput, ctx?: TContext): number\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type, @typescript-eslint/no-unused-vars\nexport interface FormatterMeta<TInput, TOutput, TContext = unknown> {}\n\nexport interface Formatter<TInput, TOutput, TContext = unknown> {\n  compare: FormatterCompare<TInput, TContext>\n  format: FormatterFormat<TInput, TOutput, TContext>\n  meta?: FormatterMeta<TInput, TOutput, TContext>\n  stringify: FormatterStringify<TInput, TContext>\n}\n\nexport interface CreateFormatterParam<TInput, TOutput, TContext = unknown> {\n  compare?: FormatterCompare<TInput, TContext>\n  format: FormatterFormat<TInput, TOutput, TContext>\n  meta?: FormatterMeta<TInput, TOutput, TContext>\n  stringify?: FormatterStringify<TInput, TContext>\n}\n\nexport const createFormatter = <TInput, TOutput, TContext = unknown>(\n  param: CreateFormatterParam<TInput, TOutput, TContext>,\n): Formatter<TInput, TOutput, TContext> => {\n  const { compare: compareParam, format, meta, stringify: stringifyParam } = param\n\n  const stringify: FormatterStringify<TInput, TContext> =\n    stringifyParam ?? ((value, ctx) => String(format(value, ctx)))\n\n  const compare: FormatterCompare<TInput, TContext> =\n    compareParam ?? ((a, b, ctx) => stringify(a, ctx).localeCompare(stringify(b, ctx)))\n\n  return {\n    compare,\n    format,\n    meta,\n    stringify,\n  }\n}\n"],"mappings":";;AA6BA,MAAa,mBACX,UACyC;CACzC,MAAM,EAAE,SAAS,cAAc,QAAQ,MAAM,WAAW,mBAAmB;CAE3E,MAAM,YACJ,oBAAoB,OAAO,QAAQ,OAAO,OAAO,OAAO,GAAG,CAAC;CAK9D,OAAO;EACL,SAHA,kBAAkB,GAAG,GAAG,QAAQ,UAAU,GAAG,GAAG,EAAE,cAAc,UAAU,GAAG,GAAG,CAAC;EAIjF;EACA;EACA;CACF;AACF"}

package/dist/index.d.cts

@@ -1,34 +1,27 @@
 //#region src/createFormatter.d.ts
-interface FormatterFormatDefinition<TInput, TOutput, TUsageContext extends object = object> {
-  (value: TInput, usageContext: Partial<TUsageContext>): TOutput;
+interface FormatterFormat<TInput, TOutput, TContext = unknown> {
+  (value: TInput, ctx?: TContext): TOutput;
 }
-interface FormatterFormat<TInput, TOutput, TUsageContext extends object = object> {
-  (value: TInput, usageContext?: Partial<TUsageContext>): TOutput;
+interface FormatterStringify<TInput, TContext = unknown> {
+  (value: TInput, ctx?: TContext): string;
 }
-interface FormatterStringifyDefinition<TInput, TUsageContext extends object = object> {
-  (value: TInput, usageContext: Partial<TUsageContext>): string;
+interface FormatterCompare<TInput, TContext = unknown> {
+  (a: TInput, b: TInput, ctx?: TContext): number;
 }
-interface FormatterStringify<TInput, TUsageContext extends object = object> {
-  (value: TInput, usageContext?: Partial<TUsageContext>): string;
+interface FormatterMeta<TInput, TOutput, TContext = unknown> {}
+interface Formatter<TInput, TOutput, TContext = unknown> {
+  compare: FormatterCompare<TInput, TContext>;
+  format: FormatterFormat<TInput, TOutput, TContext>;
+  meta?: FormatterMeta<TInput, TOutput, TContext>;
+  stringify: FormatterStringify<TInput, TContext>;
 }
-interface FormatterCompareDefinition<TInput, TUsageContext extends object = object> {
-  (a: TInput, b: TInput, usageContext: Partial<TUsageContext>): number;
+interface CreateFormatterParam<TInput, TOutput, TContext = unknown> {
+  compare?: FormatterCompare<TInput, TContext>;
+  format: FormatterFormat<TInput, TOutput, TContext>;
+  meta?: FormatterMeta<TInput, TOutput, TContext>;
+  stringify?: FormatterStringify<TInput, TContext>;
 }
-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>;
+declare const createFormatter: <TInput, TOutput, TContext = unknown>(param: CreateFormatterParam<TInput, TOutput, TContext>) => Formatter<TInput, TOutput, TContext>;
 //#endregion
-export { CreateFormatterParam, Formatter, FormatterCompare, FormatterCompareDefinition, FormatterFormat, FormatterFormatDefinition, FormatterStringify, FormatterStringifyDefinition, createFormatter };
+export { CreateFormatterParam, Formatter, FormatterCompare, FormatterFormat, FormatterMeta, FormatterStringify, createFormatter };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,34 +1,27 @@
 //#region src/createFormatter.d.ts
-interface FormatterFormatDefinition<TInput, TOutput, TUsageContext extends object = object> {
-  (value: TInput, usageContext: Partial<TUsageContext>): TOutput;
+interface FormatterFormat<TInput, TOutput, TContext = unknown> {
+  (value: TInput, ctx?: TContext): TOutput;
 }
-interface FormatterFormat<TInput, TOutput, TUsageContext extends object = object> {
-  (value: TInput, usageContext?: Partial<TUsageContext>): TOutput;
+interface FormatterStringify<TInput, TContext = unknown> {
+  (value: TInput, ctx?: TContext): string;
 }
-interface FormatterStringifyDefinition<TInput, TUsageContext extends object = object> {
-  (value: TInput, usageContext: Partial<TUsageContext>): string;
+interface FormatterCompare<TInput, TContext = unknown> {
+  (a: TInput, b: TInput, ctx?: TContext): number;
 }
-interface FormatterStringify<TInput, TUsageContext extends object = object> {
-  (value: TInput, usageContext?: Partial<TUsageContext>): string;
+interface FormatterMeta<TInput, TOutput, TContext = unknown> {}
+interface Formatter<TInput, TOutput, TContext = unknown> {
+  compare: FormatterCompare<TInput, TContext>;
+  format: FormatterFormat<TInput, TOutput, TContext>;
+  meta?: FormatterMeta<TInput, TOutput, TContext>;
+  stringify: FormatterStringify<TInput, TContext>;
 }
-interface FormatterCompareDefinition<TInput, TUsageContext extends object = object> {
-  (a: TInput, b: TInput, usageContext: Partial<TUsageContext>): number;
+interface CreateFormatterParam<TInput, TOutput, TContext = unknown> {
+  compare?: FormatterCompare<TInput, TContext>;
+  format: FormatterFormat<TInput, TOutput, TContext>;
+  meta?: FormatterMeta<TInput, TOutput, TContext>;
+  stringify?: FormatterStringify<TInput, TContext>;
 }
-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>;
+declare const createFormatter: <TInput, TOutput, TContext = unknown>(param: CreateFormatterParam<TInput, TOutput, TContext>) => Formatter<TInput, TOutput, TContext>;
 //#endregion
-export { CreateFormatterParam, Formatter, FormatterCompare, FormatterCompareDefinition, FormatterFormat, FormatterFormatDefinition, FormatterStringify, FormatterStringifyDefinition, createFormatter };
+export { CreateFormatterParam, Formatter, FormatterCompare, FormatterFormat, FormatterMeta, FormatterStringify, createFormatter };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,13 +1,12 @@
 //#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 ?? {}));
+	const { compare: compareParam, format, meta, stringify: stringifyParam } = param;
+	const stringify = stringifyParam ?? ((value, ctx) => String(format(value, ctx)));
 	return {
-		compare: compareParam ? (a, b, usageContext) => compareParam(a, b, usageContext ?? {}) : (a, b, usageContext) => stringify(a, usageContext ?? {}).localeCompare(stringify(b, usageContext ?? {})),
+		compare: compareParam ?? ((a, b, ctx) => stringify(a, ctx).localeCompare(stringify(b, ctx))),
 		format,
-		stringify,
-		...rest
+		meta,
+		stringify
 	};
 };
 //#endregion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/createFormatter.ts"],"sourcesContent":["export interface FormatterFormatDefinition<TInput, TOutput, TUsageContext extends object = object> {\n  (value: TInput, usageContext: Partial<TUsageContext>): TOutput\n}\n\nexport interface FormatterFormat<TInput, TOutput, TUsageContext extends object = object> {\n  (value: TInput, usageContext?: Partial<TUsageContext>): TOutput\n}\n\nexport interface FormatterStringifyDefinition<TInput, TUsageContext extends object = object> {\n  (value: TInput, usageContext: Partial<TUsageContext>): string\n}\n\nexport interface FormatterStringify<TInput, TUsageContext extends object = object> {\n  (value: TInput, usageContext?: Partial<TUsageContext>): string\n}\n\nexport interface FormatterCompareDefinition<TInput, TUsageContext extends object = object> {\n  (a: TInput, b: TInput, usageContext: Partial<TUsageContext>): number\n}\n\nexport interface FormatterCompare<TInput, TUsageContext extends object = object> {\n  (a: TInput, b: TInput, usageContext?: Partial<TUsageContext>): number\n}\n\nexport interface Formatter<TInput, TOutput, TUsageContext extends object = object> {\n  compare: FormatterCompare<TInput, TUsageContext>\n  format: FormatterFormat<TInput, TOutput, TUsageContext>\n  stringify: FormatterStringify<TInput, TUsageContext>\n  name?: string\n}\n\nexport interface CreateFormatterParam<TInput, TOutput, TUsageContext extends object = object> {\n  compare?: FormatterCompareDefinition<TInput, TUsageContext>\n  format: FormatterFormatDefinition<TInput, TOutput, TUsageContext>\n  stringify?: FormatterStringifyDefinition<TInput, TUsageContext>\n}\n\nexport const createFormatter = <TInput, TOutput, TUsageContext extends object = object>(\n  param: CreateFormatterParam<TInput, TOutput, TUsageContext>,\n): Formatter<TInput, TOutput, TUsageContext> => {\n  const { format: formatParam, stringify: stringifyParam, compare: compareParam, ...rest } = param\n\n  const format: FormatterFormat<TInput, TOutput, TUsageContext> = (value, usageContext) =>\n    formatParam(value, usageContext ?? {})\n\n  const stringify: FormatterStringify<TInput, TUsageContext> = stringifyParam\n    ? (value, usageContext) => stringifyParam(value, usageContext ?? {})\n    : (value, usageContext) => String(format(value, usageContext ?? {}))\n\n  const compare: FormatterCompare<TInput, TUsageContext> = compareParam\n    ? (a, b, usageContext) => compareParam(a, b, usageContext ?? {})\n    : (a, b, usageContext) =>\n        stringify(a, usageContext ?? {}).localeCompare(stringify(b, usageContext ?? {}))\n\n  return {\n    compare,\n    format,\n    stringify,\n    ...rest,\n  }\n}\n"],"mappings":";AAqCA,MAAa,mBACX,UAC8C;CAC9C,MAAM,EAAE,QAAQ,aAAa,WAAW,gBAAgB,SAAS,cAAc,GAAG,SAAS;CAE3F,MAAM,UAA2D,OAAO,iBACtE,YAAY,OAAO,gBAAgB,CAAC,CAAC;CAEvC,MAAM,YAAuD,kBACxD,OAAO,iBAAiB,eAAe,OAAO,gBAAgB,CAAC,CAAC,KAChE,OAAO,iBAAiB,OAAO,OAAO,OAAO,gBAAgB,CAAC,CAAC,CAAC;CAOrE,OAAO;EACL,SANuD,gBACpD,GAAG,GAAG,iBAAiB,aAAa,GAAG,GAAG,gBAAgB,CAAC,CAAC,KAC5D,GAAG,GAAG,iBACL,UAAU,GAAG,gBAAgB,CAAC,CAAC,EAAE,cAAc,UAAU,GAAG,gBAAgB,CAAC,CAAC,CAAC;EAInF;EACA;EACA,GAAG;CACL;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/createFormatter.ts"],"sourcesContent":["export interface FormatterFormat<TInput, TOutput, TContext = unknown> {\n  (value: TInput, ctx?: TContext): TOutput\n}\n\nexport interface FormatterStringify<TInput, TContext = unknown> {\n  (value: TInput, ctx?: TContext): string\n}\n\nexport interface FormatterCompare<TInput, TContext = unknown> {\n  (a: TInput, b: TInput, ctx?: TContext): number\n}\n\n// eslint-disable-next-line @typescript-eslint/no-empty-object-type, @typescript-eslint/no-unused-vars\nexport interface FormatterMeta<TInput, TOutput, TContext = unknown> {}\n\nexport interface Formatter<TInput, TOutput, TContext = unknown> {\n  compare: FormatterCompare<TInput, TContext>\n  format: FormatterFormat<TInput, TOutput, TContext>\n  meta?: FormatterMeta<TInput, TOutput, TContext>\n  stringify: FormatterStringify<TInput, TContext>\n}\n\nexport interface CreateFormatterParam<TInput, TOutput, TContext = unknown> {\n  compare?: FormatterCompare<TInput, TContext>\n  format: FormatterFormat<TInput, TOutput, TContext>\n  meta?: FormatterMeta<TInput, TOutput, TContext>\n  stringify?: FormatterStringify<TInput, TContext>\n}\n\nexport const createFormatter = <TInput, TOutput, TContext = unknown>(\n  param: CreateFormatterParam<TInput, TOutput, TContext>,\n): Formatter<TInput, TOutput, TContext> => {\n  const { compare: compareParam, format, meta, stringify: stringifyParam } = param\n\n  const stringify: FormatterStringify<TInput, TContext> =\n    stringifyParam ?? ((value, ctx) => String(format(value, ctx)))\n\n  const compare: FormatterCompare<TInput, TContext> =\n    compareParam ?? ((a, b, ctx) => stringify(a, ctx).localeCompare(stringify(b, ctx)))\n\n  return {\n    compare,\n    format,\n    meta,\n    stringify,\n  }\n}\n"],"mappings":";AA6BA,MAAa,mBACX,UACyC;CACzC,MAAM,EAAE,SAAS,cAAc,QAAQ,MAAM,WAAW,mBAAmB;CAE3E,MAAM,YACJ,oBAAoB,OAAO,QAAQ,OAAO,OAAO,OAAO,GAAG,CAAC;CAK9D,OAAO;EACL,SAHA,kBAAkB,GAAG,GAAG,QAAQ,UAAU,GAAG,GAAG,EAAE,cAAc,UAAU,GAAG,GAAG,CAAC;EAIjF;EACA;EACA;CACF;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "afformative",
-  "version": "0.7.0-beta.3",
+  "version": "0.7.0-beta.5",
   "description": "A standardized way to format values in your React components.",
   "keywords": [
     "react",
@@ -46,7 +46,7 @@
     "test:eslint": "eslint src",
     "test:prettier": "prettier --check src",
     "test:typescript": "tsc --noEmit",
-    "test:vitest": "vitest run"
+    "test:vitest": "vitest run --typecheck"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",