@regle/mcp-server 1.14.7 → 1.15.1

package/dist/regle-mcp-server.js

@@ -132,7 +132,7 @@ var docs_data_default = {
 			"title": "Built-in rules",
 			"category": "rules",
 			"path": "core-concepts/rules/built-in-rules.md",
-			"content": "# Built-in rules\n\nAll built-in rules are available through the `@regle/rules` package.\n\nDon't forget to install it if you haven't:\n\n::: code-group\n\n```sh [pnpm]\npnpm add @regle/rules\n```\n\n```sh [npm]\nnpm install @regle/rules\n```\n\n```sh [yarn]\nyarn add @regle/rules\n```\n\n```sh [bun]\nbun add @regle/rules\n```\n\n:::\n\n:::tip\nEvery built-in rule will check if the value of the field is set before checking if it's valid.\n\nThis allow to have rules even if the field is not required.\n:::\n\n## `alpha`\n\n_**Params**_\n  - `allowSymbols?: MaybeRefOrGetter<boolean>`\n\nAllows only alphabetic characters.\n\n```ts\nimport { alpha } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: { \n    alpha,\n    // or\n    alpha: alpha({ allowSymbols: true }),\n  },\n})\n```\n\n## `alphaNum`\n\n_**Params**_\n  - `allowSymbols?: MaybeRefOrGetter<boolean>`\n\nAllows only alphanumeric characters.\n\n```ts\nimport { alphaNum } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: { \n    alphaNum,\n    // or\n    alphaNum: alphaNum({ allowSymbols: true }),\n})\n```\n\n## `between`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `max: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\nChecks if a number is in specified bounds. `min` and `max` are both inclusive.\n\n```ts\nimport { between } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    between: between(1, 6),\n    between: between(1, maxCount, {allowEqual: false}),\n    between: between(() => maxCount.value, 10)\n  },\n})\n```\n\n## `boolean`\n\nRequires a value to be a native boolean type. Mainly used for typing.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { boolean } from '@regle/rules';\n\nconst rules = {\n  checkbox: { boolean },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `checked`\n\nRequires a boolean value to be `true`. This is useful for checkbox inputs.\n\n```ts\nimport { checked } from '@regle/rules';\n\nconst { r$ } = useRegle({ confirm: false }, {\n  confirm: { checked },\n})\n```\n\n## `contains`\n\n_**Params**_\n- `contain: Ref<string> | string | () => string`\n\nChecks if the string contains the specified substring.\n\n```ts\nimport { contains } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestLib: '' }, {\n  bestLib: {\n    contains: contains('regle')\n  },\n})\n```\n\n## `date`\n\nRequires a value to be a native Date constructor. Mainly used for typing.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { date } from '@regle/rules';\n\nconst rules = {\n  birthday: { date },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `dateAfter`\n_**Params**_\n - `after: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date is after the given parameter.\n\n```ts\nimport { dateAfter } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateAfter: dateAfter(new Date()),\n    // or\n    dateAfter: dateAfter(new Date(), { allowEqual: false }),\n  },\n})\n```\n\n## `dateBefore`\n_**Params**_\n - `before: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date is before the given parameter.\n\n```ts\nimport { dateBefore } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateBefore: dateBefore(new Date()),\n    // or\n    dateBefore: dateBefore(new Date(), { allowEqual: false }),\n  },\n})\n```\n\n## `dateBetweeen`\n\n_**Params**_\n - `before: Ref<string | Date> | string | Date | () => string | Date`\n - `after: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date falls between the specified bounds.\n\n```ts\nimport { dateBetween } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateBetween: dateBetween(new Date(), new Date(2030, 3, 1)),\n    // or\n    dateBetween: dateBetween(new Date(), new Date(2030, 3, 1), { allowEqual: false }),\n  },\n})\n```\n\n## `decimal`\n\nAllows positive and negative decimal numbers.\n\n```ts\nimport { decimal } from '@regle/rules';\n\nconst { r$ } = useRegle({ price: 0 }, {\n  price: { decimal },\n})\n```\n\n## `email`\n\nValidates email addresses. Always verify on the server to ensure the address is real and not already in use.\n\n```ts\nimport { email } from '@regle/rules';\n\nconst { r$ } = useRegle({ email: '' }, {\n  email: { email },\n})\n```\n\n## `endsWith`\n\n_**Params**_\n- `end: Ref<string> | string | () => string`\n\nChecks if the string ends with the specified substring.\n\n```ts\nimport { endsWith } from '@regle/rules';\n\nconst { r$ } = useRegle({ firstName: '' }, {\n  firstName: { endsWith: endsWith('foo') },\n})\n```\n\n## `exactLength`\n\n_**Params**_\n  - `count: Ref<number> | number | () => number`\n\nRequires the input value to have a strict specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { exactLength } from '@regle/rules';\n\nconst exactValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    exactLength: exactLength(6),\n    exactLength: exactLength(exactValue),\n    exactLength: exactLength(() => exactValue.value)\n  },\n})\n```\n\n## `exactValue`\n\n_**Params**_\n  - `count: Ref<number> | number | () => number`\n\nRequires a field to have a strict numeric value.\n\n```ts\nimport { exactValue } from '@regle/rules';\n\nconst exactCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    exactValue: exactValue(6),\n    exactValue: exactValue(exactCount),\n    exactValue: exactValue(() => exactCount.value)\n  },\n})\n```\n\n## `hexadecimal`\n\nValidates hexadecimal values.\n\n```ts\nimport { hexadecimal } from '@regle/rules';\n\nconst { r$ } = useRegle({ hexadecimal: '' }, {\n  hexadecimal: { hexadecimal },\n})\n```\n\n## `integer`\n\nAllows only integers (positive and negative).\n\n```ts\nimport { integer } from '@regle/rules';\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: { integer },\n})\n```\n\n## `ipv4Address`\n\nValidates IPv4 addresses in dotted decimal notation *127.0.0.1*.\n\n```ts\nimport { ipv4Address } from '@regle/rules';\n\nconst { r$ } = useRegle({ address: '' }, {\n  address: { ipv4Address },\n})\n```\n\n## `macAddress`\n\n_**Params**_\n  - `separator?: string | Ref<string> | () => string`\n\nValidates MAC addresses. Call as a function to specify a custom separator (e.g., ':' or an empty string for 00ff1122334455).\n\n```ts\n\nimport { macAddress } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ address: '' }, {\n  address: {\n    macAddress,\n    // or\n    macAddress: macAddress('-')\n  },\n})\n```\n\n## `maxLength`\n\n_**Params**_\n  - `max: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `Array | Record | string | number`\n\nRequires the input value to have a maximum specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { maxLength } from '@regle/rules';\n\nconst maxValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    maxLength: maxLength(6),\n    maxLength: maxLength(maxValue),\n    maxLength: maxLength(() => maxValue.value)\n  },\n})\n```\n\n## `maxValue`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n  Requires a field to have a specified maximum numeric value.\n\n```ts\nimport { maxValue } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    maxValue: maxValue(6),\n    maxValue: maxValue(maxCount, {allowEqual: false}),\n    maxValue: maxValue(() => maxCount.value)\n  },\n})\n```\n\n## `minLength`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `Array | Record | string | number`\n\nRequires the input value to have a minimum specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { minLength } from '@regle/rules';\n\nconst minValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    minLength: minLength(6),\n    minLength: minLength(minValue),\n    minLength: minLength(() => minValue.value)\n  },\n})\n```\n\n## `minValue`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `number`\n\nRequires a field to have a specified minimum numeric value.\n\n```ts\nimport { minValue } from '@regle/rules';\n\nconst minCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    minValue: minValue(6),\n    minValue: minValue(minCount, {allowEqual: false}),\n    minValue: minValue(() => minCount.value)\n  },\n})\n```\n\n## `nativeEnum`\n\nValidate against a native Typescript enum value. Similar to Zod's `nativeEnum`\n\n```ts\nimport { nativeEnum } from '@regle/rules';\n\nenum Foo {\n  Bar, Baz\n}\n\nconst { r$ } = useRegle({ type: '' }, {\n  type: { nativeEnum: nativeEnum(Foo) },\n})\n```\n\n## `number`\n\nRequires a value to be a native number type. Mainly used for typing.\n\n```ts\nimport { number } from '@regle/rules';\n\nconst rules = {\n  count: { number },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `numeric`\n\nAllows only numeric values (including numeric strings).\n\n```ts\nimport { numeric } from '@regle/rules';\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: { numeric },\n})\n```\n\n## `oneOf`\n\nAllow only one of the values from a fixed Array of possible entries.\n\n_**Params**_\n  - `options: MaybeRefOrGetter<Array<string | number>>`\n\n```ts\nimport { oneOf } from '@regle/rules';\n\nconst { r$ } = useRegle({ aliment: 'Fish' }, {\n  aliment: {\n    oneOf: oneOf(['Fish', 'Meat', 'Bone'])\n  },\n})\n```\n\n## `regex`\n\n_**Params**_\n- `regexps: MaybeRefOrGetter<RegExp | RegExp[]>`\n\nChecks if the value matches one or more regular expressions.\n\n```ts\nimport { regex } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    regex: regex(/^foo/),\n    regex: regex([/^bar/, /baz$/]),\n  },\n})\n```\n\n## `required`\n\nRequires non-empty data. Checks for empty arrays and strings containing only whitespaces.\n\n```ts\nimport {required} from '@regle/rules';\n\nconst {r$} = useRegle({name: ''}, {\n  name: {required},\n})\n```\n\n## `requiredIf`\n\n_**Params**_\n  - `condition: Ref<unknown> | unknown | () => unknown` - the property to base the `required` validator on.\n\nRequires non-empty data, only if provided data property, ref, or a function resolves to `true`.\n\n```ts\nimport { requiredIf } from '@regle/rules';\n\nconst form = ref({ name: '', condition: false });\n\nconst conditionRef = ref(false);\n\nconst { r$ } = useRegle(form, {\n  name: {\n    required: requiredIf(() => form.value.condition),\n    required: requiredIf(conditionRef),\n  },\n})\n```\n\n## `requiredUnless`\n\n_**Params**_\n  - `condition: Ref<unknown> | unknown | () => unknown` - the property to base the `required` validator on.\n\nRequires non-empty data, only if provided data property, ref, or a function resolves to `false`.\n\n```ts\nimport { requiredUnless } from '@regle/rules';\n\nconst form = ref({ name: '', condition: false });\n\nconst conditionRef = ref(false);\n\nconst { r$ } = useRegle(form, {\n  name: {\n    required: requiredUnless(() => form.value.condition),\n    required: requiredUnless(conditionRef)\n  },\n})\n```\n\n## `sameAs`\n\n_**Params**_\n  * `target: unknown`\n\nChecks if the value matches the specified property or ref.\n\n```ts\nimport { sameAs } from '@regle/rules';\n\nconst form = ref({\n  password: '',\n  confirmPassword: '',\n});\n\nconst { r$ } = useRegle(form, {\n  confirmPassword: {\n    sameAs: sameAs(() => form.value.password),\n  }\n})\n```\n\n## `startsWith`\n\n_**Params**_\n- `start: Ref<string> | string | () => string`\n\nChecks if the string starts with the specified substring.\n\n```ts\nimport { startsWith } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestLib: '' }, {\n  bestLib: {\n    startsWith: startsWith('regle')\n  },\n})\n```\n\n## `string`\n\nRequires a value to be a native string type. Mainly used for typing\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { string } from '@regle/rules';\n\nconst rules = {\n  firstName: { string },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `type`\n\nDefine the input type of a rule. No runtime validation.   \nOverride any input type set by other rules.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { type } from '@regle/rules';\n\nconst rules = {\n  firstName: { type: type<string>() },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `url`\n\nValidates URLs.\n\n```ts\nimport { url } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestUrl: '' }, {\n  bestUrl: { url },\n})\n```"
+			"content": "# Built-in rules\n\nAll built-in rules are available through the `@regle/rules` package.\n\nDon't forget to install it if you haven't:\n\n::: code-group\n\n```sh [pnpm]\npnpm add @regle/rules\n```\n\n```sh [npm]\nnpm install @regle/rules\n```\n\n```sh [yarn]\nyarn add @regle/rules\n```\n\n```sh [bun]\nbun add @regle/rules\n```\n\n:::\n\n:::tip\nEvery built-in rule will check if the value of the field is set before checking if it's valid.\n\nThis allow to have rules even if the field is not required.\n:::\n\n## `alpha`\n\n_**Params**_\n  - `allowSymbols?: MaybeRefOrGetter<boolean>`\n\nAllows only alphabetic characters.\n\n```ts\nimport { alpha } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: { \n    alpha,\n    // or\n    alpha: alpha({ allowSymbols: true }),\n  },\n})\n```\n\n## `alphaNum`\n\n_**Params**_\n  - `allowSymbols?: MaybeRefOrGetter<boolean>`\n\nAllows only alphanumeric characters.\n\n```ts\nimport { alphaNum } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: { \n    alphaNum,\n    // or\n    alphaNum: alphaNum({ allowSymbols: true }),\n})\n```\n\n## `between`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `max: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\nChecks if a number is in specified bounds. `min` and `max` are both inclusive.\n\n```ts\nimport { between } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    between: between(1, 6),\n    between: between(1, maxCount, {allowEqual: false}),\n    between: between(() => maxCount.value, 10)\n  },\n})\n```\n\n## `boolean`\n\nRequires a value to be a native boolean type. Mainly used for typing.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { boolean } from '@regle/rules';\n\nconst rules = {\n  checkbox: { boolean },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `checked`\n\nRequires a boolean value to be `true`. This is useful for checkbox inputs.\n\n```ts\nimport { checked } from '@regle/rules';\n\nconst { r$ } = useRegle({ confirm: false }, {\n  confirm: { checked },\n})\n```\n\n## `contains`\n\n_**Params**_\n- `contain: Ref<string> | string | () => string`\n\nChecks if the string contains the specified substring.\n\n```ts\nimport { contains } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestLib: '' }, {\n  bestLib: {\n    contains: contains('regle')\n  },\n})\n```\n\n## `date`\n\nRequires a value to be a native Date constructor. Mainly used for typing.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { date } from '@regle/rules';\n\nconst rules = {\n  birthday: { date },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `dateAfter`\n_**Params**_\n - `after: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date is after the given parameter.\n\n```ts\nimport { dateAfter } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateAfter: dateAfter(new Date()),\n    // or\n    dateAfter: dateAfter(new Date(), { allowEqual: false }),\n  },\n})\n```\n\n## `dateBefore`\n_**Params**_\n - `before: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date is before the given parameter.\n\n```ts\nimport { dateBefore } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateBefore: dateBefore(new Date()),\n    // or\n    dateBefore: dateBefore(new Date(), { allowEqual: false }),\n  },\n})\n```\n\n## `dateBetweeen`\n\n_**Params**_\n - `before: Ref<string | Date> | string | Date | () => string | Date`\n - `after: Ref<string | Date> | string | Date | () => string | Date`\n - `options?: {allowEqual?: boolean}`\n\nChecks if the date falls between the specified bounds.\n\n```ts\nimport { dateBetween } from '@regle/rules';\n\nconst { r$ } = useRegle({ birthday: null as Date | null }, {\n  birthday: {\n    dateBetween: dateBetween(new Date(), new Date(2030, 3, 1)),\n    // or\n    dateBetween: dateBetween(new Date(), new Date(2030, 3, 1), { allowEqual: false }),\n  },\n})\n```\n\n## `decimal`\n\nAllows positive and negative decimal numbers.\n\n```ts\nimport { decimal } from '@regle/rules';\n\nconst { r$ } = useRegle({ price: 0 }, {\n  price: { decimal },\n})\n```\n\n## `email`\n\nValidates email addresses. Always verify on the server to ensure the address is real and not already in use.\n\n```ts\nimport { email } from '@regle/rules';\n\nconst { r$ } = useRegle({ email: '' }, {\n  email: { email },\n})\n```\n\n## `endsWith`\n\n_**Params**_\n- `end: Ref<string> | string | () => string`\n\nChecks if the string ends with the specified substring.\n\n```ts\nimport { endsWith } from '@regle/rules';\n\nconst { r$ } = useRegle({ firstName: '' }, {\n  firstName: { endsWith: endsWith('foo') },\n})\n```\n\n## `exactLength`\n\n_**Params**_\n  - `count: Ref<number> | number | () => number`\n\nRequires the input value to have a strict specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { exactLength } from '@regle/rules';\n\nconst exactValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    exactLength: exactLength(6),\n    exactLength: exactLength(exactValue),\n    exactLength: exactLength(() => exactValue.value)\n  },\n})\n```\n\n## `exactValue`\n\n_**Params**_\n  - `count: Ref<number> | number | () => number`\n\nRequires a field to have a strict numeric value.\n\n```ts\nimport { exactValue } from '@regle/rules';\n\nconst exactCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    exactValue: exactValue(6),\n    exactValue: exactValue(exactCount),\n    exactValue: exactValue(() => exactCount.value)\n  },\n})\n```\n\n## `file`\n\nRequires a value to be a native File constructor. Mainly used for typing.\n\n```ts\nimport { file } from '@regle/rules';\n\nconst rules = {\n  file: { file },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `fileType`\n\nRequires a value to be a file with a specific type.\n\n```ts\nimport { fileType } from '@regle/rules';\n\nconst { r$ } = useRegle({ file: null as File | null }, {\n  file: { fileType: fileType(['image/png', 'image/jpeg']) },\n})\n```\n\n## `hexadecimal`\n\nValidates hexadecimal values.\n\n```ts\nimport { hexadecimal } from '@regle/rules';\n\nconst { r$ } = useRegle({ hexadecimal: '' }, {\n  hexadecimal: { hexadecimal },\n})\n```\n\n## `integer`\n\nAllows only integers (positive and negative).\n\n```ts\nimport { integer } from '@regle/rules';\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: { integer },\n})\n```\n\n## `ipv4Address`\n\nValidates IPv4 addresses in dotted decimal notation *127.0.0.1*.\n\n```ts\nimport { ipv4Address } from '@regle/rules';\n\nconst { r$ } = useRegle({ address: '' }, {\n  address: { ipv4Address },\n})\n```\n\n## `macAddress`\n\n_**Params**_\n  - `separator?: string | Ref<string> | () => string`\n\nValidates MAC addresses. Call as a function to specify a custom separator (e.g., ':' or an empty string for 00ff1122334455).\n\n```ts\n\nimport { macAddress } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ address: '' }, {\n  address: {\n    macAddress,\n    // or\n    macAddress: macAddress('-')\n  },\n})\n```\n\n## `maxFileSize`\n\nRequires a value to be a file with a maximum size.\n\n```ts\nimport { maxFileSize } from '@regle/rules';\n\nconst { r$ } = useRegle({ file: null as File | null }, {\n  file: { maxFileSize: maxFileSize(10_000_000) }, // 10 MB\n})\n```\n\n## `maxLength`\n\n_**Params**_\n  - `max: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `Array | Record | string | number`\n\nRequires the input value to have a maximum specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { maxLength } from '@regle/rules';\n\nconst maxValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    maxLength: maxLength(6),\n    maxLength: maxLength(maxValue),\n    maxLength: maxLength(() => maxValue.value)\n  },\n})\n```\n\n## `maxValue`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n  Requires a field to have a specified maximum numeric value.\n\n```ts\nimport { maxValue } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    maxValue: maxValue(6),\n    maxValue: maxValue(maxCount, {allowEqual: false}),\n    maxValue: maxValue(() => maxCount.value)\n  },\n})\n```\n\n## `minFileSize`\n\nRequires a value to be a file with a minimum size.\n\n```ts\nimport { minFileSize } from '@regle/rules';\n\nconst { r$ } = useRegle({ file: null as File | null }, {\n  file: { minFileSize: minFileSize(1_000_000) }, // 1 MB\n})\n```\n\n## `minLength`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `Array | Record | string | number`\n\nRequires the input value to have a minimum specified length, inclusive. Works with arrays, objects and strings.\n\n```ts\nimport { minLength } from '@regle/rules';\n\nconst minValue = ref(6);\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    minLength: minLength(6),\n    minLength: minLength(minValue),\n    minLength: minLength(() => minValue.value)\n  },\n})\n```\n\n## `minValue`\n\n_**Params**_\n  - `min: Ref<number> | number | () => number`\n  - `options?: {allowEqual?: boolean}`\n\n_**Works with**_\n  - `number`\n\nRequires a field to have a specified minimum numeric value.\n\n```ts\nimport { minValue } from '@regle/rules';\n\nconst minCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    minValue: minValue(6),\n    minValue: minValue(minCount, {allowEqual: false}),\n    minValue: minValue(() => minCount.value)\n  },\n})\n```\n\n## `nativeEnum`\n\nValidate against a native Typescript enum value. Similar to Zod's `nativeEnum`\n\n```ts\nimport { nativeEnum } from '@regle/rules';\n\nenum Foo {\n  Bar, Baz\n}\n\nconst { r$ } = useRegle({ type: '' }, {\n  type: { nativeEnum: nativeEnum(Foo) },\n})\n```\n\n## `number`\n\nRequires a value to be a native number type. Mainly used for typing.\n\n```ts\nimport { number } from '@regle/rules';\n\nconst rules = {\n  count: { number },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `numeric`\n\nAllows only numeric values (including numeric strings).\n\n```ts\nimport { numeric } from '@regle/rules';\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: { numeric },\n})\n```\n\n## `oneOf`\n\nAllow only one of the values from a fixed Array of possible entries.\n\n_**Params**_\n  - `options: MaybeRefOrGetter<Array<string | number>>`\n\n```ts\nimport { oneOf } from '@regle/rules';\n\nconst { r$ } = useRegle({ aliment: 'Fish' }, {\n  aliment: {\n    oneOf: oneOf(['Fish', 'Meat', 'Bone'])\n  },\n})\n```\n\n## `regex`\n\n_**Params**_\n- `regexps: MaybeRefOrGetter<RegExp | RegExp[]>`\n\nChecks if the value matches one or more regular expressions.\n\n```ts\nimport { regex } from '@regle/rules';\n\nconst { r$ } = useRegle({ name: '' }, {\n  name: {\n    regex: regex(/^foo/),\n    regex: regex([/^bar/, /baz$/]),\n  },\n})\n```\n\n## `required`\n\nRequires non-empty data. Checks for empty arrays and strings containing only whitespaces.\n\n```ts\nimport {required} from '@regle/rules';\n\nconst {r$} = useRegle({name: ''}, {\n  name: {required},\n})\n```\n\n## `requiredIf`\n\n_**Params**_\n  - `condition: Ref<unknown> | unknown | () => unknown` - the property to base the `required` validator on.\n\nRequires non-empty data, only if provided data property, ref, or a function resolves to `true`.\n\n```ts\nimport { requiredIf } from '@regle/rules';\n\nconst form = ref({ name: '', condition: false });\n\nconst conditionRef = ref(false);\n\nconst { r$ } = useRegle(form, {\n  name: {\n    required: requiredIf(() => form.value.condition),\n    required: requiredIf(conditionRef),\n  },\n})\n```\n\n## `requiredUnless`\n\n_**Params**_\n  - `condition: Ref<unknown> | unknown | () => unknown` - the property to base the `required` validator on.\n\nRequires non-empty data, only if provided data property, ref, or a function resolves to `false`.\n\n```ts\nimport { requiredUnless } from '@regle/rules';\n\nconst form = ref({ name: '', condition: false });\n\nconst conditionRef = ref(false);\n\nconst { r$ } = useRegle(form, {\n  name: {\n    required: requiredUnless(() => form.value.condition),\n    required: requiredUnless(conditionRef)\n  },\n})\n```\n\n## `sameAs`\n\n_**Params**_\n  * `target: unknown`\n\nChecks if the value matches the specified property or ref.\n\n```ts\nimport { sameAs } from '@regle/rules';\n\nconst form = ref({\n  password: '',\n  confirmPassword: '',\n});\n\nconst { r$ } = useRegle(form, {\n  confirmPassword: {\n    sameAs: sameAs(() => form.value.password),\n  }\n})\n```\n\n## `startsWith`\n\n_**Params**_\n- `start: Ref<string> | string | () => string`\n\nChecks if the string starts with the specified substring.\n\n```ts\nimport { startsWith } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestLib: '' }, {\n  bestLib: {\n    startsWith: startsWith('regle')\n  },\n})\n```\n\n## `string`\n\nRequires a value to be a native string type. Mainly used for typing\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { string } from '@regle/rules';\n\nconst rules = {\n  firstName: { string },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `type`\n\nDefine the input type of a rule. No runtime validation.   \nOverride any input type set by other rules.\n\n```ts\nimport {type InferInput} from '@regle/core';\nimport { type } from '@regle/rules';\n\nconst rules = {\n  firstName: { type: type<string>() },\n}\n\nconst state = ref<InferInput<typeof rules>>({});\n```\n\n## `url`\n\nValidates URLs.\n\n```ts\nimport { url } from '@regle/rules';\n\nconst { r$ } = useRegle({ bestUrl: '' }, {\n  bestUrl: { url },\n})\n```"
 		},
 		{
 			"id": "core-concepts-rules-index",
@@ -921,6 +921,29 @@ var docs_data_default = {
 				"example": "import { exactValue } from '@regle/rules';\n\nconst exactCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    exactValue: exactValue(6),\n    // or with reactive value\n    exactValue: exactValue(exactCount),\n    // or with getter\n    exactValue: exactValue(() => exactCount.value)\n  },\n})",
 				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#exactvalue Documentation" }
 			},
+			{
+				"name": "file",
+				"kind": "const",
+				"description": "Requires a value to be a native `File` constructor.\n\nMainly used for typing with `InferInput`.",
+				"parameters": [],
+				"returnType": "",
+				"example": "import { type InferInput } from '@regle/core';\nimport { file } from '@regle/rules';\n\nconst rules = {\n  file: { file },\n}\n\nconst state = ref<InferInput<typeof rules>>({});",
+				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#file Documentation" }
+			},
+			{
+				"name": "fileType",
+				"kind": "const",
+				"description": "Requires a value to be a file with a specific type.",
+				"parameters": [{
+					"name": "params",
+					"type": "[accept: MaybeRefOrGetter<string[]>]",
+					"description": "",
+					"optional": false
+				}],
+				"returnType": "RegleRuleDefinition<File, [accept: string[]], false, boolean, unknown, File>",
+				"example": "import { type InferInput } from '@regle/core';\nimport { fileType } from '@regle/rules';\n\nconst {r$} = useRegle({ file: null as File | null }, {\n  file: { fileType: fileType(['image/png', 'image/jpeg']) },\n})",
+				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#filetype Documentation" }
+			},
 			{
 				"name": "getSize",
 				"kind": "function",
@@ -1075,6 +1098,20 @@ var docs_data_default = {
 				"example": "import { createRule, type Maybe } from '@regle/core';\nimport { isFilled, matchRegex } from '@regle/rules';\n\nconst regex = createRule({\n  validator(value: Maybe<string>, regexps: RegExp[]) {\n    if (isFilled(value)) {\n      return matchRegex(value, ...regexps);\n    }\n    return true;\n  },\n  message: 'Error'\n})",
 				"tags": { "see": "://reglejs.dev/core-concepts/rules/validations-helpers#matchregex Documentation" }
 			},
+			{
+				"name": "maxFileSize",
+				"kind": "const",
+				"description": "Requires a value to be a file with a maximum size.",
+				"parameters": [{
+					"name": "params",
+					"type": "[maxSize: MaybeRefOrGetter<number>]",
+					"description": "",
+					"optional": false
+				}],
+				"returnType": "RegleRuleDefinition<File, [maxSize: number], false, true | { $valid: boolean; fileSize: number; }, unknown, File>",
+				"example": "import { type InferInput } from '@regle/core';\nimport { maxFileSize } from '@regle/rules';\n\nconst {r$} = useRegle({ file: null as File | null }, {\n  file: { maxFileSize: maxFileSize(10_000_000) }, // 10 MB\n})",
+				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#maxfilesize Documentation" }
+			},
 			{
 				"name": "maxLength",
 				"kind": "const",
@@ -1103,6 +1140,20 @@ var docs_data_default = {
 				"example": "import { maxValue } from '@regle/rules';\n\nconst maxCount = ref(6);\n\nconst { r$ } = useRegle({ count: 0 }, {\n  count: {\n    maxValue: maxValue(6),\n    // or with options\n    maxValue: maxValue(maxCount, { allowEqual: false }),\n    // or with getter\n    maxValue: maxValue(() => maxCount.value)\n  },\n})",
 				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#maxvalue Documentation" }
 			},
+			{
+				"name": "minFileSize",
+				"kind": "const",
+				"description": "Requires a value to be a file with a minimum size.",
+				"parameters": [{
+					"name": "params",
+					"type": "[minSize: MaybeRefOrGetter<number>]",
+					"description": "",
+					"optional": false
+				}],
+				"returnType": "RegleRuleDefinition<File, [minSize: number], false, true | { $valid: boolean; fileSize: number; }, unknown, File>",
+				"example": "import { type InferInput } from '@regle/core';\nimport { minFileSize } from '@regle/rules';\n\nconst {r$} = useRegle({ file: null as File | null }, {\n  file: { minFileSize: minFileSize(1_000_000) }, // 1 MB\n})",
+				"tags": { "see": "://reglejs.dev/core-concepts/rules/built-in-rules#minfilesize Documentation" }
+			},
 			{
 				"name": "minLength",
 				"kind": "const",
@@ -1666,7 +1717,7 @@ function searchApi(query) {
 	return results;
 }
 
-var version = "1.14.7";
+var version = "1.15.1";
 
 let posthogClient = null;
 posthogClient = new PostHog("phc_kqgJoylCpKkGkkRGxb4MyN2mViehoQcUFEGwVkk4l8E", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@regle/mcp-server",
-  "version": "1.14.7",
+  "version": "1.15.1",
   "description": "MCP Server for Regle",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.24.3",