@cosmicdrift/kumiko-types 0.321.0 → 0.322.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.321.0",
+  "version": "0.322.0",
   "description": "Framework-Type-Definitions für Kumiko — FeatureDefinition, BootCheck-Types und die reinen Engine-Types. Erlaubt Downstream-Konsumenten, gegen die Type-Contracts zu bauen, ohne das ganze Framework-Package zu importieren. Enthaelt keine identitaets-sensitiven Runtime-Werte mehr (Error-Klassen leben seit #1629 in kumiko-framework, Brand-Symbole nutzen Symbol.for) und ist deshalb eine plain dependency, keine peerDependency.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",

package/src/__tests__/plural-forms.test.ts

@@ -0,0 +1,18 @@
+// Type-level contract for PluralForms (#3344): `other` is the CLDR-mandated
+// fallback and must stay required. The body below is never invoked — tsc
+// checks it, bun:test does not run it. If `other` ever becomes optional the
+// `@ts-expect-error` turns into an "unused directive" compile error.
+
+import { expect, test } from "bun:test";
+import type { PluralForms } from "../config";
+
+function _pluralFormsRequireOther(): readonly PluralForms[] {
+  const withOther: PluralForms = { other: "items" };
+  // @ts-expect-error — `other` is required; a plural entry without it must not typecheck.
+  const missingOther: PluralForms = { one: "item" };
+  return [withOther, missingOther];
+}
+
+test("PluralForms: compile-time contract is wired", () => {
+  expect(_pluralFormsRequireOther).toBeDefined();
+});

package/src/config.ts

@@ -453,7 +453,19 @@ export type NotificationDefinition = {
 
 // --- Translations ---
 
-export type TranslationEntry = Readonly<Record<string, string>>;
+// CLDR plural categories for one locale's variants of a translation string.
+// `other` is the CLDR-mandated fallback and therefore required; the rest
+// only exist in some locales (e.g. "few"/"many" for Slavic plurals).
+export type PluralForms = {
+  readonly zero?: string;
+  readonly one?: string;
+  readonly two?: string;
+  readonly few?: string;
+  readonly many?: string;
+  readonly other: string;
+};
+export type TranslationValue = string | PluralForms;
+export type TranslationEntry = Readonly<Record<string, TranslationValue>>;
 export type TranslationKeys = Readonly<Record<string, TranslationEntry>>;
 
 export type TranslationsDef = {