@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/i18n/interpolate-label-params.shared.utils.js

@@ -0,0 +1,63 @@
+/**
+ * interpolateLabelParams — the single canonical placeholder substitution for
+ * every translated label in the framework.
+ *
+ * ## Convention (the ONE contract content authors and the generator follow)
+ *
+ * SINGLE braces, and the placeholder name is exactly the declared param name:
+ *
+ * ```
+ * interpolateLabelParams('Enter at least {count} characters', { count: 2 })
+ *   // -> 'Enter at least 2 characters'
+ * interpolateLabelParams('Showing {from}–{to} of {total}', { from: 1, to: 10, total: 42 })
+ *   // -> 'Showing 1–10 of 42'
+ * ```
+ *
+ * This util is the single source of truth shared by:
+ *   - the frontend translation engine (`t()` in `I18nContext`)
+ *   - the backend email/label interpolation (`interpolateEmailLabel`)
+ * and it mirrors the convention the LLM label generator is instructed to emit
+ * (single-brace placeholders whose names match the declared `params` of each
+ * label).
+ *
+ * ## Why these exact semantics
+ *
+ * - **Name-based, not positional** — multi-param labels
+ *   (`Select between {min} and {max}`) and locale reorderings
+ *   (`{total} éléments` vs `{total} items`) stay correct because each
+ *   placeholder binds to its named value, never to an index.
+ * - **Unknown placeholder left verbatim** — a `{token}` with no matching param
+ *   is returned untouched rather than blanked. This means (a) a label that
+ *   legitimately contains brace text is never corrupted, and (b) a
+ *   genuinely-missing param surfaces as a visible `{token}` instead of a silent
+ *   gap, which is the louder, easier-to-catch failure.
+ * - **No params → identity** — passing `undefined`/no params returns the
+ *   template unchanged (the common case for paramless labels).
+ *
+ * ## History (do not regress)
+ *
+ * The frontend `t()` historically matched DOUBLE braces (`{{param}}`) while
+ * 100% of generated content and the backend interpolator used single braces —
+ * so no frontend parameter ever interpolated and users saw literal `{value}` /
+ * `{count}` text. Centralizing the substitution here removes that divergence:
+ * there is now exactly one brace convention, defined in one place.
+ *
+ * @param template the (already locale-resolved) label string
+ * @param params   name → value map; values are coerced with `String(...)`
+ * @returns the template with every `{name}` whose `name` is present in `params`
+ *          replaced by its stringified value; all other text (including
+ *          unmatched `{tokens}`) left exactly as authored.
+ */
+export function interpolateLabelParams(template, params) {
+    if (!params) {
+        return template;
+    }
+    return template.replace(/\{(\w+)\}/g, (match, key) => {
+        const value = params[key];
+        if (value === undefined || value === null) {
+            return match;
+        }
+        return String(value);
+    });
+}
+//# sourceMappingURL=interpolate-label-params.shared.utils.js.map

package/dist/esm/i18n/interpolate-label-params.shared.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate-label-params.shared.utils.js","sourceRoot":"","sources":["../../../../src/i18n/interpolate-label-params.shared.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAgB,EAChB,MAA2D;IAE3D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * interpolateLabelParams — the single canonical placeholder substitution for\n * every translated label in the framework.\n *\n * ## Convention (the ONE contract content authors and the generator follow)\n *\n * SINGLE braces, and the placeholder name is exactly the declared param name:\n *\n * ```\n * interpolateLabelParams('Enter at least {count} characters', { count: 2 })\n *   // -> 'Enter at least 2 characters'\n * interpolateLabelParams('Showing {from}–{to} of {total}', { from: 1, to: 10, total: 42 })\n *   // -> 'Showing 1–10 of 42'\n * ```\n *\n * This util is the single source of truth shared by:\n *   - the frontend translation engine (`t()` in `I18nContext`)\n *   - the backend email/label interpolation (`interpolateEmailLabel`)\n * and it mirrors the convention the LLM label generator is instructed to emit\n * (single-brace placeholders whose names match the declared `params` of each\n * label).\n *\n * ## Why these exact semantics\n *\n * - **Name-based, not positional** — multi-param labels\n *   (`Select between {min} and {max}`) and locale reorderings\n *   (`{total} éléments` vs `{total} items`) stay correct because each\n *   placeholder binds to its named value, never to an index.\n * - **Unknown placeholder left verbatim** — a `{token}` with no matching param\n *   is returned untouched rather than blanked. This means (a) a label that\n *   legitimately contains brace text is never corrupted, and (b) a\n *   genuinely-missing param surfaces as a visible `{token}` instead of a silent\n *   gap, which is the louder, easier-to-catch failure.\n * - **No params → identity** — passing `undefined`/no params returns the\n *   template unchanged (the common case for paramless labels).\n *\n * ## History (do not regress)\n *\n * The frontend `t()` historically matched DOUBLE braces (`{{param}}`) while\n * 100% of generated content and the backend interpolator used single braces —\n * so no frontend parameter ever interpolated and users saw literal `{value}` /\n * `{count}` text. Centralizing the substitution here removes that divergence:\n * there is now exactly one brace convention, defined in one place.\n *\n * @param template the (already locale-resolved) label string\n * @param params   name → value map; values are coerced with `String(...)`\n * @returns the template with every `{name}` whose `name` is present in `params`\n *          replaced by its stringified value; all other text (including\n *          unmatched `{tokens}`) left exactly as authored.\n */\nexport function interpolateLabelParams(\n  template: string,\n  params?: Record<string, string | number | undefined | null>,\n): string {\n  if (!params) {\n    return template;\n  }\n\n  return template.replace(/\\{(\\w+)\\}/g, (match, key: string) => {\n    const value = params[key];\n    if (value === undefined || value === null) {\n      return match;\n    }\n    return String(value);\n  });\n}\n"]}

