schema-dsl 2.0.0 → 2.0.1

package/src/types/dsl.ts

@@ -1,131 +1,131 @@
-import type { JSONSchema } from './schema.js'
-import type { DslConfigOptions } from './config.js'
-import type { IConditionalBuilder } from './conditional.js'
-
-/**
- * DslBuilder interface definition (chainable API shape).
- * Implementation class is in src/core/DslBuilder.ts (Phase 7).
- */
-export interface IDslBuilder {
-  // ── Core constraint methods ──────────────────────────────────
-  min(n: number): this
-  max(n: number): this
-  label(text: string): this
-  description(text: string): this
-  pattern(regex: RegExp | string, message?: string): this
-  enum(...values: unknown[]): this
-  optional(): this
-  required(): this
-  default(value: unknown): this
-  error(messages: Record<string, string>): this
-  messages(msgs: Record<string, string>): this
-  format(fmt: string): this
-  custom(validatorFn: (value: unknown) => unknown): this
-
-  // ── String validators ────────────────────────────────────────
-  length(n: number): this
-  alphanum(): this
-  trim(): this
-  lowercase(): this
-  uppercase(): this
-  ip(): this
-  base64(): this
-  jwt(): this
-  json(): this
-  domain(): this
-  slug(): this
-  after(date: string): this
-  before(date: string): this
-  dateGreater(date: string): this
-  dateLess(date: string): this
-  dateFormat(fmt: string): this
-  username(preset?: string | { minLength?: number; maxLength?: number; allowUnderscore?: boolean; allowNumber?: boolean }): this
-  password(preset?: string): this
-  phone(country?: string): this
-  phoneNumber(country?: string): this
-  idCard(country?: string): this
-  creditCard(type?: string): this
-  licensePlate(country?: string): this
-  postalCode(country?: string): this
-  passport(country?: string): this
-
-  // ── Number validators ────────────────────────────────────────
-  precision(n: number): this
-  multiple(n: number): this
-  port(): this
-
-  // ── Object validators ────────────────────────────────────────
-  requireAll(): this
-  strict(): this
-
-  // ── Array validators ─────────────────────────────────────────
-  noSparse(): this
-  includesRequired(items: unknown[]): this
-
-  // ── Output ───────────────────────────────────────────────────
-  toJsonSchema(): JSONSchema
-  toSchema(): JSONSchema
-  toString(): string
-
-  // ── Internal marker ──────────────────────────────────────────
-  readonly _isDslBuilder: true
-}
-
-/**
- * DSL object definition (key → field mapping).
- * ⚠️ Must be an interface rather than a type alias to support recursive DslField ↔ DslDefinition references.
- */
-export interface DslDefinition {
-  [key: string]: DslField
-}
-
-/**
- * v1 conditional field marker (created by dsl.if / dsl.match; compiled to allOf conditional schema during parseObject).
- */
-export interface DslConditionMarker {
-  _isIf?: true
-  _isMatch?: true
-  condition?: string
-  field?: string
-  then?: unknown
-  else?: unknown
-  map?: Record<string, unknown>
-}
-
-/**
- * DSL field type (recursive definition).
- * String | DslBuilder instance | nested object.
- */
-export type DslField = string | IDslBuilder | DslDefinition | DslConditionMarker
-
-/**
- * DslBuilder constructor input (string or nested definition).
- */
-export type DslInput = string | DslDefinition
-
-/**
- * if/conditional function types.
- */
-export type DslIfFn = (condition: (data: unknown) => boolean) => IConditionalBuilder
-export type DslFieldIfFn = (condition: string, thenSchema: unknown, elseSchema?: unknown) => DslConditionMarker
-
-/**
- * dsl.error namespace.
- */
-export interface DslErrorNamespace {
-  readonly [code: string]: string
-}
-
-/**
- * DslFn interface (function overloads + namespace attachments).
- * ⚠️ Uses function overloads rather than union return types to ensure TypeScript type narrowing works correctly.
- */
-export interface DslFn {
-  (def: string): IDslBuilder
-  (def: DslDefinition): JSONSchema
-  config: (options?: Partial<DslConfigOptions>) => void
-  if: DslIfFn & DslFieldIfFn
-  _if: DslIfFn & DslFieldIfFn
-  match: (value: unknown, cases: Record<string, unknown>) => DslConditionMarker
-  error: DslErrorNamespace
-}
+import type { JSONSchema } from './schema.js'
+import type { DslConfigOptions } from './config.js'
+import type { IConditionalBuilder } from './conditional.js'
+
+/**
+ * DslBuilder interface definition (chainable API shape).
+ * Implementation class is in src/core/DslBuilder.ts (Phase 7).
+ */
+export interface IDslBuilder {
+  // ── Core constraint methods ──────────────────────────────────
+  min(n: number): this
+  max(n: number): this
+  label(text: string): this
+  description(text: string): this
+  pattern(regex: RegExp | string, message?: string): this
+  enum(...values: unknown[]): this
+  optional(): this
+  required(): this
+  default(value: unknown): this
+  error(messages: Record<string, string>): this
+  messages(msgs: Record<string, string>): this
+  format(fmt: string): this
+  custom(validatorFn: (value: unknown) => unknown): this
+
+  // ── String validators ────────────────────────────────────────
+  length(n: number): this
+  alphanum(): this
+  trim(): this
+  lowercase(): this
+  uppercase(): this
+  ip(): this
+  base64(): this
+  jwt(): this
+  json(): this
+  domain(): this
+  slug(): this
+  after(date: string): this
+  before(date: string): this
+  dateGreater(date: string): this
+  dateLess(date: string): this
+  dateFormat(fmt: string): this
+  username(preset?: string | { minLength?: number; maxLength?: number; allowUnderscore?: boolean; allowNumber?: boolean }): this
+  password(preset?: string): this
+  phone(country?: string): this
+  phoneNumber(country?: string): this
+  idCard(country?: string): this
+  creditCard(type?: string): this
+  licensePlate(country?: string): this
+  postalCode(country?: string): this
+  passport(country?: string): this
+
+  // ── Number validators ────────────────────────────────────────
+  precision(n: number): this
+  multiple(n: number): this
+  port(): this
+
+  // ── Object validators ────────────────────────────────────────
+  requireAll(): this
+  strict(): this
+
+  // ── Array validators ─────────────────────────────────────────
+  noSparse(): this
+  includesRequired(items: unknown[]): this
+
+  // ── Output ───────────────────────────────────────────────────
+  toJsonSchema(): JSONSchema
+  toSchema(): JSONSchema
+  toString(): string
+
+  // ── Internal marker ──────────────────────────────────────────
+  readonly _isDslBuilder: true
+}
+
+/**
+ * DSL object definition (key → field mapping).
+ * ⚠️ Must be an interface rather than a type alias to support recursive DslField ↔ DslDefinition references.
+ */
+export interface DslDefinition {
+  [key: string]: DslField
+}
+
+/**
+ * v1 conditional field marker (created by dsl.if / dsl.match; compiled to allOf conditional schema during parseObject).
+ */
+export interface DslConditionMarker {
+  _isIf?: true
+  _isMatch?: true
+  condition?: string
+  field?: string
+  then?: unknown
+  else?: unknown
+  map?: Record<string, unknown>
+}
+
+/**
+ * DSL field type (recursive definition).
+ * String | DslBuilder instance | nested object.
+ */
+export type DslField = string | IDslBuilder | DslDefinition | DslConditionMarker
+
+/**
+ * DslBuilder constructor input (string or nested definition).
+ */
+export type DslInput = string | DslDefinition
+
+/**
+ * if/conditional function types.
+ */
+export type DslIfFn = (condition: (data: unknown) => boolean) => IConditionalBuilder
+export type DslFieldIfFn = (condition: string, thenSchema: unknown, elseSchema?: unknown) => DslConditionMarker
+
+/**
+ * dsl.error namespace.
+ */
+export interface DslErrorNamespace {
+  readonly [code: string]: string
+}
+
+/**
+ * DslFn interface (function overloads + namespace attachments).
+ * ⚠️ Uses function overloads rather than union return types to ensure TypeScript type narrowing works correctly.
+ */
+export interface DslFn {
+  (def: string): IDslBuilder
+  (def: DslDefinition): JSONSchema
+  config: (options?: Partial<DslConfigOptions>) => void
+  if: DslIfFn & DslFieldIfFn
+  _if: DslIfFn & DslFieldIfFn
+  match: (value: unknown, cases: Record<string, unknown>) => DslConditionMarker
+  error: DslErrorNamespace
+}

