@saykit/config 0.11.0 → 0.12.0

package/dist/features/catalogue/index.d.cts

@@ -1,47 +1,56 @@
-import { a as Message, n as Config, t as Bucket } from "../../shapes-CRlXtss0.cjs";
-//#region src/features/catalogue/merge.d.ts
-declare function mergeExtractedMessages(messages: Message[]): {
+import { a as Message, n as Config, t as Bucket } from "../../shapes-Dq0aJdsn.cjs";
+/**
+ * Where a locale's generated module goes: beside its catalogue, as `.js`.
+ *
+ * @throws If that is the catalogue itself, as for a formatter with a `.js` extension
+ */
+export declare function modulePathFor(bucket: Bucket, locale: string): string;
+/**
+ * Build the source of a locale's generated module from its assembled record.
+ *
+ * The module is plain data, so it can cross a server/client boundary as JSON.
+ *
+ * @param record The locale's messages, keyed by id, as ICU
+ */
+export declare function generateCatalogueModule(record: Record<string, string>): string;
+/**
+ * Compile one locale's catalogue, and its fallbacks, into a module on disk.
+ *
+ * The fallback chain is merged here, so the app still imports one module per locale.
+ */
+export declare function emitCatalogueModule(config: Config, bucket: Bucket, locale: string): Promise<{
+  path: string;
+  count: number;
+}>;
+export declare function mergeExtractedMessages(messages: Message[]): {
   message: string;
-  comments: string[];
-  references: string[];
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
-}[];
-declare function pruneLocaleMessages(existingMessages: Message[], sourceMessages: Message[]): {
-  message: string;
   comments: string[];
   references: string[];
+}[];
+export declare function pruneLocaleMessages(existingMessages: Message[], sourceMessages: Message[]): {
+  message: string;
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
+  comments: string[];
+  references: string[];
 }[];
-//#endregion
-//#region src/features/catalogue/path.d.ts
-declare function expandBucketOutputPath(bucket: Bucket, locale: string, extension?: `.${string}`): string;
-/**
- * The declaration file that types a catalogue, e.g. `en.json` -> `en.d.json.ts`.
- *
- * TypeScript resolves `./en.json` by stripping the extension and looking for
- * `en.d.json.ts`; the `en.json.d.ts` form is only consulted for extensions the
- * resolver does not recognise. Non-JS extensions additionally require
- * `allowArbitraryExtensions` in the consumer's tsconfig.
- */
-declare function declarationPathFor(cataloguePath: string): string;
-//#endregion
-//#region src/features/catalogue/record.d.ts
+export declare function expandBucketOutputPath(bucket: Bucket, locale: string, extension?: `.${string}`): string;
 /**
  * Resolve the fallback chain for a locale, most specific first. The source
  * locale (the first configured locale) is always the final fallback, so an
  * untranslated key ultimately resolves to the source string.
  */
-declare function resolveFallbackChain(config: Config, locale: string): string[];
+export declare function resolveFallbackChain(config: Config, locale: string): string[];
 /**
  * Resolve the catalogue files that contribute to a locale module, most specific
  * first. When the path does not map to a configured locale it is loaded on its
  * own.
  */
-declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: string): {
+export declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: string): {
   locale: string | undefined;
   sources: string[];
 };
@@ -51,17 +60,13 @@ declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: s
  * (most specific first): more specific locales override their fallbacks, and any
  * key still untranslated falls back to its source message.
  */
