@spintax/core 0.3.4 → 0.4.0

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 All notable changes to `@spintax/core` are documented here. This project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.4.0 — 2026-08-17
+
+### Added
+
+- **`plural.locale-missing` — a warning where `validate` used to be silent** (issue #65, reported
+  from a pipeline rendering ~1000 articles per campaign).
+
+  `validate` files no arity *verdict* without a locale, and that stays: the template may well be
+  correct for the locale the host will render with, so failing it here would fail a good template
+  for a fact the caller never claimed. But `render` has no such luxury — it resolves against the
+  2-form default — so a `{plural …}` block with any other form count reached finished text as the
+  fullwidth-brace fallback `｛plural …｝`, with nothing said upfront. Downstream checks that scan
+  for `{`/`}` do not see those braces.
+
+  The warning fires only where the risk is: **no locale normalized, and the form count is not the
+  render default**. A 2-form block stays silent, because the default resolves it. `valid` is
+  unchanged in every case (`valid ⇔ no error-severity diagnostic`), and supplying any locale
+  replaces the warning with the real verdict — nothing for `ru`, `plural.arity` for `en`.
+
+  Carries `data: { got, defaultArity }`. The default arity is derived from the same table `render`
+  uses rather than written as a literal, so the two cannot come to disagree.
+
+  Mirrored into `spintax/core`, the WordPress plugin and `spintax-core` (Python) in the same
+  change, and pinned by a corpus fixture. Note the gate's shape: the shared corpus asserts
+  diagnostics as a SUBSET, so it can pin that the warning IS emitted but not that it is absent on
+  a 2-form block — that negative control lives in each engine's own suite.
+
 ## 0.3.4 — 2026-08-08
 
 Docs-only release — no engine changes; every byte of `dist/` behavior is 0.3.3's.

package/dist/index.cjs

@@ -399,6 +399,7 @@ function pluralArity(baseLang) {
       return 2;
   }
 }
+var DEFAULT_PLURAL_ARITY = pluralArity("");
 function pluralFor(baseLang, n, forms) {
   const abs = Math.abs(n);
   const mod10 = abs % 10;
@@ -581,8 +582,8 @@ function checkPlurals(text, idx, locale, out) {
       out.push(err("plural.nested-brackets", "{plural ...}: forms must not contain nested spintax brackets. Extract via #def first \u2014 a #set is substituted verbatim and would put the brackets straight back.", at));
       continue;
     }
+    const count = block.formsRaw.split("|").length;
     if (arity > 0) {
-      const count = block.formsRaw.split("|").length;
       if (count !== arity) {
         out.push(err(
           "plural.arity",
@@ -590,6 +591,12 @@ function checkPlurals(text, idx, locale, out) {
           { ...at, data: { expected: arity, got: count } }
         ));
       }
+    } else if (count !== DEFAULT_PLURAL_ARITY) {
+      out.push(warn(
+        "plural.locale-missing",
+        `{plural ...}: ${count} forms, but no locale was supplied. render defaults to ${DEFAULT_PLURAL_ARITY} forms and leaves this block unresolved \u2014 pass the locale you will render with.`,
+        { ...at, data: { got: count, defaultArity: DEFAULT_PLURAL_ARITY } }
+      ));
     }
   }
 }