@oxog/vld 1.3.1 → 1.5.0

package/dist/plugins/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * VLD Plugin Types
+ *
+ * This module defines the plugin system interfaces and types
+ * for extending VLD with custom validators, transforms, and codecs.
+ */
+import type { VldBase } from '../validators/base';
+import type { VldError } from '../errors';
+import type { ParseResult } from '../validators/base';
+import type { Locale } from '../locales';
+/**
+ * Plugin metadata
+ */
+export interface PluginMeta {
+    /** Plugin name (must be unique) */
+    readonly name: string;
+    /** Plugin version (semver) */
+    readonly version: string;
+    /** Plugin description */
+    readonly description?: string;
+    /** Plugin author */
+    readonly author?: string;
+    /** Plugin dependencies */
+    readonly dependencies?: Record<string, string>;
+}
+/**
+ * VLD context available to plugins
+ */
+export interface VldContext {
+    /** Current locale */
+    locale: Locale;
+    /** Strict mode enabled */
+    strict: boolean;
+    /** Debug mode enabled */
+    debug: boolean;
+    /** Custom context data */
+    custom: Record<string, unknown>;
+}
+/**
+ * Validator factory function
+ */
+export type ValidatorFactory<T = unknown> = (...args: unknown[]) => VldBase<unknown, T>;
+/**
+ * Transform factory function
+ */
+export type TransformFactory<TInput = unknown, TOutput = unknown> = (...args: unknown[]) => (value: TInput) => TOutput;
+/**
+ * Codec factory function
+ */
+export interface CodecFactory<TInput = unknown, TOutput = unknown> {
+    decode: (value: TInput) => TOutput | Promise<TOutput>;
+    encode: (value: TOutput) => TInput | Promise<TInput>;
+}
+/**
+ * Plugin hook context
+ */
+export interface HookContext {
+    /** Path to current value in nested validation */
+    path: (string | number)[];
+    /** Parent schema (if nested) */
+    parent?: VldBase<unknown, unknown>;
+    /** Abort validation */
+    abort: () => void;
+}
+/**
+ * Plugin hooks for intercepting validation lifecycle
+ */
+export interface PluginHooks {
+    /**
+     * Called before parsing starts
+     * Can modify the value before validation
+     */
+    onBeforeParse?: (value: unknown, schema: VldBase<unknown, unknown>, context: HookContext) => unknown;
+    /**
+     * Called after parsing completes (success or failure)
+     * Can modify the result
+     */
+    onAfterParse?: <T>(result: ParseResult<T>, schema: VldBase<unknown, unknown>, context: HookContext) => ParseResult<T>;
+    /**
+     * Called when a validation error occurs
+     * Can log, transform, or suppress errors
+     */
+    onError?: (error: VldError, schema: VldBase<unknown, unknown>, context: HookContext) => void;
+    /**
+     * Called when validation succeeds
+     * Useful for metrics and logging
+     */
+    onSuccess?: <T>(data: T, schema: VldBase<unknown, unknown>, context: HookContext) => void;
+}
+/**
+ * VLD Plugin interface
+ */
+export interface VldPlugin extends PluginMeta, PluginHooks {
+    /**
+     * Custom validators provided by this plugin
+     */
+    validators?: Record<string, ValidatorFactory>;
+    /**
+     * Custom transforms provided by this plugin
+     */
+    transforms?: Record<string, TransformFactory>;
+    /**
+     * Custom codecs provided by this plugin
+     */
+    codecs?: Record<string, CodecFactory>;
+    /**
+     * Install hook - called when plugin is registered
+     * Receives the VLD kernel for additional setup
+     */
+    install?: (kernel: VldKernelInstance) => void | Promise<void>;
+    /**
+     * Uninstall hook - called when plugin is removed
+     */
+    uninstall?: (kernel: VldKernelInstance) => void | Promise<void>;
+}
+/**
+ * Kernel options
+ */
+export interface VldKernelOptions {
+    /** Initial context */
+    context?: Partial<VldContext>;
+    /** Plugins to load on creation */
+    plugins?: VldPlugin[];
+    /** Error handling strategy */
+    errorStrategy?: 'throw' | 'isolate' | 'silent';
+    /** Enable debug mode */
+    debug?: boolean;
+}
+/**
+ * VLD Kernel instance interface
+ */
+export interface VldKernelInstance {
+    /** Get current context */
+    getContext(): VldContext;
+    /** Update context */
+    setContext(partial: Partial<VldContext>): void;
+    /** Register a plugin */
+    use(plugin: VldPlugin): this;
+    /** Remove a plugin by name */
+    remove(name: string): boolean;
+    /** Get a plugin by name */
+    getPlugin(name: string): VldPlugin | undefined;
+    /** Get all registered plugins */
+    getPlugins(): VldPlugin[];
+    /** Check if a plugin is registered */
+    hasPlugin(name: string): boolean;
+    /** Register a custom validator */
+    registerValidator(name: string, factory: ValidatorFactory): this;
+    /** Get a validator by name */
+    getValidator(name: string): VldBase<unknown, unknown> | undefined;
+    /** Get all registered validators */
+    getValidators(): Record<string, ValidatorFactory>;
+    /** Register a custom transform */
+    registerTransform(name: string, factory: TransformFactory): this;
+    /** Get a transform by name */
+    getTransform(name: string): TransformFactory | undefined;
+    /** Register a custom codec */
+    registerCodec(name: string, codec: CodecFactory): this;
+    /** Get a codec by name */
+    getCodec(name: string): CodecFactory | undefined;
+    /** Execute beforeParse hooks */
+    executeBeforeParse(value: unknown, schema: VldBase<unknown, unknown>, context: HookContext): unknown;
+    /** Execute afterParse hooks */
+    executeAfterParse<T>(result: ParseResult<T>, schema: VldBase<unknown, unknown>, context: HookContext): ParseResult<T>;
+    /** Execute error hooks */
+    executeOnError(error: VldError, schema: VldBase<unknown, unknown>, context: HookContext): void;
+    /** Execute success hooks */
+    executeOnSuccess<T>(data: T, schema: VldBase<unknown, unknown>, context: HookContext): void;
+    /** Dispose of all plugins and cleanup */
+    dispose(): Promise<void>;
+}
+/**
+ * Plugin builder for fluent plugin creation
+ */
+export interface PluginBuilder {
+    name(name: string): this;
+    version(version: string): this;
+    description(description: string): this;
+    validator(name: string, factory: ValidatorFactory): this;
+    transform(name: string, factory: TransformFactory): this;
+    codec(name: string, codec: CodecFactory): this;
+    hook<K extends keyof PluginHooks>(name: K, fn: PluginHooks[K]): this;
+    install(fn: VldPlugin['install']): this;
+    build(): VldPlugin;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/types.js

@@ -0,0 +1,8 @@
+/**
+ * VLD Plugin Types
+ *
+ * This module defines the plugin system interfaces and types
+ * for extending VLD with custom validators, transforms, and codecs.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\r\n * VLD Plugin Types\r\n *\r\n * This module defines the plugin system interfaces and types\r\n * for extending VLD with custom validators, transforms, and codecs.\r\n */\r\n\r\nimport type { VldBase } from '../validators/base';\r\nimport type { VldError } from '../errors';\r\nimport type { ParseResult } from '../validators/base';\r\nimport type { Locale } from '../locales';\r\n\r\n/**\r\n * Plugin metadata\r\n */\r\nexport interface PluginMeta {\r\n  /** Plugin name (must be unique) */\r\n  readonly name: string;\r\n  /** Plugin version (semver) */\r\n  readonly version: string;\r\n  /** Plugin description */\r\n  readonly description?: string;\r\n  /** Plugin author */\r\n  readonly author?: string;\r\n  /** Plugin dependencies */\r\n  readonly dependencies?: Record<string, string>;\r\n}\r\n\r\n/**\r\n * VLD context available to plugins\r\n */\r\nexport interface VldContext {\r\n  /** Current locale */\r\n  locale: Locale;\r\n  /** Strict mode enabled */\r\n  strict: boolean;\r\n  /** Debug mode enabled */\r\n  debug: boolean;\r\n  /** Custom context data */\r\n  custom: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Validator factory function\r\n */\r\nexport type ValidatorFactory<T = unknown> = (\r\n  ...args: unknown[]\r\n) => VldBase<unknown, T>;\r\n\r\n/**\r\n * Transform factory function\r\n */\r\nexport type TransformFactory<TInput = unknown, TOutput = unknown> = (\r\n  ...args: unknown[]\r\n) => (value: TInput) => TOutput;\r\n\r\n/**\r\n * Codec factory function\r\n */\r\nexport interface CodecFactory<TInput = unknown, TOutput = unknown> {\r\n  decode: (value: TInput) => TOutput | Promise<TOutput>;\r\n  encode: (value: TOutput) => TInput | Promise<TInput>;\r\n}\r\n\r\n/**\r\n * Plugin hook context\r\n */\r\nexport interface HookContext {\r\n  /** Path to current value in nested validation */\r\n  path: (string | number)[];\r\n  /** Parent schema (if nested) */\r\n  parent?: VldBase<unknown, unknown>;\r\n  /** Abort validation */\r\n  abort: () => void;\r\n}\r\n\r\n/**\r\n * Plugin hooks for intercepting validation lifecycle\r\n */\r\nexport interface PluginHooks {\r\n  /**\r\n   * Called before parsing starts\r\n   * Can modify the value before validation\r\n   */\r\n  onBeforeParse?: (\r\n    value: unknown,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ) => unknown;\r\n\r\n  /**\r\n   * Called after parsing completes (success or failure)\r\n   * Can modify the result\r\n   */\r\n  onAfterParse?: <T>(\r\n    result: ParseResult<T>,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ) => ParseResult<T>;\r\n\r\n  /**\r\n   * Called when a validation error occurs\r\n   * Can log, transform, or suppress errors\r\n   */\r\n  onError?: (\r\n    error: VldError,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ) => void;\r\n\r\n  /**\r\n   * Called when validation succeeds\r\n   * Useful for metrics and logging\r\n   */\r\n  onSuccess?: <T>(\r\n    data: T,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ) => void;\r\n}\r\n\r\n/**\r\n * VLD Plugin interface\r\n */\r\nexport interface VldPlugin extends PluginMeta, PluginHooks {\r\n  /**\r\n   * Custom validators provided by this plugin\r\n   */\r\n  validators?: Record<string, ValidatorFactory>;\r\n\r\n  /**\r\n   * Custom transforms provided by this plugin\r\n   */\r\n  transforms?: Record<string, TransformFactory>;\r\n\r\n  /**\r\n   * Custom codecs provided by this plugin\r\n   */\r\n  codecs?: Record<string, CodecFactory>;\r\n\r\n  /**\r\n   * Install hook - called when plugin is registered\r\n   * Receives the VLD kernel for additional setup\r\n   */\r\n  install?: (kernel: VldKernelInstance) => void | Promise<void>;\r\n\r\n  /**\r\n   * Uninstall hook - called when plugin is removed\r\n   */\r\n  uninstall?: (kernel: VldKernelInstance) => void | Promise<void>;\r\n}\r\n\r\n/**\r\n * Kernel options\r\n */\r\nexport interface VldKernelOptions {\r\n  /** Initial context */\r\n  context?: Partial<VldContext>;\r\n  /** Plugins to load on creation */\r\n  plugins?: VldPlugin[];\r\n  /** Error handling strategy */\r\n  errorStrategy?: 'throw' | 'isolate' | 'silent';\r\n  /** Enable debug mode */\r\n  debug?: boolean;\r\n}\r\n\r\n/**\r\n * VLD Kernel instance interface\r\n */\r\nexport interface VldKernelInstance {\r\n  // ============================================\r\n  // Context Management\r\n  // ============================================\r\n\r\n  /** Get current context */\r\n  getContext(): VldContext;\r\n\r\n  /** Update context */\r\n  setContext(partial: Partial<VldContext>): void;\r\n\r\n  // ============================================\r\n  // Plugin Management\r\n  // ============================================\r\n\r\n  /** Register a plugin */\r\n  use(plugin: VldPlugin): this;\r\n\r\n  /** Remove a plugin by name */\r\n  remove(name: string): boolean;\r\n\r\n  /** Get a plugin by name */\r\n  getPlugin(name: string): VldPlugin | undefined;\r\n\r\n  /** Get all registered plugins */\r\n  getPlugins(): VldPlugin[];\r\n\r\n  /** Check if a plugin is registered */\r\n  hasPlugin(name: string): boolean;\r\n\r\n  // ============================================\r\n  // Validator Registry\r\n  // ============================================\r\n\r\n  /** Register a custom validator */\r\n  registerValidator(name: string, factory: ValidatorFactory): this;\r\n\r\n  /** Get a validator by name */\r\n  getValidator(name: string): VldBase<unknown, unknown> | undefined;\r\n\r\n  /** Get all registered validators */\r\n  getValidators(): Record<string, ValidatorFactory>;\r\n\r\n  // ============================================\r\n  // Transform Registry\r\n  // ============================================\r\n\r\n  /** Register a custom transform */\r\n  registerTransform(name: string, factory: TransformFactory): this;\r\n\r\n  /** Get a transform by name */\r\n  getTransform(name: string): TransformFactory | undefined;\r\n\r\n  // ============================================\r\n  // Codec Registry\r\n  // ============================================\r\n\r\n  /** Register a custom codec */\r\n  registerCodec(name: string, codec: CodecFactory): this;\r\n\r\n  /** Get a codec by name */\r\n  getCodec(name: string): CodecFactory | undefined;\r\n\r\n  // ============================================\r\n  // Hook Execution\r\n  // ============================================\r\n\r\n  /** Execute beforeParse hooks */\r\n  executeBeforeParse(\r\n    value: unknown,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ): unknown;\r\n\r\n  /** Execute afterParse hooks */\r\n  executeAfterParse<T>(\r\n    result: ParseResult<T>,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ): ParseResult<T>;\r\n\r\n  /** Execute error hooks */\r\n  executeOnError(\r\n    error: VldError,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ): void;\r\n\r\n  /** Execute success hooks */\r\n  executeOnSuccess<T>(\r\n    data: T,\r\n    schema: VldBase<unknown, unknown>,\r\n    context: HookContext\r\n  ): void;\r\n\r\n  // ============================================\r\n  // Lifecycle\r\n  // ============================================\r\n\r\n  /** Dispose of all plugins and cleanup */\r\n  dispose(): Promise<void>;\r\n}\r\n\r\n/**\r\n * Plugin builder for fluent plugin creation\r\n */\r\nexport interface PluginBuilder {\r\n  name(name: string): this;\r\n  version(version: string): this;\r\n  description(description: string): this;\r\n  validator(name: string, factory: ValidatorFactory): this;\r\n  transform(name: string, factory: TransformFactory): this;\r\n  codec(name: string, codec: CodecFactory): this;\r\n  hook<K extends keyof PluginHooks>(name: K, fn: PluginHooks[K]): this;\r\n  install(fn: VldPlugin['install']): this;\r\n  build(): VldPlugin;\r\n}\r\n"]}

package/dist/style.d.ts

@@ -0,0 +1,123 @@
+/**
+ * VLD Style - Console styling utilities
+ *
+ * Bu modül @oxog/pigment paketi ile uyumlu renkli console output sağlar.
+ * Eğer @oxog/pigment yüklüyse onun implementasyonu kullanılır.
+ * Yüklü değilse, internal ANSI color implementasyonu kullanılır.
+ */
+/**
+ * Renkleri etkinleştirir
+ */
+export declare function enableColors(): void;
+/**
+ * Renkleri devre dışı bırakır
+ */
+export declare function disableColors(): void;
+/**
+ * Renklerin etkin olup olmadığını kontrol eder
+ */
+export declare function colorsEnabled(): boolean;
+/**
+ * Style helper object - @oxog/pigment API'si ile uyumlu
+ */
+export declare const style: {
+    reset: (text: string) => string;
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    italic: (text: string) => string;
+    underline: (text: string) => string;
+    inverse: (text: string) => string;
+    hidden: (text: string) => string;
+    strikethrough: (text: string) => string;
+    black: (text: string) => string;
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    blue: (text: string) => string;
+    magenta: (text: string) => string;
+    cyan: (text: string) => string;
+    white: (text: string) => string;
+    gray: (text: string) => string;
+    grey: (text: string) => string;
+    brightRed: (text: string) => string;
+    brightGreen: (text: string) => string;
+    brightYellow: (text: string) => string;
+    brightBlue: (text: string) => string;
+    brightMagenta: (text: string) => string;
+    brightCyan: (text: string) => string;
+    brightWhite: (text: string) => string;
+    bgBlack: (text: string) => string;
+    bgRed: (text: string) => string;
+    bgGreen: (text: string) => string;
+    bgYellow: (text: string) => string;
+    bgBlue: (text: string) => string;
+    bgMagenta: (text: string) => string;
+    bgCyan: (text: string) => string;
+    bgWhite: (text: string) => string;
+    success: (text: string) => string;
+    error: (text: string) => string;
+    warning: (text: string) => string;
+    info: (text: string) => string;
+    muted: (text: string) => string;
+    highlight: (text: string) => string;
+    combine: (...styles: ((text: string) => string)[]) => (text: string) => string;
+};
+import type { VldError, VldIssue } from './errors.js';
+/**
+ * VLD hata mesajını renkli formatta döner
+ */
+export declare function prettifyErrorColored(error: VldError): string;
+/**
+ * VLD issue'yu renkli formatta döner
+ */
+export declare function formatIssueColored(issue: VldIssue): string;
+/**
+ * Başarı mesajı formatlar
+ */
+export declare function formatSuccess(message: string): string;
+/**
+ * Uyarı mesajı formatlar
+ */
+export declare function formatWarning(message: string): string;
+/**
+ * Bilgi mesajı formatlar
+ */
+export declare function formatInfo(message: string): string;
+/**
+ * Debug mesajı formatlar
+ */
+export declare function formatDebug(message: string): string;
+export interface TableColumn {
+    header: string;
+    width?: number;
+    align?: 'left' | 'right' | 'center';
+}
+export interface TableOptions {
+    columns: TableColumn[];
+    border?: boolean;
+    headerColor?: (text: string) => string;
+    rowColor?: (text: string, rowIndex: number) => string;
+}
+/**
+ * Basit tablo formatlar
+ */
+export declare function formatTable(rows: string[][], options: TableOptions): string;
+/**
+ * Spinner oluşturur
+ */
+export declare function createSpinner(text: string): {
+    start: () => void;
+    stop: (success?: boolean, finalText?: string) => void;
+    update: (text: string) => void;
+};
+export interface BoxOptions {
+    title?: string;
+    padding?: number;
+    borderColor?: (text: string) => string;
+    titleColor?: (text: string) => string;
+}
+/**
+ * Metin etrafına kutu çizer
+ */
+export declare function box(content: string, options?: BoxOptions): string;
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"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"}