@wildo-ai/zod-decorators 1.0.1 → 1.1.0

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

@@ -1,6 +1,6 @@
-import { DecoratorInput, MoneySchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types.js";
+import { DecoratorInput, MoneySchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types";
 import { z } from "zod";
-import { CurrencySchema } from "./currencies.shared.schemas.js";
+import { CurrencySchema } from "./currencies.shared.schemas";
 /**
  * Money value type - represents a monetary amount with bigint storage.
  *
@@ -12,7 +12,18 @@ import { CurrencySchema } from "./currencies.shared.schemas.js";
  * Example: { amount: 1999n, currency: 'USD', decimals: 2 } = $19.99
  */
 export interface MoneyValue {
-    /** Amount in smallest unit (e.g., cents). BigInt to avoid precision issues with large amounts. */
+    /**
+     * Amount in smallest unit (e.g., cents). BigInt to avoid precision issues with
+     * large amounts.
+     *
+     * WIRE CONTRACT: a `bigint` has no JSON form, so on the wire (and at rest in
+     * Mongo) this amount is a decimal STRING (e.g. `"1999"`). Outbound it is encoded
+     * by `BigInt.prototype.toJSON` (`installBigIntJsonEncoding`, same package);
+     * inbound it is coerced back to `bigint` by `applyNetworkBoundaryCoercion`
+     * (`@wildo-ai/saas-models`) on the shared request/response DTO — so both the
+     * frontend and backend hold a real `bigint` at runtime. Full mechanism map:
+     * `install-bigint-json-encoding.ts`.
+     */
     amount: bigint;
     /** ISO 4217 currency code (e.g., 'USD', 'EUR', 'BTC') */
     currency: string;
@@ -28,6 +39,8 @@ export declare const MoneyValueSchema: z.ZodObject<{
     decimals: z.ZodNumber;
 }>;
 /**
+ * @wildo_source:part:start zod.factories.money facet:layer:shared facet:family:schema-factory
+ *
  * z_money() - Creates money schemas for financial amounts.
  *
  * Money values are stored as integers to avoid floating-point precision issues.
@@ -88,6 +101,7 @@ export type DecoratedMoneySchema = z.ZodObject<{
     [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedMoneySchema;
     [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedMoneySchema;
     [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedMoneySchema;
+    [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedMoneySchema;
     [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedMoneySchema;
     [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedMoneySchema;
     addDecorators(decorators: DecoratorInput[]): DecoratedMoneySchema;
@@ -123,6 +137,7 @@ export type DecoratedMoneySchema = z.ZodObject<{
  * ```
  */
 export declare function z_money(options?: MoneySchemaOptions): DecoratedMoneySchema;
+/** @wildo_source:part:end zod.factories.money */
 /**
  * Convert a decimal amount to bigint representation.
  *

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

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

package/dist/esm/zod-money.js

@@ -14,6 +14,8 @@ export const MoneyValueSchema = z.object({
     decimals: z.number().int().min(0).max(18),
 });
 /**
+ * @wildo_source:part:start zod.factories.money facet:layer:shared facet:family:schema-factory
+ *
  * z_money() - Creates money schemas for financial amounts.
  *
  * Money values are stored as integers to avoid floating-point precision issues.
@@ -124,6 +126,7 @@ export function createMoneySchema(options = {}) {
 export function z_money(options) {
     return createMoneySchema(options);
 }
+/** @wildo_source:part:end zod.factories.money */
 // ============================================================================
 // MONEY UTILITY FUNCTIONS
 // ============================================================================
@@ -290,4 +293,4 @@ export function formatMoney(money, options = {}) {
         ? `${symbol} ${formattedNumber}`
         : `${formattedNumber} ${symbol}`;
 }
-//# sourceMappingURL=zod-money.js.map
+//# sourceMappingURL=zod-money.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"zod-money.js","sourceRoot":"","sources":["../../src/zod-money.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zod-money.js","sourceRoot":"","sources":["../../../src/zod-money.ts"],"names":[],"mappings":"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","sourcesContent":["\n// ============================================================================\n// MONEY SCHEMA HELPER\n// ============================================================================\n\nimport { DecoratorInput, SCHEMA_METADATA, CustomFieldMetadata, MoneySchemaMetadata, MoneySchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from \"./zod-decorators.types\";\nimport { z } from \"zod\";\nimport { addChainableMethods } from \"./zod.module-override\";\nimport { CurrencySchema } from \"./currencies.shared.schemas\";\n\n/**\n * Money value type - represents a monetary amount with bigint storage.\n *\n * The amount is stored as a bigint in the smallest unit (e.g., cents for USD).\n * Using bigint ensures no precision loss for arbitrarily large amounts.\n * The decimals field indicates how to convert to the display value:\n * - displayValue = Number(amount) / (10 ** decimals)\n *\n * Example: { amount: 1999n, currency: 'USD', decimals: 2 } = $19.99\n */\nexport interface MoneyValue {\n  /**\n   * Amount in smallest unit (e.g., cents). BigInt to avoid precision issues with\n   * large amounts.\n   *\n   * WIRE CONTRACT: a `bigint` has no JSON form, so on the wire (and at rest in\n   * Mongo) this amount is a decimal STRING (e.g. `\"1999\"`). Outbound it is encoded\n   * by `BigInt.prototype.toJSON` (`installBigIntJsonEncoding`, same package);\n   * inbound it is coerced back to `bigint` by `applyNetworkBoundaryCoercion`\n   * (`@wildo-ai/saas-models`) on the shared request/response DTO — so both the\n   * frontend and backend hold a real `bigint` at runtime. Full mechanism map:\n   * `install-bigint-json-encoding.ts`.\n   */\n  amount: bigint;\n  /** ISO 4217 currency code (e.g., 'USD', 'EUR', 'BTC') */\n  currency: string;\n  /** Number of decimal places for display (e.g., 2 for USD, 8 for BTC) */\n  decimals: number;\n}\n\n/**\n * Zod schema for MoneyValue.\n */\nexport const MoneyValueSchema: z.ZodObject<{ amount: z.ZodBigInt; currency: typeof CurrencySchema; decimals: z.ZodNumber }> = z.object({\n  amount: z.bigint(),\n  currency: CurrencySchema,\n  decimals: z.number().int().min(0).max(18),\n});\n\n/**\n * @wildo_source:part:start zod.factories.money facet:layer:shared facet:family:schema-factory\n *\n * z_money() - Creates money schemas for financial amounts.\n *\n * Money values are stored as integers to avoid floating-point precision issues.\n * The schema creates an object with: { amount, currency, decimals }\n *\n * @example\n * ```typescript\n * import { z_money } from '@wildo-ai/zod-decorators';\n *\n * const price = z_money();\n * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });\n * const usdPrice = z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } });\n *\n * // With decorators (chainable)\n * z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } })\n * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR] }).isHidden({ edit: true })\n * ```\n */\n\n/**\n * Creates a money schema with metadata for detection and form component rendering.\n *\n * @param options - Configuration options for money field\n * @returns A Zod object schema with metadata for money detection\n *\n * @example\n * ```typescript\n * // Simple money (all currencies)\n * const price = z_money();\n * // Infers: { amount: bigint, currency: string, decimals: number }\n *\n * // Fiat only (no crypto)\n * const fiatPrice = z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] });\n *\n * // Fixed currency with amount constraints\n * const usdPrice = z_money({\n *   allowCurrencyChange: false,\n *   minAmount: 0n,\n *   maxAmount: 100000000n // $1,000,000.00 in cents\n * }).moneyUI({ edit: { defaultCurrency: 'USD' } });\n * ```\n */\nexport function createMoneySchema(\n  options: MoneySchemaOptions = {}\n): DecoratedMoneySchema {\n  const {\n    currenciesAllowed,\n    appEnabledOnly = true,\n    allowCurrencyChange = true,\n    minAmount,\n    maxAmount,\n  } = options;\n\n  // Create the amount schema with optional min/max constraints\n  // Using bigint for amount to avoid precision issues with large financial amounts\n  let amountSchema = z.bigint();\n  if (minAmount !== undefined) {\n    amountSchema = amountSchema.min(minAmount);\n  }\n  if (maxAmount !== undefined) {\n    amountSchema = amountSchema.max(maxAmount);\n  }\n\n  // Create the money object schema\n  const moneySchema = z.object({\n    amount: amountSchema,\n    currency: CurrencySchema,\n    decimals: z.number().int().min(0).max(18),\n  });\n\n  const moneyMetadata: MoneySchemaMetadata = {\n    isMoney: true,\n    ...(currenciesAllowed && currenciesAllowed.length > 0 && { currenciesAllowed }),\n    appEnabledOnly,\n    allowCurrencyChange,\n    ...(minAmount !== undefined && { minAmount }),\n    ...(maxAmount !== undefined && { maxAmount }),\n  };\n\n  // Initialize or extend SCHEMA_METADATA with money config\n  const existingMetadata: CustomFieldMetadata = (moneySchema as any)[SCHEMA_METADATA] || {};\n  (moneySchema as any)[SCHEMA_METADATA] = {\n    ...existingMetadata,\n    moneyConfig: moneyMetadata,\n  };\n\n  // Add chainable decorator methods to the money schema instance\n  // This allows: z_money().moneyUI({ edit: { defaultCurrency: 'EUR' } }).isHidden()\n  addChainableMethods(moneySchema);\n\n  return moneySchema as DecoratedMoneySchema;\n}\n\n/**\n * Return type for money schemas - includes decorator methods.\n * Note: IS_FOREIGN_KEY is not applicable to money objects.\n * IS_DB_INDEXED will index internal fields (amount, currency) for query optimization.\n *\n * This type must list all decorators applicable to ZodObject (per ApplyableTypeAllTypes).\n * Missing entries here cause TS errors when chaining decorators on z_money() fields.\n */\nexport type DecoratedMoneySchema = z.ZodObject<{\n  amount: z.ZodBigInt;\n  currency: typeof CurrencySchema;\n  decimals: z.ZodNumber;\n}> & {\n  [ZodDecorator.IS_DB_INDEXED](): DecoratedMoneySchema;\n  [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedMoneySchema;\n  [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedMoneySchema;\n  // Resource-level decorators (applicable to all types including ZodObject)\n  [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedMoneySchema;\n  [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedMoneySchema;\n  [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedMoneySchema;\n  [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedMoneySchema;\n  [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedMoneySchema;\n  addDecorators(decorators: DecoratorInput[]): DecoratedMoneySchema;\n};\n\n/**\n * Creates a money schema for financial amounts with integer storage.\n * Named z_money to indicate it's a Zod helper function exported standalone.\n *\n * Money values are stored as: { amount: int, currency: string, decimals: int }\n * - amount: Value in smallest unit (e.g., cents for USD, satoshis for BTC)\n * - currency: ISO 4217 code (e.g., 'USD', 'EUR', 'BTC')\n * - decimals: Decimal places for display conversion (e.g., 2 for USD, 8 for BTC)\n *\n * @example\n * ```typescript\n * import { z_money } from '@wildo-ai/zod-decorators';\n *\n * // Simple usage\n * z_money()  // All currencies\n *\n * // With options\n * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] })\n * z_money({ allowCurrencyChange: false }).moneyUI({ edit: { defaultCurrency: 'USD' } })\n * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT_MAJOR], minAmount: 0n })\n *\n * // With decorators (chainable)\n * z_money().moneyUI({ edit: { defaultCurrency: 'USD' } })\n * z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).isHidden({ edit: true })\n *\n * // Usage example\n * const price: MoneyValue = { amount: 1999n, currency: 'USD', decimals: 2 };\n * // Represents $19.99\n * ```\n */\nexport function z_money(\n  options?: MoneySchemaOptions\n): DecoratedMoneySchema {\n  return createMoneySchema(options) as DecoratedMoneySchema;\n}\n/** @wildo_source:part:end zod.factories.money */\n\n// ============================================================================\n// MONEY UTILITY FUNCTIONS\n// ============================================================================\n\n/**\n * Convert a decimal amount to bigint representation.\n *\n * **Precision caveat:** This uses floating-point arithmetic internally\n * (`Math.round(decimalAmount * 10^decimals)`), which can produce rounding\n * errors for certain values. Prefer `parseDecimalStringToAmount` when working\n * with user input strings to avoid float precision issues entirely.\n *\n * @param decimalAmount - The decimal amount (e.g., 19.99)\n * @param decimals - Number of decimal places (e.g., 2)\n * @returns BigInt amount (e.g., 1999n)\n */\nexport function toMoneyAmount(decimalAmount: number, decimals: number): bigint {\n  return BigInt(Math.round(decimalAmount * Math.pow(10, decimals)));\n}\n\n/**\n * Convert a bigint amount to decimal representation.\n * @param amount - The bigint amount (e.g., 1999n)\n * @param decimals - Number of decimal places (e.g., 2)\n * @returns Decimal amount (e.g., 19.99)\n */\nexport function fromMoneyAmount(amount: bigint, decimals: number): number {\n  return Number(amount) / Math.pow(10, decimals);\n}\n\n/**\n * Convert a string or number to bigint safely.\n * Useful for parsing user input or JSON values.\n * @param value - String, number, or bigint to convert\n * @returns BigInt amount\n */\nexport function toBigIntAmount(value: string | number | bigint): bigint {\n  if (typeof value === 'bigint') return value;\n  if (typeof value === 'number') return BigInt(Math.round(value));\n  return BigInt(value);\n}\n\n/**\n * Parse a decimal string directly to a bigint amount, avoiding floating-point\n * precision issues entirely.\n *\n * This is the preferred way to convert user input (e.g., from an HTML input\n * element) to a money amount. It works by splitting the string at the decimal\n * point and manipulating integer/fractional parts as strings, so no float\n * arithmetic is ever involved.\n *\n * - Extra fractional digits beyond `decimals` are **truncated** (not rounded).\n * - Missing fractional digits are **zero-padded**.\n *\n * @param input - A decimal string (e.g., \"19.99\", \"5\", \".50\", \"-12.345\")\n * @param decimals - Number of decimal places for the target currency\n * @returns BigInt amount, or `null` if the input is not a valid decimal string\n *\n * **Note:** Scientific notation strings (e.g., `\"1e+10\"`) are rejected (returns\n * `null`) since they are not valid monetary input. This is correct behavior when\n * reading from `<input type=\"number\">`, which may produce such strings for very\n * large values — those inputs should be constrained via `min`/`max` attributes.\n *\n * @example\n * ```typescript\n * parseDecimalStringToAmount(\"19.99\", 2)   // → 1999n\n * parseDecimalStringToAmount(\"19.999\", 2)  // → 1999n  (truncates, not rounds)\n * parseDecimalStringToAmount(\"19.9\", 2)    // → 1990n  (pads missing decimals)\n * parseDecimalStringToAmount(\"5\", 2)       // → 500n\n * parseDecimalStringToAmount(\".50\", 2)     // → 50n\n * parseDecimalStringToAmount(\"-12.34\", 2)  // → -1234n\n * parseDecimalStringToAmount(\"abc\", 2)     // → null\n * parseDecimalStringToAmount(\"1e+10\", 2)   // → null   (scientific notation rejected)\n * ```\n */\nexport function parseDecimalStringToAmount(input: string, decimals: number): bigint | null {\n  const trimmed = input.trim();\n  if (trimmed === '' || trimmed === '.' || trimmed === '-' || trimmed === '-.') return null;\n\n  // Handle sign\n  const isNegative = trimmed.startsWith('-');\n  const unsigned = isNegative ? trimmed.slice(1) : trimmed;\n\n  // Validate: only digits and at most one decimal point\n  if (!/^\\d*\\.?\\d*$/.test(unsigned)) return null;\n\n  const dotIndex = unsigned.indexOf('.');\n  const integerPart = dotIndex === -1 ? unsigned : (unsigned.slice(0, dotIndex) || '0');\n  const fractionalRaw = dotIndex === -1 ? '' : unsigned.slice(dotIndex + 1);\n\n  // Pad or truncate fractional part to exactly `decimals` digits\n  const fractionalPart = decimals === 0\n    ? ''\n    : fractionalRaw.padEnd(decimals, '0').slice(0, decimals);\n\n  // Build the combined string and convert to bigint\n  const combined = integerPart + fractionalPart;\n  // Guard against empty combined (shouldn't happen after validation, but be safe)\n  if (combined === '') return 0n;\n\n  try {\n    const result = BigInt(combined);\n    return isNegative ? -result : result;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Convert a money amount from one decimal precision to another using pure\n * bigint arithmetic (no floating-point involved).\n *\n * Use this when changing a currency (which may have different decimal places)\n * instead of the float roundtrip `fromMoneyAmount` → `toMoneyAmount`.\n *\n * - When increasing decimals (e.g., 2 → 8): multiplies by 10^(diff)\n * - When decreasing decimals (e.g., 8 → 2): divides with half-away-from-zero rounding\n *\n * @param amount - The bigint amount in the source precision\n * @param fromDecimals - Source decimal places\n * @param toDecimals - Target decimal places\n * @returns BigInt amount in the target precision\n *\n * @example\n * ```typescript\n * convertMoneyDecimals(1999n, 2, 2)  // → 1999n   (same decimals, no-op)\n * convertMoneyDecimals(1999n, 2, 4)  // → 199900n (scale up)\n * convertMoneyDecimals(199900n, 4, 2) // → 1999n  (scale down)\n * convertMoneyDecimals(12345678n, 8, 2) // → 12n  (BTC satoshis to 2-decimal)\n * ```\n */\nexport function convertMoneyDecimals(amount: bigint, fromDecimals: number, toDecimals: number): bigint {\n  if (fromDecimals === toDecimals) return amount;\n\n  const diff = toDecimals - fromDecimals;\n\n  if (diff > 0) {\n    // Scale up: multiply\n    return amount * (10n ** BigInt(diff));\n  }\n\n  // Scale down: divide with rounding (half-away-from-zero)\n  const divisor = 10n ** BigInt(-diff);\n  const isNegative = amount < 0n;\n  const absAmount = isNegative ? -amount : amount;\n  const rounded = (absAmount + divisor / 2n) / divisor;\n  return isNegative ? -rounded : rounded;\n}\n\n/**\n * Format a money value for display.\n * @param money - The money value\n * @param options - Formatting options\n * @returns Formatted string (e.g., \"$19.99\" or \"19.99 USD\")\n */\nexport function formatMoney(\n  money: MoneyValue,\n  options: {\n    showSymbol?: boolean;\n    symbolPosition?: 'before' | 'after';\n    thousandsSeparator?: string;\n    decimalSeparator?: string;\n  } = {}\n): string {\n  const {\n    showSymbol = true,\n    symbolPosition = 'before',\n    thousandsSeparator = ',',\n    decimalSeparator = '.',\n  } = options;\n\n  const decimalValue = fromMoneyAmount(money.amount, money.decimals);\n\n  // Format with proper decimal places\n  const [integerPart, decimalPart] = decimalValue.toFixed(money.decimals).split('.');\n\n  // Add thousands separator\n  const formattedInteger = integerPart.replace(/\\B(?=(\\d{3})+(?!\\d))/g, thousandsSeparator);\n\n  const formattedNumber = decimalPart\n    ? `${formattedInteger}${decimalSeparator}${decimalPart}`\n    : formattedInteger;\n\n  if (!showSymbol) {\n    return formattedNumber;\n  }\n\n  // For now, use currency code as symbol (can be enhanced with CURRENCY_INFO_MAP)\n  const symbol = money.currency;\n\n  return symbolPosition === 'before'\n    ? `${symbol} ${formattedNumber}`\n    : `${formattedNumber} ${symbol}`;\n}\n\n"]}

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

@@ -1,4 +1,4 @@
-import type { DecoratorInput, PhoneSchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from './zod-decorators.types.js';
+import type { DecoratorInput, PhoneSchemaOptions, SummaryFieldParams, ZodDecorator, ZodDecorator_ParamsType } from './zod-decorators.types';
 import { z } from 'zod';
 import { parsePhoneNumberFromString } from 'libphonenumber-js';
 /** Returns country codes (e.g. "US", "FR") for form components. */
@@ -40,6 +40,40 @@ export declare function formatPhoneNumber(value: string, defaultCountry?: string
  */
 export declare function getPhoneCountryCode(country: string): string;
 /**
+ * Format a PARTIAL (as-you-type) national phone input for a country.
+ *
+ * Wraps libphonenumber's incomplete-number formatter so form controls can
+ * format while the user is still typing ("0612" → "06 12" for FR) without
+ * importing libphonenumber-js directly — the phone surface stays owned here.
+ *
+ * @param value - Partial national input (digits, may carry punctuation)
+ * @param country - Country code (e.g. "US", "FR") providing the format plan
+ * @returns The formatted partial, or the input unchanged when no plan applies
+ */
+export declare function formatPartialPhoneNumber(value: string, country?: string): string;
+/**
+ * Example national number for a country, for use as an input placeholder
+ * (e.g. FR → "06 12 34 56 78"). Backed by libphonenumber's curated mobile
+ * example set; returns undefined for countries without an example.
+ *
+ * @param country - Country code (e.g. "US", "FR")
+ */
+export declare function getExamplePhoneNumber(country: string): string | undefined;
+/**
+ * Detect the country of a phone input that starts with an international
+ * prefix ("+..."), even while the number is still incomplete.
+ *
+ * Powers the best-practice behavior where pasting/typing "+49 30 ..." into
+ * the national input automatically switches the country selector to DE.
+ * Returns undefined when the input is not international or the country is
+ * not yet determinable (e.g. "+1" is ambiguous across NANP countries).
+ *
+ * @param value - Raw input, expected to start with "+"
+ */
+export declare function detectPhoneCountry(value: string): string | undefined;
+/**
+ * @wildo_source:part:start zod.factories.phone facet:layer:shared facet:family:schema-factory
+ *
  * Creates a phone schema with metadata for detection and form component rendering.
  * Values are stored as E.164 strings. Empty string passes validation.
  *
@@ -56,6 +90,7 @@ export type DecoratedPhoneSchema = z.ZodString & {
     [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedPhoneSchema;
     [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedPhoneSchema;
     [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPhoneSchema;
+    [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPhoneSchema;
     [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPhoneSchema;
     [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPhoneSchema;
     addDecorators(decorators: DecoratorInput[]): DecoratedPhoneSchema;
@@ -72,4 +107,5 @@ export type DecoratedPhoneSchema = z.ZodString & {
  * ```
  */
 export declare function z_phone(options?: PhoneSchemaOptions): DecoratedPhoneSchema;
+/** @wildo_source:part:end zod.factories.phone */
 //# sourceMappingURL=zod-phone.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"zod-phone.d.ts","sourceRoot":"","sources":["../../src/zod-phone.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,0BAA0B,EAK3B,MAAM,mBAAmB,CAAC;AAE3B,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAKhC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAMhH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,GAAE,eAAe,GAAG,UAA4B,GACrD,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,oBAAoB,CA8BxF;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,GAAG;IAC/C,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACnF,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAE1E"}
+{"version":3,"file":"zod-phone.d.ts","sourceRoot":"","sources":["../../../src/zod-phone.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAGd,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,0BAA0B,EAQ3B,MAAM,mBAAmB,CAAC;AAM3B,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAKhC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAMhH;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,GAAE,eAAe,GAAG,UAA4B,GACrD,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,oBAAoB,CAsCxF;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,GAAG;IAC/C,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACnF,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAAC;IAC/H,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,oBAAoB,CAAC;IAC3D,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,oBAAoB,CAE1E;AACD,iDAAiD"}

package/dist/esm/zod-phone.js

@@ -4,7 +4,11 @@
 import { SCHEMA_METADATA } from './zod-decorators.types.js';
 import { z } from 'zod';
 import { addChainableMethods } from './zod.module-override.js';
-import { parsePhoneNumberFromString, isValidPhoneNumber, getCountries as getCountriesFromLib, getCountryCallingCode, } from 'libphonenumber-js';
+import { parsePhoneNumberFromString, isValidPhoneNumber, getCountries as getCountriesFromLib, getCountryCallingCode, formatIncompletePhoneNumber, getExampleNumber, AsYouType, } from 'libphonenumber-js';
+// JS-module subpath (NOT the .json subpath): importable under native ESM
+// without JSON import attributes, so the same source compiles for Node and
+// browser consumers alike. Example numbers back per-country placeholders.
+import phoneExamples from 'libphonenumber-js/mobile/examples';
 /** Returns country codes (e.g. "US", "FR") for form components. */
 export function getCountries() {
     return getCountriesFromLib();
@@ -66,6 +70,54 @@ export function getPhoneCountryCode(country) {
     return getCountryCallingCode(country);
 }
 /**
+ * Format a PARTIAL (as-you-type) national phone input for a country.
+ *
+ * Wraps libphonenumber's incomplete-number formatter so form controls can
+ * format while the user is still typing ("0612" → "06 12" for FR) without
+ * importing libphonenumber-js directly — the phone surface stays owned here.
+ *
+ * @param value - Partial national input (digits, may carry punctuation)
+ * @param country - Country code (e.g. "US", "FR") providing the format plan
+ * @returns The formatted partial, or the input unchanged when no plan applies
+ */
+export function formatPartialPhoneNumber(value, country) {
+    if (!value)
+        return value;
+    const cc = (country ?? DEFAULT_COUNTRY);
+    return formatIncompletePhoneNumber(value, cc);
+}
+/**
+ * Example national number for a country, for use as an input placeholder
+ * (e.g. FR → "06 12 34 56 78"). Backed by libphonenumber's curated mobile
+ * example set; returns undefined for countries without an example.
+ *
+ * @param country - Country code (e.g. "US", "FR")
+ */
+export function getExamplePhoneNumber(country) {
+    const example = getExampleNumber(country, phoneExamples);
+    return example?.formatNational();
+}
+/**
+ * Detect the country of a phone input that starts with an international
+ * prefix ("+..."), even while the number is still incomplete.
+ *
+ * Powers the best-practice behavior where pasting/typing "+49 30 ..." into
+ * the national input automatically switches the country selector to DE.
+ * Returns undefined when the input is not international or the country is
+ * not yet determinable (e.g. "+1" is ambiguous across NANP countries).
+ *
+ * @param value - Raw input, expected to start with "+"
+ */
+export function detectPhoneCountry(value) {
+    if (!value?.trim().startsWith('+'))
+        return undefined;
+    const formatter = new AsYouType();
+    formatter.input(value.trim());
+    return formatter.getCountry();
+}
+/**
+ * @wildo_source:part:start zod.factories.phone facet:layer:shared facet:family:schema-factory
+ *
  * Creates a phone schema with metadata for detection and form component rendering.
  * Values are stored as E.164 strings. Empty string passes validation.
  *
@@ -78,19 +130,27 @@ export function createPhoneSchema(options = {}) {
         isPhone: true,
         defaultCountry,
     };
+    // PhoneCountryCode is libphonenumber's CountryCode union, so no cast needed.
     const country = defaultCountry;
     const phoneSchema = z
         .string()
-        .transform((s) => s?.trim() ?? '')
+        .trim()
         .refine((val) => val === '' || isValidPhone(val, country), {
         message: 'Invalid phone number',
     })
-        .transform((val) => {
+        // E.164 normalization is string -> string, so model it as a Zod 4
+        // overwrite rather than a transform. The runtime result is identical, but
+        // the schema remains truthfully introspectable as a string by JSON Schema /
+        // OpenAPI generators instead of degrading to an unrepresentable transform.
+        .overwrite((val) => {
         if (val === '')
             return '';
         const parsed = parsePhone(val, country);
         return parsed?.format('E.164') ?? val;
-    });
+    })
+        // Preserve the established ZodPipe surface used by decorator metadata and
+        // boundary walkers; the terminal string adds no value conversion.
+        .pipe(z.string());
     const existingMetadata = phoneSchema[SCHEMA_METADATA] || {};
     phoneSchema[SCHEMA_METADATA] = {
         ...existingMetadata,
@@ -113,4 +173,5 @@ export function createPhoneSchema(options = {}) {
 export function z_phone(options) {
     return createPhoneSchema(options);
 }
-//# sourceMappingURL=zod-phone.js.map
+/** @wildo_source:part:end zod.factories.phone */
+//# sourceMappingURL=zod-phone.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"zod-phone.js","sourceRoot":"","sources":["../../src/zod-phone.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"zod-phone.js","sourceRoot":"","sources":["../../../src/zod-phone.ts"],"names":[],"mappings":"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","sourcesContent":["// ============================================================================\n// PHONE SCHEMA HELPER\n// ============================================================================\n\nimport type {\n  DecoratorInput,\n  CustomFieldMetadata,\n  PhoneSchemaMetadata,\n  PhoneSchemaOptions,\n  SummaryFieldParams,\n  ZodDecorator,\n  ZodDecorator_ParamsType,\n} from './zod-decorators.types';\nimport { SCHEMA_METADATA } from './zod-decorators.types';\nimport { z } from 'zod';\nimport { addChainableMethods } from './zod.module-override';\nimport {\n  parsePhoneNumberFromString,\n  isValidPhoneNumber,\n  getCountries as getCountriesFromLib,\n  type CountryCode,\n  getCountryCallingCode,\n  formatIncompletePhoneNumber,\n  getExampleNumber,\n  AsYouType,\n} from 'libphonenumber-js';\n// JS-module subpath (NOT the .json subpath): importable under native ESM\n// without JSON import attributes, so the same source compiles for Node and\n// browser consumers alike. Example numbers back per-country placeholders.\nimport phoneExamples from 'libphonenumber-js/mobile/examples';\n\n/** Returns country codes (e.g. \"US\", \"FR\") for form components. */\nexport function getCountries(): string[] {\n  return getCountriesFromLib() as string[];\n}\n\n/**\n * Phone value type — E.164 string (e.g., \"+33123456789\").\n * Use formatPhoneNumber() for display, parsePhoneNumber() for parsing.\n */\nexport type PhoneValue = string;\n\n/** Default country when parsing numbers without country code */\nconst DEFAULT_COUNTRY: CountryCode = 'US';\n\n/**\n * Parse a phone string to PhoneNumber or undefined.\n *\n * @param value - Raw input (E.164, national, or partial)\n * @param defaultCountry - Country code (e.g. \"US\", \"FR\") for numbers without +prefix\n * @returns PhoneNumber or undefined if invalid\n */\nexport function parsePhone(value: string, defaultCountry?: string): ReturnType<typeof parsePhoneNumberFromString> {\n  if (!value || typeof value !== 'string') return undefined;\n  const trimmed = value.trim();\n  if (!trimmed) return undefined;\n  const country = defaultCountry ?? DEFAULT_COUNTRY;\n  return parsePhoneNumberFromString(trimmed, { defaultCountry: country as CountryCode });\n}\n\n/**\n * Validate a phone number string.\n *\n * @param value - Phone string to validate\n * @param defaultCountry - Country code (e.g. \"US\", \"FR\") for numbers without +prefix\n * @returns true if valid\n */\nexport function isValidPhone(value: string, defaultCountry?: string): boolean {\n  if (!value || typeof value !== 'string') return false;\n  const trimmed = value.trim();\n  if (!trimmed) return false;\n  const country = defaultCountry ?? DEFAULT_COUNTRY;\n  return isValidPhoneNumber(trimmed, { defaultCountry: country as CountryCode });\n}\n\n/**\n * Format a phone number for display.\n *\n * @param value - E.164 or parseable phone string\n * @param defaultCountry - Country code (e.g. \"US\", \"FR\") for numbers without +prefix\n * @param format - 'international' | 'national' (default: international)\n * @returns Formatted string or original if unparseable\n */\nexport function formatPhoneNumber(\n  value: string,\n  defaultCountry?: string,\n  format: 'international' | 'national' = 'international'\n): string {\n  const parsed = parsePhone(value, defaultCountry);\n  if (!parsed) return value;\n  return format === 'national' ? parsed.formatNational() : parsed.formatInternational();\n}\n\n/**\n * Get country calling code (e.g., \"1\" for US).\n *\n * @param country - Country code (e.g. \"US\", \"FR\")\n */\nexport function getPhoneCountryCode(country: string): string {\n  return getCountryCallingCode(country as CountryCode);\n}\n\n/**\n * Format a PARTIAL (as-you-type) national phone input for a country.\n *\n * Wraps libphonenumber's incomplete-number formatter so form controls can\n * format while the user is still typing (\"0612\" → \"06 12\" for FR) without\n * importing libphonenumber-js directly — the phone surface stays owned here.\n *\n * @param value - Partial national input (digits, may carry punctuation)\n * @param country - Country code (e.g. \"US\", \"FR\") providing the format plan\n * @returns The formatted partial, or the input unchanged when no plan applies\n */\nexport function formatPartialPhoneNumber(value: string, country?: string): string {\n  if (!value) return value;\n  const cc = (country ?? DEFAULT_COUNTRY) as CountryCode;\n  return formatIncompletePhoneNumber(value, cc);\n}\n\n/**\n * Example national number for a country, for use as an input placeholder\n * (e.g. FR → \"06 12 34 56 78\"). Backed by libphonenumber's curated mobile\n * example set; returns undefined for countries without an example.\n *\n * @param country - Country code (e.g. \"US\", \"FR\")\n */\nexport function getExamplePhoneNumber(country: string): string | undefined {\n  const example = getExampleNumber(country as CountryCode, phoneExamples);\n  return example?.formatNational();\n}\n\n/**\n * Detect the country of a phone input that starts with an international\n * prefix (\"+...\"), even while the number is still incomplete.\n *\n * Powers the best-practice behavior where pasting/typing \"+49 30 ...\" into\n * the national input automatically switches the country selector to DE.\n * Returns undefined when the input is not international or the country is\n * not yet determinable (e.g. \"+1\" is ambiguous across NANP countries).\n *\n * @param value - Raw input, expected to start with \"+\"\n */\nexport function detectPhoneCountry(value: string): string | undefined {\n  if (!value?.trim().startsWith('+')) return undefined;\n  const formatter = new AsYouType();\n  formatter.input(value.trim());\n  return formatter.getCountry();\n}\n\n/**\n * @wildo_source:part:start zod.factories.phone facet:layer:shared facet:family:schema-factory\n *\n * Creates a phone schema with metadata for detection and form component rendering.\n * Values are stored as E.164 strings. Empty string passes validation.\n *\n * @param options - Configuration options for phone field\n * @returns A Zod string schema with metadata for phone detection\n */\nexport function createPhoneSchema(options: PhoneSchemaOptions = {}): DecoratedPhoneSchema {\n  const { defaultCountry = DEFAULT_COUNTRY } = options;\n\n  const phoneMetadata: PhoneSchemaMetadata = {\n    isPhone: true,\n    defaultCountry,\n  };\n\n  // PhoneCountryCode is libphonenumber's CountryCode union, so no cast needed.\n  const country: CountryCode = defaultCountry;\n  const phoneSchema = z\n    .string()\n    .trim()\n    .refine((val) => val === '' || isValidPhone(val, country), {\n      message: 'Invalid phone number',\n    })\n    // E.164 normalization is string -> string, so model it as a Zod 4\n    // overwrite rather than a transform. The runtime result is identical, but\n    // the schema remains truthfully introspectable as a string by JSON Schema /\n    // OpenAPI generators instead of degrading to an unrepresentable transform.\n    .overwrite((val) => {\n      if (val === '') return '';\n      const parsed = parsePhone(val, country);\n      return parsed?.format('E.164') ?? val;\n    })\n    // Preserve the established ZodPipe surface used by decorator metadata and\n    // boundary walkers; the terminal string adds no value conversion.\n    .pipe(z.string()) as unknown as z.ZodString;\n\n  const existingMetadata: CustomFieldMetadata = (phoneSchema as any)[SCHEMA_METADATA] || {};\n  (phoneSchema as any)[SCHEMA_METADATA] = {\n    ...existingMetadata,\n    phoneConfig: phoneMetadata,\n  };\n\n  addChainableMethods(phoneSchema);\n\n  return phoneSchema as unknown as DecoratedPhoneSchema;\n}\n\n/**\n * Return type for phone schemas - includes decorator methods.\n */\nexport type DecoratedPhoneSchema = z.ZodString & {\n  [ZodDecorator.IS_DB_INDEXED](): DecoratedPhoneSchema;\n  [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedPhoneSchema;\n  [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedPhoneSchema;\n  [ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedPhoneSchema;\n  [ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPhoneSchema;\n  [ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPhoneSchema;\n  [ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPhoneSchema;\n  [ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPhoneSchema;\n  addDecorators(decorators: DecoratorInput[]): DecoratedPhoneSchema;\n};\n\n/**\n * Creates a phone schema for E.164 phone numbers.\n *\n * @example\n * ```typescript\n * import { z_phone } from '@wildo-ai/zod-decorators';\n *\n * z_phone()\n * z_phone({ defaultCountry: 'FR' })\n * ```\n */\nexport function z_phone(options?: PhoneSchemaOptions): DecoratedPhoneSchema {\n  return createPhoneSchema(options);\n}\n/** @wildo_source:part:end zod.factories.phone */\n"]}

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

@@ -1,6 +1,8 @@
-import { DecoratorInput, RangeSchemaOptions, RangeType, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types.js";
+import { DecoratorInput, RangeSchemaOptions, RangeType, ZodDecorator, ZodDecorator_ParamsType } from "./zod-decorators.types";
 import { z } from "zod";
 /**
+ * @wildo_source:part:start zod.factories.range facet:layer:shared facet:family:schema-factory
+ *
  * z_range() - Creates range schemas for number, date, datetime, or time ranges.
  *
  * This is a standalone Zod helper function (cannot be added to frozen Zod module at runtime).
@@ -84,4 +86,5 @@ export type DecoratedRangeSchema = z.ZodObject<any> & {
  * ```
  */
 export declare function z_range<T extends RangeType | `${RangeType}`>(type: T, options?: RangeSchemaOptions): DecoratedRangeSchema;
+/** @wildo_source:part:end zod.factories.range */
 //# sourceMappingURL=zod-range.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"zod-range.d.ts","sourceRoot":"","sources":["../../src/zod-range.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAA6D,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzL,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EACnD,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,kBAAuB,GAC/B,oBAAoB,CAmEtB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG;IACpD,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,GAAG,SAAS,EAAE,EAC1D,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CAEtB"}
+{"version":3,"file":"zod-range.d.ts","sourceRoot":"","sources":["../../../src/zod-range.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAA6D,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzL,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EACnD,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,kBAAuB,GAC/B,oBAAoB,CAmEtB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG;IACpD,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC;IACrD,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,oBAAoB,CAAC;IACzG,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAAC;IACrH,aAAa,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC;CACnE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,GAAG,SAAS,EAAE,EAC1D,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,kBAAkB,GAC3B,oBAAoB,CAEtB;AACD,iDAAiD"}

package/dist/esm/zod-range.js

@@ -7,6 +7,8 @@ import { addChainableMethods } from "./zod.module-override.js";
 import { BigDecimalValueSchema } from "./zod-bigdecimal.js";
 import { MoneyValueSchema } from "./zod-money.js";
 /**
+ * @wildo_source:part:start zod.factories.range facet:layer:shared facet:family:schema-factory
+ *
  * z_range() - Creates range schemas for number, date, datetime, or time ranges.
  *
  * This is a standalone Zod helper function (cannot be added to frozen Zod module at runtime).
@@ -135,4 +137,5 @@ export function createRangeSchema(type, options = {}) {
 export function z_range(type, options) {
     return createRangeSchema(type, options);
 }
-//# sourceMappingURL=zod-range.js.map
+/** @wildo_source:part:end zod.factories.range */
+//# sourceMappingURL=zod-range.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"zod-range.js","sourceRoot":"","sources":["../../src/zod-range.ts"],"names":[],"mappings":"AACA,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAkB,eAAe,EAAgE,SAAS,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AACzL,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAO,EACP,UAA8B,EAAE;IAEhC,MAAM,EACJ,YAAY,GAAG,IAAI,EACnB,UAAU,GAAG,IAAI,EACjB,GAAG,EACH,GAAG,GACJ,GAAG,OAAO,CAAC;IAEZ,4CAA4C;IAC5C,IAAI,UAAwB,CAAC;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS,CAAC,MAAM;YACnB,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM;QACR,KAAK,SAAS,CAAC,IAAI;YACjB,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,SAAS,CAAC,QAAQ;YACrB,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM;QACR,KAAK,SAAS,CAAC,IAAI;YACjB,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM;QACR,KAAK,SAAS,CAAC,UAAU;YACvB,UAAU,GAAG,qBAAqB,CAAC;YACnC,MAAM;QACR,KAAK,SAAS,CAAC,KAAK;YAClB,UAAU,GAAG,gBAAgB,CAAC;YAC9B,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAEjE,2BAA2B;IAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,QAAQ;KACb,CAAC,CAAC;IAEH,sDAAsD;IACtD,MAAM,aAAa,GAAwB;QACzC,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,YAAY;QACZ,UAAU;QACV,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;KAClC,CAAC;IAEF,yDAAyD;IACzD,MAAM,gBAAgB,GAAyB,WAAmB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IACzF,WAAmB,CAAC,eAAe,CAAC,GAAG;QACtC,GAAG,gBAAgB;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,aAAa;KAC3B,CAAC;IAEF,+DAA+D;IAC/D,uFAAuF;IACvF,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEjC,OAAO,WAAmC,CAAC;AAC7C,CAAC;AAcD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CACrB,IAAO,EACP,OAA4B;IAE5B,OAAO,iBAAiB,CAAC,IAAiB,EAAE,OAAO,CAAyB,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"zod-range.js","sourceRoot":"","sources":["../../../src/zod-range.ts"],"names":[],"mappings":"AACA,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAkB,eAAe,EAAgE,SAAS,EAAE,YAAY,EAA2B,MAAM,wBAAwB,CAAC;AACzL,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAO,EACP,UAA8B,EAAE;IAEhC,MAAM,EACJ,YAAY,GAAG,IAAI,EACnB,UAAU,GAAG,IAAI,EACjB,GAAG,EACH,GAAG,GACJ,GAAG,OAAO,CAAC;IAEZ,4CAA4C;IAC5C,IAAI,UAAwB,CAAC;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS,CAAC,MAAM;YACnB,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM;QACR,KAAK,SAAS,CAAC,IAAI;YACjB,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM;QACR,KAAK,SAAS,CAAC,QAAQ;YACrB,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM;QACR,KAAK,SAAS,CAAC,IAAI;YACjB,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM;QACR,KAAK,SAAS,CAAC,UAAU;YACvB,UAAU,GAAG,qBAAqB,CAAC;YACnC,MAAM;QACR,KAAK,SAAS,CAAC,KAAK;YAClB,UAAU,GAAG,gBAAgB,CAAC;YAC9B,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAEjE,2BAA2B;IAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,QAAQ;KACb,CAAC,CAAC;IAEH,sDAAsD;IACtD,MAAM,aAAa,GAAwB;QACzC,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,YAAY;QACZ,UAAU;QACV,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;KAClC,CAAC;IAEF,yDAAyD;IACzD,MAAM,gBAAgB,GAAyB,WAAmB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IACzF,WAAmB,CAAC,eAAe,CAAC,GAAG;QACtC,GAAG,gBAAgB;QACnB,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,aAAa;KAC3B,CAAC;IAEF,+DAA+D;IAC/D,uFAAuF;IACvF,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEjC,OAAO,WAAmC,CAAC;AAC7C,CAAC;AAcD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CACrB,IAAO,EACP,OAA4B;IAE5B,OAAO,iBAAiB,CAAC,IAAiB,EAAE,OAAO,CAAyB,CAAC;AAC/E,CAAC;AACD,iDAAiD","sourcesContent":["\n// ============================================================================\n// RANGE SCHEMA HELPER\n// ============================================================================\n\nimport { DecoratorInput, SCHEMA_METADATA, CustomFieldMetadata, RangeSchemaMetadata, RangeSchemaOptions, RangeType, ZodDecorator, ZodDecorator_ParamsType } from \"./zod-decorators.types\";\nimport { z } from \"zod\";\nimport { addChainableMethods } from \"./zod.module-override\";\nimport { BigDecimalValueSchema } from \"./zod-bigdecimal\";\nimport { MoneyValueSchema } from \"./zod-money\";\n\n\n/**\n * @wildo_source:part:start zod.factories.range facet:layer:shared facet:family:schema-factory\n *\n * z_range() - Creates range schemas for number, date, datetime, or time ranges.\n *\n * This is a standalone Zod helper function (cannot be added to frozen Zod module at runtime).\n *\n * @example\n * ```typescript\n * import { z_range } from '@wildo-ai/saas-models';\n *\n * const priceRange = z_range('number', { min: 0, max: 1000 });\n * const dateRange = z_range('date');\n * const timeRange = z_range('time');\n *\n * // With decorators (chainable)\n * z_range('number').numberUI({ edit: { editMode: 'SLIDER' } })\n * z_range('date', { min: new Date() }).isHidden({ edit: true })\n * ```\n */\n\n/**\n * Creates a range object schema with `from` and `to` fields.\n * Stores metadata for easy detection and form component rendering.\n *\n * @param type - The type of values in the range\n * @param options - Configuration options for optionality and constraints\n * @returns A Zod object schema with metadata for range detection\n *\n * @example\n * ```typescript\n * // Simple number range (both optional)\n * const priceRange = z.range('number');\n * // Infers: { from?: number; to?: number }\n *\n * // Date range with required 'from'\n * const eventRange = z.range('date', { fromOptional: false });\n * // Infers: { from: Date; to?: Date }\n *\n * // Number range with min/max constraints\n * const ageRange = z.range('number', { min: 0, max: 120 });\n * // Infers: { from?: number; to?: number }\n * // Metadata includes min: 0, max: 120 for UI hints\n *\n * // Both required with constraints\n * const salaryRange = z.range('number', {\n *   fromOptional: false,\n *   toOptional: false,\n *   min: 0,\n * });\n * // Infers: { from: number; to: number }\n * ```\n */\nexport function createRangeSchema<T extends RangeType>(\n  type: T,\n  options: RangeSchemaOptions = {}\n): DecoratedRangeSchema {\n  const {\n    fromOptional = true,\n    toOptional = true,\n    min,\n    max,\n  } = options;\n\n  // Create the base schema for the value type\n  let baseSchema: z.ZodTypeAny;\n\n  switch (type) {\n    case RangeType.NUMBER:\n      baseSchema = z.number();\n      break;\n    case RangeType.DATE:\n      baseSchema = z.date();\n      break;\n    case RangeType.DATETIME:\n      baseSchema = z.iso.datetime();\n      break;\n    case RangeType.TIME:\n      baseSchema = z.iso.time();\n      break;\n    case RangeType.BIGDECIMAL:\n      baseSchema = BigDecimalValueSchema;\n      break;\n    case RangeType.MONEY:\n      baseSchema = MoneyValueSchema;\n      break;\n    default:\n      throw new Error(`Unknown range type: ${type}`);\n  }\n\n  // Create from/to schemas based on optionality\n  const fromSchema = fromOptional ? baseSchema.optional() : baseSchema;\n  const toSchema = toOptional ? baseSchema.optional() : baseSchema;\n\n  // Create the object schema\n  const rangeSchema = z.object({\n    from: fromSchema,\n    to: toSchema,\n  });\n\n  // Store range metadata in SCHEMA_METADATA.rangeConfig\n  const rangeMetadata: RangeSchemaMetadata = {\n    isRange: true,\n    type,\n    fromOptional,\n    toOptional,\n    ...(min !== undefined && { min }),\n    ...(max !== undefined && { max }),\n  };\n\n  // Initialize or extend SCHEMA_METADATA with range config\n  const existingMetadata: CustomFieldMetadata = (rangeSchema as any)[SCHEMA_METADATA] || {};\n  (rangeSchema as any)[SCHEMA_METADATA] = {\n    ...existingMetadata,\n    rangeType: type,\n    rangeConfig: rangeMetadata,\n  };\n\n  // Add chainable decorator methods to the range schema instance\n  // This allows: z_range('number').numberUI({ edit: { editMode: 'SLIDER' } }).isHidden()\n  addChainableMethods(rangeSchema);\n\n  return rangeSchema as DecoratedRangeSchema;\n}\n\n/**\n * Return type for range schemas - includes decorator methods.\n * Note: IS_FOREIGN_KEY is not applicable to range objects.\n * IS_DB_INDEXED will index internal fields (from, to) for range query optimization.\n */\nexport type DecoratedRangeSchema = z.ZodObject<any> & {\n  [ZodDecorator.IS_DB_INDEXED](): DecoratedRangeSchema;\n  [ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedRangeSchema;\n  [ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedRangeSchema;\n  addDecorators(decorators: DecoratorInput[]): DecoratedRangeSchema;\n};\n\n/**\n * Creates a range object schema with `from` and `to` fields.\n * Named z_range to indicate it's a Zod helper function exported standalone.\n *\n * @example\n * ```typescript\n * import { z_range } from '@wildo-ai/saas-models';\n *\n * // Simple usage\n * z_range('number')  // { from?: number; to?: number }\n * z_range('date')    // { from?: Date; to?: Date }\n *\n * // With options\n * z_range('number', { fromOptional: false, min: 0 })\n * z_range('datetime', { toOptional: false })\n *\n * // With decorators (chainable)\n * z_range('number').numberUI({ edit: { editMode: 'SLIDER' } })\n * z_range('date', { min: new Date() }).isHidden({ edit: true })\n * ```\n */\nexport function z_range<T extends RangeType | `${RangeType}`>(\n  type: T,\n  options?: RangeSchemaOptions\n): DecoratedRangeSchema {\n  return createRangeSchema(type as RangeType, options) as DecoratedRangeSchema;\n}\n/** @wildo_source:part:end zod.factories.range */\n"]}