@messageformat/fluent

This library provides conversion and compatibility tools for using Fluent resources with the Unicode MessageFormat 2.0 -based ECMA-402 Intl.MessageFormat proposal.

The Fluent message representation relies on @fluent/syntax, while the MessageFormat 2 representation uses messageformat@next.

This package is distributed only as an ES module.

Usage

npm install @messageformat/fluent
Copy

import { fluentToResource } from '@messageformat/fluent';

const locale = 'en-US';
const src = 'msg = Today is {DATETIME($today, dateStyle: "medium")}\n';

const resource = fluentToResource(src, locale);

const msg = resource.get('msg').get('');

msg.format({ today: new Date('2022-02-02') });
// 'Today is Feb 2, 2022'

msg.formatToParts({ today: new Date('2022-02-02') });
// [
//   MessageLiteral { type: 'literal', value: 'Today is ' },
//   MessageDateTime {
//     type: 'datetime',
//     value: 2022-02-02T00:00:00.000Z,
//     options: { localeMatcher: 'best fit', dateStyle: 'medium' },
//     source: '$today :DATETIME'
//   }
// ]
Copy

API

import {
  fluentToMessage,
  fluentToResource,
  fluentToResourceData,
  getMessageFunction,
  messageToFluent,
  resourceToFluent
} from '@messageformat/fluent';

import type {
  FluentMessageResource,
  FluentMessageResourceData
} from '@messageformat/fluent';
Copy

For more information, see the documentation site.