package/src/types/error.ts

@@ -1,60 +1,60 @@
-/**
- * Error message templates (custom validation error copy).
- */
-export interface ErrorMessages {
-  // Length / range (v1.0.3+ recommends min/max over minLength/maximum etc.)
-  min?: string
-  max?: string
-  minLength?: string
-  maxLength?: string
-  minimum?: string
-  maximum?: string
-  minItems?: string
-  maxItems?: string
-  // Types
-  type?: string
-  string?: string
-  number?: string
-  integer?: string
-  boolean?: string
-  array?: string
-  object?: string
-  // Formats
-  email?: string
-  url?: string
-  date?: string
-  dateTime?: string
-  uuid?: string
-  ipv4?: string
-  ipv6?: string
-  // Other
-  pattern?: string
-  format?: string
-  required?: string
-  enum?: string
-  uniqueItems?: string
-  // Custom keywords
-  exactLength?: string
-  phone?: string
-  idCard?: string
-  creditCard?: string
-  // Extensible
-  [key: string]: string | undefined
-}
-
-/**
- * Error code constant type (shape of the ErrorCodes object).
- */
-export interface ErrorCodeMap {
-  // Validation errors
-  VALIDATION_ERROR: 'VALIDATION_ERROR'
-  INVALID_SCHEMA: 'INVALID_SCHEMA'
-  // Config errors
-  INVALID_CONFIG: 'INVALID_CONFIG'
-  INVALID_LOCALE: 'INVALID_LOCALE'
-  // Plugin errors
-  PLUGIN_INSTALL_ERROR: 'PLUGIN_INSTALL_ERROR'
-  PLUGIN_NOT_FOUND: 'PLUGIN_NOT_FOUND'
-  // Extensible
-  [key: string]: string
-}
+/**
+ * Error message templates (custom validation error copy).
+ */
+export interface ErrorMessages {
+  // Length / range (v1.0.3+ recommends min/max over minLength/maximum etc.)
+  min?: string
+  max?: string
+  minLength?: string
+  maxLength?: string
+  minimum?: string
+  maximum?: string
+  minItems?: string
+  maxItems?: string
+  // Types
+  type?: string
+  string?: string
+  number?: string
+  integer?: string
+  boolean?: string
+  array?: string
+  object?: string
+  // Formats
+  email?: string
+  url?: string
+  date?: string
+  dateTime?: string
+  uuid?: string
+  ipv4?: string
+  ipv6?: string
+  // Other
+  pattern?: string
+  format?: string
+  required?: string
+  enum?: string
+  uniqueItems?: string
+  // Custom keywords
+  exactLength?: string
+  phone?: string
+  idCard?: string
+  creditCard?: string
+  // Extensible
+  [key: string]: string | undefined
+}
+
+/**
+ * Error code constant type (shape of the ErrorCodes object).
+ */
+export interface ErrorCodeMap {
+  // Validation errors
+  VALIDATION_ERROR: 'VALIDATION_ERROR'
+  INVALID_SCHEMA: 'INVALID_SCHEMA'
+  // Config errors
+  INVALID_CONFIG: 'INVALID_CONFIG'
+  INVALID_LOCALE: 'INVALID_LOCALE'
+  // Plugin errors
+  PLUGIN_INSTALL_ERROR: 'PLUGIN_INSTALL_ERROR'
+  PLUGIN_NOT_FOUND: 'PLUGIN_NOT_FOUND'
+  // Extensible
+  [key: string]: string
+}