-declare function assembleCatalogueRecord(bucket: Bucket, contents: string[]): Record<string, string>;
-//#endregion
-//#region src/features/catalogue/storage.d.ts
-declare function readCatalogueMessages(bucket: Bucket, locale: string, path?: string): Promise<{
+export declare function assembleCatalogueRecord(bucket: Bucket, contents: string[]): Record<string, string>;
+export declare function readCatalogueMessages(bucket: Bucket, locale: string, path?: string): Promise<{
   message: string;
-  comments: string[];
-  references: string[];
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
+  comments: string[];
+  references: string[];
 }[]>;
-declare function writeCatalogueMessages(bucket: Bucket, locale: string, messages: Message[], path?: string): Promise<void>;
-//#endregion
-export { assembleCatalogueRecord, declarationPathFor, expandBucketOutputPath, mergeExtractedMessages, pruneLocaleMessages, readCatalogueMessages, resolveCatalogueSources, resolveFallbackChain, writeCatalogueMessages };
+export declare function writeCatalogueMessages(bucket: Bucket, locale: string, messages: Message[], path?: string): Promise<void>;

package/dist/features/catalogue/index.d.mts

@@ -1,47 +1,56 @@
-import { a as Message, n as Config, t as Bucket } from "../../shapes-CRlXtss0.mjs";
-//#region src/features/catalogue/merge.d.ts
-declare function mergeExtractedMessages(messages: Message[]): {
+import { a as Message, n as Config, t as Bucket } from "../../shapes-Dq0aJdsn.mjs";
+/**
+ * Where a locale's generated module goes: beside its catalogue, as `.js`.
+ *
+ * @throws If that is the catalogue itself, as for a formatter with a `.js` extension
+ */
+export declare function modulePathFor(bucket: Bucket, locale: string): string;
+/**
+ * Build the source of a locale's generated module from its assembled record.
+ *
+ * The module is plain data, so it can cross a server/client boundary as JSON.
+ *
+ * @param record The locale's messages, keyed by id, as ICU
+ */
+export declare function generateCatalogueModule(record: Record<string, string>): string;
+/**
+ * Compile one locale's catalogue, and its fallbacks, into a module on disk.
+ *
+ * The fallback chain is merged here, so the app still imports one module per locale.
+ */
+export declare function emitCatalogueModule(config: Config, bucket: Bucket, locale: string): Promise<{
+  path: string;
+  count: number;
+}>;
+export declare function mergeExtractedMessages(messages: Message[]): {
   message: string;
-  comments: string[];
-  references: string[];
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
-}[];
-declare function pruneLocaleMessages(existingMessages: Message[], sourceMessages: Message[]): {
-  message: string;
   comments: string[];
   references: string[];
+}[];
+export declare function pruneLocaleMessages(existingMessages: Message[], sourceMessages: Message[]): {
+  message: string;
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
+  comments: string[];
+  references: string[];
 }[];
-//#endregion
-//#region src/features/catalogue/path.d.ts
-declare function expandBucketOutputPath(bucket: Bucket, locale: string, extension?: `.${string}`): string;
-/**
- * The declaration file that types a catalogue, e.g. `en.json` -> `en.d.json.ts`.
- *
- * TypeScript resolves `./en.json` by stripping the extension and looking for
- * `en.d.json.ts`; the `en.json.d.ts` form is only consulted for extensions the
- * resolver does not recognise. Non-JS extensions additionally require
- * `allowArbitraryExtensions` in the consumer's tsconfig.
- */
-declare function declarationPathFor(cataloguePath: string): string;
-//#endregion
-//#region src/features/catalogue/record.d.ts
+export declare function expandBucketOutputPath(bucket: Bucket, locale: string, extension?: `.${string}`): string;
 /**
  * Resolve the fallback chain for a locale, most specific first. The source
  * locale (the first configured locale) is always the final fallback, so an
  * untranslated key ultimately resolves to the source string.
  */
-declare function resolveFallbackChain(config: Config, locale: string): string[];
+export declare function resolveFallbackChain(config: Config, locale: string): string[];
 /**
  * Resolve the catalogue files that contribute to a locale module, most specific
  * first. When the path does not map to a configured locale it is loaded on its
  * own.
  */
-declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: string): {
+export declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: string): {
   locale: string | undefined;
   sources: string[];
 };
@@ -51,17 +60,13 @@ declare function resolveCatalogueSources(config: Config, bucket: Bucket, path: s
  * (most specific first): more specific locales override their fallbacks, and any
  * key still untranslated falls back to its source message.
  */
-declare function assembleCatalogueRecord(bucket: Bucket, contents: string[]): Record<string, string>;
-//#endregion
-//#region src/features/catalogue/storage.d.ts
-declare function readCatalogueMessages(bucket: Bucket, locale: string, path?: string): Promise<{
+export declare function assembleCatalogueRecord(bucket: Bucket, contents: string[]): Record<string, string>;
+export declare function readCatalogueMessages(bucket: Bucket, locale: string, path?: string): Promise<{
   message: string;
-  comments: string[];
-  references: string[];
   translation?: string | undefined;
   id?: string | undefined;
   context?: string | undefined;
+  comments: string[];
+  references: string[];
 }[]>;
-declare function writeCatalogueMessages(bucket: Bucket, locale: string, messages: Message[], path?: string): Promise<void>;
-//#endregion
-export { assembleCatalogueRecord, declarationPathFor, expandBucketOutputPath, mergeExtractedMessages, pruneLocaleMessages, readCatalogueMessages, resolveCatalogueSources, resolveFallbackChain, writeCatalogueMessages };
+export declare function writeCatalogueMessages(bucket: Bucket, locale: string, messages: Message[], path?: string): Promise<void>;

package/dist/features/catalogue/index.mjs

@@ -1,39 +1 @@
-import { t as generateHash } from "../../hash-DvzpieJD.mjs";
-import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, r as declarationPathFor, t as readCatalogueMessages } from "../../storage-8485YdBh.mjs";
-import { resolve } from "node:path";
-//#region src/features/catalogue/record.ts
-function resolveFallbackChain(config, locale) {
-	const source = config.locales[0];
-	const configured = config.fallbackLocales?.[locale];
-	const fallbacks = configured ? Array.isArray(configured) ? configured : [configured] : [];
-	return Array.from(/* @__PURE__ */ new Set([
-		locale,
-		...fallbacks,
-		source
-	]));
-}
-function resolveCatalogueSources(config, bucket, path) {
-	const resolved = resolve(path);
-	const locale = config.locales.find((l) => expandBucketOutputPath(bucket, l) === resolved);
-	return {
-		locale,
-		sources: locale ? resolveFallbackChain(config, locale).map((l) => expandBucketOutputPath(bucket, l)) : [resolved]
-	};
-}
-function assembleCatalogueRecord(bucket, contents) {
-	const record = {};
-	for (const content of [...contents].reverse()) {
-		if (!content) continue;
-		for (const message of bucket.formatter.parse(content)) {
-			const key = message.id || generateHash(message.message, message.context);
-			if (message.translation) {
-				record[key] = message.translation;
-				continue;
-			}
-			if (!record[key] && message.message) record[key] = message.message;
-		}
-	}
-	return record;
-}
-//#endregion
-export { assembleCatalogueRecord, declarationPathFor, expandBucketOutputPath, mergeExtractedMessages, pruneLocaleMessages, readCatalogueMessages, resolveCatalogueSources, resolveFallbackChain, writeCatalogueMessages };
+export { i as assembleCatalogueRecord, t as emitCatalogueModule, l as expandBucketOutputPath, n as generateCatalogueModule, u as mergeExtractedMessages, r as modulePathFor, d as pruneLocaleMessages, s as readCatalogueMessages, a as resolveCatalogueSources, o as resolveFallbackChain, c as writeCatalogueMessages } from "../../emit-q78c-G_t.mjs";

package/dist/features/loader/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_loader = require("../../loader-XE7SprlF.cjs");
+const require_loader = require("../../loader-V92j1gfD.cjs");
 exports.resolveConfig = require_loader.resolveConfig;
 exports.resolveConfigFile = require_loader.resolveConfigFile;

package/dist/features/loader/index.d.cts

@@ -1,11 +1,8 @@
-import { n as Config } from "../../shapes-CRlXtss0.cjs";
-//#region src/features/loader/resolve.d.ts
+import { n as Config } from "../../shapes-Dq0aJdsn.cjs";
 /**
  * The config file {@link resolveConfig} would load, for callers that need the
  * path itself rather than its contents, salting a bundler's cache key with it,
  * for one, since what a catalogue assembles into depends on the config.
  */
-declare function resolveConfigFile(name?: string): string;
-declare function resolveConfig(name?: string): Config;
-//#endregion
-export { resolveConfig, resolveConfigFile };
+export declare function resolveConfigFile(name?: string): string;
+export declare function resolveConfig(name?: string): Config;

package/dist/features/loader/index.d.mts

@@ -1,11 +1,8 @@
-import { n as Config } from "../../shapes-CRlXtss0.mjs";
-//#region src/features/loader/resolve.d.ts
+import { n as Config } from "../../shapes-Dq0aJdsn.mjs";
 /**
  * The config file {@link resolveConfig} would load, for callers that need the
  * path itself rather than its contents, salting a bundler's cache key with it,
  * for one, since what a catalogue assembles into depends on the config.
  */
-declare function resolveConfigFile(name?: string): string;
-declare function resolveConfig(name?: string): Config;
-//#endregion
-export { resolveConfig, resolveConfigFile };
+export declare function resolveConfigFile(name?: string): string;
+export declare function resolveConfig(name?: string): Config;

package/dist/features/loader/index.mjs

@@ -1,2 +1 @@
-import { n as resolveConfigFile, t as resolveConfig } from "../../loader-C6XxYhMl.mjs";
-export { resolveConfig, resolveConfigFile };
+export { t as resolveConfig, n as resolveConfigFile } from "../../loader-1PBbw7yb.mjs";

package/dist/features/messages/index.cjs

@@ -1,20 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_hash = require("../../hash-51ce8YiG.cjs");
-let _messageformat_date_skeleton = require("@messageformat/date-skeleton");
-let _messageformat_number_skeleton = require("@messageformat/number-skeleton");
-//#region src/features/messages/escape.ts
+const require_compile = require("../../compile-BrwRUqtQ.cjs");
+// src/features/messages/escape.ts
 function escapeIcuLiteral(text, hash = false) {
 	return text.replace(/'/gu, "''").replace(hash ? /[{}#]+/gu : /[{}]+/gu, (run) => `'${run}'`);
 }
-//#endregion
-//#region src/features/messages/types.ts
+// src/features/messages/types.ts
 var Base = class {
 	toICUString() {
 		return convertMessageToIcu(this);
 	}
 	toHashString() {
 		const context = this instanceof CompositeMessage ? this.descriptor.context : void 0;
-		return require_hash.generateHash(this.toICUString(), context);
+		return require_compile.generateHash(this.toICUString(), context);
 	}
 };
 var LiteralMessage = class extends Base {
@@ -78,8 +75,7 @@ var CompositeMessage = class extends Base {
 		this.whitespace = whitespace;
 	}
 };
-//#endregion
-//#region src/features/messages/identifier.ts
+// src/features/messages/identifier.ts
 const AUTO_INCREMENT_IDENTIFIER = Symbol("auto-increment");
 const BRANCH_PATTERN = /^(?:=\d+|[^\p{Pattern_Syntax}\p{Pattern_White_Space}]+)$/u;
 function getBranchCase(kind, identifier) {
@@ -148,8 +144,7 @@ function collectAssignedIdentifiers(message, equivalent) {
 	for (const tag of tags.keys()) if (values.has(tag)) throw new Error(`Element tag '${tag}' collides with an argument of the same name`);
 	return /* @__PURE__ */ new Set([...tags.keys(), ...values.keys()]);
 }
-//#endregion
-//#region src/features/messages/convert.ts
+// src/features/messages/convert.ts
 function convertMessageToIcu(message) {
 	function internalConvertMessageToIcu(message, hash) {
 		switch (true) {
@@ -182,68 +177,23 @@ function convertMessageToIcu(message) {
 	}
 	return internalConvertMessageToIcu(message, void 0).trim();
 }
-//#endregion
-//#region src/features/messages/format.ts
-const ARGUMENT_STYLES = {
-	number: ["integer", "percent"],
-	date: [
-		"short",
-		"medium",
-		"long",
-		"full"
-	],
-	time: [
-		"short",
-		"medium",
-		"long",
-		"full"
-	]
-};
-const ARGUMENT_TYPES = Object.keys(ARGUMENT_STYLES);
-function isArgumentType(kind) {
-	return Object.hasOwn(ARGUMENT_STYLES, kind);
-}
-const LITERAL_STYLE_PATTERN = /^[^{}\r\n]*[#0][^{}\r\n]*$/;
-const SKELETON = "::";
-function invalidSkeleton(type, skeleton) {
-	if (skeleton === "") return "it names no fields";
-	const errors = [];
-	if (type === "number") {
-		(0, _messageformat_number_skeleton.getNumberFormatOptions)((0, _messageformat_number_skeleton.parseNumberSkeleton)(skeleton, (error) => errors.push(String(error))), (stem) => {
-			if (stem !== "scale") errors.push(`unsupported stem '${stem}'`);
-		});
-		return errors[0];
-	}
-	const options = (0, _messageformat_date_skeleton.getDateTimeFormatOptions)((0, _messageformat_date_skeleton.parseDateTokens)(skeleton), (_type, message) => errors.push(message));
-	if (errors.length > 0) return errors[0];
-	if (Object.keys(options).length === 0) return "it names no fields";
-}
-function validateArgumentStyle(type, style) {
-	const named = ARGUMENT_STYLES[type];
-	if (named.includes(style)) return;
-	if (style.startsWith(SKELETON)) {
-		const reason = invalidSkeleton(type, style.slice(2));
-		if (!reason) return;
-		throw new Error(`Invalid ${type} skeleton '${style}': ${reason}`);
-	}
-	if (type === "number" && LITERAL_STYLE_PATTERN.test(style)) return;
-	const expected = named.map((s) => `'${s}'`).join(", ");
-	throw new Error(`Invalid ${type} style '${style}', expected ${expected}, or a skeleton such as ` + (type === "number" ? "::currency/EUR" : "::yyyyMMdd") + (type === "number" ? ", or a literal number pattern such as #,##0.00" : ""));
-}
-//#endregion
-exports.ARGUMENT_STYLES = ARGUMENT_STYLES;
-exports.ARGUMENT_TYPES = ARGUMENT_TYPES;
+exports.ARGUMENT_STYLES = require_compile.ARGUMENT_STYLES;
+exports.ARGUMENT_TYPES = require_compile.ARGUMENT_TYPES;
 exports.AUTO_INCREMENT_IDENTIFIER = AUTO_INCREMENT_IDENTIFIER;
 exports.ArgumentMessage = ArgumentMessage;
 exports.ChoiceMessage = ChoiceMessage;
 exports.CompositeMessage = CompositeMessage;
 exports.ElementMessage = ElementMessage;
 exports.LiteralMessage = LiteralMessage;
+exports.StyleError = require_compile.StyleError;
 exports.assignSequenceIdentifiers = assignSequenceIdentifiers;
+exports.compileMessage = require_compile.compileMessage;
 exports.convertMessageToIcu = convertMessageToIcu;
+exports.dateTimeStyle = require_compile.dateTimeStyle;
 exports.escapeIcuLiteral = escapeIcuLiteral;
-exports.generateHash = require_hash.generateHash;
+exports.generateHash = require_compile.generateHash;
 exports.getBranchCase = getBranchCase;
-exports.isArgumentType = isArgumentType;
-exports.validateArgumentStyle = validateArgumentStyle;
+exports.isArgumentType = require_compile.isArgumentType;
+exports.numberStyle = require_compile.numberStyle;
+exports.validateArgumentStyle = require_compile.validateArgumentStyle;
 exports.validateBranchIdentifier = validateBranchIdentifier;

package/dist/features/messages/index.d.cts

@@ -1,41 +1,49 @@
-//#region src/features/messages/format.d.ts
 /**
- * The ICU argument types a macro can author, and the named styles each accepts.
- *
- * A style may also be a skeleton, which is where the formats these names have
- * no word for live; see {@link validateArgumentStyle}.
+ * What each node in a compiled message is, by the number it starts with.
  *
- * `currency` is deliberately absent from `number`: MF1 has nowhere to write the
- * code, so `{price, number, currency}` formats as a bare number. Currency
- * belongs to a skeleton, `::currency/EUR`, which the formatter does honour.
- *
- * `spellout`, RBNF `ordinal` and `choice` are absent by decision: the first two
- * are ICU4J/ICU4C rule-based formats with no `Intl` equivalent, and the third
- * is deprecated in ICU itself in favour of `plural`.
+ * The numbers are the format, so a kind is only ever appended, never renumbered or reused.
  */
-declare const ARGUMENT_STYLES: {
-  readonly number: readonly ["integer", "percent"];
-  readonly date: readonly ["short", "medium", "long", "full"];
-  readonly time: readonly ["short", "medium", "long", "full"];
+declare const Kind: {
+  readonly Value: 0;
+  readonly Number: 1;
+  readonly DateTime: 2;
+  readonly Plural: 3;
+  readonly Ordinal: 4;
+  readonly Select: 5;
+  readonly Hash: 6;
 };
-type ArgumentType = keyof typeof ARGUMENT_STYLES;
-declare const ARGUMENT_TYPES: ArgumentType[];
-declare function isArgumentType(kind: string): kind is ArgumentType;
+type Kind = (typeof Kind)[keyof typeof Kind];
 /**
- * Reject an argument style the formatter cannot honour, while the style is
- * still attached to a file and a line.
+ * A compiled message.
+ *
+ * The CLI compiles a catalogue to this: strings and arrays, with styles already resolved to
+ * `Intl` options. It is plain JSON, so it can cross a server/client boundary.
  *
- * A style is a bare string in the source and in the catalogue, so nothing
- * between here and the runtime has an opinion about it. Left unchecked, a typo
- * like `{d, date, meduim}` only misformats once it reaches a user.
+ * A node is an array starting with its {@link Kind}; an array starting with anything else is a
+ * concatenation. Operands are descriptor keys, never nodes. A message with no placeholders is its
+ * own string.
+ */
+type Message$1 = string | Message$1[] | [typeof Kind.Value, string] | [typeof Kind.Number, string, Intl.NumberFormatOptions?, number?] | [typeof Kind.DateTime, string, Intl.DateTimeFormatOptions?] | [typeof Kind.Plural, string, Message$1.Cases, number?] | [typeof Kind.Ordinal, string, Message$1.Cases, number?] | [typeof Kind.Select, string, Message$1.Cases] | [typeof Kind.Hash];
+declare namespace Message$1 {
+  /**
+   * A plural's or a select's branches, by key. A plural's keys are CLDR
+   * categories or an exact `=n`, and `other` is the fallback for both.
+   */
+  type Cases = {
+    [key: string]: Message$1;
+  };
+  /** What a compiled message is called with: the descriptor the transform built. */
+  type Values = Record<string, unknown>;
+}
+/**
+ * Compile one ICU MessageFormat 1 message.
  *
- * Three forms are accepted: a named style, a `::`-prefixed skeleton, and, for
- * a number, a literal pattern such as `#,##0.00`.
+ * @param icu The message, in ICU MessageFormat 1 syntax
+ * @returns The compiled message
+ * @throws If the message is not valid ICU MessageFormat 1
  */
-declare function validateArgumentStyle(type: ArgumentType, style: string): void;
-//#endregion
-//#region src/features/messages/identifier.d.ts
-declare const AUTO_INCREMENT_IDENTIFIER: unique symbol;
+export declare function compileMessage(icu: string): Message$1;
+export declare const AUTO_INCREMENT_IDENTIFIER: unique symbol;
 /**
  * The ICU case a branch is written as.
  *
@@ -48,7 +56,7 @@ declare const AUTO_INCREMENT_IDENTIFIER: unique symbol;
  * coerce to `=0`, which would pass for a key selecting zero and leave the
  * author's own key out of the catalogue.
  */
-declare function getBranchCase(kind: string, identifier: string | typeof AUTO_INCREMENT_IDENTIFIER): string;
+export declare function getBranchCase(kind: string, identifier: string | typeof AUTO_INCREMENT_IDENTIFIER): string;
 /**
  * Reject a branch key ICU cannot express, while the key is still attached to a
  * file and a line.
@@ -57,23 +65,77 @@ declare function getBranchCase(kind: string, identifier: string | typeof AUTO_IN
  * builds, and extracts to a normal-looking catalogue entry, and the only sign
  * of trouble is a parse error at format time.
  */
-declare function validateBranchIdentifier(kind: string, identifier: string | typeof AUTO_INCREMENT_IDENTIFIER): void;
+export declare function validateBranchIdentifier(kind: string, identifier: string | typeof AUTO_INCREMENT_IDENTIFIER): void;
 /**
  * Decides whether two placeholders sharing a name are the same placeholder, and
  * so may share it. Only the syntax that produced them can answer that, so the
  * caller supplies the comparison; by default nothing is interchangeable.
  */
-type PlaceholderEquivalence = (a: any, b: any) => boolean;
-declare function assignSequenceIdentifiers(message: Message, sequence?: {
+export type PlaceholderEquivalence = (a: any, b: any) => boolean;
+export declare function assignSequenceIdentifiers(message: Message, sequence?: {
   current: number;
 }, equivalent?: PlaceholderEquivalence): void;
-//#endregion
-//#region src/features/messages/types.d.ts
+/**
+ * Argument styles: which ones a macro may author, and the `Intl` options each resolves to.
+ *
+ * Validation and compilation share these functions, so a style the transform accepts is one the
+ * compiler honours.
+ */
+/**
+ * The ICU argument types a macro can author, and the named styles each accepts.
+ *
+ * `currency` is absent from `number` because MF1 has nowhere to write the code; use
+ * `::currency/EUR`.
+ * `duration`, `spellout`, RBNF `ordinal` and `choice` are absent too, and compile to the bare
+ * value.
+ */
+export declare const ARGUMENT_STYLES: {
+  readonly number: readonly ['integer', 'percent'];
+  readonly date: readonly ['short', 'medium', 'long', 'full'];
+  readonly time: readonly ['short', 'medium', 'long', 'full'];
+};
+export type ArgumentType = keyof typeof ARGUMENT_STYLES;
+export declare const ARGUMENT_TYPES: ArgumentType[];
+export declare function isArgumentType(kind: string): kind is ArgumentType;
+/** The extra key a number's bag may carry, which `Intl` has no option for. */
+export type NumberOptions = Intl.NumberFormatOptions & {
+  scale?: number;
+};
+/** A style that could not be resolved, with the reason it could not. */
+export declare class StyleError extends Error {}
+/**
+ * Turn a `date` or `time` argument style into `Intl.DateTimeFormat` options.
+ *
+ * A `::`-prefixed style is a skeleton such as `::yyyyMMdd`; an empty style takes MF1's default.
+ *
+ * @throws {StyleError} If the style names no fields
+ */
+export declare function dateTimeStyle(kind: 'date' | 'time', style: string): Intl.DateTimeFormatOptions;
+/**
+ * Turn a `number` argument style into `Intl.NumberFormat` options.
+ *
+ * Accepts MF1's named styles, a `::`-prefixed skeleton, or a literal pattern such as `#,##0.00`.
+ * Named styles are expanded here because the pattern parser would read `percent` as literal text.
+ *
+ * `scale` comes back beside the bag, since `Intl` has no option for it.
+ *
+ * @throws {StyleError} If the style is not valid, or asks for something `Intl` cannot express
+ */
+export declare function numberStyle(style: string): NumberOptions;
+/**
+ * Reject an argument style the compiler cannot honour, while it is still attached to a file and
+ * line.
+ *
+ * The compiler falls back to the default format, so an unchecked typo like `{d, date, meduim}` only
+ * misformats in production.
+ * Skeletons and patterns are checked by resolving them as the compiler will.
+ */
+export declare function validateArgumentStyle(type: ArgumentType, style: string): void;
 declare abstract class Base {
   toICUString(this: Message): string;
   toHashString(this: Message): string;
 }
-declare class LiteralMessage extends Base {
+export declare class LiteralMessage extends Base {
   readonly text: string;
   constructor(text: string);
 }
@@ -85,23 +147,23 @@ declare class LiteralMessage extends Base {
  * options, because the catalogue is the source of truth and only the ICU
  * spelling round-trips back out of it.
  */
-interface ArgumentFormat {
+export interface ArgumentFormat {
   type: ArgumentType;
   style?: string;
 }
-declare class ArgumentMessage extends Base {
+export declare class ArgumentMessage extends Base {
   identifier: string | typeof AUTO_INCREMENT_IDENTIFIER;
   readonly expression: any;
   readonly format?: ArgumentFormat | undefined;
   constructor(identifier: string | typeof AUTO_INCREMENT_IDENTIFIER, expression: any, format?: ArgumentFormat | undefined);
 }
-declare class ElementMessage extends Base {
+export declare class ElementMessage extends Base {
   identifier: string | typeof AUTO_INCREMENT_IDENTIFIER;
   readonly children: Message[];
   readonly expression: any;
   constructor(identifier: string | typeof AUTO_INCREMENT_IDENTIFIER, children: Message[], expression: any);
 }
-declare class ChoiceMessage extends Base {
+export declare class ChoiceMessage extends Base {
   readonly kind: string;
   identifier: string | typeof AUTO_INCREMENT_IDENTIFIER;
   readonly branches: {
@@ -126,7 +188,7 @@ declare class ChoiceMessage extends Base {
    */
   offset?: number | undefined);
 }
-declare class CompositeMessage extends Base {
+export declare class CompositeMessage extends Base {
   readonly descriptor: {
     id?: string;
     context?: string;
@@ -141,12 +203,8 @@ declare class CompositeMessage extends Base {
     context?: string;
   }, comments: string[], references: string[], children: Message[], accessor: any, whitespace?: boolean | undefined);
 }
-type Message = LiteralMessage | ArgumentMessage | ElementMessage | ChoiceMessage | CompositeMessage;
-//#endregion
-//#region src/features/messages/convert.d.ts
-declare function convertMessageToIcu(message: Message): string;
-//#endregion
-//#region src/features/messages/escape.d.ts
+export type Message = LiteralMessage | ArgumentMessage | ElementMessage | ChoiceMessage | CompositeMessage;
+export declare function convertMessageToIcu(message: Message): string;
 /**
  * Quoting for text that has to survive a message format unchanged.
  *
@@ -167,9 +225,7 @@ declare function convertMessageToIcu(message: Message): string;
  * @param hash Whether `#` stands for a number here, i.e. whether some `plural`
  *   or `ordinal` encloses this text
  */
-declare function escapeIcuLiteral(text: string, hash?: boolean): string;
-//#endregion
-//#region src/features/messages/hash.d.ts
+export declare function escapeIcuLiteral(text: string, hash?: boolean): string;
 /**
  * Hashed in userland rather than with `node:crypto`, because this runs wherever
  * a bundler runs it. `createHash` is one of the entry points `unenv` leaves
@@ -178,6 +234,5 @@ declare function escapeIcuLiteral(text: string, hash?: boolean): string;
  * equivalent, `subtle.digest`, is async, and an id is resolved from a
  * synchronous extraction pass.
  */
-declare function generateHash(input: string, context?: string): string;
-//#endregion
-export { ARGUMENT_STYLES, ARGUMENT_TYPES, AUTO_INCREMENT_IDENTIFIER, ArgumentFormat, ArgumentMessage, ArgumentType, ChoiceMessage, CompositeMessage, ElementMessage, LiteralMessage, Message, PlaceholderEquivalence, assignSequenceIdentifiers, convertMessageToIcu, escapeIcuLiteral, generateHash, getBranchCase, isArgumentType, validateArgumentStyle, validateBranchIdentifier };
+export declare function generateHash(input: string, context?: string): string;
+export {};