schema-dsl 1.2.5 → 2.0.1

package/src/locales/index.ts

@@ -0,0 +1,103 @@
+import type { LocaleKey, LocaleMessage, LocaleMessages } from './types.js'
+import zhCN from './zh-CN.js'
+import enUS from './en-US.js'
+import jaJP from './ja-JP.js'
+import esES from './es-ES.js'
+import frFR from './fr-FR.js'
+
+export type { LocaleKey, LocaleMessage, LocaleMessages }
+
+// ─── Supported locale registry ─────────────────────────────────────────────────────────
+const LOCALES: Readonly<Record<string, LocaleMessages>> = {
+  'zh-CN': zhCN,
+  'en-US': enUS,
+  'ja-JP': jaJP,
+  'es-ES': esES,
+  'fr-FR': frFR,
+}
+
+/** Default locale (global fallback base) */
+const DEFAULT_LOCALE = 'en-US'
+
+/** en-US acts as secondary fallback (used when any locale is missing a key) */
+const FALLBACK_LOCALE = 'en-US'
+
+/**
+ * Look up a locale message entry (with fallback chain).
+ *
+ * Fallback chain: locale → en-US (if locale ≠ en-US) → key itself
+ */
+export function getMessage(
+  key: LocaleKey,
+  locale: string = DEFAULT_LOCALE
+): LocaleMessage {
+  const messages = LOCALES[locale]
+  if (messages && key in messages) {
+    return messages[key]
+  }
+
+  // Primary fallback: en-US
+  if (locale !== DEFAULT_LOCALE) {
+    const defaultMessages = LOCALES[DEFAULT_LOCALE]
+    if (defaultMessages && key in defaultMessages) {
+      return defaultMessages[key]
+    }
+  }
+
+  // Secondary fallback: en-US
+  const fallbackMessages = LOCALES[FALLBACK_LOCALE]
+  if (fallbackMessages && key in fallbackMessages) {
+    return fallbackMessages[key]
+  }
+
+  // Final fallback: return the key itself (never returns undefined)
+  return key
+}
+
+/**
+ * Get the resolved string for a message (unwraps {code, message} object format).
+ */
+export function getMessageString(
+  key: LocaleKey,
+  locale: string = DEFAULT_LOCALE
+): string {
+  const msg = getMessage(key, locale)
+  if (typeof msg === 'string') return msg
+  return msg.message
+}
+
+/**
+ * Get the error code of a message (if the value is a {code, message} object).
+ */
+export function getMessageCode(
+  key: LocaleKey,
+  locale: string = DEFAULT_LOCALE
+): string | number | undefined {
+  const msg = getMessage(key, locale)
+  if (typeof msg === 'object') return msg.code
+  return undefined
+}
+
+/**
+ * Get the complete message map for the given locale.
+ */
+export function getMessages(locale: string = DEFAULT_LOCALE): LocaleMessages {
+  return LOCALES[locale] ?? LOCALES[DEFAULT_LOCALE]!
+}
+
+/**
+ * Check whether a locale is supported.
+ */
+export function isSupportedLocale(locale: string): boolean {
+  return locale in LOCALES
+}
+
+/**
+ * Get all supported locale codes.
+ */
+export function getSupportedLocales(): string[] {
+  return Object.keys(LOCALES)
+}
+
+export { zhCN, enUS, jaJP, esES, frFR }
+export default LOCALES

package/{lib/locales/ja-JP.js → src/locales/ja-JP.ts}

