@saykit/config 0.4.1 → 0.6.0

package/dist/commands/index.cjs

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-require("../chunk-CKQMccvm.cjs");
-const require_storage = require("../storage-wS6e6qWM.cjs");
-const require_loader = require("../loader-DATEQsXj.cjs");
+const require_storage = require("../storage-DqhzA5H8.cjs");
+const require_loader = require("../loader-A1uS7qkK.cjs");
 let _commander_js_extra_typings = require("@commander-js/extra-typings");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
@@ -145,7 +144,7 @@ function exists(path) {
 var BucketExtractWorker = class extends BucketWorker {
 	#indexedMessagesByPath = /* @__PURE__ */ new Map();
 	get #indexedMessages() {
-		return Array.from(this.#indexedMessagesByPath.values()).flat();
+		return [...this.bucket.messages, ...Array.from(this.#indexedMessagesByPath.values()).flat()];
 	}
 	async #indexPath(path) {
 		const relativePath = normalisePathForLogs(path);
@@ -167,8 +166,10 @@ var BucketExtractWorker = class extends BucketWorker {
 		this.logger.info(`Scanning bucket: ${this.bucket.include}`);
 		const paths = await globBucket(this.bucket);
 		this.logger.step(`Found ${paths.length} file(s)`);
+		if (this.bucket.messages.length) this.logger.step(`Including ${this.bucket.messages.length} message(s) declared in the config`);
 		await Promise.all(paths.map((p) => this.#indexPath(p)));
-		this.logger.info(`Total extracted messages: ${this.#indexedMessages.length}`);
+		const extracted = Array.from(this.#indexedMessagesByPath.values()).flat().length;
+		this.logger.info(`Total extracted messages: ${extracted}`);
 	}
 	async write() {
 		const mergedMessages = require_storage.mergeExtractedMessages(this.#indexedMessages);

package/dist/commands/index.d.cts

@@ -1 +1 @@
-export { };
+export {}

package/dist/commands/index.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/dist/commands/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, t as readCatalogueMessages } from "../storage-CqKPYfCR.mjs";
-import { t as resolveConfig } from "../loader-BuAqYtfl.mjs";
+import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, t as readCatalogueMessages } from "../storage-B6mn0s3V.mjs";
+import { t as resolveConfig } from "../loader-DLyuZzF2.mjs";
 import { Command, program } from "@commander-js/extra-typings";
 import { access, glob, readFile, stat, watch } from "node:fs/promises";
 import { join, relative } from "node:path";
@@ -144,7 +144,7 @@ function exists(path) {
 var BucketExtractWorker = class extends BucketWorker {
 	#indexedMessagesByPath = /* @__PURE__ */ new Map();
 	get #indexedMessages() {
-		return Array.from(this.#indexedMessagesByPath.values()).flat();
+		return [...this.bucket.messages, ...Array.from(this.#indexedMessagesByPath.values()).flat()];
 	}
 	async #indexPath(path) {
 		const relativePath = normalisePathForLogs(path);
@@ -166,8 +166,10 @@ var BucketExtractWorker = class extends BucketWorker {
 		this.logger.info(`Scanning bucket: ${this.bucket.include}`);
 		const paths = await globBucket(this.bucket);
 		this.logger.step(`Found ${paths.length} file(s)`);
+		if (this.bucket.messages.length) this.logger.step(`Including ${this.bucket.messages.length} message(s) declared in the config`);
 		await Promise.all(paths.map((p) => this.#indexPath(p)));
-		this.logger.info(`Total extracted messages: ${this.#indexedMessages.length}`);
+		const extracted = Array.from(this.#indexedMessagesByPath.values()).flat().length;
+		this.logger.info(`Total extracted messages: ${extracted}`);
 	}
 	async write() {
 		const mergedMessages = mergeExtractedMessages(this.#indexedMessages);

package/dist/features/catalogue/index.cjs

@@ -1,7 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-require("../../chunk-CKQMccvm.cjs");
-const require_hash = require("../../hash-CxBlj5Dz.cjs");
-const require_storage = require("../../storage-wS6e6qWM.cjs");
+const require_hash = require("../../hash-51ce8YiG.cjs");
+const require_storage = require("../../storage-DqhzA5H8.cjs");
 let node_path = require("node:path");
 //#region src/features/catalogue/record.ts
 /**
@@ -13,7 +12,7 @@ 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(new Set([
+	return Array.from(/* @__PURE__ */ new Set([
 		locale,
 		...fallbacks,
 		source

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

@@ -1,5 +1,4 @@
-import { i as Message, n as Config, t as Bucket } from "../../shapes-Ba3xS10n.cjs";
-
+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[]): {
   message: string;

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

@@ -1,5 +1,4 @@
-import { i as Message, n as Config, t as Bucket } from "../../shapes-NPfwlInG.mjs";
-
+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[]): {
   message: string;

package/dist/features/catalogue/index.mjs

@@ -1,5 +1,5 @@
-import { t as generateHash } from "../../hash-DyC8GzMa.mjs";
-import { a as mergeExtractedMessages, i as expandBucketOutputPath, n as writeCatalogueMessages, o as pruneLocaleMessages, r as declarationPathFor, t as readCatalogueMessages } from "../../storage-CqKPYfCR.mjs";
+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-B6mn0s3V.mjs";
 import { resolve } from "node:path";
 //#region src/features/catalogue/record.ts
 /**
@@ -11,7 +11,7 @@ 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(new Set([
+	return Array.from(/* @__PURE__ */ new Set([
 		locale,
 		...fallbacks,
 		source

package/dist/features/loader/index.cjs

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

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

@@ -1,5 +1,4 @@
-import { n as Config } from "../../shapes-Ba3xS10n.cjs";
-
+import { n as Config } from "../../shapes-CRlXtss0.cjs";
 //#region src/features/loader/resolve.d.ts
 declare function resolveConfig(name?: string): Config;
 //#endregion

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

@@ -1,5 +1,4 @@
-import { n as Config } from "../../shapes-NPfwlInG.mjs";
-
+import { n as Config } from "../../shapes-CRlXtss0.mjs";
 //#region src/features/loader/resolve.d.ts
 declare function resolveConfig(name?: string): Config;
 //#endregion

package/dist/features/loader/index.mjs

@@ -1,2 +1,2 @@
-import { t as resolveConfig } from "../../loader-BuAqYtfl.mjs";
+import { t as resolveConfig } from "../../loader-DLyuZzF2.mjs";
 export { resolveConfig };

package/dist/features/messages/index.cjs

@@ -1,16 +1,52 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_hash = require("../../hash-CxBlj5Dz.cjs");
+const require_hash = require("../../hash-51ce8YiG.cjs");
 //#region src/features/messages/identifier.ts
 const AUTO_INCREMENT_IDENTIFIER = Symbol("auto-increment");
-function assignSequenceIdentifiers(message, sequence = { current: 0 }) {
-	if (message instanceof ArgumentMessage || message instanceof ElementMessage || message instanceof ChoiceMessage) {
-		if (message.identifier === AUTO_INCREMENT_IDENTIFIER) message.identifier = `${sequence.current++}`;
+function assignSequenceIdentifiers(message, sequence = { current: 0 }, equivalent = () => false) {
+	const reserved = collectAssignedIdentifiers(message, equivalent);
+	function next() {
+		let identifier = `${sequence.current++}`;
+		while (reserved.has(identifier)) identifier = `${sequence.current++}`;
+		return identifier;
 	}
-	if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) assignSequenceIdentifiers(child, sequence);
-	if (message instanceof ChoiceMessage) for (const branch of message.branches) {
-		if (branch.identifier === AUTO_INCREMENT_IDENTIFIER) branch.identifier = `${sequence.current++}`;
-		assignSequenceIdentifiers(branch.value, sequence);
+	function walk(message) {
+		if (message instanceof ArgumentMessage || message instanceof ElementMessage || message instanceof ChoiceMessage) {
+			if (message.identifier === AUTO_INCREMENT_IDENTIFIER) message.identifier = next();
+		}
+		if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) walk(child);
+		if (message instanceof ChoiceMessage) for (const branch of message.branches) {
+			if (branch.identifier === AUTO_INCREMENT_IDENTIFIER) branch.identifier = next();
+			walk(branch.value);
+		}
+	}
+	walk(message);
+}
+/**
+* Collect the identifiers already assigned before this pass runs, so generated
+* sequence numbers never shadow an explicit one (e.g. an element tagged `0`).
+*
+* A name is claimed by what produced it, not by the name alone. Two that differ
+* each compile to their own prop, and a translator moving them around a sentence
+* has to be able to tell them apart, so they are a build error. Repeats are fine
+* when nothing distinguishes them: the same variable interpolated twice is one
+* value, and two identical elements are one tag.
+*/
+function collectAssignedIdentifiers(message, equivalent) {
+	const tags = /* @__PURE__ */ new Map();
+	const values = /* @__PURE__ */ new Map();
+	function claim(claimed, identifier, expression, conflict) {
+		if (claimed.has(identifier) && !equivalent(claimed.get(identifier), expression)) throw new Error(conflict);
+		claimed.set(identifier, expression);
+	}
+	function walk(message) {
+		if (message instanceof ElementMessage && typeof message.identifier === "string") claim(tags, message.identifier, message.expression, `Duplicate element tag '${message.identifier}', give each element in a message its own tag unless they are identical`);
+		if ((message instanceof ArgumentMessage || message instanceof ChoiceMessage) && typeof message.identifier === "string") claim(values, message.identifier, message.expression, `Duplicate placeholder name '${message.identifier}', give each value in a message its own name unless they are identical`);
+		if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) walk(child);
+		if (message instanceof ChoiceMessage) for (const branch of message.branches) walk(branch.value);
 	}
+	walk(message);
+	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/types.ts
@@ -24,12 +60,15 @@ var Base = class {
 	}
 };
 var LiteralMessage = class extends Base {
+	text;
 	constructor(text) {
 		super();
 		this.text = text;
 	}
 };
 var ArgumentMessage = class extends Base {
+	identifier;
+	expression;
 	constructor(identifier, expression) {
 		super();
 		this.identifier = identifier;
@@ -37,6 +76,9 @@ var ArgumentMessage = class extends Base {
 	}
 };
 var ElementMessage = class extends Base {
+	identifier;
+	children;
+	expression;
 	constructor(identifier, children, expression) {
 		super();
 		this.identifier = identifier;
@@ -45,6 +87,10 @@ var ElementMessage = class extends Base {
 	}
 };
 var ChoiceMessage = class extends Base {
+	kind;
+	identifier;
+	branches;
+	expression;
 	constructor(kind, identifier, branches, expression) {
 		super();
 		this.kind = kind;
@@ -54,6 +100,12 @@ var ChoiceMessage = class extends Base {
 	}
 };
 var CompositeMessage = class extends Base {
+	descriptor;
+	comments;
+	references;
+	children;
+	accessor;
+	whitespace;
 	constructor(descriptor, comments, references, children, accessor, whitespace) {
 		super();
 		this.descriptor = descriptor;
@@ -72,6 +124,7 @@ function convertMessageToIcu(message) {
 			case message instanceof LiteralMessage: return String(message.text);
 			case message instanceof ArgumentMessage: return `{${String(message.identifier)}}`;
 			case message instanceof ElementMessage: {
+				if (message.children.length === 0) return `<${String(message.identifier)}/>`;
 				const children = message.children.map((m) => internalConvertMessageToIcu(m)).join("");
 				return `<${String(message.identifier)}>${children}</${String(message.identifier)}>`;
 			}

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

@@ -1,8 +1,14 @@
 //#region src/features/messages/identifier.d.ts
 declare const AUTO_INCREMENT_IDENTIFIER: unique symbol;
+/**
+ * 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?: {
   current: number;
-}): void;
+}, equivalent?: PlaceholderEquivalence): void;
 //#endregion
 //#region src/features/messages/types.d.ts
 declare abstract class Base {
@@ -60,4 +66,4 @@ declare function convertMessageToIcu(message: Message): string;
 //#region src/features/messages/hash.d.ts
 declare function generateHash(input: string, context?: string): string;
 //#endregion
-export { AUTO_INCREMENT_IDENTIFIER, ArgumentMessage, ChoiceMessage, CompositeMessage, ElementMessage, LiteralMessage, Message, assignSequenceIdentifiers, convertMessageToIcu, generateHash };
+export { AUTO_INCREMENT_IDENTIFIER, ArgumentMessage, ChoiceMessage, CompositeMessage, ElementMessage, LiteralMessage, Message, PlaceholderEquivalence, assignSequenceIdentifiers, convertMessageToIcu, generateHash };

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

@@ -1,8 +1,14 @@
 //#region src/features/messages/identifier.d.ts
 declare const AUTO_INCREMENT_IDENTIFIER: unique symbol;
+/**
+ * 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?: {
   current: number;
-}): void;
+}, equivalent?: PlaceholderEquivalence): void;
 //#endregion
 //#region src/features/messages/types.d.ts
 declare abstract class Base {
@@ -60,4 +66,4 @@ declare function convertMessageToIcu(message: Message): string;
 //#region src/features/messages/hash.d.ts
 declare function generateHash(input: string, context?: string): string;
 //#endregion
-export { AUTO_INCREMENT_IDENTIFIER, ArgumentMessage, ChoiceMessage, CompositeMessage, ElementMessage, LiteralMessage, Message, assignSequenceIdentifiers, convertMessageToIcu, generateHash };
+export { AUTO_INCREMENT_IDENTIFIER, ArgumentMessage, ChoiceMessage, CompositeMessage, ElementMessage, LiteralMessage, Message, PlaceholderEquivalence, assignSequenceIdentifiers, convertMessageToIcu, generateHash };

package/dist/features/messages/index.mjs

@@ -1,15 +1,51 @@
-import { t as generateHash } from "../../hash-DyC8GzMa.mjs";
+import { t as generateHash } from "../../hash-DvzpieJD.mjs";
 //#region src/features/messages/identifier.ts
 const AUTO_INCREMENT_IDENTIFIER = Symbol("auto-increment");
-function assignSequenceIdentifiers(message, sequence = { current: 0 }) {
-	if (message instanceof ArgumentMessage || message instanceof ElementMessage || message instanceof ChoiceMessage) {
-		if (message.identifier === AUTO_INCREMENT_IDENTIFIER) message.identifier = `${sequence.current++}`;
+function assignSequenceIdentifiers(message, sequence = { current: 0 }, equivalent = () => false) {
+	const reserved = collectAssignedIdentifiers(message, equivalent);
+	function next() {
+		let identifier = `${sequence.current++}`;
+		while (reserved.has(identifier)) identifier = `${sequence.current++}`;
+		return identifier;
 	}
-	if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) assignSequenceIdentifiers(child, sequence);
-	if (message instanceof ChoiceMessage) for (const branch of message.branches) {
-		if (branch.identifier === AUTO_INCREMENT_IDENTIFIER) branch.identifier = `${sequence.current++}`;
-		assignSequenceIdentifiers(branch.value, sequence);
+	function walk(message) {
+		if (message instanceof ArgumentMessage || message instanceof ElementMessage || message instanceof ChoiceMessage) {
+			if (message.identifier === AUTO_INCREMENT_IDENTIFIER) message.identifier = next();
+		}
+		if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) walk(child);
+		if (message instanceof ChoiceMessage) for (const branch of message.branches) {
+			if (branch.identifier === AUTO_INCREMENT_IDENTIFIER) branch.identifier = next();
+			walk(branch.value);
+		}
+	}
+	walk(message);
+}
+/**
+* Collect the identifiers already assigned before this pass runs, so generated
+* sequence numbers never shadow an explicit one (e.g. an element tagged `0`).
+*
+* A name is claimed by what produced it, not by the name alone. Two that differ
+* each compile to their own prop, and a translator moving them around a sentence
+* has to be able to tell them apart, so they are a build error. Repeats are fine
+* when nothing distinguishes them: the same variable interpolated twice is one
+* value, and two identical elements are one tag.
+*/
+function collectAssignedIdentifiers(message, equivalent) {
+	const tags = /* @__PURE__ */ new Map();
+	const values = /* @__PURE__ */ new Map();
+	function claim(claimed, identifier, expression, conflict) {
+		if (claimed.has(identifier) && !equivalent(claimed.get(identifier), expression)) throw new Error(conflict);
+		claimed.set(identifier, expression);
+	}
+	function walk(message) {
+		if (message instanceof ElementMessage && typeof message.identifier === "string") claim(tags, message.identifier, message.expression, `Duplicate element tag '${message.identifier}', give each element in a message its own tag unless they are identical`);
+		if ((message instanceof ArgumentMessage || message instanceof ChoiceMessage) && typeof message.identifier === "string") claim(values, message.identifier, message.expression, `Duplicate placeholder name '${message.identifier}', give each value in a message its own name unless they are identical`);
+		if (message instanceof CompositeMessage || message instanceof ElementMessage) for (const child of message.children) walk(child);
+		if (message instanceof ChoiceMessage) for (const branch of message.branches) walk(branch.value);
 	}
+	walk(message);
+	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/types.ts
@@ -23,12 +59,15 @@ var Base = class {
 	}
 };
 var LiteralMessage = class extends Base {
+	text;
 	constructor(text) {
 		super();
 		this.text = text;
 	}
 };
 var ArgumentMessage = class extends Base {
+	identifier;
+	expression;
 	constructor(identifier, expression) {
 		super();
 		this.identifier = identifier;
@@ -36,6 +75,9 @@ var ArgumentMessage = class extends Base {
 	}
 };
 var ElementMessage = class extends Base {
+	identifier;
+	children;
+	expression;
 	constructor(identifier, children, expression) {
 		super();
 		this.identifier = identifier;
@@ -44,6 +86,10 @@ var ElementMessage = class extends Base {
 	}
 };
 var ChoiceMessage = class extends Base {
+	kind;
+	identifier;
+	branches;
+	expression;
 	constructor(kind, identifier, branches, expression) {
 		super();
 		this.kind = kind;
@@ -53,6 +99,12 @@ var ChoiceMessage = class extends Base {
 	}
 };
 var CompositeMessage = class extends Base {
+	descriptor;
+	comments;
+	references;
+	children;
+	accessor;
+	whitespace;
 	constructor(descriptor, comments, references, children, accessor, whitespace) {
 		super();
 		this.descriptor = descriptor;
@@ -71,6 +123,7 @@ function convertMessageToIcu(message) {
 			case message instanceof LiteralMessage: return String(message.text);
 			case message instanceof ArgumentMessage: return `{${String(message.identifier)}}`;
 			case message instanceof ElementMessage: {
+				if (message.children.length === 0) return `<${String(message.identifier)}/>`;
 				const children = message.children.map((m) => internalConvertMessageToIcu(m)).join("");
 				return `<${String(message.identifier)}>${children}</${String(message.identifier)}>`;
 			}

package/dist/{hash-CxBlj5Dz.cjs → hash-51ce8YiG.cjs}

@@ -1,4 +1,3 @@
-require("./chunk-CKQMccvm.cjs");
 let js_sha256 = require("js-sha256");
 //#region src/features/messages/hash.ts
 function generateHash(input, context) {

package/dist/index.cjs

@@ -1,9 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_chunk = require("./chunk-CKQMccvm.cjs");
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 let picomatch = require("picomatch");
-picomatch = require_chunk.__toESM(picomatch, 1);
+picomatch = __toESM(picomatch, 1);
 let zod = require("zod");
-zod = require_chunk.__toESM(zod, 1);
+zod = __toESM(zod, 1);
 zod.object({
 	message: zod.string(),
 	translation: zod.string().optional(),
@@ -22,6 +43,16 @@ const Transformer = zod.object({
 	extract: zod.custom((v) => typeof v === "function"),
 	transform: zod.custom((v) => typeof v === "function")
 });
+/**
+* A message declared in the config rather than found in source. The shorthand
+* is the source string; the object form adds the metadata a descriptor would
+* otherwise carry.
+*/
+const DeclaredMessage = zod.string().or(zod.object({
+	message: zod.string(),
+	context: zod.string().optional(),
+	comments: zod.string().array().optional()
+}));
 const Bucket = zod.object({
 	include: zod.string().array(),
 	exclude: zod.string().array().optional(),
@@ -31,6 +62,14 @@ const Bucket = zod.object({
 		zod.string(),
 		".{extension}"
 	]),
+	/**
+	* Messages that belong in the catalogue but have no call site to extract
+	* them from — strings owned by a non-JavaScript artefact such as a manifest,
+	* a store listing, or an email subject. Keyed by id, so the id is stable and
+	* hand-written by definition, and merged into every extraction alongside
+	* whatever the transformers find.
+	*/
+	messages: zod.record(zod.string(), DeclaredMessage).optional(),
 	formatter: Formatter,
 	transformer: Transformer.transform((t) => [t]).or(Transformer.array()).transform((t) => ({
 		match: (id) => t.some((t) => t.match(id)),
@@ -39,6 +78,17 @@ const Bucket = zod.object({
 	}))
 }).transform((v) => ({
 	...v,
+	messages: Object.entries(v.messages ?? {}).map(([id, declared]) => {
+		const entry = typeof declared === "string" ? { message: declared } : declared;
+		return {
+			id,
+			message: entry.message,
+			translation: entry.message,
+			context: "context" in entry ? entry.context : void 0,
+			comments: ("comments" in entry ? entry.comments : void 0) ?? [],
+			references: []
+		};
+	}),
 	match: (0, picomatch.default)(v.include, { ignore: v.exclude }),
 	output: Object.assign(v.output, { match: (0, picomatch.default)(v.output.replace("{locale}", "*").replace("{extension}", v.formatter.extension.slice(1))) })
 }));

package/dist/index.d.cts

@@ -1,14 +1,20 @@
-import { a as Transformer, i as Message, n as Config, r as Formatter, t as Bucket } from "./shapes-Ba3xS10n.cjs";
+import { a as Message, i as Formatter, n as Config, o as Transformer, r as DeclaredMessage, t as Bucket } from "./shapes-CRlXtss0.cjs";
 import { input } from "zod";
-import * as _$picomatch_lib_picomatch_js0 from "picomatch/lib/picomatch.js";
-
 //#region src/index.d.ts
 declare function defineConfig<C extends input<typeof Config>>(config: C): {
   locales: [string, ...string[]];
   buckets: {
+    messages: {
+      message: string;
+      comments: string[];
+      references: string[];
+      translation?: string | undefined;
+      id?: string | undefined;
+      context?: string | undefined;
+    }[];
     match: (id: string) => boolean;
     output: `${string}{locale}${string}.{extension}` & {
-      match: _$picomatch_lib_picomatch_js0.Matcher;
+      match: import("picomatch/lib/picomatch.js").Matcher;
     };
     include: string[];
     formatter: {
@@ -36,4 +42,4 @@ declare function defineConfig<C extends input<typeof Config>>(config: C): {
   fallbackLocales?: Record<string, string | string[]> | undefined;
 };
 //#endregion
-export { Bucket, Config, Formatter, Message, Transformer, defineConfig };
+export { type Bucket, type Config, type DeclaredMessage, type Formatter, type Message, type Transformer, defineConfig };

package/dist/index.d.mts

@@ -1,14 +1,20 @@
-import { a as Transformer, i as Message, n as Config, r as Formatter, t as Bucket } from "./shapes-NPfwlInG.mjs";
+import { a as Message, i as Formatter, n as Config, o as Transformer, r as DeclaredMessage, t as Bucket } from "./shapes-CRlXtss0.mjs";
 import { input } from "zod";
-import * as _$picomatch_lib_picomatch_js0 from "picomatch/lib/picomatch.js";
-
 //#region src/index.d.ts
 declare function defineConfig<C extends input<typeof Config>>(config: C): {
   locales: [string, ...string[]];
   buckets: {
+    messages: {
+      message: string;
+      comments: string[];
+      references: string[];
+      translation?: string | undefined;
+      id?: string | undefined;
+      context?: string | undefined;
+    }[];
     match: (id: string) => boolean;
     output: `${string}{locale}${string}.{extension}` & {
-      match: _$picomatch_lib_picomatch_js0.Matcher;
+      match: import("picomatch/lib/picomatch.js").Matcher;
     };
     include: string[];
     formatter: {
@@ -36,4 +42,4 @@ declare function defineConfig<C extends input<typeof Config>>(config: C): {
   fallbackLocales?: Record<string, string | string[]> | undefined;
 };
 //#endregion
-export { Bucket, Config, Formatter, Message, Transformer, defineConfig };
+export { type Bucket, type Config, type DeclaredMessage, type Formatter, type Message, type Transformer, defineConfig };

package/dist/index.mjs

@@ -18,6 +18,16 @@ const Transformer = z.object({
 	extract: z.custom((v) => typeof v === "function"),
 	transform: z.custom((v) => typeof v === "function")
 });
+/**
+* A message declared in the config rather than found in source. The shorthand
+* is the source string; the object form adds the metadata a descriptor would
+* otherwise carry.
+*/
+const DeclaredMessage = z.string().or(z.object({
+	message: z.string(),
+	context: z.string().optional(),
+	comments: z.string().array().optional()
+}));
 const Bucket = z.object({
 	include: z.string().array(),
 	exclude: z.string().array().optional(),
@@ -27,6 +37,14 @@ const Bucket = z.object({
 		z.string(),
 		".{extension}"
 	]),
+	/**
+	* Messages that belong in the catalogue but have no call site to extract
+	* them from — strings owned by a non-JavaScript artefact such as a manifest,
+	* a store listing, or an email subject. Keyed by id, so the id is stable and
+	* hand-written by definition, and merged into every extraction alongside
+	* whatever the transformers find.
+	*/
+	messages: z.record(z.string(), DeclaredMessage).optional(),
 	formatter: Formatter,
 	transformer: Transformer.transform((t) => [t]).or(Transformer.array()).transform((t) => ({
 		match: (id) => t.some((t) => t.match(id)),
@@ -35,6 +53,17 @@ const Bucket = z.object({
 	}))
 }).transform((v) => ({
 	...v,
+	messages: Object.entries(v.messages ?? {}).map(([id, declared]) => {
+		const entry = typeof declared === "string" ? { message: declared } : declared;
+		return {
+			id,
+			message: entry.message,
+			translation: entry.message,
+			context: "context" in entry ? entry.context : void 0,
+			comments: ("comments" in entry ? entry.comments : void 0) ?? [],
+			references: []
+		};
+	}),
 	match: picomatch(v.include, { ignore: v.exclude }),
 	output: Object.assign(v.output, { match: picomatch(v.output.replace("{locale}", "*").replace("{extension}", v.formatter.extension.slice(1))) })
 }));