@cosmicdrift/kumiko-types 0.321.0 → 0.323.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-types",
-  "version": "0.321.0",
+  "version": "0.323.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 = {

package/src/fields.ts

@@ -160,6 +160,11 @@ export type Findability = "exact" | "fuzzy" | "none" | "secret";
 // force every OTHER intersected property (e.g. a factory's `required?: R`)
 // to `never` too, since its index signature applies to all string keys.
 // Naming the three annotation keys explicitly avoids that trap.
+//
+// kumiko-framework#2921: no longer part of PersonalAnnotations /
+// PersonalAnnotationsLongText — text and longText fields must declare an
+// explicit stance. It still applies to PersonalAnnotationsNoFind, whose
+// factories keep `personal` optional.
 type NoPersonalAnnotation = {
   readonly personal?: never;
   readonly find?: never;
@@ -178,8 +183,7 @@ export type PersonalAnnotations =
       readonly personal: false;
       readonly reason: string;
       readonly anonymize?: () => unknown | Promise<unknown>;
-    }
-  | NoPersonalAnnotation;
+    };
 
 // longText has no lookupable/searchable machinery ("Kein searchable" — see
 // LongTextFieldDef doc) — only "does this need to stay a secret" applies.
@@ -197,8 +201,7 @@ export type PersonalAnnotationsLongText =
       readonly personal: false;
       readonly reason: string;
       readonly anonymize?: () => unknown | Promise<unknown>;
-    }
-  | NoPersonalAnnotation;
+    };
 
 // Same as PersonalAnnotations but without `find` — for field types with no
 // full-text/blind-index machinery (everything except text and longText).