package/src/types/index.ts

@@ -1,17 +1,17 @@
-// --- Core types ---
-export type { JSONSchema, SchemaIOOptions } from './schema.js'
-export type {
-  DslFn,
-  DslField,
-  DslDefinition,
-  DslInput,
-  IDslBuilder,
-  DslIfFn,
-  DslErrorNamespace,
-} from './dsl.js'
-export type { ValidateOptions, ValidationResult, ValidationErrorItem, AjvError } from './validate.js'
-export type { DslConfigOptions, I18nConfig, CacheOptions, ValidatorOptions } from './config.js'
-export type { ErrorMessages, ErrorCodeMap } from './error.js'
-export type { Plugin, HookFn, HookName, HookContext, PluginManagerOptions } from './plugin.js'
-export type { IConditionalBuilder } from './conditional.js'
-export type { InferSchema, InferJsonSchema, InferDslDefinition, InferDslString } from './infer.js'
+// --- Core types ---
+export type { JSONSchema, SchemaIOOptions } from './schema.js'
+export type {
+  DslFn,
+  DslField,
+  DslDefinition,
+  DslInput,
+  IDslBuilder,
+  DslIfFn,
+  DslErrorNamespace,
+} from './dsl.js'
+export type { ValidateOptions, ValidationResult, ValidationErrorItem, AjvError } from './validate.js'
+export type { DslConfigOptions, I18nConfig, CacheOptions, ValidatorOptions } from './config.js'
+export type { ErrorMessages, ErrorCodeMap } from './error.js'
+export type { Plugin, HookFn, HookName, HookContext, PluginManagerOptions } from './plugin.js'
+export type { IConditionalBuilder } from './conditional.js'
+export type { InferSchema, InferJsonSchema, InferDslDefinition, InferDslString } from './infer.js'