@ultimat3/i18n 18.0.0 → 19.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/i18n",
-  "version": "18.0.0",
+  "version": "19.1.0",
   "description": "Dependency-free translator, catalog flattening, locale negotiation and loud missing-key rendering",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,6 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "18.0.0"
+    "@ultimat3/core": "19.1.0"
   }
 }

package/src/extract.ts

@@ -4,6 +4,7 @@
  * a translation gap is a build error, not a ticket.
  */
 
+import { stripComments } from '@ultimat3/core';
 import { type Catalog, catalogKeys } from './catalog';
 import { catalogMissingKeys } from './errors';
 import { PLURAL_CATEGORIES } from './interpolate';
@@ -72,7 +73,11 @@ export function extractKeys(
   const usages: KeyUsage[] = [];
   const dynamic: DynamicUsage[] = [];
 
-  for (const match of source.matchAll(pattern)) {
+  // Over the COMMENT-STRIPPED text, never the raw file: a `// … t('…', { … })` in a comment matched
+  // the shape above and produced a phantom key that `x i18n sync` would have written into every
+  // catalog as `"…": "⟦…⟧"` (measured 2026-09-05). The mask keeps every newline and every string
+  // literal in place, so an index into it is an index into `source` and the positions below hold.
+  for (const match of stripComments(source).matchAll(pattern)) {
     const argument = (match[1] ?? '').trim();
     const index = match.index ?? 0;
     const position = positionOf(source, index);

package/src/index.ts

@@ -1,5 +1,12 @@
 /** Public surface of @ultimat3/i18n. Explicit exports only. */
 
+// Anchored on purpose, and NOT by the `sideEffects` array: Bun reads any array as `false` and drops
+// the module regardless (oven-sh/bun#40650). `registerBaseCatalog` here fills the catalog `t()`
+// falls back to, and `t()` never imports this module — so without the bare import every framework
+// string renders as its ⟦key⟧ placeholder. `SIDE_EFFECTS_ANCHORS` carries the argument and
+// `bun run side-effects` enforces it.
+import './framework';
+
 export {
   type Catalog,
   catalogKeys,