@lichens-innovation/ts-common 1.13.0 → 1.15.0

package/README.md

@@ -36,10 +36,12 @@ Table of content
     - [Web (`@lichens-innovation/ts-common/web`)](#web-lichens-innovationts-commonweb)
     - [MIME (`@lichens-innovation/ts-common/mime`)](#mime-lichens-innovationts-commonmime)
     - [Logger (`@lichens-innovation/ts-common/logger`)](#logger-lichens-innovationts-commonlogger)
+    - [RJSF (`@lichens-innovation/ts-common/rjsf`)](#rjsf-lichens-innovationts-commonrjsf)
   - [Contributions](#contributions)
   - [Unit tests](#unit-tests)
   - [Library semantic versioning](#library-semantic-versioning)
   - [Project coding guidelines](#project-coding-guidelines)
+  - [TODOs](#todos)
   - [License](#license)
 
 ## Prerequisites
@@ -64,7 +66,7 @@ Table of content
 
 ## Optional modules
 
-This library provides optional subpath modules with external dependencies. Install only the dependencies you need. For more information regarding the packaging, see the [following technical explaination](docs/packaging-approach.md).
+This library provides optional subpath modules with external dependencies. Install only the dependencies you need. For more information regarding the packaging, see the [following technical explanation](docs/packaging-approach.md).
 
 ### Excel (`@lichens-innovation/ts-common/excel`)
 
@@ -128,6 +130,33 @@ logger.debug("Debug", { userId: "123", action: "login" });
 logger.error("Error", { code: 500 });
 ```
 
+### RJSF (`@lichens-innovation/ts-common/rjsf`)
+
+Utilities and hooks for [React JSON Schema Form (RJSF)](https://rjsf-team.github.io/react-jsonschema-form/) with i18n (i18next / react-i18next), localized validation (ajv-i18n), and form layout. For React apps using RJSF with translation and validation.
+
+**Install the dependencies:**
+
+```bash
+npm install @rjsf/utils @rjsf/validator-ajv8 ajv-i18n i18next react-i18next
+```
+
+**Exports:** `initRjsf`, `useLocalizedForm`, `useRjsfValidator`, `useFormLayoutCols`, `translateRjsfString`, `RJSF_STRING_TO_I18N_KEY`, types (`LocalizedFormSchema`, `MetaFormSchema`, etc.).
+
+**Usage example:**
+
+```ts
+import { initRjsf, useLocalizedForm, useRjsfValidator } from "@lichens-innovation/ts-common/rjsf";
+
+// After i18next is initialized (e.g. initI18N())
+initRjsf();
+
+// In a form component: localized schema from meta schema
+const localizedSchema = useLocalizedForm(metaFormSchema);
+
+// Validator with localized AJV messages (e.g. fr, en)
+const validator = useRjsfValidator();
+```
+
 ## Contributions
 
 Contributions to the project are made by simply improving the current codebase and then creating a Pull Request. If the version field in `package.json` is incremented, the build will be automatically triggered when the PR is merged into the `main` branch, and the new version will be published to our enterprise Git repository.
@@ -150,6 +179,11 @@ Adhering to established coding guidelines is essential for developing efficient,
 
 * [Coding guidelines](https://github.com/amwebexpert/chrome-extensions-collection/blob/master/packages/coding-guide-helper/public/markdowns/table-of-content.md)
 
+## TODOs
+
+This section list remaining tasks (not yet completed)
+* RJSF-001: find a way to dynamically resolve the rjsf-i18n.utils "%1 Key" pattern
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/logger.cjs

@@ -103,10 +103,12 @@ var pinoLogger = createPinoLogger();
 var setLoggerMinimumLevel = (level) => {
   pinoLogger.level = level;
 };
-var consoleMethodToPinoMethod = (level) => {
-  return (...args) => {
-    pinoLogger[level](...args);
-  };
+var consoleMethodToPinoMethod = (level) => (message, payload) => {
+  if (isNullish(payload)) {
+    pinoLogger[level](message);
+  } else {
+    pinoLogger[level](payload, message);
+  }
 };
 var logger = {
   trace: consoleMethodToPinoMethod("trace"),

package/dist/logger.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/runtime-env.utils.ts","../src/logger/logger.utils.ts"],"names":["pino"],"mappings":"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","file":"logger.cjs","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\n/**\n * Returns true when running in Node.js.\n * Checks for process.versions.node to avoid false positives in Web Workers.\n */\nexport const isRuntimeEnvNodeJs = (): boolean => {\n  if (typeof window !== \"undefined\") return false;\n  if (typeof process === \"undefined\") return false;\n  if (isNullish(process?.versions?.node)) return false;\n\n  return true;\n};\n","import pino from \"pino\";\nimport { isRuntimeEnvNodeJs } from \"../utils/runtime-env.utils\";\nimport { isNullish } from \"../utils/types.utils\";\n\nconst LEVEL_LABELS: Record<number, string> = {\n  10: \"trace\",\n  20: \"debug\",\n  30: \"info\",\n  40: \"warn\",\n  50: \"error\",\n  60: \"fatal\",\n};\n\nconst LEVEL_COLORS: Record<string, string> = {\n  trace: \"color: #94a3b8\",\n  debug: \"color: #22d3ee\",\n  info: \"color: #4ade80\",\n  warn: \"color: #fbbf24\",\n  error: \"color: #f87171\",\n  fatal: \"color: #dc2626; font-weight: bold\",\n};\n\nconst MESSAGE_KEY = \"msg\";\n\ntype LogObject = Record<string, unknown> & { level?: number; time?: string; [MESSAGE_KEY]?: string };\n\nconst getLevelLabel = (levelNum: number): string => LEVEL_LABELS[levelNum] ?? \"info\";\n\nconst getLevelColor = (label: string): string => LEVEL_COLORS[label] ?? LEVEL_COLORS.info;\n\nconst getLogTimestamp = ({ time }: LogObject): string => (typeof time === \"string\" ? time : new Date().toISOString());\n\ntype ConsoleMethod = \"log\" | \"warn\" | \"error\";\nconst getConsoleMethod = (levelNum: number): ConsoleMethod => {\n  if (levelNum >= 50) return \"error\";\n  if (levelNum >= 40) return \"warn\";\n  return \"log\";\n};\n\nconst getRestPayload = (obj: LogObject): Record<string, unknown> =>\n  Object.keys(obj)\n    .filter((k) => k !== \"level\" && k !== \"time\" && k !== MESSAGE_KEY)\n    .reduce<Record<string, unknown>>((acc, k) => {\n      acc[k] = obj[k];\n      return acc;\n    }, {});\n\ntype BuildMainArgsParams = {\n  timestamp: string;\n  label: string;\n  color: string;\n  msg: unknown;\n  extraArgs: unknown[];\n  rest: Record<string, unknown>;\n};\n\nconst buildMainArgs = ({ timestamp, label, color, msg, extraArgs, rest }: BuildMainArgsParams): unknown[] => {\n  const prefix = `[${timestamp}]`;\n  const levelPart = ` ${label.toUpperCase()} `;\n  const hasRest = Object.keys(rest).length > 0;\n  const mainArgs: unknown[] = [`${prefix}%c${levelPart}%c`, color, \"color: inherit\"];\n\n  if (!isNullish(msg)) mainArgs.push(msg);\n  if (extraArgs.length > 0) mainArgs.push(...extraArgs);\n  if (hasRest) mainArgs.push(rest);\n\n  return mainArgs;\n};\n\nconst baseOptions: pino.LoggerOptions = {\n  timestamp: pino.stdTimeFunctions.isoTime,\n  messageKey: MESSAGE_KEY,\n};\n\nconst browserOptions: pino.LoggerOptions = {\n  ...baseOptions,\n  browser: {\n    write: (logObj: object, ...args: unknown[]) => {\n      const obj = logObj as LogObject;\n      const levelNum = obj.level ?? 30;\n      const label = getLevelLabel(levelNum);\n      const color = getLevelColor(label);\n      const timestamp = getLogTimestamp(obj);\n      const msg = obj[MESSAGE_KEY];\n      const rest = getRestPayload(obj);\n      const consoleMethod = getConsoleMethod(levelNum);\n      const mainArgs = buildMainArgs({\n        timestamp,\n        label,\n        color,\n        msg,\n        extraArgs: args,\n        rest,\n      });\n      (console[consoleMethod] as (...a: unknown[]) => void)(...mainArgs);\n    },\n  },\n};\n\nconst createPinoLogger = (): pino.Logger => {\n  if (isRuntimeEnvNodeJs()) {\n    try {\n      const transport = pino.transport({ target: \"pino-pretty\", options: { colorize: true } });\n      return pino(baseOptions, transport);\n    } catch (e: unknown) {\n      console.warn(\"pino-pretty not installed, using default pino output\", e);\n      return pino(baseOptions);\n    }\n  }\n\n  return pino(browserOptions);\n};\n\nconst pinoLogger = createPinoLogger();\n\nexport type Level = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nexport const setLoggerMinimumLevel = (level: Level) => {\n  pinoLogger.level = level;\n};\n\ntype ConsoleLogMethod = Console[\"log\"];\n\nconst consoleMethodToPinoMethod = (level: Level): ConsoleLogMethod => {\n  return (...args: unknown[]) => {\n    (pinoLogger[level] as ConsoleLogMethod)(...args);\n  };\n};\n\nexport const logger = {\n  trace: consoleMethodToPinoMethod(\"trace\"),\n  debug: consoleMethodToPinoMethod(\"debug\"),\n  info: consoleMethodToPinoMethod(\"info\"),\n  warn: consoleMethodToPinoMethod(\"warn\"),\n  error: consoleMethodToPinoMethod(\"error\"),\n  fatal: consoleMethodToPinoMethod(\"fatal\"),\n  log: consoleMethodToPinoMethod(\"info\"),\n};\n"]}
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/runtime-env.utils.ts","../src/logger/logger.utils.ts"],"names":["pino"],"mappings":"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","file":"logger.cjs","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\n/**\n * Returns true when running in Node.js.\n * Checks for process.versions.node to avoid false positives in Web Workers.\n */\nexport const isRuntimeEnvNodeJs = (): boolean => {\n  if (typeof window !== \"undefined\") return false;\n  if (typeof process === \"undefined\") return false;\n  if (isNullish(process?.versions?.node)) return false;\n\n  return true;\n};\n","import pino from \"pino\";\nimport { isRuntimeEnvNodeJs } from \"../utils/runtime-env.utils\";\nimport { isNullish } from \"../utils/types.utils\";\n\nconst LEVEL_LABELS: Record<number, string> = {\n  10: \"trace\",\n  20: \"debug\",\n  30: \"info\",\n  40: \"warn\",\n  50: \"error\",\n  60: \"fatal\",\n};\n\nconst LEVEL_COLORS: Record<string, string> = {\n  trace: \"color: #94a3b8\",\n  debug: \"color: #22d3ee\",\n  info: \"color: #4ade80\",\n  warn: \"color: #fbbf24\",\n  error: \"color: #f87171\",\n  fatal: \"color: #dc2626; font-weight: bold\",\n};\n\nconst MESSAGE_KEY = \"msg\";\n\ntype LogObject = Record<string, unknown> & { level?: number; time?: string; [MESSAGE_KEY]?: string };\n\nconst getLevelLabel = (levelNum: number): string => LEVEL_LABELS[levelNum] ?? \"info\";\n\nconst getLevelColor = (label: string): string => LEVEL_COLORS[label] ?? LEVEL_COLORS.info;\n\nconst getLogTimestamp = ({ time }: LogObject): string => (typeof time === \"string\" ? time : new Date().toISOString());\n\ntype ConsoleMethod = \"log\" | \"warn\" | \"error\";\nconst getConsoleMethod = (levelNum: number): ConsoleMethod => {\n  if (levelNum >= 50) return \"error\";\n  if (levelNum >= 40) return \"warn\";\n  return \"log\";\n};\n\nconst getRestPayload = (obj: LogObject): Record<string, unknown> =>\n  Object.keys(obj)\n    .filter((k) => k !== \"level\" && k !== \"time\" && k !== MESSAGE_KEY)\n    .reduce<Record<string, unknown>>((acc, k) => {\n      acc[k] = obj[k];\n      return acc;\n    }, {});\n\ntype BuildMainArgsParams = {\n  timestamp: string;\n  label: string;\n  color: string;\n  msg: unknown;\n  extraArgs: unknown[];\n  rest: Record<string, unknown>;\n};\n\nconst buildMainArgs = ({ timestamp, label, color, msg, extraArgs, rest }: BuildMainArgsParams): unknown[] => {\n  const prefix = `[${timestamp}]`;\n  const levelPart = ` ${label.toUpperCase()} `;\n  const hasRest = Object.keys(rest).length > 0;\n  const mainArgs: unknown[] = [`${prefix}%c${levelPart}%c`, color, \"color: inherit\"];\n\n  if (!isNullish(msg)) mainArgs.push(msg);\n  if (extraArgs.length > 0) mainArgs.push(...extraArgs);\n  if (hasRest) mainArgs.push(rest);\n\n  return mainArgs;\n};\n\nconst baseOptions: pino.LoggerOptions = {\n  timestamp: pino.stdTimeFunctions.isoTime,\n  messageKey: MESSAGE_KEY,\n};\n\nconst browserOptions: pino.LoggerOptions = {\n  ...baseOptions,\n  browser: {\n    write: (logObj: object, ...args: unknown[]) => {\n      const obj = logObj as LogObject;\n      const levelNum = obj.level ?? 30;\n      const label = getLevelLabel(levelNum);\n      const color = getLevelColor(label);\n      const timestamp = getLogTimestamp(obj);\n      const msg = obj[MESSAGE_KEY];\n      const rest = getRestPayload(obj);\n      const consoleMethod = getConsoleMethod(levelNum);\n      const mainArgs = buildMainArgs({\n        timestamp,\n        label,\n        color,\n        msg,\n        extraArgs: args,\n        rest,\n      });\n      (console[consoleMethod] as (...a: unknown[]) => void)(...mainArgs);\n    },\n  },\n};\n\nconst createPinoLogger = (): pino.Logger => {\n  if (isRuntimeEnvNodeJs()) {\n    try {\n      const transport = pino.transport({ target: \"pino-pretty\", options: { colorize: true } });\n      return pino(baseOptions, transport);\n    } catch (e: unknown) {\n      console.warn(\"pino-pretty not installed, using default pino output\", e);\n      return pino(baseOptions);\n    }\n  }\n\n  return pino(browserOptions);\n};\n\nconst pinoLogger = createPinoLogger();\n\nexport type Level = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nexport const setLoggerMinimumLevel = (level: Level) => {\n  pinoLogger.level = level;\n};\n\nconst consoleMethodToPinoMethod = (level: Level) => (message: string, payload?: Record<string, unknown>) => {\n  if (isNullish(payload)) {\n    pinoLogger[level](message);\n  } else {\n    pinoLogger[level](payload, message);\n  }\n};\n\nexport const logger = {\n  trace: consoleMethodToPinoMethod(\"trace\"),\n  debug: consoleMethodToPinoMethod(\"debug\"),\n  info: consoleMethodToPinoMethod(\"info\"),\n  warn: consoleMethodToPinoMethod(\"warn\"),\n  error: consoleMethodToPinoMethod(\"error\"),\n  fatal: consoleMethodToPinoMethod(\"fatal\"),\n  log: consoleMethodToPinoMethod(\"info\"),\n};\n"]}

package/dist/logger.d.cts

@@ -1,13 +1,13 @@
 type Level = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
 declare const setLoggerMinimumLevel: (level: Level) => void;
 declare const logger: {
-    trace: (...data: any[]) => void;
-    debug: (...data: any[]) => void;
-    info: (...data: any[]) => void;
-    warn: (...data: any[]) => void;
-    error: (...data: any[]) => void;
-    fatal: (...data: any[]) => void;
-    log: (...data: any[]) => void;
+    trace: (message: string, payload?: Record<string, unknown>) => void;
+    debug: (message: string, payload?: Record<string, unknown>) => void;
+    info: (message: string, payload?: Record<string, unknown>) => void;
+    warn: (message: string, payload?: Record<string, unknown>) => void;
+    error: (message: string, payload?: Record<string, unknown>) => void;
+    fatal: (message: string, payload?: Record<string, unknown>) => void;
+    log: (message: string, payload?: Record<string, unknown>) => void;
 };
 
 export { type Level, logger, setLoggerMinimumLevel };

package/dist/logger.d.ts

@@ -1,13 +1,13 @@
 type Level = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
 declare const setLoggerMinimumLevel: (level: Level) => void;
 declare const logger: {
-    trace: (...data: any[]) => void;
-    debug: (...data: any[]) => void;
-    info: (...data: any[]) => void;
-    warn: (...data: any[]) => void;
-    error: (...data: any[]) => void;
-    fatal: (...data: any[]) => void;
-    log: (...data: any[]) => void;
+    trace: (message: string, payload?: Record<string, unknown>) => void;
+    debug: (message: string, payload?: Record<string, unknown>) => void;
+    info: (message: string, payload?: Record<string, unknown>) => void;
+    warn: (message: string, payload?: Record<string, unknown>) => void;
+    error: (message: string, payload?: Record<string, unknown>) => void;
+    fatal: (message: string, payload?: Record<string, unknown>) => void;
+    log: (message: string, payload?: Record<string, unknown>) => void;
 };
 
 export { type Level, logger, setLoggerMinimumLevel };

package/dist/logger.js

@@ -97,10 +97,12 @@ var pinoLogger = createPinoLogger();
 var setLoggerMinimumLevel = (level) => {
   pinoLogger.level = level;
 };
-var consoleMethodToPinoMethod = (level) => {
-  return (...args) => {
-    pinoLogger[level](...args);
-  };
+var consoleMethodToPinoMethod = (level) => (message, payload) => {
+  if (isNullish(payload)) {
+    pinoLogger[level](message);
+  } else {
+    pinoLogger[level](payload, message);
+  }
 };
 var logger = {
   trace: consoleMethodToPinoMethod("trace"),

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/runtime-env.utils.ts","../src/logger/logger.utils.ts"],"names":[],"mappings":"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","file":"logger.js","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\n/**\n * Returns true when running in Node.js.\n * Checks for process.versions.node to avoid false positives in Web Workers.\n */\nexport const isRuntimeEnvNodeJs = (): boolean => {\n  if (typeof window !== \"undefined\") return false;\n  if (typeof process === \"undefined\") return false;\n  if (isNullish(process?.versions?.node)) return false;\n\n  return true;\n};\n","import pino from \"pino\";\nimport { isRuntimeEnvNodeJs } from \"../utils/runtime-env.utils\";\nimport { isNullish } from \"../utils/types.utils\";\n\nconst LEVEL_LABELS: Record<number, string> = {\n  10: \"trace\",\n  20: \"debug\",\n  30: \"info\",\n  40: \"warn\",\n  50: \"error\",\n  60: \"fatal\",\n};\n\nconst LEVEL_COLORS: Record<string, string> = {\n  trace: \"color: #94a3b8\",\n  debug: \"color: #22d3ee\",\n  info: \"color: #4ade80\",\n  warn: \"color: #fbbf24\",\n  error: \"color: #f87171\",\n  fatal: \"color: #dc2626; font-weight: bold\",\n};\n\nconst MESSAGE_KEY = \"msg\";\n\ntype LogObject = Record<string, unknown> & { level?: number; time?: string; [MESSAGE_KEY]?: string };\n\nconst getLevelLabel = (levelNum: number): string => LEVEL_LABELS[levelNum] ?? \"info\";\n\nconst getLevelColor = (label: string): string => LEVEL_COLORS[label] ?? LEVEL_COLORS.info;\n\nconst getLogTimestamp = ({ time }: LogObject): string => (typeof time === \"string\" ? time : new Date().toISOString());\n\ntype ConsoleMethod = \"log\" | \"warn\" | \"error\";\nconst getConsoleMethod = (levelNum: number): ConsoleMethod => {\n  if (levelNum >= 50) return \"error\";\n  if (levelNum >= 40) return \"warn\";\n  return \"log\";\n};\n\nconst getRestPayload = (obj: LogObject): Record<string, unknown> =>\n  Object.keys(obj)\n    .filter((k) => k !== \"level\" && k !== \"time\" && k !== MESSAGE_KEY)\n    .reduce<Record<string, unknown>>((acc, k) => {\n      acc[k] = obj[k];\n      return acc;\n    }, {});\n\ntype BuildMainArgsParams = {\n  timestamp: string;\n  label: string;\n  color: string;\n  msg: unknown;\n  extraArgs: unknown[];\n  rest: Record<string, unknown>;\n};\n\nconst buildMainArgs = ({ timestamp, label, color, msg, extraArgs, rest }: BuildMainArgsParams): unknown[] => {\n  const prefix = `[${timestamp}]`;\n  const levelPart = ` ${label.toUpperCase()} `;\n  const hasRest = Object.keys(rest).length > 0;\n  const mainArgs: unknown[] = [`${prefix}%c${levelPart}%c`, color, \"color: inherit\"];\n\n  if (!isNullish(msg)) mainArgs.push(msg);\n  if (extraArgs.length > 0) mainArgs.push(...extraArgs);\n  if (hasRest) mainArgs.push(rest);\n\n  return mainArgs;\n};\n\nconst baseOptions: pino.LoggerOptions = {\n  timestamp: pino.stdTimeFunctions.isoTime,\n  messageKey: MESSAGE_KEY,\n};\n\nconst browserOptions: pino.LoggerOptions = {\n  ...baseOptions,\n  browser: {\n    write: (logObj: object, ...args: unknown[]) => {\n      const obj = logObj as LogObject;\n      const levelNum = obj.level ?? 30;\n      const label = getLevelLabel(levelNum);\n      const color = getLevelColor(label);\n      const timestamp = getLogTimestamp(obj);\n      const msg = obj[MESSAGE_KEY];\n      const rest = getRestPayload(obj);\n      const consoleMethod = getConsoleMethod(levelNum);\n      const mainArgs = buildMainArgs({\n        timestamp,\n        label,\n        color,\n        msg,\n        extraArgs: args,\n        rest,\n      });\n      (console[consoleMethod] as (...a: unknown[]) => void)(...mainArgs);\n    },\n  },\n};\n\nconst createPinoLogger = (): pino.Logger => {\n  if (isRuntimeEnvNodeJs()) {\n    try {\n      const transport = pino.transport({ target: \"pino-pretty\", options: { colorize: true } });\n      return pino(baseOptions, transport);\n    } catch (e: unknown) {\n      console.warn(\"pino-pretty not installed, using default pino output\", e);\n      return pino(baseOptions);\n    }\n  }\n\n  return pino(browserOptions);\n};\n\nconst pinoLogger = createPinoLogger();\n\nexport type Level = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nexport const setLoggerMinimumLevel = (level: Level) => {\n  pinoLogger.level = level;\n};\n\ntype ConsoleLogMethod = Console[\"log\"];\n\nconst consoleMethodToPinoMethod = (level: Level): ConsoleLogMethod => {\n  return (...args: unknown[]) => {\n    (pinoLogger[level] as ConsoleLogMethod)(...args);\n  };\n};\n\nexport const logger = {\n  trace: consoleMethodToPinoMethod(\"trace\"),\n  debug: consoleMethodToPinoMethod(\"debug\"),\n  info: consoleMethodToPinoMethod(\"info\"),\n  warn: consoleMethodToPinoMethod(\"warn\"),\n  error: consoleMethodToPinoMethod(\"error\"),\n  fatal: consoleMethodToPinoMethod(\"fatal\"),\n  log: consoleMethodToPinoMethod(\"info\"),\n};\n"]}
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/runtime-env.utils.ts","../src/logger/logger.utils.ts"],"names":[],"mappings":"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","file":"logger.js","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { isNullish } from \"./types.utils\";\n\n/**\n * Returns true when running in Node.js.\n * Checks for process.versions.node to avoid false positives in Web Workers.\n */\nexport const isRuntimeEnvNodeJs = (): boolean => {\n  if (typeof window !== \"undefined\") return false;\n  if (typeof process === \"undefined\") return false;\n  if (isNullish(process?.versions?.node)) return false;\n\n  return true;\n};\n","import pino from \"pino\";\nimport { isRuntimeEnvNodeJs } from \"../utils/runtime-env.utils\";\nimport { isNullish } from \"../utils/types.utils\";\n\nconst LEVEL_LABELS: Record<number, string> = {\n  10: \"trace\",\n  20: \"debug\",\n  30: \"info\",\n  40: \"warn\",\n  50: \"error\",\n  60: \"fatal\",\n};\n\nconst LEVEL_COLORS: Record<string, string> = {\n  trace: \"color: #94a3b8\",\n  debug: \"color: #22d3ee\",\n  info: \"color: #4ade80\",\n  warn: \"color: #fbbf24\",\n  error: \"color: #f87171\",\n  fatal: \"color: #dc2626; font-weight: bold\",\n};\n\nconst MESSAGE_KEY = \"msg\";\n\ntype LogObject = Record<string, unknown> & { level?: number; time?: string; [MESSAGE_KEY]?: string };\n\nconst getLevelLabel = (levelNum: number): string => LEVEL_LABELS[levelNum] ?? \"info\";\n\nconst getLevelColor = (label: string): string => LEVEL_COLORS[label] ?? LEVEL_COLORS.info;\n\nconst getLogTimestamp = ({ time }: LogObject): string => (typeof time === \"string\" ? time : new Date().toISOString());\n\ntype ConsoleMethod = \"log\" | \"warn\" | \"error\";\nconst getConsoleMethod = (levelNum: number): ConsoleMethod => {\n  if (levelNum >= 50) return \"error\";\n  if (levelNum >= 40) return \"warn\";\n  return \"log\";\n};\n\nconst getRestPayload = (obj: LogObject): Record<string, unknown> =>\n  Object.keys(obj)\n    .filter((k) => k !== \"level\" && k !== \"time\" && k !== MESSAGE_KEY)\n    .reduce<Record<string, unknown>>((acc, k) => {\n      acc[k] = obj[k];\n      return acc;\n    }, {});\n\ntype BuildMainArgsParams = {\n  timestamp: string;\n  label: string;\n  color: string;\n  msg: unknown;\n  extraArgs: unknown[];\n  rest: Record<string, unknown>;\n};\n\nconst buildMainArgs = ({ timestamp, label, color, msg, extraArgs, rest }: BuildMainArgsParams): unknown[] => {\n  const prefix = `[${timestamp}]`;\n  const levelPart = ` ${label.toUpperCase()} `;\n  const hasRest = Object.keys(rest).length > 0;\n  const mainArgs: unknown[] = [`${prefix}%c${levelPart}%c`, color, \"color: inherit\"];\n\n  if (!isNullish(msg)) mainArgs.push(msg);\n  if (extraArgs.length > 0) mainArgs.push(...extraArgs);\n  if (hasRest) mainArgs.push(rest);\n\n  return mainArgs;\n};\n\nconst baseOptions: pino.LoggerOptions = {\n  timestamp: pino.stdTimeFunctions.isoTime,\n  messageKey: MESSAGE_KEY,\n};\n\nconst browserOptions: pino.LoggerOptions = {\n  ...baseOptions,\n  browser: {\n    write: (logObj: object, ...args: unknown[]) => {\n      const obj = logObj as LogObject;\n      const levelNum = obj.level ?? 30;\n      const label = getLevelLabel(levelNum);\n      const color = getLevelColor(label);\n      const timestamp = getLogTimestamp(obj);\n      const msg = obj[MESSAGE_KEY];\n      const rest = getRestPayload(obj);\n      const consoleMethod = getConsoleMethod(levelNum);\n      const mainArgs = buildMainArgs({\n        timestamp,\n        label,\n        color,\n        msg,\n        extraArgs: args,\n        rest,\n      });\n      (console[consoleMethod] as (...a: unknown[]) => void)(...mainArgs);\n    },\n  },\n};\n\nconst createPinoLogger = (): pino.Logger => {\n  if (isRuntimeEnvNodeJs()) {\n    try {\n      const transport = pino.transport({ target: \"pino-pretty\", options: { colorize: true } });\n      return pino(baseOptions, transport);\n    } catch (e: unknown) {\n      console.warn(\"pino-pretty not installed, using default pino output\", e);\n      return pino(baseOptions);\n    }\n  }\n\n  return pino(browserOptions);\n};\n\nconst pinoLogger = createPinoLogger();\n\nexport type Level = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n\nexport const setLoggerMinimumLevel = (level: Level) => {\n  pinoLogger.level = level;\n};\n\nconst consoleMethodToPinoMethod = (level: Level) => (message: string, payload?: Record<string, unknown>) => {\n  if (isNullish(payload)) {\n    pinoLogger[level](message);\n  } else {\n    pinoLogger[level](payload, message);\n  }\n};\n\nexport const logger = {\n  trace: consoleMethodToPinoMethod(\"trace\"),\n  debug: consoleMethodToPinoMethod(\"debug\"),\n  info: consoleMethodToPinoMethod(\"info\"),\n  warn: consoleMethodToPinoMethod(\"warn\"),\n  error: consoleMethodToPinoMethod(\"error\"),\n  fatal: consoleMethodToPinoMethod(\"fatal\"),\n  log: consoleMethodToPinoMethod(\"info\"),\n};\n"]}

package/dist/rjsf.cjs

@@ -0,0 +1,216 @@
+'use strict';
+
+var i18next = require('i18next');
+var utils = require('@rjsf/utils');
+var reactI18next = require('react-i18next');
+var validatorAjv8 = require('@rjsf/validator-ajv8');
+var localizer = require('ajv-i18n');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var i18next__default = /*#__PURE__*/_interopDefault(i18next);
+var localizer__default = /*#__PURE__*/_interopDefault(localizer);
+
+// src/rjsf/i18n/i18n.ts
+
+// src/rjsf/i18n/en/rjsf.json
+var rjsf_default = {
+  rjsf: {
+    add: "Add",
+    debugFormDataTitle: "JSON data",
+    addItem: "Add Item",
+    clear: "Clear",
+    errors: "Errors detected in the form",
+    copy: "Copy",
+    keyLabel: "%1 Key",
+    moveDown: "Move down",
+    moveUp: "Move up",
+    no: "No",
+    remove: "Remove",
+    submit: "Submit",
+    yes: "Yes"
+  }
+};
+
+// src/rjsf/i18n/fr/rjsf.json
+var rjsf_default2 = {
+  rjsf: {
+    add: "Ajouter",
+    debugFormDataTitle: "Donn\xE9es JSON",
+    addItem: "Ajouter un \xE9l\xE9ment",
+    clear: "Effacer",
+    errors: "Erreurs d\xE9tect\xE9es dans le formulaire",
+    copy: "Copier",
+    keyLabel: "Cl\xE9 %1",
+    moveDown: "D\xE9placer vers le bas",
+    moveUp: "D\xE9placer vers le haut",
+    no: "Non",
+    remove: "Supprimer",
+    submit: "Envoyer",
+    yes: "Oui"
+  }
+};
+
+// src/rjsf/i18n/i18n.ts
+var NAMESPACE = "rjsf";
+var initRjsf = () => {
+  if (!i18next__default.default.isInitialized) {
+    throw new Error("[initRjsf] i18next must be initialized before calling initRjsf. Call initI18N() or i18next.init() first.");
+  }
+  if (i18next__default.default.hasResourceBundle("en", NAMESPACE)) return;
+  const isDeep = true;
+  const isOverwrite = true;
+  i18next__default.default.addResourceBundle("en", NAMESPACE, rjsf_default.rjsf, isDeep, isOverwrite);
+  i18next__default.default.addResourceBundle("fr", NAMESPACE, rjsf_default2.rjsf, isDeep, isOverwrite);
+  console.info("[initRjsf] RJSF i18n initialized");
+};
+
+// src/utils/types.utils.ts
+var isNullish = (value) => value === null || value === void 0;
+
+// src/utils/string.utils.ts
+var isBlank = (str) => {
+  return isNullish(str) || str?.trim() === "";
+};
+
+// src/rjsf/utils/rjsf-i18n.utils.ts
+var RJSF_STRING_TO_I18N_KEY = {
+  "Add Item": "rjsf:addItem",
+  Add: "rjsf:add",
+  Copy: "rjsf:copy",
+  "Move down": "rjsf:moveDown",
+  "Move up": "rjsf:moveUp",
+  Remove: "rjsf:remove",
+  "clear input": "rjsf:clear",
+  "%1 Key": "rjsf:keyLabel",
+  // TODO: RJSF-001 find a way to dynamicaly resolve the rjsf-i18n.utils "%1 Key" pattern
+  Yes: "rjsf:yes",
+  No: "rjsf:no",
+  Errors: "rjsf:errors"
+};
+var translateRjsfString = ({ stringToTranslate, params }) => {
+  const i18nKey = RJSF_STRING_TO_I18N_KEY[stringToTranslate];
+  if (isBlank(i18nKey)) {
+    console.warn(`[translateRjsfString] RJSF i18n: missing key: "${stringToTranslate}"`);
+  }
+  const translated = i18nKey ? i18next__default.default.t(i18nKey) : stringToTranslate;
+  return utils.replaceStringParameters(translated, params);
+};
+
+// src/rjsf/utils/rjsf-widgets.utils.ts
+var hasRjsfErrors = (rawErrors) => Array.isArray(rawErrors) && rawErrors.length > 0;
+var getRjsfDisplayLabel = ({ label, required, hideLabel }) => {
+  if (hideLabel) return void 0;
+  if (isBlank(label)) return void 0;
+  const requiredSuffix = required ? " *" : "";
+  return `${label}${requiredSuffix}`;
+};
+var toEnumOptionDisplay = (o) => ({
+  label: o?.label ?? String(o?.value ?? ""),
+  value: String(o?.value ?? "")
+});
+var mapEnumOptions = (options) => {
+  const enumOptions = options?.enumOptions;
+  if (!Array.isArray(enumOptions)) return [];
+  return enumOptions.map(toEnumOptionDisplay);
+};
+var toStringOrEmpty = (value) => isNullish(value) ? "" : String(value);
+var toStringOrUndefined = (value) => isNullish(value) ? void 0 : String(value);
+var getRjsfTextChangeValue = ({ text, emptyValue }) => {
+  if (text === "") return emptyValue;
+  return text;
+};
+var parseDateOrNull = (value) => {
+  if (isBlank(value)) return null;
+  const date = new Date(value);
+  const isValid = !Number.isNaN(date.getTime());
+  return isValid ? date : null;
+};
+var dateToDateOnlyString = (date) => {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+};
+var DATE_ONLY_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+var parseDateOnlyToLocalDate = (value) => {
+  if (isBlank(value)) return null;
+  const trimmed = String(value).trim();
+  const dateOnly = trimmed.slice(0, 10);
+  if (!DATE_ONLY_REGEX.test(dateOnly)) return null;
+  const [y, m, d] = dateOnly.split("-").map(Number);
+  return new Date(y, m - 1, d);
+};
+var formatDateOnlyForDisplay = (value) => {
+  if (isBlank(value)) return "";
+  const trimmed = String(value).trim();
+  const dateOnly = trimmed.slice(0, 10);
+  return DATE_ONLY_REGEX.test(dateOnly) ? dateOnly : "";
+};
+var formatDateTimeForDisplay = (value) => {
+  const date = parseDateOrNull(value);
+  return date ? date.toLocaleString() : "";
+};
+var DEFAULT_SPAN = 24;
+var getFormLayoutCols = (formContext) => {
+  if (isNullish(formContext)) {
+    return {
+      labelCol: { span: DEFAULT_SPAN },
+      wrapperCol: { span: DEFAULT_SPAN }
+    };
+  }
+  const { labelCol, wrapperCol } = formContext;
+  return {
+    labelCol: labelCol ?? { span: DEFAULT_SPAN },
+    wrapperCol: wrapperCol ?? { span: DEFAULT_SPAN }
+  };
+};
+var DEFAULT_LANGUAGE = "fr";
+var parseSimplifiedLangCode = (language) => {
+  if (isBlank(language)) return DEFAULT_LANGUAGE;
+  return language.split("-")[0];
+};
+var getFallbackLanguage = (metaFormSchema) => {
+  return Object.keys(metaFormSchema.i18n)[0] ?? DEFAULT_LANGUAGE;
+};
+var useLocalizedForm = (metaFormSchema) => {
+  const { i18n } = reactI18next.useTranslation();
+  const language = parseSimplifiedLangCode(i18n.language);
+  if (metaFormSchema.i18n[language]) {
+    return metaFormSchema.i18n[language];
+  }
+  const fallbackLanguage = getFallbackLanguage(metaFormSchema);
+  console.warn(
+    `Language ${language} not found in metaFormSchema ${metaFormSchema.id}. Falling back to ${fallbackLanguage}.`
+  );
+  return metaFormSchema.i18n[fallbackLanguage];
+};
+var customFormats = {
+  "phone-america": /^\(?\d{3}\)?[\s-]?\d{3}[\s-]?\d{4}$/
+};
+var useRjsfValidator = () => {
+  const { i18n } = reactI18next.useTranslation();
+  const appLanguage = i18n.language;
+  const localizerFn = localizer__default.default[appLanguage] ?? localizer__default.default.en;
+  return validatorAjv8.customizeValidator({ customFormats }, localizerFn);
+};
+
+exports.RJSF_STRING_TO_I18N_KEY = RJSF_STRING_TO_I18N_KEY;
+exports.dateToDateOnlyString = dateToDateOnlyString;
+exports.formatDateOnlyForDisplay = formatDateOnlyForDisplay;
+exports.formatDateTimeForDisplay = formatDateTimeForDisplay;
+exports.getFormLayoutCols = getFormLayoutCols;
+exports.getRjsfDisplayLabel = getRjsfDisplayLabel;
+exports.getRjsfTextChangeValue = getRjsfTextChangeValue;
+exports.hasRjsfErrors = hasRjsfErrors;
+exports.initRjsf = initRjsf;
+exports.mapEnumOptions = mapEnumOptions;
+exports.parseDateOnlyToLocalDate = parseDateOnlyToLocalDate;
+exports.parseDateOrNull = parseDateOrNull;
+exports.toStringOrEmpty = toStringOrEmpty;
+exports.toStringOrUndefined = toStringOrUndefined;
+exports.translateRjsfString = translateRjsfString;
+exports.useLocalizedForm = useLocalizedForm;
+exports.useRjsfValidator = useRjsfValidator;
+//# sourceMappingURL=rjsf.cjs.map
+//# sourceMappingURL=rjsf.cjs.map

package/dist/rjsf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rjsf/i18n/en/rjsf.json","../src/rjsf/i18n/fr/rjsf.json","../src/rjsf/i18n/i18n.ts","../src/utils/types.utils.ts","../src/utils/string.utils.ts","../src/rjsf/utils/rjsf-i18n.utils.ts","../src/rjsf/utils/rjsf-widgets.utils.ts","../src/rjsf/utils/use-localized-form.ts","../src/rjsf/utils/use-rjsf-validator.ts"],"names":["rjsf_default","i18next","replaceStringParameters","useTranslation","localizer","customizeValidator"],"mappings":"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","file":"rjsf.cjs","sourcesContent":["{\n  \"rjsf\": {\n    \"add\": \"Add\",\n    \"debugFormDataTitle\": \"JSON data\",\n    \"addItem\": \"Add Item\",\n    \"clear\": \"Clear\",\n    \"errors\": \"Errors detected in the form\",\n    \"copy\": \"Copy\",\n    \"keyLabel\": \"%1 Key\",\n    \"moveDown\": \"Move down\",\n    \"moveUp\": \"Move up\",\n    \"no\": \"No\",\n    \"remove\": \"Remove\",\n    \"submit\": \"Submit\",\n    \"yes\": \"Yes\"\n  }\n}\n","{\n  \"rjsf\": {\n    \"add\": \"Ajouter\",\n    \"debugFormDataTitle\": \"Données JSON\",\n    \"addItem\": \"Ajouter un élément\",\n    \"clear\": \"Effacer\",\n    \"errors\": \"Erreurs détectées dans le formulaire\",\n    \"copy\": \"Copier\",\n    \"keyLabel\": \"Clé %1\",\n    \"moveDown\": \"Déplacer vers le bas\",\n    \"moveUp\": \"Déplacer vers le haut\",\n    \"no\": \"Non\",\n    \"remove\": \"Supprimer\",\n    \"submit\": \"Envoyer\",\n    \"yes\": \"Oui\"\n  }\n}\n","import i18next from \"i18next\";\n\nimport en from \"./en/rjsf.json\";\nimport fr from \"./fr/rjsf.json\";\n\nconst NAMESPACE = \"rjsf\";\n\nexport const initRjsf = (): void => {\n  if (!i18next.isInitialized) {\n    throw new Error(\"[initRjsf] i18next must be initialized before calling initRjsf. Call initI18N() or i18next.init() first.\");\n  }\n\n  if (i18next.hasResourceBundle(\"en\", NAMESPACE)) return;\n\n  const isDeep = true;\n  const isOverwrite = true;\n\n  i18next.addResourceBundle(\"en\", NAMESPACE, en.rjsf, isDeep, isOverwrite);\n  i18next.addResourceBundle(\"fr\", NAMESPACE, fr.rjsf, isDeep, isOverwrite);\n\n  // eslint-disable-next-line no-console\n  console.info('[initRjsf] RJSF i18n initialized');  \n};\n","export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n\n/**\n * Parses an optional comma-separated string into a trimmed, non-blank string array.\n */\nexport const parseCommaSeparatedList = (raw?: string | null): string[] => {\n  if (isBlank(raw)) {\n    return [];\n  }\n\n  return raw\n    .split(\",\")\n    .map((s: string) => s.trim())\n    .filter(isNotBlank);\n};\n","import { replaceStringParameters } from \"@rjsf/utils\";\nimport i18next from \"i18next\";\nimport { isBlank } from \"~/utils/string.utils\";\n\n/** Maps RJSF TranslatableString values to our i18n keys (rjsf namespace). */\nexport const RJSF_STRING_TO_I18N_KEY: Record<string, string> = {\n  \"Add Item\": \"rjsf:addItem\",\n  Add: \"rjsf:add\",\n  Copy: \"rjsf:copy\",\n  \"Move down\": \"rjsf:moveDown\",\n  \"Move up\": \"rjsf:moveUp\",\n  Remove: \"rjsf:remove\",\n  \"clear input\": \"rjsf:clear\",\n  \"%1 Key\": \"rjsf:keyLabel\", // TODO: RJSF-001 find a way to dynamicaly resolve the rjsf-i18n.utils \"%1 Key\" pattern\n  Yes: \"rjsf:yes\",\n  No: \"rjsf:no\",\n  Errors: \"rjsf:errors\",\n};\n\ninterface TranslateStringArgs {\n  stringToTranslate: string;\n  params?: string[];\n}\n\nexport const translateRjsfString = ({ stringToTranslate, params }: TranslateStringArgs): string => {\n  const i18nKey = RJSF_STRING_TO_I18N_KEY[stringToTranslate];\n  if (isBlank(i18nKey)) {\n    // eslint-disable-next-line no-console\n    console.warn(`[translateRjsfString] RJSF i18n: missing key: \"${stringToTranslate}\"`);\n  }\n\n  const translated = i18nKey ? i18next.t(i18nKey) : stringToTranslate;\n  return replaceStringParameters(translated, params);\n};\n","import type { WidgetProps } from \"@rjsf/utils\";\nimport { isBlank } from \"~/utils/string.utils\";\nimport { isNullish } from \"~/utils/types.utils\";\n\n/**\n * Returns true when the widget has at least one validation error from RJSF.\n *\n * @param rawErrors - The rawErrors from WidgetProps (often `unknown`).\n * @returns true if rawErrors is a non-empty array.\n */\nexport const hasRjsfErrors = (rawErrors: unknown): boolean => Array.isArray(rawErrors) && rawErrors.length > 0;\n\nexport interface GetRjsfDisplayLabelArgs {\n  label?: string;\n  required?: boolean;\n  hideLabel?: boolean;\n}\n\n/**\n * Returns the label to display for an RJSF widget, with optional required asterisk and\n * hideLabel support.\n *\n * @param label - The label to display for the widget.\n * @param required - Whether the field is required.\n * @param hideLabel - Whether to hide the label.\n *\n * @returns The label to display for the widget.\n */\nexport const getRjsfDisplayLabel = ({ label, required, hideLabel }: GetRjsfDisplayLabelArgs): string | undefined => {\n  if (hideLabel) return undefined;\n  if (isBlank(label)) return undefined;\n\n  const requiredSuffix = required ? \" *\" : \"\";\n  return `${label}${requiredSuffix}`;\n};\n\ninterface EnumOption {\n  value: string;\n  label: string;\n}\n\nexport type EnumOptionDisplay = { label: string; value: string };\n\nconst toEnumOptionDisplay = (o: EnumOption): EnumOptionDisplay => ({\n  label: o?.label ?? String(o?.value ?? \"\"),\n  value: String(o?.value ?? \"\"),\n});\n\nexport const mapEnumOptions = (options: WidgetProps[\"options\"]): EnumOptionDisplay[] => {\n  const enumOptions = options?.enumOptions as EnumOption[] | undefined;\n  if (!Array.isArray(enumOptions)) return [];\n  return enumOptions.map(toEnumOptionDisplay);\n};\n\n/**\n * Converts a value to display string, or empty string when null/undefined.\n */\nexport const toStringOrEmpty = (value: unknown): string => (isNullish(value) ? \"\" : String(value));\n\n/**\n * Converts a value to display string, or undefined when null/undefined (e.g. for select placeholder).\n */\nexport const toStringOrUndefined = (value: unknown): string | undefined =>\n  isNullish(value) ? undefined : String(value);\n\nexport interface GetRjsfTextChangeValueArgs {\n  text: string;\n  emptyValue?: unknown;\n}\n\n/**\n * Returns the value to pass to onChange for a text input.\n *\n * @param args.text - The current text input value.\n * @param args.emptyValue - The value to use when text is empty (e.g. options.emptyValue from WidgetProps).\n * @returns emptyValue when text is empty, otherwise text.\n */\nexport const getRjsfTextChangeValue = ({ text, emptyValue }: GetRjsfTextChangeValueArgs): unknown => {\n  if (text === \"\") return emptyValue;\n  return text;\n};\n\nexport const parseDateOrNull = (value?: string): Date | null => {\n  if (isBlank(value)) return null;\n\n  const date = new Date(value);\n  const isValid = !Number.isNaN(date.getTime());\n  return isValid ? date : null;\n};\n\n/** Returns YYYY-MM-DD for JSON Schema \"date\" format (form storage). */\nexport const dateToDateOnlyString = (date: Date): string => {\n  const y = date.getFullYear();\n  const m = String(date.getMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getDate()).padStart(2, \"0\");\n  return `${y}-${m}-${d}`;\n};\n\nconst DATE_ONLY_REGEX = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** Parses a date-only or full ISO string into a Date at local midnight (for date picker display). */\nexport const parseDateOnlyToLocalDate = (value?: string): Date | null => {\n  if (isBlank(value)) return null;\n\n  const trimmed = String(value).trim();\n  const dateOnly = trimmed.slice(0, 10);\n  if (!DATE_ONLY_REGEX.test(dateOnly)) return null;\n\n  const [y, m, d] = dateOnly.split(\"-\").map(Number);\n  return new Date(y, m - 1, d);\n};\n\n/** Extracts date-only YYYY-MM-DD for display from a full ISO or date-only string. */\nexport const formatDateOnlyForDisplay = (value?: string): string => {\n  if (isBlank(value)) return \"\";\n\n  const trimmed = String(value).trim();\n  const dateOnly = trimmed.slice(0, 10);\n  return DATE_ONLY_REGEX.test(dateOnly) ? dateOnly : \"\";\n};\n\n/** Formats a full ISO or date string for date-time display (locale string). */\nexport const formatDateTimeForDisplay = (value?: string): string => {\n  const date = parseDateOrNull(value);\n  return date ? date.toLocaleString() : \"\";\n};\n\ntype FormLayoutContext = {\n  labelCol?: { span: number };\n  wrapperCol?: { span: number };\n};\n\nconst DEFAULT_SPAN = 24;\n\nexport const getFormLayoutCols = (formContext?: unknown): FormLayoutContext => {\n  if (isNullish(formContext)) {\n    return {\n      labelCol: { span: DEFAULT_SPAN },\n      wrapperCol: { span: DEFAULT_SPAN },\n    };\n  }\n\n  const { labelCol, wrapperCol } = formContext as FormLayoutContext;\n  return {\n    labelCol: labelCol ?? { span: DEFAULT_SPAN },\n    wrapperCol: wrapperCol ?? { span: DEFAULT_SPAN },\n  };\n};\n","import { isBlank } from \"~/utils/string.utils\";\nimport { useTranslation } from \"react-i18next\";\nimport type { LocalizedFormSchema, MetaFormSchema } from \"./rjsf-i18n-types\";\n\nconst DEFAULT_LANGUAGE = \"fr\";\n\n// i18n.language can be 'fr-CA', so we take the first part\nconst parseSimplifiedLangCode = (language?: string): string => {\n  if (isBlank(language)) return DEFAULT_LANGUAGE;\n  return language.split(\"-\")[0];\n};\n\nconst getFallbackLanguage = (metaFormSchema: MetaFormSchema): string => {\n  return Object.keys(metaFormSchema.i18n)[0] ?? DEFAULT_LANGUAGE;\n};\n\nexport const useLocalizedForm = (metaFormSchema: MetaFormSchema): LocalizedFormSchema => {\n  const { i18n } = useTranslation();\n  const language = parseSimplifiedLangCode(i18n.language);\n\n  if (metaFormSchema.i18n[language]) {\n    return metaFormSchema.i18n[language];\n  }\n\n  const fallbackLanguage = getFallbackLanguage(metaFormSchema);\n  // eslint-disable-next-line no-console\n  console.warn(\n    `Language ${language} not found in metaFormSchema ${metaFormSchema.id}. Falling back to ${fallbackLanguage}.`\n  );\n\n  return metaFormSchema.i18n[fallbackLanguage];\n};\n","import { customizeValidator, type Localizer } from \"@rjsf/validator-ajv8\";\nimport localizer from \"ajv-i18n\";\nimport { useTranslation } from \"react-i18next\";\n\nconst customFormats = {\n  \"phone-america\": /^\\(?\\d{3}\\)?[\\s-]?\\d{3}[\\s-]?\\d{4}$/,\n};\n\ntype ValidationLanguages = keyof typeof localizer;\n\nexport const useRjsfValidator = () => {\n  const { i18n } = useTranslation();\n  const appLanguage = i18n.language as ValidationLanguages;\n  const localizerFn: Localizer = localizer[appLanguage] ?? localizer.en;\n\n  return customizeValidator({ customFormats }, localizerFn);\n};\n"]}

package/dist/rjsf.d.cts

@@ -0,0 +1,101 @@
+import * as _rjsf_utils from '@rjsf/utils';
+import { TranslatableString, RJSFSchema, UiSchema, WidgetProps } from '@rjsf/utils';
+import * as _rjsf_validator_ajv8_lib_validator_js from '@rjsf/validator-ajv8/lib/validator.js';
+
+declare const initRjsf: () => void;
+
+type Language = string;
+/** Registry shape with translation used by RJSF template buttons. */
+type RjsfRegistryWithTranslate = {
+    translateString: (s: TranslatableString) => string;
+};
+interface LocalizedFormSchema {
+    schema: RJSFSchema;
+    uiSchema: UiSchema;
+}
+interface MetaFormSchema {
+    id: string;
+    version: string;
+    i18n: Record<Language, LocalizedFormSchema>;
+}
+
+/** Maps RJSF TranslatableString values to our i18n keys (rjsf namespace). */
+declare const RJSF_STRING_TO_I18N_KEY: Record<string, string>;
+interface TranslateStringArgs {
+    stringToTranslate: string;
+    params?: string[];
+}
+declare const translateRjsfString: ({ stringToTranslate, params }: TranslateStringArgs) => string;
+
+/**
+ * Returns true when the widget has at least one validation error from RJSF.
+ *
+ * @param rawErrors - The rawErrors from WidgetProps (often `unknown`).
+ * @returns true if rawErrors is a non-empty array.
+ */
+declare const hasRjsfErrors: (rawErrors: unknown) => boolean;
+interface GetRjsfDisplayLabelArgs {
+    label?: string;
+    required?: boolean;
+    hideLabel?: boolean;
+}
+/**
+ * Returns the label to display for an RJSF widget, with optional required asterisk and
+ * hideLabel support.
+ *
+ * @param label - The label to display for the widget.
+ * @param required - Whether the field is required.
+ * @param hideLabel - Whether to hide the label.
+ *
+ * @returns The label to display for the widget.
+ */
+declare const getRjsfDisplayLabel: ({ label, required, hideLabel }: GetRjsfDisplayLabelArgs) => string | undefined;
+type EnumOptionDisplay = {
+    label: string;
+    value: string;
+};
+declare const mapEnumOptions: (options: WidgetProps["options"]) => EnumOptionDisplay[];
+/**
+ * Converts a value to display string, or empty string when null/undefined.
+ */
+declare const toStringOrEmpty: (value: unknown) => string;
+/**
+ * Converts a value to display string, or undefined when null/undefined (e.g. for select placeholder).
+ */
+declare const toStringOrUndefined: (value: unknown) => string | undefined;
+interface GetRjsfTextChangeValueArgs {
+    text: string;
+    emptyValue?: unknown;
+}
+/**
+ * Returns the value to pass to onChange for a text input.
+ *
+ * @param args.text - The current text input value.
+ * @param args.emptyValue - The value to use when text is empty (e.g. options.emptyValue from WidgetProps).
+ * @returns emptyValue when text is empty, otherwise text.
+ */
+declare const getRjsfTextChangeValue: ({ text, emptyValue }: GetRjsfTextChangeValueArgs) => unknown;
+declare const parseDateOrNull: (value?: string) => Date | null;
+/** Returns YYYY-MM-DD for JSON Schema "date" format (form storage). */
+declare const dateToDateOnlyString: (date: Date) => string;
+/** Parses a date-only or full ISO string into a Date at local midnight (for date picker display). */
+declare const parseDateOnlyToLocalDate: (value?: string) => Date | null;
+/** Extracts date-only YYYY-MM-DD for display from a full ISO or date-only string. */
+declare const formatDateOnlyForDisplay: (value?: string) => string;
+/** Formats a full ISO or date string for date-time display (locale string). */
+declare const formatDateTimeForDisplay: (value?: string) => string;
+type FormLayoutContext = {
+    labelCol?: {
+        span: number;
+    };
+    wrapperCol?: {
+        span: number;
+    };
+};
+declare const getFormLayoutCols: (formContext?: unknown) => FormLayoutContext;
+
+declare const useLocalizedForm: (metaFormSchema: MetaFormSchema) => LocalizedFormSchema;
+
+declare const useRjsfValidator: () => _rjsf_validator_ajv8_lib_validator_js.default<any, _rjsf_utils.RJSFSchema, any>;
+
+export { type EnumOptionDisplay, type GetRjsfDisplayLabelArgs, type GetRjsfTextChangeValueArgs, type Language, type LocalizedFormSchema, type MetaFormSchema, RJSF_STRING_TO_I18N_KEY, type RjsfRegistryWithTranslate, dateToDateOnlyString, formatDateOnlyForDisplay, formatDateTimeForDisplay, getFormLayoutCols, getRjsfDisplayLabel, getRjsfTextChangeValue, hasRjsfErrors, initRjsf, mapEnumOptions, parseDateOnlyToLocalDate, parseDateOrNull, toStringOrEmpty, toStringOrUndefined, translateRjsfString, useLocalizedForm, useRjsfValidator };

package/dist/rjsf.d.ts

@@ -0,0 +1,101 @@
+import * as _rjsf_utils from '@rjsf/utils';
+import { TranslatableString, RJSFSchema, UiSchema, WidgetProps } from '@rjsf/utils';
+import * as _rjsf_validator_ajv8_lib_validator_js from '@rjsf/validator-ajv8/lib/validator.js';
+
+declare const initRjsf: () => void;
+
+type Language = string;
+/** Registry shape with translation used by RJSF template buttons. */
+type RjsfRegistryWithTranslate = {
+    translateString: (s: TranslatableString) => string;
+};
+interface LocalizedFormSchema {
+    schema: RJSFSchema;
+    uiSchema: UiSchema;
+}
+interface MetaFormSchema {
+    id: string;
+    version: string;
+    i18n: Record<Language, LocalizedFormSchema>;
+}
+
+/** Maps RJSF TranslatableString values to our i18n keys (rjsf namespace). */
+declare const RJSF_STRING_TO_I18N_KEY: Record<string, string>;
+interface TranslateStringArgs {
+    stringToTranslate: string;
+    params?: string[];
+}
+declare const translateRjsfString: ({ stringToTranslate, params }: TranslateStringArgs) => string;
+
+/**
+ * Returns true when the widget has at least one validation error from RJSF.
+ *
+ * @param rawErrors - The rawErrors from WidgetProps (often `unknown`).
+ * @returns true if rawErrors is a non-empty array.
+ */
+declare const hasRjsfErrors: (rawErrors: unknown) => boolean;
+interface GetRjsfDisplayLabelArgs {
+    label?: string;
+    required?: boolean;
+    hideLabel?: boolean;
+}
+/**
+ * Returns the label to display for an RJSF widget, with optional required asterisk and
+ * hideLabel support.
+ *
+ * @param label - The label to display for the widget.
+ * @param required - Whether the field is required.
+ * @param hideLabel - Whether to hide the label.
+ *
+ * @returns The label to display for the widget.
+ */
+declare const getRjsfDisplayLabel: ({ label, required, hideLabel }: GetRjsfDisplayLabelArgs) => string | undefined;
+type EnumOptionDisplay = {
+    label: string;
+    value: string;
+};
+declare const mapEnumOptions: (options: WidgetProps["options"]) => EnumOptionDisplay[];
+/**
+ * Converts a value to display string, or empty string when null/undefined.
+ */
+declare const toStringOrEmpty: (value: unknown) => string;
+/**
+ * Converts a value to display string, or undefined when null/undefined (e.g. for select placeholder).
+ */
+declare const toStringOrUndefined: (value: unknown) => string | undefined;
+interface GetRjsfTextChangeValueArgs {
+    text: string;
+    emptyValue?: unknown;
+}
+/**
+ * Returns the value to pass to onChange for a text input.
+ *
+ * @param args.text - The current text input value.
+ * @param args.emptyValue - The value to use when text is empty (e.g. options.emptyValue from WidgetProps).
+ * @returns emptyValue when text is empty, otherwise text.
+ */
+declare const getRjsfTextChangeValue: ({ text, emptyValue }: GetRjsfTextChangeValueArgs) => unknown;
+declare const parseDateOrNull: (value?: string) => Date | null;
+/** Returns YYYY-MM-DD for JSON Schema "date" format (form storage). */
+declare const dateToDateOnlyString: (date: Date) => string;
+/** Parses a date-only or full ISO string into a Date at local midnight (for date picker display). */
+declare const parseDateOnlyToLocalDate: (value?: string) => Date | null;
+/** Extracts date-only YYYY-MM-DD for display from a full ISO or date-only string. */
+declare const formatDateOnlyForDisplay: (value?: string) => string;
+/** Formats a full ISO or date string for date-time display (locale string). */
+declare const formatDateTimeForDisplay: (value?: string) => string;
+type FormLayoutContext = {
+    labelCol?: {
+        span: number;
+    };
+    wrapperCol?: {
+        span: number;
+    };
+};
+declare const getFormLayoutCols: (formContext?: unknown) => FormLayoutContext;
+
+declare const useLocalizedForm: (metaFormSchema: MetaFormSchema) => LocalizedFormSchema;
+
+declare const useRjsfValidator: () => _rjsf_validator_ajv8_lib_validator_js.default<any, _rjsf_utils.RJSFSchema, any>;
+
+export { type EnumOptionDisplay, type GetRjsfDisplayLabelArgs, type GetRjsfTextChangeValueArgs, type Language, type LocalizedFormSchema, type MetaFormSchema, RJSF_STRING_TO_I18N_KEY, type RjsfRegistryWithTranslate, dateToDateOnlyString, formatDateOnlyForDisplay, formatDateTimeForDisplay, getFormLayoutCols, getRjsfDisplayLabel, getRjsfTextChangeValue, hasRjsfErrors, initRjsf, mapEnumOptions, parseDateOnlyToLocalDate, parseDateOrNull, toStringOrEmpty, toStringOrUndefined, translateRjsfString, useLocalizedForm, useRjsfValidator };

package/dist/rjsf.js

@@ -0,0 +1,193 @@
+import i18next from 'i18next';
+import { replaceStringParameters } from '@rjsf/utils';
+import { useTranslation } from 'react-i18next';
+import { customizeValidator } from '@rjsf/validator-ajv8';
+import localizer from 'ajv-i18n';
+
+// src/rjsf/i18n/i18n.ts
+
+// src/rjsf/i18n/en/rjsf.json
+var rjsf_default = {
+  rjsf: {
+    add: "Add",
+    debugFormDataTitle: "JSON data",
+    addItem: "Add Item",
+    clear: "Clear",
+    errors: "Errors detected in the form",
+    copy: "Copy",
+    keyLabel: "%1 Key",
+    moveDown: "Move down",
+    moveUp: "Move up",
+    no: "No",
+    remove: "Remove",
+    submit: "Submit",
+    yes: "Yes"
+  }
+};
+
+// src/rjsf/i18n/fr/rjsf.json
+var rjsf_default2 = {
+  rjsf: {
+    add: "Ajouter",
+    debugFormDataTitle: "Donn\xE9es JSON",
+    addItem: "Ajouter un \xE9l\xE9ment",
+    clear: "Effacer",
+    errors: "Erreurs d\xE9tect\xE9es dans le formulaire",
+    copy: "Copier",
+    keyLabel: "Cl\xE9 %1",
+    moveDown: "D\xE9placer vers le bas",
+    moveUp: "D\xE9placer vers le haut",
+    no: "Non",
+    remove: "Supprimer",
+    submit: "Envoyer",
+    yes: "Oui"
+  }
+};
+
+// src/rjsf/i18n/i18n.ts
+var NAMESPACE = "rjsf";
+var initRjsf = () => {
+  if (!i18next.isInitialized) {
+    throw new Error("[initRjsf] i18next must be initialized before calling initRjsf. Call initI18N() or i18next.init() first.");
+  }
+  if (i18next.hasResourceBundle("en", NAMESPACE)) return;
+  const isDeep = true;
+  const isOverwrite = true;
+  i18next.addResourceBundle("en", NAMESPACE, rjsf_default.rjsf, isDeep, isOverwrite);
+  i18next.addResourceBundle("fr", NAMESPACE, rjsf_default2.rjsf, isDeep, isOverwrite);
+  console.info("[initRjsf] RJSF i18n initialized");
+};
+
+// src/utils/types.utils.ts
+var isNullish = (value) => value === null || value === void 0;
+
+// src/utils/string.utils.ts
+var isBlank = (str) => {
+  return isNullish(str) || str?.trim() === "";
+};
+
+// src/rjsf/utils/rjsf-i18n.utils.ts
+var RJSF_STRING_TO_I18N_KEY = {
+  "Add Item": "rjsf:addItem",
+  Add: "rjsf:add",
+  Copy: "rjsf:copy",
+  "Move down": "rjsf:moveDown",
+  "Move up": "rjsf:moveUp",
+  Remove: "rjsf:remove",
+  "clear input": "rjsf:clear",
+  "%1 Key": "rjsf:keyLabel",
+  // TODO: RJSF-001 find a way to dynamicaly resolve the rjsf-i18n.utils "%1 Key" pattern
+  Yes: "rjsf:yes",
+  No: "rjsf:no",
+  Errors: "rjsf:errors"
+};
+var translateRjsfString = ({ stringToTranslate, params }) => {
+  const i18nKey = RJSF_STRING_TO_I18N_KEY[stringToTranslate];
+  if (isBlank(i18nKey)) {
+    console.warn(`[translateRjsfString] RJSF i18n: missing key: "${stringToTranslate}"`);
+  }
+  const translated = i18nKey ? i18next.t(i18nKey) : stringToTranslate;
+  return replaceStringParameters(translated, params);
+};
+
+// src/rjsf/utils/rjsf-widgets.utils.ts
+var hasRjsfErrors = (rawErrors) => Array.isArray(rawErrors) && rawErrors.length > 0;
+var getRjsfDisplayLabel = ({ label, required, hideLabel }) => {
+  if (hideLabel) return void 0;
+  if (isBlank(label)) return void 0;
+  const requiredSuffix = required ? " *" : "";
+  return `${label}${requiredSuffix}`;
+};
+var toEnumOptionDisplay = (o) => ({
+  label: o?.label ?? String(o?.value ?? ""),
+  value: String(o?.value ?? "")
+});
+var mapEnumOptions = (options) => {
+  const enumOptions = options?.enumOptions;
+  if (!Array.isArray(enumOptions)) return [];
+  return enumOptions.map(toEnumOptionDisplay);
+};
+var toStringOrEmpty = (value) => isNullish(value) ? "" : String(value);
+var toStringOrUndefined = (value) => isNullish(value) ? void 0 : String(value);
+var getRjsfTextChangeValue = ({ text, emptyValue }) => {
+  if (text === "") return emptyValue;
+  return text;
+};
+var parseDateOrNull = (value) => {
+  if (isBlank(value)) return null;
+  const date = new Date(value);
+  const isValid = !Number.isNaN(date.getTime());
+  return isValid ? date : null;
+};
+var dateToDateOnlyString = (date) => {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+};
+var DATE_ONLY_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+var parseDateOnlyToLocalDate = (value) => {
+  if (isBlank(value)) return null;
+  const trimmed = String(value).trim();
+  const dateOnly = trimmed.slice(0, 10);
+  if (!DATE_ONLY_REGEX.test(dateOnly)) return null;
+  const [y, m, d] = dateOnly.split("-").map(Number);
+  return new Date(y, m - 1, d);
+};
+var formatDateOnlyForDisplay = (value) => {
+  if (isBlank(value)) return "";
+  const trimmed = String(value).trim();
+  const dateOnly = trimmed.slice(0, 10);
+  return DATE_ONLY_REGEX.test(dateOnly) ? dateOnly : "";
+};
+var formatDateTimeForDisplay = (value) => {
+  const date = parseDateOrNull(value);
+  return date ? date.toLocaleString() : "";
+};
+var DEFAULT_SPAN = 24;
+var getFormLayoutCols = (formContext) => {
+  if (isNullish(formContext)) {
+    return {
+      labelCol: { span: DEFAULT_SPAN },
+      wrapperCol: { span: DEFAULT_SPAN }
+    };
+  }
+  const { labelCol, wrapperCol } = formContext;
+  return {
+    labelCol: labelCol ?? { span: DEFAULT_SPAN },
+    wrapperCol: wrapperCol ?? { span: DEFAULT_SPAN }
+  };
+};
+var DEFAULT_LANGUAGE = "fr";
+var parseSimplifiedLangCode = (language) => {
+  if (isBlank(language)) return DEFAULT_LANGUAGE;
+  return language.split("-")[0];
+};
+var getFallbackLanguage = (metaFormSchema) => {
+  return Object.keys(metaFormSchema.i18n)[0] ?? DEFAULT_LANGUAGE;
+};
+var useLocalizedForm = (metaFormSchema) => {
+  const { i18n } = useTranslation();
+  const language = parseSimplifiedLangCode(i18n.language);
+  if (metaFormSchema.i18n[language]) {
+    return metaFormSchema.i18n[language];
+  }
+  const fallbackLanguage = getFallbackLanguage(metaFormSchema);
+  console.warn(
+    `Language ${language} not found in metaFormSchema ${metaFormSchema.id}. Falling back to ${fallbackLanguage}.`
+  );
+  return metaFormSchema.i18n[fallbackLanguage];
+};
+var customFormats = {
+  "phone-america": /^\(?\d{3}\)?[\s-]?\d{3}[\s-]?\d{4}$/
+};
+var useRjsfValidator = () => {
+  const { i18n } = useTranslation();
+  const appLanguage = i18n.language;
+  const localizerFn = localizer[appLanguage] ?? localizer.en;
+  return customizeValidator({ customFormats }, localizerFn);
+};
+
+export { RJSF_STRING_TO_I18N_KEY, dateToDateOnlyString, formatDateOnlyForDisplay, formatDateTimeForDisplay, getFormLayoutCols, getRjsfDisplayLabel, getRjsfTextChangeValue, hasRjsfErrors, initRjsf, mapEnumOptions, parseDateOnlyToLocalDate, parseDateOrNull, toStringOrEmpty, toStringOrUndefined, translateRjsfString, useLocalizedForm, useRjsfValidator };
+//# sourceMappingURL=rjsf.js.map
+//# sourceMappingURL=rjsf.js.map

package/dist/rjsf.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rjsf/i18n/en/rjsf.json","../src/rjsf/i18n/fr/rjsf.json","../src/rjsf/i18n/i18n.ts","../src/utils/types.utils.ts","../src/utils/string.utils.ts","../src/rjsf/utils/rjsf-i18n.utils.ts","../src/rjsf/utils/rjsf-widgets.utils.ts","../src/rjsf/utils/use-localized-form.ts","../src/rjsf/utils/use-rjsf-validator.ts"],"names":["rjsf_default","i18next","useTranslation"],"mappings":"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","file":"rjsf.js","sourcesContent":["{\n  \"rjsf\": {\n    \"add\": \"Add\",\n    \"debugFormDataTitle\": \"JSON data\",\n    \"addItem\": \"Add Item\",\n    \"clear\": \"Clear\",\n    \"errors\": \"Errors detected in the form\",\n    \"copy\": \"Copy\",\n    \"keyLabel\": \"%1 Key\",\n    \"moveDown\": \"Move down\",\n    \"moveUp\": \"Move up\",\n    \"no\": \"No\",\n    \"remove\": \"Remove\",\n    \"submit\": \"Submit\",\n    \"yes\": \"Yes\"\n  }\n}\n","{\n  \"rjsf\": {\n    \"add\": \"Ajouter\",\n    \"debugFormDataTitle\": \"Données JSON\",\n    \"addItem\": \"Ajouter un élément\",\n    \"clear\": \"Effacer\",\n    \"errors\": \"Erreurs détectées dans le formulaire\",\n    \"copy\": \"Copier\",\n    \"keyLabel\": \"Clé %1\",\n    \"moveDown\": \"Déplacer vers le bas\",\n    \"moveUp\": \"Déplacer vers le haut\",\n    \"no\": \"Non\",\n    \"remove\": \"Supprimer\",\n    \"submit\": \"Envoyer\",\n    \"yes\": \"Oui\"\n  }\n}\n","import i18next from \"i18next\";\n\nimport en from \"./en/rjsf.json\";\nimport fr from \"./fr/rjsf.json\";\n\nconst NAMESPACE = \"rjsf\";\n\nexport const initRjsf = (): void => {\n  if (!i18next.isInitialized) {\n    throw new Error(\"[initRjsf] i18next must be initialized before calling initRjsf. Call initI18N() or i18next.init() first.\");\n  }\n\n  if (i18next.hasResourceBundle(\"en\", NAMESPACE)) return;\n\n  const isDeep = true;\n  const isOverwrite = true;\n\n  i18next.addResourceBundle(\"en\", NAMESPACE, en.rjsf, isDeep, isOverwrite);\n  i18next.addResourceBundle(\"fr\", NAMESPACE, fr.rjsf, isDeep, isOverwrite);\n\n  // eslint-disable-next-line no-console\n  console.info('[initRjsf] RJSF i18n initialized');  \n};\n","export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n\n/**\n * Parses an optional comma-separated string into a trimmed, non-blank string array.\n */\nexport const parseCommaSeparatedList = (raw?: string | null): string[] => {\n  if (isBlank(raw)) {\n    return [];\n  }\n\n  return raw\n    .split(\",\")\n    .map((s: string) => s.trim())\n    .filter(isNotBlank);\n};\n","import { replaceStringParameters } from \"@rjsf/utils\";\nimport i18next from \"i18next\";\nimport { isBlank } from \"~/utils/string.utils\";\n\n/** Maps RJSF TranslatableString values to our i18n keys (rjsf namespace). */\nexport const RJSF_STRING_TO_I18N_KEY: Record<string, string> = {\n  \"Add Item\": \"rjsf:addItem\",\n  Add: \"rjsf:add\",\n  Copy: \"rjsf:copy\",\n  \"Move down\": \"rjsf:moveDown\",\n  \"Move up\": \"rjsf:moveUp\",\n  Remove: \"rjsf:remove\",\n  \"clear input\": \"rjsf:clear\",\n  \"%1 Key\": \"rjsf:keyLabel\", // TODO: RJSF-001 find a way to dynamicaly resolve the rjsf-i18n.utils \"%1 Key\" pattern\n  Yes: \"rjsf:yes\",\n  No: \"rjsf:no\",\n  Errors: \"rjsf:errors\",\n};\n\ninterface TranslateStringArgs {\n  stringToTranslate: string;\n  params?: string[];\n}\n\nexport const translateRjsfString = ({ stringToTranslate, params }: TranslateStringArgs): string => {\n  const i18nKey = RJSF_STRING_TO_I18N_KEY[stringToTranslate];\n  if (isBlank(i18nKey)) {\n    // eslint-disable-next-line no-console\n    console.warn(`[translateRjsfString] RJSF i18n: missing key: \"${stringToTranslate}\"`);\n  }\n\n  const translated = i18nKey ? i18next.t(i18nKey) : stringToTranslate;\n  return replaceStringParameters(translated, params);\n};\n","import type { WidgetProps } from \"@rjsf/utils\";\nimport { isBlank } from \"~/utils/string.utils\";\nimport { isNullish } from \"~/utils/types.utils\";\n\n/**\n * Returns true when the widget has at least one validation error from RJSF.\n *\n * @param rawErrors - The rawErrors from WidgetProps (often `unknown`).\n * @returns true if rawErrors is a non-empty array.\n */\nexport const hasRjsfErrors = (rawErrors: unknown): boolean => Array.isArray(rawErrors) && rawErrors.length > 0;\n\nexport interface GetRjsfDisplayLabelArgs {\n  label?: string;\n  required?: boolean;\n  hideLabel?: boolean;\n}\n\n/**\n * Returns the label to display for an RJSF widget, with optional required asterisk and\n * hideLabel support.\n *\n * @param label - The label to display for the widget.\n * @param required - Whether the field is required.\n * @param hideLabel - Whether to hide the label.\n *\n * @returns The label to display for the widget.\n */\nexport const getRjsfDisplayLabel = ({ label, required, hideLabel }: GetRjsfDisplayLabelArgs): string | undefined => {\n  if (hideLabel) return undefined;\n  if (isBlank(label)) return undefined;\n\n  const requiredSuffix = required ? \" *\" : \"\";\n  return `${label}${requiredSuffix}`;\n};\n\ninterface EnumOption {\n  value: string;\n  label: string;\n}\n\nexport type EnumOptionDisplay = { label: string; value: string };\n\nconst toEnumOptionDisplay = (o: EnumOption): EnumOptionDisplay => ({\n  label: o?.label ?? String(o?.value ?? \"\"),\n  value: String(o?.value ?? \"\"),\n});\n\nexport const mapEnumOptions = (options: WidgetProps[\"options\"]): EnumOptionDisplay[] => {\n  const enumOptions = options?.enumOptions as EnumOption[] | undefined;\n  if (!Array.isArray(enumOptions)) return [];\n  return enumOptions.map(toEnumOptionDisplay);\n};\n\n/**\n * Converts a value to display string, or empty string when null/undefined.\n */\nexport const toStringOrEmpty = (value: unknown): string => (isNullish(value) ? \"\" : String(value));\n\n/**\n * Converts a value to display string, or undefined when null/undefined (e.g. for select placeholder).\n */\nexport const toStringOrUndefined = (value: unknown): string | undefined =>\n  isNullish(value) ? undefined : String(value);\n\nexport interface GetRjsfTextChangeValueArgs {\n  text: string;\n  emptyValue?: unknown;\n}\n\n/**\n * Returns the value to pass to onChange for a text input.\n *\n * @param args.text - The current text input value.\n * @param args.emptyValue - The value to use when text is empty (e.g. options.emptyValue from WidgetProps).\n * @returns emptyValue when text is empty, otherwise text.\n */\nexport const getRjsfTextChangeValue = ({ text, emptyValue }: GetRjsfTextChangeValueArgs): unknown => {\n  if (text === \"\") return emptyValue;\n  return text;\n};\n\nexport const parseDateOrNull = (value?: string): Date | null => {\n  if (isBlank(value)) return null;\n\n  const date = new Date(value);\n  const isValid = !Number.isNaN(date.getTime());\n  return isValid ? date : null;\n};\n\n/** Returns YYYY-MM-DD for JSON Schema \"date\" format (form storage). */\nexport const dateToDateOnlyString = (date: Date): string => {\n  const y = date.getFullYear();\n  const m = String(date.getMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getDate()).padStart(2, \"0\");\n  return `${y}-${m}-${d}`;\n};\n\nconst DATE_ONLY_REGEX = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** Parses a date-only or full ISO string into a Date at local midnight (for date picker display). */\nexport const parseDateOnlyToLocalDate = (value?: string): Date | null => {\n  if (isBlank(value)) return null;\n\n  const trimmed = String(value).trim();\n  const dateOnly = trimmed.slice(0, 10);\n  if (!DATE_ONLY_REGEX.test(dateOnly)) return null;\n\n  const [y, m, d] = dateOnly.split(\"-\").map(Number);\n  return new Date(y, m - 1, d);\n};\n\n/** Extracts date-only YYYY-MM-DD for display from a full ISO or date-only string. */\nexport const formatDateOnlyForDisplay = (value?: string): string => {\n  if (isBlank(value)) return \"\";\n\n  const trimmed = String(value).trim();\n  const dateOnly = trimmed.slice(0, 10);\n  return DATE_ONLY_REGEX.test(dateOnly) ? dateOnly : \"\";\n};\n\n/** Formats a full ISO or date string for date-time display (locale string). */\nexport const formatDateTimeForDisplay = (value?: string): string => {\n  const date = parseDateOrNull(value);\n  return date ? date.toLocaleString() : \"\";\n};\n\ntype FormLayoutContext = {\n  labelCol?: { span: number };\n  wrapperCol?: { span: number };\n};\n\nconst DEFAULT_SPAN = 24;\n\nexport const getFormLayoutCols = (formContext?: unknown): FormLayoutContext => {\n  if (isNullish(formContext)) {\n    return {\n      labelCol: { span: DEFAULT_SPAN },\n      wrapperCol: { span: DEFAULT_SPAN },\n    };\n  }\n\n  const { labelCol, wrapperCol } = formContext as FormLayoutContext;\n  return {\n    labelCol: labelCol ?? { span: DEFAULT_SPAN },\n    wrapperCol: wrapperCol ?? { span: DEFAULT_SPAN },\n  };\n};\n","import { isBlank } from \"~/utils/string.utils\";\nimport { useTranslation } from \"react-i18next\";\nimport type { LocalizedFormSchema, MetaFormSchema } from \"./rjsf-i18n-types\";\n\nconst DEFAULT_LANGUAGE = \"fr\";\n\n// i18n.language can be 'fr-CA', so we take the first part\nconst parseSimplifiedLangCode = (language?: string): string => {\n  if (isBlank(language)) return DEFAULT_LANGUAGE;\n  return language.split(\"-\")[0];\n};\n\nconst getFallbackLanguage = (metaFormSchema: MetaFormSchema): string => {\n  return Object.keys(metaFormSchema.i18n)[0] ?? DEFAULT_LANGUAGE;\n};\n\nexport const useLocalizedForm = (metaFormSchema: MetaFormSchema): LocalizedFormSchema => {\n  const { i18n } = useTranslation();\n  const language = parseSimplifiedLangCode(i18n.language);\n\n  if (metaFormSchema.i18n[language]) {\n    return metaFormSchema.i18n[language];\n  }\n\n  const fallbackLanguage = getFallbackLanguage(metaFormSchema);\n  // eslint-disable-next-line no-console\n  console.warn(\n    `Language ${language} not found in metaFormSchema ${metaFormSchema.id}. Falling back to ${fallbackLanguage}.`\n  );\n\n  return metaFormSchema.i18n[fallbackLanguage];\n};\n","import { customizeValidator, type Localizer } from \"@rjsf/validator-ajv8\";\nimport localizer from \"ajv-i18n\";\nimport { useTranslation } from \"react-i18next\";\n\nconst customFormats = {\n  \"phone-america\": /^\\(?\\d{3}\\)?[\\s-]?\\d{3}[\\s-]?\\d{4}$/,\n};\n\ntype ValidationLanguages = keyof typeof localizer;\n\nexport const useRjsfValidator = () => {\n  const { i18n } = useTranslation();\n  const appLanguage = i18n.language as ValidationLanguages;\n  const localizerFn: Localizer = localizer[appLanguage] ?? localizer.en;\n\n  return customizeValidator({ customFormats }, localizerFn);\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lichens-innovation/ts-common",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "Reusable generic typescript utilities, types, constants, helpers",
   "keywords": [
     "typescript",
@@ -54,6 +54,12 @@
       "import": "./dist/logger.js",
       "require": "./dist/logger.cjs",
       "default": "./dist/logger.js"
+    },
+    "./rjsf": {
+      "types": "./dist/rjsf.d.ts",
+      "import": "./dist/rjsf.js",
+      "require": "./dist/rjsf.cjs",
+      "default": "./dist/rjsf.js"
     }
   },
   "sideEffects": false,
@@ -84,25 +90,33 @@
     "date-fns": "^4.1.0"
   },
   "peerDependencies": {
+    "@rjsf/utils": "*",
+    "@rjsf/validator-ajv8": "*",
+    "ajv-i18n": "*",
     "exceljs": "^4.4.0",
+    "i18next": "*",
     "jspdf": "^4.1.0",
     "jspdf-autotable": "^5.0.7",
     "mime": "^4.1.0",
     "papaparse": "^5.4.1",
     "pino": "^10.3.1",
-    "pino-pretty": "^13.0.0"
+    "pino-pretty": "^13.0.0",
+    "react-i18next": "*"
   },
   "peerDependenciesMeta": {
-    "exceljs": {
+    "@rjsf/utils": {
       "optional": true
     },
-    "papaparse": {
+    "@rjsf/validator-ajv8": {
       "optional": true
     },
-    "pino": {
+    "ajv-i18n": {
       "optional": true
     },
-    "pino-pretty": {
+    "exceljs": {
+      "optional": true
+    },
+    "i18next": {
       "optional": true
     },
     "jspdf": {
@@ -113,22 +127,39 @@
     },
     "mime": {
       "optional": true
+    },
+    "papaparse": {
+      "optional": true
+    },
+    "pino": {
+      "optional": true
+    },
+    "pino-pretty": {
+      "optional": true
+    },
+    "react-i18next": {
+      "optional": true
     }
   },
   "engines": {
     "node": ">=20.11.0"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.3",
-    "@commitlint/config-conventional": "^20.4.3",
+    "@commitlint/cli": "^20.4.4",
+    "@rjsf/utils": "^6.4.1",
+    "@rjsf/validator-ajv8": "^6.4.1",
+    "ajv-i18n": "^4.2.0",
+    "i18next": "^25.8.18",
+    "react-i18next": "^16.5.8",
+    "@commitlint/config-conventional": "^20.4.4",
     "@eslint/js": "^10.0.1",
     "@faker-js/faker": "^10.3.0",
-    "@types/node": "^25.3.5",
+    "@types/node": "^25.5.0",
     "@types/papaparse": "^5.5.2",
-    "@vitest/coverage-v8": "4.0.18",
-    "commitlint": "^20.4.3",
+    "@vitest/coverage-v8": "4.1.0",
+    "commitlint": "^20.4.4",
     "cross-env": "^10.1.0",
-    "eslint": "^10.0.2",
+    "eslint": "^10.0.3",
     "exceljs": "^4.4.0",
     "globals": "^17.4.0",
     "husky": "^9.1.7",
@@ -142,9 +173,9 @@
     "rimraf": "^6.1.3",
     "tsup": "^8.5.1",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.56.1",
-    "vite": "^7.3.1",
+    "typescript-eslint": "^8.57.0",
+    "vite": "^8.0.0",
     "vite-tsconfig-paths": "^6.1.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   }
 }