@entifix/i18n 0.1.2 → 0.1.3

package/README.md

@@ -12,6 +12,8 @@ pnpm add @entifix/i18n i18next
 
 ## Entry points
 
+`fill` fills `{{name}}` placeholders of a string already translated, and `CatalogShape<T>` is the type a second locale's catalog `satisfies`.
+
 | Import                  | What it holds                                                                                    |
 | ----------------------- | ------------------------------------------------------------------------------------------------ |
 | `@entifix/i18n`         | `defineCatalogs`, `createI18n`, `getServerTFor`                                                  |

package/dist/catalog-shape.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The same keys as `T`, every leaf a string.
+ *
+ * A second locale's catalog is declared `satisfies CatalogShape<typeof en>`,
+ * and `satisfies` checks an object literal both ways: a key missing from it
+ * and a key only it has are each a type error, so a catalog cannot drift from
+ * the one it translates without failing the build.
+ */
+export type CatalogShape<T> = {
+    readonly [K in keyof T]: T[K] extends string ? string : CatalogShape<T[K]>;
+};
+//# sourceMappingURL=catalog-shape.d.ts.map

package/dist/catalog-shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-shape.d.ts","sourceRoot":"","sources":["../src/catalog-shape.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC5B,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3E,CAAC"}

package/dist/catalog-shape.js

@@ -0,0 +1,10 @@
+/**
+ * The same keys as `T`, every leaf a string.
+ *
+ * A second locale's catalog is declared `satisfies CatalogShape<typeof en>`,
+ * and `satisfies` checks an object literal both ways: a key missing from it
+ * and a key only it has are each a type error, so a catalog cannot drift from
+ * the one it translates without failing the build.
+ */ export { };
+
+//# sourceMappingURL=catalog-shape.js.map

package/dist/catalog-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog-shape.ts"],"sourcesContent":["/**\n * The same keys as `T`, every leaf a string.\n *\n * A second locale's catalog is declared `satisfies CatalogShape<typeof en>`,\n * and `satisfies` checks an object literal both ways: a key missing from it\n * and a key only it has are each a type error, so a catalog cannot drift from\n * the one it translates without failing the build.\n */\nexport type CatalogShape<T> = {\n  readonly [K in keyof T]: T[K] extends string ? string : CatalogShape<T[K]>;\n};\n"],"names":[],"mappings":"AAAA;;;;;;;CAOC,GACD,WAEE"}

package/dist/fill.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A catalog string with its `{{name}}` placeholders filled in, for copy a
+ * component receives already translated: `fill('{{n}} active', { n: 2 })`.
+ * A placeholder with no value stays as written.
+ *
+ * Pure, and free of i18next: a client component can fill a string the server
+ * translated without installing a catalog.
+ */
+export declare function fill(template: string, values: Readonly<Record<string, string | number>>): string;
+//# sourceMappingURL=fill.d.ts.map

package/dist/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../src/fill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAChD,MAAM,CAIR"}

package/dist/fill.js

@@ -0,0 +1,12 @@
+/**
+ * A catalog string with its `{{name}}` placeholders filled in, for copy a
+ * component receives already translated: `fill('{{n}} active', { n: 2 })`.
+ * A placeholder with no value stays as written.
+ *
+ * Pure, and free of i18next: a client component can fill a string the server
+ * translated without installing a catalog.
+ */ export function fill(template, values) {
+    return template.replace(/\{\{(\w+)\}\}/g, (placeholder, name)=>name in values ? String(values[name]) : placeholder);
+}
+
+//# sourceMappingURL=fill.js.map

package/dist/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fill.ts"],"sourcesContent":["/**\n * A catalog string with its `{{name}}` placeholders filled in, for copy a\n * component receives already translated: `fill('{{n}} active', { n: 2 })`.\n * A placeholder with no value stays as written.\n *\n * Pure, and free of i18next: a client component can fill a string the server\n * translated without installing a catalog.\n */\nexport function fill(\n  template: string,\n  values: Readonly<Record<string, string | number>>,\n): string {\n  return template.replace(/\\{\\{(\\w+)\\}\\}/g, (placeholder, name: string) =>\n    name in values ? String(values[name]) : placeholder,\n  );\n}\n"],"names":["fill","template","values","replace","placeholder","name","String"],"mappings":"AAAA;;;;;;;CAOC,GACD,OAAO,SAASA,KACdC,QAAgB,EAChBC,MAAiD;IAEjD,OAAOD,SAASE,OAAO,CAAC,kBAAkB,CAACC,aAAaC,OACtDA,QAAQH,SAASI,OAAOJ,MAAM,CAACG,KAAK,IAAID;AAE5C"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
+export * from './catalog-shape.js';
+export * from './fill.js';
 export * from './instance.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,3 +1,5 @@
+export * from './catalog-shape.js';
+export * from './fill.js';
 export * from './instance.js';
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './instance.js';\n"],"names":[],"mappings":"AAAA,cAAc,gBAAgB"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './catalog-shape.js';\nexport * from './fill.js';\nexport * from './instance.js';\n"],"names":[],"mappings":"AAAA,cAAc,qBAAqB;AACnC,cAAc,YAAY;AAC1B,cAAc,gBAAgB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entifix/i18n",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "i18next binding: install each package's catalogs once, translate with typed keys, and negotiate a locale.",
   "license": "MIT",
   "repository": {
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@swc/helpers": "0.5.23",
-    "@entifix/core": "0.1.2"
+    "@entifix/core": "0.1.3"
   },
   "peerDependencies": {
     "i18next": ">=26 <27"