@wildo-ai/zod-decorators 1.0.0

package/dist/esm/zod-bigdecimal.d.ts

@@ -0,0 +1,193 @@
+import { DecoratorInput, BigDecimalSchemaOptions, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types.js";
+import { z } from "zod";
+import Big from "big.js";
+/**
+ * BigDecimal value type - represents a precise decimal number as a string.
+ *
+ * Using strings to store decimal values avoids JavaScript's floating-point
+ * precision issues. The big.js library is used for precise arithmetic operations.
+ *
+ * Example: "19.99", "0.00000001", "123456789.123456789"
+ */
+export type BigDecimalValue = string;
+/**
+ * Zod schema for BigDecimalValue.
+ * Validates that the string represents a valid decimal number.
+ */
+export declare const BigDecimalValueSchema: z.ZodString;
+/**
+ * z_bigdecimal() - Creates bigdecimal schemas for precise decimal numbers.
+ *
+ * BigDecimal values are stored as strings to avoid floating-point precision issues.
+ * The big.js library is used for arithmetic operations.
+ *
+ * @example
+ * ```typescript
+ * import { z_bigdecimal } from '@wildo-ai/zod-decorators';
+ *
+ * const price = z_bigdecimal();
+ * const quantity = z_bigdecimal({ precision: 8 });
+ * const percentage = z_bigdecimal({ min: '0', max: '100' });
+ *
+ * // With decorators (chainable)
+ * z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } })
+ * z_bigdecimal({ precision: 2 }).isHidden({ edit: true })
+ * ```
+ */
+/**
+ * Creates a bigdecimal schema with metadata for detection and form component rendering.
+ *
+ * @param options - Configuration options for bigdecimal field
+ * @returns A Zod string schema with metadata for bigdecimal detection
+ *
+ * @example
+ * ```typescript
+ * // Simple bigdecimal
+ * const price = z_bigdecimal();
+ * // Infers: string
+ *
+ * // With precision constraint
+ * const btcAmount = z_bigdecimal({ precision: 8 });
+ *
+ * // With min/max constraints
+ * const percentage = z_bigdecimal({
+ *   min: '0',
+ *   max: '100',
+ *   precision: 2
+ * });
+ * ```
+ */
+export declare function createBigDecimalSchema(options?: BigDecimalSchemaOptions): DecoratedBigDecimalSchema;
+/**
+ * Return type for bigdecimal schemas - includes decorator methods.
+ * Note: IS_FOREIGN_KEY is not applicable to bigdecimal values.
+ * IS_DB_INDEXED indexes the string value directly for query optimization.
+ */
+export type DecoratedBigDecimalSchema = z.ZodString & {
+    [ZodDecorator.IS_DB_INDEXED](): DecoratedBigDecimalSchema;
+    [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedBigDecimalSchema;
+    [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedBigDecimalSchema;
+    addDecorators(decorators: DecoratorInput[]): DecoratedBigDecimalSchema;
+};
+/**
+ * Creates a bigdecimal schema for precise decimal numbers stored as strings.
+ * Named z_bigdecimal to indicate it's a Zod helper function exported standalone.
+ *
+ * BigDecimal values are stored as strings to avoid floating-point precision issues.
+ * Use big.js for arithmetic operations on these values.
+ *
+ * @example
+ * ```typescript
+ * import { z_bigdecimal } from '@wildo-ai/zod-decorators';
+ *
+ * // Simple usage
+ * z_bigdecimal()  // Any valid decimal number as string
+ *
+ * // With options
+ * z_bigdecimal({ precision: 2 })  // Max 2 decimal places
+ * z_bigdecimal({ min: '0', max: '100' })  // Range constraint
+ * z_bigdecimal({ precision: 8, min: '0' })  // Crypto amount
+ *
+ * // With decorators (chainable)
+ * z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } })
+ * z_bigdecimal({ precision: 2 }).isHidden({ edit: true })
+ *
+ * // Usage example
+ * const price: BigDecimalValue = "19.99";
+ * const btcAmount: BigDecimalValue = "0.00000001";
+ *
+ * // Arithmetic with big.js
+ * import Big from 'big.js';
+ * const total = new Big(price).plus("10.01").toString(); // "30.00"
+ * ```
+ */
+export declare function z_bigdecimal(options?: BigDecimalSchemaOptions): DecoratedBigDecimalSchema;
+/**
+ * Add two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns Sum as string
+ */
+export declare function bigDecimalAdd(a: BigDecimalValue, b: BigDecimalValue): BigDecimalValue;
+/**
+ * Subtract two bigdecimal values.
+ * @param a - Value to subtract from
+ * @param b - Value to subtract
+ * @returns Difference as string
+ */
+export declare function bigDecimalSubtract(a: BigDecimalValue, b: BigDecimalValue): BigDecimalValue;
+/**
+ * Multiply two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns Product as string
+ */
+export declare function bigDecimalMultiply(a: BigDecimalValue, b: BigDecimalValue): BigDecimalValue;
+/**
+ * Divide two bigdecimal values.
+ * @param a - Dividend
+ * @param b - Divisor
+ * @param precision - Number of decimal places for result (default: 20)
+ * @returns Quotient as string
+ */
+export declare function bigDecimalDivide(a: BigDecimalValue, b: BigDecimalValue, precision?: number): BigDecimalValue;
+/**
+ * Compare two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export declare function bigDecimalCompare(a: BigDecimalValue, b: BigDecimalValue): -1 | 0 | 1;
+/**
+ * Round a bigdecimal value to specified precision.
+ * @param value - Value to round
+ * @param precision - Number of decimal places
+ * @param roundingMode - big.js rounding mode (default: ROUND_HALF_UP)
+ * @returns Rounded value as string
+ */
+export declare function bigDecimalRound(value: BigDecimalValue, precision: number, roundingMode?: Big.RoundingMode): BigDecimalValue;
+/**
+ * Format a bigdecimal value for display with fixed decimal places.
+ * @param value - Value to format
+ * @param decimalPlaces - Number of decimal places to show
+ * @returns Formatted string with trailing zeros if needed
+ */
+export declare function bigDecimalFormat(value: BigDecimalValue, decimalPlaces: number): string;
+/**
+ * Check if a bigdecimal value is zero.
+ * @param value - Value to check
+ * @returns true if value equals zero
+ */
+export declare function bigDecimalIsZero(value: BigDecimalValue): boolean;
+/**
+ * Check if a bigdecimal value is positive (> 0).
+ * @param value - Value to check
+ * @returns true if value is greater than zero
+ */
+export declare function bigDecimalIsPositive(value: BigDecimalValue): boolean;
+/**
+ * Check if a bigdecimal value is negative (< 0).
+ * @param value - Value to check
+ * @returns true if value is less than zero
+ */
+export declare function bigDecimalIsNegative(value: BigDecimalValue): boolean;
+/**
+ * Get the absolute value of a bigdecimal.
+ * @param value - Value
+ * @returns Absolute value as string
+ */
+export declare function bigDecimalAbs(value: BigDecimalValue): BigDecimalValue;
+/**
+ * Convert a number to bigdecimal string.
+ * @param value - Number to convert
+ * @returns String representation
+ */
+export declare function toBigDecimal(value: number): BigDecimalValue;
+/**
+ * Convert a bigdecimal string to number.
+ * Warning: May lose precision for very large or very precise numbers.
+ * @param value - BigDecimal string
+ * @returns Number value
+ */
+export declare function fromBigDecimal(value: BigDecimalValue): number;
+//# sourceMappingURL=zod-bigdecimal.d.ts.map

package/dist/esm/zod-bigdecimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-bigdecimal.d.ts","sourceRoot":"","sources":["../../src/zod-bigdecimal.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAkE,uBAAuB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACxL,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,GAAG,MAAM,QAAQ,CAAC;AAEzB;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAcrC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,CAAC,CAAC,SAGtB,CAAC;AAEjB;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,yBAAyB,CAkE3B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,SAAS,GAAG;IACpD,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,yBAAyB,CAAC;IAC1D,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,yBAAyB,CAAC;IAC9G,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,yBAAyB,CAAC;IAC1H,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,yBAAyB,CAAC;CACxE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,uBAAuB,GAChC,yBAAyB,CAE3B;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,eAAe,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,eAAe,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,eAAe,CAE1F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,EAAE,SAAS,GAAE,MAAW,GAAG,eAAe,CAEhH;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAEpF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,GAAG,CAAC,YAA8B,GAC/C,eAAe,CAEjB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAErE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE7D"}

package/dist/esm/zod-bigdecimal.js

@@ -0,0 +1,274 @@
+// ============================================================================
+// BIGDECIMAL SCHEMA HELPER
+// ============================================================================
+import { SCHEMA_METADATA, ZodDecorator } from "./zod-decorators.types.js";
+import { z } from "zod";
+import { addChainableMethods } from "./zod.module-override.js";
+import Big from "big.js";
+/**
+ * Validates that a string represents a valid big decimal number.
+ */
+function isValidBigDecimal(value) {
+    try {
+        new Big(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Zod schema for BigDecimalValue.
+ * Validates that the string represents a valid decimal number.
+ */
+export const BigDecimalValueSchema = z.string().refine(isValidBigDecimal, { message: "Invalid decimal number format" });
+/**
+ * z_bigdecimal() - Creates bigdecimal schemas for precise decimal numbers.
+ *
+ * BigDecimal values are stored as strings to avoid floating-point precision issues.
+ * The big.js library is used for arithmetic operations.
+ *
+ * @example
+ * ```typescript
+ * import { z_bigdecimal } from '@wildo-ai/zod-decorators';
+ *
+ * const price = z_bigdecimal();
+ * const quantity = z_bigdecimal({ precision: 8 });
+ * const percentage = z_bigdecimal({ min: '0', max: '100' });
+ *
+ * // With decorators (chainable)
+ * z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } })
+ * z_bigdecimal({ precision: 2 }).isHidden({ edit: true })
+ * ```
+ */
+/**
+ * Creates a bigdecimal schema with metadata for detection and form component rendering.
+ *
+ * @param options - Configuration options for bigdecimal field
+ * @returns A Zod string schema with metadata for bigdecimal detection
+ *
+ * @example
+ * ```typescript
+ * // Simple bigdecimal
+ * const price = z_bigdecimal();
+ * // Infers: string
+ *
+ * // With precision constraint
+ * const btcAmount = z_bigdecimal({ precision: 8 });
+ *
+ * // With min/max constraints
+ * const percentage = z_bigdecimal({
+ *   min: '0',
+ *   max: '100',
+ *   precision: 2
+ * });
+ * ```
+ */
+export function createBigDecimalSchema(options = {}) {
+    const { precision, min, max, } = options;
+    // Create the base schema with validation
+    let bigDecimalSchema = z.string().refine((value) => {
+        if (!isValidBigDecimal(value))
+            return false;
+        try {
+            const bigValue = new Big(value);
+            // Check precision (decimal places)
+            if (precision !== undefined) {
+                const decimalPlaces = value.includes('.')
+                    ? value.split('.')[1]?.length ?? 0
+                    : 0;
+                if (decimalPlaces > precision)
+                    return false;
+            }
+            // Check min
+            if (min !== undefined) {
+                const minValue = new Big(min);
+                if (bigValue.lt(minValue))
+                    return false;
+            }
+            // Check max
+            if (max !== undefined) {
+                const maxValue = new Big(max);
+                if (bigValue.gt(maxValue))
+                    return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }, {
+        message: precision !== undefined
+            ? `Invalid decimal number (max ${precision} decimal places${min !== undefined ? `, min: ${min}` : ''}${max !== undefined ? `, max: ${max}` : ''})`
+            : `Invalid decimal number${min !== undefined ? ` (min: ${min}` : ''}${max !== undefined ? `${min !== undefined ? ', ' : ' ('}max: ${max})` : min !== undefined ? ')' : ''}`
+    });
+    const bigDecimalMetadata = {
+        isBigDecimal: true,
+        ...(precision !== undefined && { precision }),
+        ...(min !== undefined && { min }),
+        ...(max !== undefined && { max }),
+    };
+    // Initialize or extend SCHEMA_METADATA with bigdecimal config
+    const existingMetadata = bigDecimalSchema[SCHEMA_METADATA] || {};
+    bigDecimalSchema[SCHEMA_METADATA] = {
+        ...existingMetadata,
+        bigDecimalConfig: bigDecimalMetadata,
+    };
+    // Add chainable decorator methods to the bigdecimal schema instance
+    // This allows: z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } }).isHidden()
+    addChainableMethods(bigDecimalSchema);
+    return bigDecimalSchema;
+}
+/**
+ * Creates a bigdecimal schema for precise decimal numbers stored as strings.
+ * Named z_bigdecimal to indicate it's a Zod helper function exported standalone.
+ *
+ * BigDecimal values are stored as strings to avoid floating-point precision issues.
+ * Use big.js for arithmetic operations on these values.
+ *
+ * @example
+ * ```typescript
+ * import { z_bigdecimal } from '@wildo-ai/zod-decorators';
+ *
+ * // Simple usage
+ * z_bigdecimal()  // Any valid decimal number as string
+ *
+ * // With options
+ * z_bigdecimal({ precision: 2 })  // Max 2 decimal places
+ * z_bigdecimal({ min: '0', max: '100' })  // Range constraint
+ * z_bigdecimal({ precision: 8, min: '0' })  // Crypto amount
+ *
+ * // With decorators (chainable)
+ * z_bigdecimal().bigDecimalUI({ display: { decimalPlaces: 4 } })
+ * z_bigdecimal({ precision: 2 }).isHidden({ edit: true })
+ *
+ * // Usage example
+ * const price: BigDecimalValue = "19.99";
+ * const btcAmount: BigDecimalValue = "0.00000001";
+ *
+ * // Arithmetic with big.js
+ * import Big from 'big.js';
+ * const total = new Big(price).plus("10.01").toString(); // "30.00"
+ * ```
+ */
+export function z_bigdecimal(options) {
+    return createBigDecimalSchema(options);
+}
+// ============================================================================
+// BIGDECIMAL UTILITY FUNCTIONS
+// ============================================================================
+/**
+ * Add two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns Sum as string
+ */
+export function bigDecimalAdd(a, b) {
+    return new Big(a).plus(b).toString();
+}
+/**
+ * Subtract two bigdecimal values.
+ * @param a - Value to subtract from
+ * @param b - Value to subtract
+ * @returns Difference as string
+ */
+export function bigDecimalSubtract(a, b) {
+    return new Big(a).minus(b).toString();
+}
+/**
+ * Multiply two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns Product as string
+ */
+export function bigDecimalMultiply(a, b) {
+    return new Big(a).times(b).toString();
+}
+/**
+ * Divide two bigdecimal values.
+ * @param a - Dividend
+ * @param b - Divisor
+ * @param precision - Number of decimal places for result (default: 20)
+ * @returns Quotient as string
+ */
+export function bigDecimalDivide(a, b, precision = 20) {
+    return new Big(a).div(b).round(precision).toString();
+}
+/**
+ * Compare two bigdecimal values.
+ * @param a - First value
+ * @param b - Second value
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function bigDecimalCompare(a, b) {
+    return new Big(a).cmp(b);
+}
+/**
+ * Round a bigdecimal value to specified precision.
+ * @param value - Value to round
+ * @param precision - Number of decimal places
+ * @param roundingMode - big.js rounding mode (default: ROUND_HALF_UP)
+ * @returns Rounded value as string
+ */
+export function bigDecimalRound(value, precision, roundingMode = Big.roundHalfUp) {
+    return new Big(value).round(precision, roundingMode).toString();
+}
+/**
+ * Format a bigdecimal value for display with fixed decimal places.
+ * @param value - Value to format
+ * @param decimalPlaces - Number of decimal places to show
+ * @returns Formatted string with trailing zeros if needed
+ */
+export function bigDecimalFormat(value, decimalPlaces) {
+    return new Big(value).toFixed(decimalPlaces);
+}
+/**
+ * Check if a bigdecimal value is zero.
+ * @param value - Value to check
+ * @returns true if value equals zero
+ */
+export function bigDecimalIsZero(value) {
+    return new Big(value).eq(0);
+}
+/**
+ * Check if a bigdecimal value is positive (> 0).
+ * @param value - Value to check
+ * @returns true if value is greater than zero
+ */
+export function bigDecimalIsPositive(value) {
+    return new Big(value).gt(0);
+}
+/**
+ * Check if a bigdecimal value is negative (< 0).
+ * @param value - Value to check
+ * @returns true if value is less than zero
+ */
+export function bigDecimalIsNegative(value) {
+    return new Big(value).lt(0);
+}
+/**
+ * Get the absolute value of a bigdecimal.
+ * @param value - Value
+ * @returns Absolute value as string
+ */
+export function bigDecimalAbs(value) {
+    return new Big(value).abs().toString();
+}
+/**
+ * Convert a number to bigdecimal string.
+ * @param value - Number to convert
+ * @returns String representation
+ */
+export function toBigDecimal(value) {
+    return new Big(value).toString();
+}
+/**
+ * Convert a bigdecimal string to number.
+ * Warning: May lose precision for very large or very precise numbers.
+ * @param value - BigDecimal string
+ * @returns Number value
+ */
+export function fromBigDecimal(value) {
+    return new Big(value).toNumber();
+}
+//# sourceMappingURL=zod-bigdecimal.js.map

package/dist/esm/zod-bigdecimal.js.map

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

package/dist/esm/zod-code.d.ts

@@ -0,0 +1,95 @@
+import { DecoratorInput, CodeSchemaOptions, CodeLanguage, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types.js";
+import { z } from "zod";
+/**
+ * Code value type - represents a code snippet with language information.
+ */
+export interface CodeValue {
+    /** The code content */
+    content: string;
+    /** Programming language for syntax highlighting and validation */
+    language: string;
+}
+/**
+ * Common programming languages for code schema language field.
+ * Can be extended with any string value.
+ */
+export declare const CommonCodeLanguages: readonly ["javascript", "typescript", "python", "java", "csharp", "cpp", "c", "go", "rust", "ruby", "php", "swift", "kotlin", "scala", "html", "css", "scss", "less", "json", "yaml", "xml", "markdown", "sql", "graphql", "bash", "shell", "powershell", "dockerfile", "nginx", "apache", "plaintext"];
+/**
+ * Zod schema for CodeValue.
+ */
+export declare const CodeValueSchema: z.ZodObject<{
+    content: z.ZodString;
+    language: z.ZodString;
+}>;
+/**
+ * z_code() - Creates code schemas for code snippets with language.
+ *
+ * @example
+ * ```typescript
+ * import { z_code } from '@wildo-ai/zod-decorators';
+ *
+ * const snippet = z_code();
+ * const restrictedCode = z_code({
+ *   allowedLanguages: ['javascript', 'typescript', 'python'],
+ *   maxLength: 10000
+ * });
+ *
+ * // UI props are now set via .codeUI():
+ * z_code().codeUI({ defaultLanguage: 'javascript', syntaxHighlighting: true })
+ * z_code().codeUI({ display: { showLineNumbers: true }, edit: { showLineNumbers: false } })
+ * ```
+ */
+/**
+ * Creates a code schema with metadata for detection and form component rendering.
+ *
+ * @param options - Configuration options for code field
+ * @returns A Zod object schema with metadata for code detection
+ */
+export declare function createCodeSchema(options?: CodeSchemaOptions): DecoratedCodeSchema;
+/**
+ * Return type for code schemas - includes decorator methods.
+ * IS_DB_INDEXED will index internal fields (content, language) for query optimization.
+ */
+export type DecoratedCodeSchema = z.ZodObject<{
+    content: z.ZodString;
+    language: z.ZodString;
+}> & {
+    [ZodDecorator.IS_DB_INDEXED](): DecoratedCodeSchema;
+    [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedCodeSchema;
+    [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedCodeSchema;
+    addDecorators(decorators: DecoratorInput[]): DecoratedCodeSchema;
+};
+/**
+ * Creates a code schema for code snippets with language information.
+ * Named z_code to indicate it's a Zod helper function exported standalone.
+ *
+ * Code values are stored as: { content: string, language: string }
+ * - content: The actual code text
+ * - language: Programming language identifier for syntax highlighting
+ *
+ * @example
+ * ```typescript
+ * import { z_code } from '@wildo-ai/zod-decorators';
+ *
+ * // Simple usage
+ * z_code()  // All languages, default 'plaintext'
+ *
+ * // With options (structural only)
+ * z_code({ allowedLanguages: ['javascript', 'typescript'] })
+ * z_code({ maxLength: 5000 })
+ *
+ * // UI props via .codeUI()
+ * z_code().codeUI({ defaultLanguage: 'typescript' })
+ * z_code().codeUI({ display: { showLineNumbers: false } })
+ * ```
+ */
+export declare function z_code(options?: CodeSchemaOptions): DecoratedCodeSchema;
+/**
+ * Get the display name for a code language.
+ */
+export declare function getLanguageDisplayName(language: CodeLanguage): string;
+/**
+ * Check if a language is in the common languages list.
+ */
+export declare function isCommonLanguage(language: string): language is typeof CommonCodeLanguages[number];
+//# sourceMappingURL=zod-code.d.ts.map

package/dist/esm/zod-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-code.d.ts","sourceRoot":"","sources":["../../src/zod-code.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAA4D,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC1L,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,ySAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,SAAS,CAAC;IAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAA;CAAE,CAGvF,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,iBAAsB,GAC9B,mBAAmB,CA6CrB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,SAAS,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;CACvB,CAAC,GAAG;IACH,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,mBAAmB,CAAC;IACpD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,mBAAmB,CAAC;IACxG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,mBAAmB,CAAC;IACpH,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,mBAAmB,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,CAEvE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAoCrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAEjG"}