@@ -1,118 +1,160 @@
-module.exports = {
-  // Generic
-  required: '{{#label}}は必須です',
-  type: '{{#label}}は{{#expected}}型である必要がありますが、{{#actual}}が渡されました',
-  min: '{{#label}}の長さは{{#limit}}以上である必要があります',
-  max: '{{#label}}の長さは{{#limit}}以下である必要があります',
-  length: '{{#label}}の長さは正確に{{#expected}}である必要があります',
-  pattern: '{{#label}}の形式が無効です',
-  enum: '{{#label}}は次のいずれかである必要があります: {{#allowed}}',
-  custom: '{{#label}}の検証に失敗しました: {{#message}}',
-  circular: '{{#label}}で循環参照が検出されました',
-  'max-depth': '{{#label}}で最大再帰深度 ({{#depth}}) を超えました',
-  exception: '{{#label}}の検証例外: {{#message}}',
-
-  // Conditional (ConditionalBuilder)
-  'conditional.underAge': '未成年者は登録できません',
-  'conditional.blocked': 'アカウントがブロックされています',
-  'conditional.notAllowed': '登録は許可されていません',
-
-  // Formats
-  'format.email': '{{#label}}は有効なメールアドレスである必要があります',
-  'format.url': '{{#label}}は有効なURLである必要があります',
-  'format.uuid': '{{#label}}は有効なUUIDである必要があります',
-  'format.date': '{{#label}}は有効な日付 (YYYY-MM-DD) である必要があります',
-  'format.datetime': '{{#label}}は有効な日時 (ISO 8601) である必要があります',
-  'format.time': '{{#label}}は有効な時刻 (HH:mm:ss) である必要があります',
-  'format.ipv4': '{{#label}}は有効なIPv4アドレスである必要があります',
-  'format.ipv6': '{{#label}}は有効なIPv6アドレスである必要があります',
-  'format.binary': '{{#label}}は有効なbase64文字列である必要があります',
-
-  // String
-  'string.hostname': '{{#label}}は有効なホスト名である必要があります',
-  'string.pattern': '{{#label}}の形式が必要なパターンと一致しません',
-  'string.enum': '{{#label}}は次のいずれかである必要があります: {{#valids}}',
-
-  // Number
-  'number.base': '{{#label}}は数値である必要があります',
-  'number.min': '{{#label}}は{{#limit}}以上である必要があります',
-  'number.max': '{{#label}}は{{#limit}}以下である必要があります',
-  'number.integer': '{{#label}}は整数である必要があります',
-  'number.positive': '{{#label}}は正の数である必要があります',
-  'number.negative': '{{#label}}は負の数である必要があります',
-
-  // Boolean
-  'boolean.base': '{{#label}}はブール値である必要があります',
-
-  // Object
-  'object.base': '{{#label}}はオブジェクトである必要があります',
-  'object.min': '{{#label}}は少なくとも{{#limit}}個のプロパティを持つ必要があります',
-  'object.max': '{{#label}}は最大{{#limit}}個のプロパティを持つことができます',
-  'object.unknown': '{{#label}}に未知のプロパティが含まれています: {{#key}}',
-  // v1.1.6 - additionalProperties
-  'additionalProperties': '{{#label}}に追加のプロパティを含めてはいけません: {{#key}}',
-
-  // Array
-  'array.base': '{{#label}}は配列である必要があります',
-  'array.min': '{{#label}}は少なくとも{{#limit}}個の要素を持つ必要があります',
-  'array.max': '{{#label}}は最大{{#limit}}個の要素を持つことができます',
-  'array.length': '{{#label}}は正確に{{#limit}}個の要素を持つ必要があります',
-  'array.unique': '{{#label}}に重複する要素を含めることはできません',
-
-  // Date
-  'date.base': '{{#label}}は有効な日付である必要があります',
-  'date.min': '{{#label}}は{{#limit}}より前であってはなりません',
-  'date.max': '{{#label}}は{{#limit}}より後であってはなりません',
-
-  // Any
-  'any.required': '{{#label}}は必須です',
-  'any.invalid': '{{#label}}に無効な値が含まれています',
-  'any.only': '{{#label}}は{{#valids}}と一致する必要があります',
-  'any.unknown': 'フィールド{{#key}}は許可されていません',
-
-  // Patterns (Legacy/Specific)
-  'pattern.phone': '無効な電話番号',
-  'pattern.phone.international': '無効な国際電話番号',
-  'pattern.idCard': '無効なIDカード番号',
-  'pattern.creditCard': '無効なクレジットカード番号',
-  'pattern.creditCard.visa': '無効なVisaカード番号',
-  'pattern.creditCard.mastercard': '無効なMastercardカード番号',
-  'pattern.creditCard.amex': '無効なAmerican Expressカード番号',
-  'pattern.creditCard.discover': '無効なDiscoverカード番号',
-  'pattern.creditCard.jcb': '無効なJCBカード番号',
-  'pattern.creditCard.unionpay': '無効なUnionPayカード番号',
-  'pattern.licensePlate': '無効なナンバープレート',
-  'pattern.postalCode': '無効な郵便番号',
-  'pattern.passport': '無効なパスポート番号',
-  'pattern.objectId': '無効なObjectId',
-  'pattern.hexColor': '無効な16進カラー',
-  'pattern.macAddress': '無効なMACアドレス',
-  'pattern.cron': '無効なCron式',
-  'pattern.slug': 'URLスラッグには小文字、数字、ハイフンのみを含めることができます',
-  // v1.0.2 新増
-  'pattern.domain': '{{#label}}は有効なドメイン名である必要があります',
-  'pattern.ip': '{{#label}}は有効なIPアドレスである必要があります',
-  'pattern.base64': '{{#label}}は有効なBase64文字列である必要があります',
-  'pattern.jwt': '{{#label}}は有効なJWTトークンである必要があります',
-  'pattern.json': '{{#label}}は有効なJSON文字列である必要があります',
-
-  // Username & Password
-  'pattern.username': 'ユーザー名は文字で始まり、文字、数字、アンダースコアのみを含む必要があります',
-  'pattern.password.weak': 'パスワードは少なくとも6文字である必要があります',
-  'pattern.password.medium': 'パスワードは少なくとも8文字で、文字と数字を含む必要があります',
-  'pattern.password.strong': 'パスワードは少なくとも8文字で、大文字、小文字、数字を含む必要があります',
-  'pattern.password.veryStrong': 'パスワードは少なくとも10文字で、大文字、小文字、数字、特殊文字を含む必要があります',
-
-  // oneOf (型の結合) - v1.1.0
-  oneOf: '{{#label}}は次のいずれかの型に一致する必要があります',
-  'oneOf.invalid': '{{#label}}の値は許可された型のいずれとも一致しません',
-
-  // Unknown error fallback
-  'UNKNOWN_ERROR': '不明な検証エラー',
-
-  // Custom validation
-  'CUSTOM_VALIDATION_FAILED': '検証に失敗しました',
-  'ASYNC_VALIDATION_NOT_SUPPORTED': '同期validate()では非同期検証はサポートされていません',
-  'VALIDATE_MUST_BE_FUNCTION': 'validateは関数である必要があります'
-};
-
+import type { LocaleMessages } from './types.js'
+
+const jaJP: LocaleMessages = {
+  // Generic
+  required: '{{#label}}は必須です',
+  type: '{{#label}}は{{#expected}}型である必要がありますが、{{#actual}}が渡されました',
+  min: '{{#label}}の長さは{{#limit}}以上である必要があります',
+  max: '{{#label}}の長さは{{#limit}}以下である必要があります',
+  length: '{{#label}}の長さは正確に{{#expected}}である必要があります',
+  pattern: '{{#label}}の形式が無効です',
+  enum: '{{#label}}は次のいずれかである必要があります: {{#allowed}}',
+  custom: '{{#label}}の検証に失敗しました: {{#message}}',
+  circular: '{{#label}}で循環参照が検出されました',
+  'max-depth': '{{#label}}で最大再帰深度 ({{#depth}}) を超えました',
+  exception: '{{#label}}の検証例外: {{#message}}',
+
+  // Conditional
+  'conditional.underAge': '未成年者は登録できません',
+  'conditional.blocked': 'アカウントがブロックされています',
+  'conditional.notAllowed': '登録は許可されていません',
+
+  // I18nError — generic (v2 additions)
+  'error.notFound': '{{#resource}}が見つかりません',
+  'error.forbidden': '{{#resource}}へのアクセスが禁止されています',
+  'error.unauthorized': '認証が必要です。ログインしてください',
+  'error.invalid': '{{#field}}が無効です',
+  'error.duplicate': '{{#resource}}はすでに存在します',
+  'error.conflict': '操作の競合: {{#reason}}',
+
+  // Account (v2 additions)
+  'account.notFound': { code: 'ACCOUNT_NOT_FOUND', message: 'アカウントが見つかりません' },
+  'account.inactive': 'アカウントが無効化されています',
+  'account.banned': 'アカウントが禁止されています',
+  'account.insufficientBalance': {
+    code: 'INSUFFICIENT_BALANCE',
+    message: '残高不足。現在: {{#balance}}、必要: {{#required}}',
+  },
+  'account.insufficientCredits': 'クレジット不足。現在: {{#credits}}、必要: {{#required}}',
+
+  // User (v2 additions)
+  'user.notFound': 'ユーザーが見つかりません',
+  'user.notVerified': 'ユーザーが確認されていません',
+  'user.noPermission': '管理者権限がありません',
+
+  // Order (v2 additions)
+  'order.notPaid': { code: 'ORDER_NOT_PAID', message: '注文が支払われていません' },
+  'order.paymentMissing': '支払い情報がありません',
+  'order.addressMissing': '配送先住所がありません',
+
+  // Format
+  'format.email': '{{#label}}は有効なメールアドレスである必要があります',
+  'format.url': '{{#label}}は有効なURLである必要があります',
+  'format.uuid': '{{#label}}は有効なUUIDである必要があります',
+  'format.date': '{{#label}}は有効な日付 (YYYY-MM-DD) である必要があります',
+  'format.datetime': '{{#label}}は有効な日時 (ISO 8601) である必要があります',
+  'format.time': '{{#label}}は有効な時刻 (HH:mm:ss) である必要があります',
+  'format.ipv4': '{{#label}}は有効なIPv4アドレスである必要があります',
+  'format.ipv6': '{{#label}}は有効なIPv6アドレスである必要があります',
+  'format.binary': '{{#label}}は有効なbase64文字列である必要があります',
+
+  // String
+  'string.hostname': '{{#label}}は有効なホスト名である必要があります',
+  'string.pattern': '{{#label}}の形式が必要なパターンと一致しません',
+  'string.enum': '{{#label}}は次のいずれかである必要があります: {{#valids}}',
+  'string.length': '{{#label}}の長さは正確に{{#limit}}文字である必要があります',
+  'string.alphanum': '{{#label}}には英数字のみを含めることができます',
+  'string.trim': '{{#label}}の前後に空白を含めることはできません',
+  'string.lowercase': '{{#label}}は小文字である必要があります',
+  'string.uppercase': '{{#label}}は大文字である必要があります',
+
+  // Number
+  'number.base': '{{#label}}は数値である必要があります',
+  'number.min': '{{#label}}は{{#limit}}以上である必要があります',
+  'number.max': '{{#label}}は{{#limit}}以下である必要があります',
+  'number.integer': '{{#label}}は整数である必要があります',
+  'number.positive': '{{#label}}は正の数である必要があります',
+  'number.negative': '{{#label}}は負の数である必要があります',
+  'number.precision': '{{#label}}の小数点以下は{{#limit}}桁以内である必要があります',
+  'number.port': '{{#label}}は有効なポート番号 (1-65535) である必要があります',
+
+  // Boolean
+  'boolean.base': '{{#label}}はブール値である必要があります',
+
+  // Object
+  'object.base': '{{#label}}はオブジェクトである必要があります',
+  'object.min': '{{#label}}は少なくとも{{#limit}}個のプロパティを持つ必要があります',
+  'object.max': '{{#label}}は最大{{#limit}}個のプロパティを持つことができます',
+  'object.unknown': '{{#label}}に未知のプロパティが含まれています: {{#key}}',
+  'object.missing': '{{#label}}には必須プロパティがありません',
+  'object.schema': '{{#label}}に追加のプロパティが含まれています',
+  'additionalProperties': '{{#label}}に追加のプロパティを含めてはいけません: {{#key}}',
+
+  // Array
+  'array.base': '{{#label}}は配列である必要があります',
+  'array.min': '{{#label}}は少なくとも{{#limit}}個の要素を持つ必要があります',
+  'array.max': '{{#label}}は最大{{#limit}}個の要素を持つことができます',
+  'array.length': '{{#label}}は正確に{{#limit}}個の要素を持つ必要があります',
+  'array.unique': '{{#label}}に重複する要素を含めることはできません',
+  'array.sparse': '{{#label}}はスパース配列であってはなりません',
+  'array.includesRequired': '{{#label}}には必須アイテムを含める必要があります',
+
+  // Date
+  'date.base': '{{#label}}は有効な日付である必要があります',
+  'date.min': '{{#label}}は{{#limit}}より前であってはなりません',
+  'date.max': '{{#label}}は{{#limit}}より後であってはなりません',
+  'date.format': '{{#label}}の日付形式が無効です',
+  'date.greater': '{{#label}}は{{#limit}}より後である必要があります',
+  'date.less': '{{#label}}は{{#limit}}より前である必要があります',
+
+  // Any
+  'any.required': '{{#label}}は必須です',
+  'any.invalid': '{{#label}}に無効な値が含まれています',
+  'any.only': '{{#label}}は{{#valids}}と一致する必要があります',
+  'any.unknown': 'フィールド{{#key}}は許可されていません',
+
+  // Patterns
+  'pattern.phone': '無効な電話番号',
+  'pattern.phone.international': '無効な国際電話番号',
+  'pattern.idCard': '無効なIDカード番号',
+  'pattern.creditCard': '無効なクレジットカード番号',
+  'pattern.creditCard.visa': '無効なVisaカード番号',
+  'pattern.creditCard.mastercard': '無効なMastercardカード番号',
+  'pattern.creditCard.amex': '無効なAmerican Expressカード番号',
+  'pattern.creditCard.discover': '無効なDiscoverカード番号',
+  'pattern.creditCard.jcb': '無効なJCBカード番号',
+  'pattern.creditCard.unionpay': '無効なUnionPayカード番号',
+  'pattern.licensePlate': '無効なナンバープレート',
+  'pattern.postalCode': '無効な郵便番号',
+  'pattern.passport': '無効なパスポート番号',
+  'pattern.objectId': '無効なObjectId',
+  'pattern.hexColor': '無効な16進カラー',
+  'pattern.macAddress': '無効なMACアドレス',
+  'pattern.cron': '無効なCron式',
+  'pattern.slug': 'URLスラッグには小文字、数字、ハイフンのみを含めることができます',
+  'pattern.domain': '{{#label}}は有効なドメイン名である必要があります',
+  'pattern.ip': '{{#label}}は有効なIPアドレスである必要があります',
+  'pattern.base64': '{{#label}}は有効なBase64文字列である必要があります',
+  'pattern.jwt': '{{#label}}は有効なJWTトークンである必要があります',
+  'pattern.json': '{{#label}}は有効なJSON文字列である必要があります',
+  'pattern.username': 'ユーザー名は文字で始まり、文字、数字、アンダースコアのみを含む必要があります',
+  'pattern.password.weak': 'パスワードは少なくとも6文字である必要があります',
+  'pattern.password.medium': 'パスワードは少なくとも8文字で、文字と数字を含む必要があります',
+  'pattern.password.strong': 'パスワードは少なくとも8文字で、大文字、小文字、数字を含む必要があります',
+  'pattern.password.veryStrong': 'パスワードは少なくとも10文字で、大文字、小文字、数字、特殊文字を含む必要があります',
+  'pattern.emailOrPhone': 'メールアドレスまたは電話番号である必要があります',
+  'pattern.usernameOrEmail': 'ユーザー名またはメールアドレスである必要があります',
+  'pattern.httpOrHttps': 'http または https で始まるURLである必要があります',
+
+  // oneOf
+  oneOf: '{{#label}}は次のいずれかの型に一致する必要があります',
+  'oneOf.invalid': '{{#label}}の値は許可された型のいずれとも一致しません',
+
+  // Error fallback
+  UNKNOWN_ERROR: '不明な検証エラー',
+  CUSTOM_VALIDATION_FAILED: '検証に失敗しました',
+  ASYNC_VALIDATION_NOT_SUPPORTED: '同期validate()では非同期検証はサポートされていません',
+  VALIDATE_MUST_BE_FUNCTION: 'validateは関数である必要があります',
+}
+
+export default jaJP