package/dist/esm/i18n/labelling.dto.shared.schemas.d.ts

@@ -5,21 +5,21 @@ declare const _EmailUpdateDtoSchema: z.ZodObject<{
     bodyHtml: z.ZodString;
     bodyText: z.ZodString;
     lang: z.ZodEnum<typeof AvailableLanguage>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const EmailUpdateDtoSchema: typeof _EmailUpdateDtoSchema;
 export type EmailUpdateDto = z.infer<typeof _EmailUpdateDtoSchema>;
 declare const _I18nLabelsRequestDtoSchema: z.ZodObject<{
     language: z.ZodEnum<typeof AvailableLanguage>;
     sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
     keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const I18nLabelsRequestDtoSchema: typeof _I18nLabelsRequestDtoSchema;
 export type I18nLabelsRequestDto = z.infer<typeof _I18nLabelsRequestDtoSchema>;
 declare const _I18nLabelsResponseDtoSchema: z.ZodObject<{
     language: z.ZodEnum<typeof AvailableLanguage>;
     labels: z.ZodRecord<z.ZodString, z.ZodAny>;
     generatedAt: z.ZodString;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export declare const I18nLabelsResponseDtoSchema: typeof _I18nLabelsResponseDtoSchema;
 export type I18nLabelsResponseDto = z.infer<typeof _I18nLabelsResponseDtoSchema>;
 export {};

package/dist/esm/i18n/labelling.dto.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"labelling.dto.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/i18n/labelling.dto.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,QAAA,MAAM,qBAAqB;;;;;uCAKzB,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,OAAO,qBAA6C,CAAC;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,QAAA,MAAM,2BAA2B;;;;uCAK/B,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,OAAO,2BAAyD,CAAC;AAC1G,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,QAAA,MAAM,4BAA4B;;;;uCAIhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}
+{"version":3,"file":"labelling.dto.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/i18n/labelling.dto.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,QAAA,MAAM,qBAAqB;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,oBAAoB,EAAE,OAAO,qBAA6C,CAAC;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,QAAA,MAAM,2BAA2B;;;;iBAK/B,CAAC;AAEH,eAAO,MAAM,0BAA0B,EAAE,OAAO,2BAAyD,CAAC;AAC1G,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAE/E,QAAA,MAAM,4BAA4B;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,OAAO,4BAA2D,CAAC;AAC7G,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/esm/i18n/labelling.dto.shared.schemas.js

@@ -20,4 +20,4 @@ const _I18nLabelsResponseDtoSchema = z.object({
     generatedAt: z.string(), // ISO timestamp when labels were generated
 });
 export const I18nLabelsResponseDtoSchema = _I18nLabelsResponseDtoSchema;
-//# sourceMappingURL=labelling.dto.shared.schemas.js.map
+//# sourceMappingURL=labelling.dto.shared.schemas.js.map

package/dist/esm/i18n/labelling.dto.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelling.dto.shared.schemas.js","sourceRoot":"","sources":["../../../src/i18n/labelling.dto.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAiC,qBAAqB,CAAC;AAGxF,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,wGAAwG;IACxG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAuC,2BAA2B,CAAC;AAG1G,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,0CAA0C;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,2CAA2C;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAwC,4BAA4B,CAAC"}
+{"version":3,"file":"labelling.dto.shared.schemas.js","sourceRoot":"","sources":["../../../../src/i18n/labelling.dto.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAExE,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;CAChC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAiC,qBAAqB,CAAC;AAGxF,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,wGAAwG;IACxG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAuC,2BAA2B,CAAC;AAG1G,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,0CAA0C;IACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,2CAA2C;CACrE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAwC,4BAA4B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { AvailableLanguage } from '@wildo-ai/presets-components-models';\n\nconst _EmailUpdateDtoSchema = z.object({\n  subject: z.string(),\n  bodyHtml: z.string(),\n  bodyText: z.string(),\n  lang: z.enum(AvailableLanguage),\n});\n\nexport const EmailUpdateDtoSchema: typeof _EmailUpdateDtoSchema = _EmailUpdateDtoSchema;\nexport type EmailUpdateDto = z.infer<typeof _EmailUpdateDtoSchema>;\n\nconst _I18nLabelsRequestDtoSchema = z.object({\n  language: z.enum(AvailableLanguage),\n  sections: z.array(z.string()).optional(),\n  /** Dot-path keys for sub-section granularity (e.g. `components.low_level_button`, `resources.todos`) */\n  keys: z.array(z.string()).optional(),\n});\n\nexport const I18nLabelsRequestDtoSchema: typeof _I18nLabelsRequestDtoSchema = _I18nLabelsRequestDtoSchema;\nexport type I18nLabelsRequestDto = z.infer<typeof _I18nLabelsRequestDtoSchema>;\n\nconst _I18nLabelsResponseDtoSchema = z.object({\n  language: z.enum(AvailableLanguage),\n  labels: z.record(z.string(), z.any()), // The actual labels object (StringRecord)\n  generatedAt: z.string(), // ISO timestamp when labels were generated\n});\n\nexport const I18nLabelsResponseDtoSchema: typeof _I18nLabelsResponseDtoSchema = _I18nLabelsResponseDtoSchema;\nexport type I18nLabelsResponseDto = z.infer<typeof _I18nLabelsResponseDtoSchema>;"]}