package/src/locales/types.ts

@@ -0,0 +1,156 @@
+/**
+ * LocaleKey — union type of all locale message keys (118 keys)
+ *
+ * TypeScript compile-time completeness enforcement: every locale file must implement
+ * the LocaleMessages interface; adding a new key causes a compiler error in all locales.
+ */
+
+// ─── Base message value type ──────────────────────────────────────────────────
+/** A message is either a plain string or an object with code (v1.1.5+ format) */
+export type LocaleMessage = string | { code: string | number; message: string }
+
+// ─── Key union (for precise key inference in getMessage) ─────────────────────
+export type LocaleKey =
+  // Generic
+  | 'required'
+  | 'type'
+  | 'min'
+  | 'max'
+  | 'length'
+  | 'pattern'
+  | 'enum'
+  | 'custom'
+  | 'circular'
+  | 'max-depth'
+  | 'exception'
+  // Conditional
+  | 'conditional.underAge'
+  | 'conditional.blocked'
+  | 'conditional.notAllowed'
+  // I18nError — generic
+  | 'error.notFound'
+  | 'error.forbidden'
+  | 'error.unauthorized'
+  | 'error.invalid'
+  | 'error.duplicate'
+  | 'error.conflict'
+  // Account
+  | 'account.notFound'
+  | 'account.inactive'
+  | 'account.banned'
+  | 'account.insufficientBalance'
+  | 'account.insufficientCredits'
+  // User
+  | 'user.notFound'
+  | 'user.notVerified'
+  | 'user.noPermission'
+  // Order
+  | 'order.notPaid'
+  | 'order.paymentMissing'
+  | 'order.addressMissing'
+  // Format
+  | 'format.email'
+  | 'format.url'
+  | 'format.uuid'
+  | 'format.date'
+  | 'format.datetime'
+  | 'format.time'
+  | 'format.ipv4'
+  | 'format.ipv6'
+  | 'format.binary'
+  // String
+  | 'string.hostname'
+  | 'string.pattern'
+  | 'string.enum'
+  | 'string.length'
+  | 'string.alphanum'
+  | 'string.trim'
+  | 'string.lowercase'
+  | 'string.uppercase'
+  // Number
+  | 'number.base'
+  | 'number.min'
+  | 'number.max'
+  | 'number.integer'
+  | 'number.positive'
+  | 'number.negative'
+  | 'number.precision'
+  | 'number.port'
+  // Boolean
+  | 'boolean.base'
+  // Object
+  | 'object.base'
+  | 'object.min'
+  | 'object.max'
+  | 'object.unknown'
+  | 'object.missing'
+  | 'object.schema'
+  | 'additionalProperties'
+  // Array
+  | 'array.base'
+  | 'array.min'
+  | 'array.max'
+  | 'array.length'
+  | 'array.unique'
+  | 'array.sparse'
+  | 'array.includesRequired'
+  // Date
+  | 'date.base'
+  | 'date.min'
+  | 'date.max'
+  | 'date.format'
+  | 'date.greater'
+  | 'date.less'
+  // Any
+  | 'any.required'
+  | 'any.invalid'
+  | 'any.only'
+  | 'any.unknown'
+  // Patterns — formats
+  | 'pattern.phone'
+  | 'pattern.phone.international'
+  | 'pattern.idCard'
+  | 'pattern.creditCard'
+  | 'pattern.creditCard.visa'
+  | 'pattern.creditCard.mastercard'
+  | 'pattern.creditCard.amex'
+  | 'pattern.creditCard.discover'
+  | 'pattern.creditCard.jcb'
+  | 'pattern.creditCard.unionpay'
+  | 'pattern.licensePlate'
+  | 'pattern.postalCode'
+  | 'pattern.passport'
+  | 'pattern.objectId'
+  | 'pattern.hexColor'
+  | 'pattern.macAddress'
+  | 'pattern.cron'
+  | 'pattern.slug'
+  | 'pattern.domain'
+  | 'pattern.ip'
+  | 'pattern.base64'
+  | 'pattern.jwt'
+  | 'pattern.json'
+  // Patterns — username & password
+  | 'pattern.username'
+  | 'pattern.password.weak'
+  | 'pattern.password.medium'
+  | 'pattern.password.strong'
+  | 'pattern.password.veryStrong'
+  // Patterns — union
+  | 'pattern.emailOrPhone'
+  | 'pattern.usernameOrEmail'
+  | 'pattern.httpOrHttps'
+  // oneOf
+  | 'oneOf'
+  | 'oneOf.invalid'
+  // Error fallback
+  | 'UNKNOWN_ERROR'
+  | 'CUSTOM_VALIDATION_FAILED'
+  | 'ASYNC_VALIDATION_NOT_SUPPORTED'
+  | 'VALIDATE_MUST_BE_FUNCTION'
+
+/**
+ * Complete locale interface — every locale file must implement this (Record<LocaleKey, LocaleMessage>).
+ * TypeScript compile-time guarantee: no key can be missing.
+ */
+export type LocaleMessages = Record<LocaleKey, LocaleMessage>