@react-querybuilder/core 8.14.3 → 8.15.0

package/dist/{basic-CNIjb6rI.d.mts → index-Lht_Wq3V.d.mts}

@@ -1,3 +1,5 @@
+import { RulesLogic } from "json-logic-js";
+
 //#region ../../node_modules/type-fest/source/union-to-intersection.d.ts
 /**
 Convert a union type to an intersection type using [distributive conditional types](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).
@@ -1214,7 +1216,7 @@ type ValueEditorType = "text" | "select" | "checkbox" | "radio" | "textarea" | "
 */
 type ValueSources = ["value"] | ["value", "field"] | ["field", "value"] | ["field"];
 type ValueSourceFlexibleOptions = ToFlexibleOptionArrays<ValueSources>;
-type ToFlexibleOptionArrays<Sources extends readonly string[]> = Sources extends unknown ? { [K in keyof Sources]: FlexibleOption<Sources[K]> } : never;
+type ToFlexibleOptionArrays<Sources extends readonly string[]> = Sources extends unknown ? { [K in keyof Sources]: FlexibleOption } : never;
 type WithOptionalClassName<T> = T & {
   className?: Classname;
 };
@@ -1296,5 +1298,595 @@ type ParseNumbersModerationLevel = "-limited" | "";
 */
 type ParseNumbersPropConfig = boolean | `${ParseNumberMethodName}${ParseNumbersModerationLevel}`;
 //#endregion
-export { Except as C, SetRequired as S, RuleGroupType as _, ValueSource as a, FullOptionList as b, RuleValidator as c, DefaultRuleGroupTypeIC as d, RuleGroupTypeAny as f, DefaultRuleGroupType as g, DefaultOperatorName as h, ParseNumbersPropConfig as i, ValidationMap as l, DefaultCombinatorName as m, FullOperator as n, ValueSources as o, RuleGroupTypeIC as p, InputType as r, QueryValidator as s, FullField as t, ValidationResult as u, RuleType as v, OptionList as x, FlexibleOptionList as y };
-//# sourceMappingURL=basic-CNIjb6rI.d.mts.map
+//#region src/types/export.d.ts
+/**
+* Available export formats for {@link formatQuery}.
+*
+* @group Export
+*/
+type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "prisma" | "sequelize" | "diagnostics";
+/**
+* Export formats for {@link formatQuery} that produce objects instead of strings.
+*
+* @group Export
+*/
+type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query" | "diagnostics";
+/**
+* Available presets for the "sql" export format.
+*
+* @group Export
+*/
+type SQLPreset = "ansi" | "sqlite" | "postgresql" | "mysql" | "mssql" | "oracle";
+/**
+* A map of operators to strings to be used in the output of {@link formatQuery}. If the
+* result can differ based on the `valueSource`, the key should map to an array where the
+* second element represents the string to be used when `valueSource` is "field". The first
+* element will be used in all other cases.
+*
+* @group Export
+*/
+type ExportOperatorMap = Partial<Record<Lowercase<DefaultOperatorName> | DefaultOperatorName, string | [string, string]>>;
+/**
+* Options object shape for {@link formatQuery}.
+*
+* @group Export
+*/
+interface FormatQueryOptions {
+  /**
+  * The {@link ExportFormat}.
+  */
+  format?: ExportFormat;
+  /**
+  * This function will be used to process the `operator` from each rule
+  * for query language formats. If not defined, the appropriate
+  * `defaultOperatorProcessor*` for the format will be used.
+  */
+  operatorProcessor?: RuleProcessor;
+  /**
+  * This function will be used to process the `value` from each rule
+  * for query language formats. If not defined, the appropriate
+  * `defaultValueProcessor*` for the format will be used.
+  */
+  valueProcessor?: ValueProcessorLegacy | ValueProcessorByRule;
+  /**
+  * This function will be used to process each rule. If not defined, the appropriate
+  * `defaultRuleProcessor*` for the given format will be used.
+  */
+  ruleProcessor?: RuleProcessor;
+  /**
+  * This function will be used to process each rule group. If not defined, the appropriate
+  * `defaultRuleGroupProcessor*` for the format will be used.
+  *
+  * If this function is defined, it will override the `format` option. This also allows
+  * `formatQuery` to produce completely custom output formats.
+  */
+  ruleGroupProcessor?: RuleGroupProcessor;
+  /**
+  * In the "sql", "parameterized", "parameterized_named", and "jsonata" export
+  * formats, field names will be bracketed by this string. If an array of strings
+  * is passed, field names will be preceded by the first element and
+  * succeeded by the second element.
+  *
+  * Tip: Use `fieldIdentifierSeparator` to bracket identifiers individually within field names.
+  *
+  * @default '' // the empty string
+  *
+  * @example
+  * formatQuery(query, { format: 'sql', quoteFieldNamesWith: '"' })
+  * // `"First name" = 'Steve'`
+  *
+  * @example
+  * formatQuery(query, { format: 'sql', quoteFieldNamesWith: ['[', ']'] })
+  * // "[First name] = 'Steve'"
+  */
+  quoteFieldNamesWith?: string | [string, string];
+  /**
+  * When used in conjunction with the `quoteFieldNamesWith` option, field names will
+  * be split by this string, each part being individually processed as per the rules
+  * of the `quoteFieldNamesWith` configuration. The parts will then be re-joined
+  * by the same string.
+  *
+  * A common value for this option is `'.'`.
+  *
+  * A value of `''` (the empty string) will disable splitting/rejoining.
+  *
+  * @default ''
+  *
+  * @example
+  * formatQuery(query, {
+  *   format: 'sql',
+  *   quoteFieldNamesWith: ['[', ']'],
+  *   fieldIdentifierSeparator: '.',
+  * })
+  * // "[dbo].[Musicians].[First name] = 'Steve'"
+  */
+  fieldIdentifierSeparator?: string;
+  /**
+  * Character to use for quoting string values in the SQL format.
+  * @default `'`
+  */
+  quoteValuesWith?: string;
+  /**
+  * Validator function for the entire query. Can be the same function passed
+  * as `validator` prop to {@link react-querybuilder!QueryBuilder QueryBuilder}.
+  */
+  validator?: QueryValidator;
+  /**
+  * This can be the same {@link FullField} array passed to {@link react-querybuilder!QueryBuilder QueryBuilder}, but
+  * really all you need to provide is the `name` and `validator` for each field.
+  *
+  * The full field object from this array, where the field's identifying property
+  * matches the rule's `field`, will be passed to the rule processor.
+  */
+  fields?: FlexibleOptionList<FullField>;
+  /**
+  * This can be the same `getOperators` function passed to {@link react-querybuilder!QueryBuilder QueryBuilder}.
+  *
+  * The full operator object from this array, where the operator's identifying property
+  * matches the rule's `operator`, will be passed to the rule processor.
+  */
+  getOperators?(field: string, misc: {
+    fieldData: FullField;
+  }): FlexibleOptionList<FullOperator> | null;
+  /**
+  * This string will be inserted in place of invalid groups for non-JSON formats.
+  * Defaults to `'(1 = 1)'` for "sql"/"parameterized"/"parameterized_named" and
+  * `'$and:[{$expr:true}]'` for "mongodb".
+  */
+  fallbackExpression?: string;
+  /**
+  * This string will be placed in front of named parameters (aka bind variables)
+  * when using the "parameterized_named" export format.
+  *
+  * @default ":"
+  */
+  paramPrefix?: string;
+  /**
+  * Maintains the parameter prefix in the `params` object keys when using the
+  * "parameterized_named" export format. Recommended when using SQLite.
+  *
+  * @default false
+  *
+  * @example
+  * console.log(formatQuery(query, {
+  *   format: "parameterized_named",
+  *   paramPrefix: "$",
+  *   paramsKeepPrefix: true
+  * }).params)
+  * // { $firstName: "Stev" }
+  * // Default (`paramsKeepPrefix` is `false`):
+  * // { firstName: "Stev" }
+  */
+  paramsKeepPrefix?: boolean;
+  /**
+  * Renders parameter placeholders as a series of sequential numbers
+  * instead of '?' like the default. This option will respect the
+  * `paramPrefix` option like the 'parameterized_named' format.
+  *
+  * @default false
+  */
+  numberedParams?: boolean;
+  /**
+  * Preserves the order of values for "between" and "notBetween" rules, even if a larger
+  * value comes before a smaller value (which will always evaluate to false).
+  */
+  preserveValueOrder?: boolean;
+  /**
+  * Renders values as either `number`-types or unquoted strings, as
+  * appropriate and when possible. Each `string`-type value is evaluated
+  * against {@link numericRegex} to determine if it can be represented as a
+  * plain numeric value. If so, `parseFloat` is used to convert it to a number.
+  */
+  parseNumbers?: ParseNumbersPropConfig;
+  /**
+  * Any rules where the field is equal to this value will be ignored.
+  *
+  * @default '~'
+  */
+  placeholderFieldName?: string;
+  /**
+  * Any rules where the operator is equal to this value will be ignored.
+  *
+  * @default '~'
+  */
+  placeholderOperatorName?: string;
+  /**
+  * Any rules where the value is equal to this value will be ignored.
+  *
+  * @default '~'
+  */
+  placeholderValueName?: string;
+  /**
+  * Operator to use when concatenating wildcard characters and field names in "sql" format.
+  * The ANSI standard is `||`, while SQL Server uses `+`. MySQL does not implement a concatenation
+  * operator by default, and therefore requires use of the `CONCAT` function.
+  *
+  * If `concatOperator` is set to `"CONCAT"` (case-insensitive), the `CONCAT` function will be
+  * used. Note that Oracle SQL does not support more than two values in the `CONCAT` function,
+  * so this option should not be used in that context. The default setting (`"||"`) is already
+  * compatible with Oracle SQL.
+  *
+  * @default '||'
+  */
+  concatOperator?: "||" | "+" | "CONCAT" | (string & {});
+  /**
+  * Option presets to maximize compatibility with various SQL dialects.
+  */
+  preset?: SQLPreset;
+  /**
+  * Map of operators to their translations for the "natural_language" format. If the
+  * result can differ based on the `valueSource`, the key should map to an array where the
+  * second element represents the string to be used when `valueSource` is "field". The first
+  * element will be used in all other cases.
+  */
+  operatorMap?: ExportOperatorMap;
+  /**
+  * [Constituent word order](https://en.wikipedia.org/wiki/Word_order#Constituent_word_orders)
+  * for the "natural_language" format. Can be abbreviated like "SVO" or spelled out like
+  * "subject-verb-object".
+  *
+  * - Subject = field
+  * - Verb = operator
+  * - Object = value
+  */
+  wordOrder?: ConstituentWordOrderString | Lowercase<ConstituentWordOrderString> | ({} & string);
+  /**
+  * Translatable strings used by the "natural_language" format.
+  */
+  translations?: Partial<Record<NLTranslationKey, string>>;
+  context?: Record<string, any>;
+}
+/**
+* Options object for {@link ValueProcessorByRule} functions.
+*
+* @group Export
+*/
+interface ValueProcessorOptions extends FormatQueryOptions {
+  valueProcessor?: ValueProcessorByRule;
+  escapeQuotes?: boolean;
+  /**
+  * The full field object, if `fields` was provided in the
+  * {@link formatQuery} options parameter.
+  */
+  fieldData?: FullField;
+  /**
+  * Included for the "parameterized_named" format only. Keys of this object represent
+  * field names and values represent the current list of parameter names for that
+  * field based on the query rules processed up to that point. Use this list to
+  * ensure that parameter names generated by the custom rule processor are unique.
+  */
+  fieldParamNames?: Record<string, string[]>;
+  /**
+  * Included for the "parameterized_named" format only. Call this function with a
+  * field name to get a unique parameter name, as yet unused during query processing.
+  */
+  getNextNamedParam?: (field: string) => string;
+  /**
+  * Additional prefix and suffix characters to wrap the value in. Useful for augmenting
+  * the default value processor results with special syntax (e.g., for dates or function
+  * calls).
+  */
+  wrapValueWith?: [string, string];
+  /**
+  * Parse numbers in the rule value.
+  *
+  * @default false
+  */
+  parseNumbers?: boolean;
+}
+/**
+* Options object curated by {@link formatQuery} and passed to a {@link RuleGroupProcessor}.
+*
+* @group Export
+*/
+interface FormatQueryFinalOptions extends Required<Except<FormatQueryOptions, "context" | "valueProcessor" | "validator" | "placeholderValueName" | "ruleGroupProcessor" | "parseNumbers">> {
+  fields: FullOptionList<FullField>;
+  getParseNumberBoolean: (inputType?: InputType | null) => boolean | undefined;
+  parseNumbers?: ParseNumbersPropConfig | undefined;
+  placeholderValueName?: string | undefined;
+  valueProcessor: ValueProcessorByRule;
+  validator?: QueryValidator;
+  validateRule: FormatQueryValidateRule;
+  validationMap: ValidationMap;
+  context?: Record<string, unknown>;
+}
+/**
+* Function that produces a processed value for a given {@link RuleType}.
+*
+* @group Export
+*/
+type ValueProcessorByRule = (rule: RuleType, options?: ValueProcessorOptions) => string;
+/**
+* Function that produces a processed value for a given `field`, `operator`, `value`,
+* and `valueSource`.
+*
+* @group Export
+*/
+type ValueProcessorLegacy = (field: string, operator: string, value: any, valueSource?: ValueSource) => string;
+/**
+* Function to produce a result that {@link formatQuery} uses when processing a
+* {@link RuleType} object.
+*
+* See the default rule processor for each format to know what type to return.
+* | Format                   | Default rule processor                    |
+* | ------------------------ | ----------------------------------------- |
+* | `sql`                    | {@link defaultRuleProcessorSQL}           |
+* | `parameterized`          | {@link defaultRuleProcessorParameterized} |
+* | `parameterized_named`    | {@link defaultRuleProcessorParameterized} |
+* | `mongodb` _(deprecated)_ | {@link defaultRuleProcessorMongoDB}       |
+* | `mongodb_query`          | {@link defaultRuleProcessorMongoDBQuery}  |
+* | `cel`                    | {@link defaultRuleProcessorCEL}           |
+* | `spel`                   | {@link defaultRuleProcessorSpEL}          |
+* | `jsonlogic`              | {@link defaultRuleProcessorJsonLogic}     |
+* | `elasticsearch`          | {@link defaultRuleProcessorElasticSearch} |
+* | `jsonata`                | {@link defaultRuleProcessorJSONata}       |
+*
+* @group Export
+*/
+type RuleProcessor = (rule: RuleType, options?: ValueProcessorOptions, meta?: {
+  processedParams?: Record<string, any> | any[];
+  context?: Record<string, any>;
+}) => any;
+/**
+* Function to produce a result that {@link formatQuery} uses when processing a
+* {@link RuleGroupType} or {@link RuleGroupTypeIC} object.
+*
+* See the default rule group processor for each format to know what type to return.
+* | Format                   | Default rule group processor                   |
+* | ------------------------ | ---------------------------------------------- |
+* | `sql`                    | {@link defaultRuleGroupProcessorSQL}           |
+* | `parameterized`          | {@link defaultRuleGroupProcessorParameterized} |
+* | `parameterized_named`    | {@link defaultRuleGroupProcessorParameterized} |
+* | `mongodb` _(deprecated)_ | {@link defaultRuleGroupProcessorMongoDB}       |
+* | `mongodb_query`          | {@link defaultRuleGroupProcessorMongoDBQuery}  |
+* | `cel`                    | {@link defaultRuleGroupProcessorCEL}           |
+* | `spel`                   | {@link defaultRuleGroupProcessorSpEL}          |
+* | `jsonlogic`              | {@link defaultRuleGroupProcessorJsonLogic}     |
+* | `elasticsearch`          | {@link defaultRuleGroupProcessorElasticSearch} |
+* | `jsonata`                | {@link defaultRuleGroupProcessorJSONata}       |
+*
+* @group Export
+*/
+type RuleGroupProcessor<TResult = unknown> = (ruleGroup: RuleGroupTypeAny, options: FormatQueryFinalOptions, meta?: {
+  processedParams?: Record<string, any> | any[];
+  context?: Record<string, any>;
+}) => TResult;
+/**
+* Rule validator for {@link formatQuery}.
+*
+* @group Export
+*/
+type FormatQueryValidateRule = (rule: RuleType) => readonly [boolean | ValidationResult | undefined, RuleValidator | undefined];
+/**
+* Object produced by {@link formatQuery} for the `"parameterized"` format.
+*
+* @group Export
+*/
+interface ParameterizedSQL {
+  /** The SQL `WHERE` clause fragment with `?` placeholders for each value. */
+  sql: string;
+  /**
+  * Parameter values in the same order their respective placeholders
+  * appear in the `sql` string.
+  */
+  params: any[];
+}
+/**
+* Object produced by {@link formatQuery} for the `"parameterized_named"` format.
+*
+* @group Export
+*/
+interface ParameterizedNamedSQL {
+  /** The SQL `WHERE` clause fragment with bind variable placeholders for each value. */
+  sql: string;
+  /**
+  * Map of bind variable names from the `sql` string to the associated values.
+  */
+  params: Record<string, any>;
+}
+/**
+* A {@link RuleType} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format.
+*
+* The generics mirror those of {@link RuleType}.
+*
+* @group Export
+*/
+type RuleDiagnosticsResult<F extends string = string, O extends string = string, V = any, C extends string = string> = RuleType<F, O, V, C> & {
+  /** Whether the rule passed all validation checks. */valid: boolean;
+  /**
+  * Reasons why the rule is invalid. Only present when
+  * the rule is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[]; /** The path to this rule within the query tree. */
+  path: number[]; /** The nesting depth of this rule (`path.length`). */
+  level: number;
+};
+/**
+* The type of the `rules` array in a {@link RuleGroupDiagnosticsResult}.
+*
+* @group Export
+*/
+type RuleGroupDiagnosticsArray<RG extends RuleGroupDiagnosticsResult = RuleGroupDiagnosticsResult, R extends RuleDiagnosticsResult = RuleDiagnosticsResult> = RuleGroupArray<RG, R>;
+/**
+* A {@link RuleGroupType} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format.
+*
+* The generics mirror those of {@link RuleGroupType}.
+*
+* @group Export
+*/
+interface RuleGroupDiagnosticsResult<R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> extends Omit<RuleGroupType<R, C>, "rules"> {
+  /** Whether the group and all of its descendants are valid. */
+  valid: boolean;
+  /**
+  * Reasons why the group itself is invalid. Only present when
+  * the group is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[];
+  /** The path to this group within the query tree. */
+  path: number[];
+  /** The nesting depth of this group (`path.length`). */
+  level: number;
+  rules: RuleGroupDiagnosticsArray<RuleGroupDiagnosticsResult<R, C>, R>;
+}
+/**
+* The type of the `rules` array in a {@link RuleGroupICDiagnosticsResult}.
+*
+* Mirrors {@link RuleGroupICArray} but with diagnostics-annotated node types.
+*
+* @group Export
+*/
+type RuleGroupICDiagnosticsArray<RG extends RuleGroupICDiagnosticsResult = RuleGroupICDiagnosticsResult, R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> = RuleGroupICArray<RG, R, C>;
+/**
+* A {@link RuleGroupTypeIC} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format (independent combinators).
+*
+* The generics mirror those of {@link RuleGroupTypeIC}.
+*
+* @group Export
+*/
+interface RuleGroupICDiagnosticsResult<R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> extends Omit<RuleGroupTypeIC<R, C>, "rules"> {
+  /** Whether the group and all of its descendants are valid. */
+  valid: boolean;
+  /**
+  * Reasons why the group itself is invalid. Only present when
+  * the group is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[];
+  /** The path to this group within the query tree. */
+  path: number[];
+  /** The nesting depth of this group (`path.length`). */
+  level: number;
+  rules: RuleGroupICDiagnosticsArray<RuleGroupICDiagnosticsResult<R, C>, R, C>;
+}
+/**
+* A single diagnostic entry produced by the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticEntry {
+  /** The `id` of the rule or group this diagnostic pertains to. */
+  id: string;
+  /** The path to the rule or group within the query tree. */
+  path: number[];
+  /** A machine-readable code identifying the type of diagnostic. */
+  code: string;
+  /** A human-readable description of the diagnostic. */
+  message: string;
+  /**
+  * Which check produced this diagnostic.
+  *
+  * - `"placeholder"` — a placeholder field, operator, or value
+  * - `"muted"` — a muted rule or group
+  * - `"query-validator"` — the query-level validator
+  * - `"field-validator"` — a field-level validator
+  * - `"type-check"` — value/type mismatch based on field `inputType`
+  * - `"field-check"` — field existence check against the `fields` config
+  */
+  source: "placeholder" | "muted" | "query-validator" | "field-validator" | "type-check" | "field-check";
+}
+/**
+* Aggregate statistics for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsStats {
+  totalRules: number;
+  totalGroups: number;
+  validRules: number;
+  invalidRules: number;
+  validGroups: number;
+  invalidGroups: number;
+}
+/**
+* Per-field summary entry for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsFieldSummaryEntry {
+  /** Number of rules referencing this field. */
+  ruleCount: number;
+  /** Number of invalid rules referencing this field. */
+  invalidCount: number;
+}
+/**
+* Top-level result of {@link formatQuery} for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsResult {
+  /** The annotated query tree with `valid`, `path`, and `level` on every node. */
+  query: RuleGroupDiagnosticsResult | RuleGroupICDiagnosticsResult;
+  /** A flat array of all diagnostic entries across the tree. */
+  diagnostics: DiagnosticEntry[];
+  /** Aggregate statistics about the query. */
+  stats: DiagnosticsStats;
+  /** Per-field summary of rule counts and invalid counts. */
+  fieldSummary: Record<string, DiagnosticsFieldSummaryEntry>;
+}
+/**
+* @group Export
+*/
+interface RQBJsonLogicStartsWith {
+  startsWith: [RQBJsonLogic, RQBJsonLogic, ...RQBJsonLogic[]];
+}
+/**
+* @group Export
+*/
+interface RQBJsonLogicEndsWith {
+  endsWith: [RQBJsonLogic, RQBJsonLogic, ...RQBJsonLogic[]];
+}
+/**
+* JsonLogic rule object with additional operators generated by {@link formatQuery}
+* and accepted by {@link parseJsonLogic!parseJsonLogic}.
+*
+* @group Export
+*/
+type RQBJsonLogic = RulesLogic<RQBJsonLogicStartsWith | RQBJsonLogicEndsWith>;
+/**
+* Constituent word order (as array) for the "natural_language" format.
+*
+* - S (subject) = field
+* - V (verb) = operator
+* - O (object) = value
+*
+* @group Export
+*/
+type ConstituentWordOrder = ["S", "V", "O"] | ["S", "O", "V"] | ["O", "S", "V"] | ["O", "V", "S"] | ["V", "S", "O"] | ["V", "O", "S"];
+/**
+* Constituent word order (as string) for the "natural_language" format.
+*
+* - S (subject) = field
+* - V (verb) = operator
+* - O (object) = value
+*
+* @group Export
+*/
+type ConstituentWordOrderString = "SVO" | "SOV" | "OSV" | "OVS" | "VSO" | "VOS";
+type RepeatStrings<S extends string[], Depth extends number[] = []> = Depth["length"] extends 2 ? "" : "" | `_${S[number]}${RepeatStrings<S, [...Depth, 1]>}`;
+type ZeroOrMoreGroupVariants = RepeatStrings<["xor", "not"]>;
+/**
+* Rule group condition identifier for the "natural_language" format.
+*
+* @group Export
+*/
+type GroupVariantCondition = "not" | "xor";
+/**
+* Keys for the `translations` config object used by the "natural_language" format.
+*
+* @group Export
+*/
+type NLTranslationKey = "and" | "or" | "true" | "false" | `groupPrefix${ZeroOrMoreGroupVariants}` | `groupSuffix${ZeroOrMoreGroupVariants}`;
+/**
+* `translations` config object for "natural_language" format.
+*
+* @group Export
+*/
+type NLTranslations = Partial<Record<NLTranslationKey, string>>;
+//#endregion
+export { SetRequired as A, RuleGroupTypeIC as C, RuleGroupType as D, DefaultRuleGroupType as E, RuleType as O, RuleGroupTypeAny as S, DefaultOperatorName as T, ValueProcessorLegacy as _, ExportOperatorMap as a, ValueSources as b, NLTranslationKey as c, ParameterizedSQL as d, RQBJsonLogic as f, ValueProcessorByRule as g, SQLPreset as h, ExportObjectFormats as i, Except as j, OptionList as k, NLTranslations as l, RuleProcessor as m, DiagnosticsResult as n, FormatQueryOptions as o, RuleGroupProcessor as p, ExportFormat as r, GroupVariantCondition as s, ConstituentWordOrder as t, ParameterizedNamedSQL as u, ValueProcessorOptions as v, DefaultCombinatorName as w, DefaultRuleGroupTypeIC as x, FullField as y };
+//# sourceMappingURL=index-Lht_Wq3V.d.mts.map

package/dist/{objectUtils-ButT0Mng.js → objectUtils-Bzug_QfX.js}

@@ -4,7 +4,7 @@ let numeric_quantity = require("numeric-quantity");
 /**
 * Converts a value to lowercase if it's a string, otherwise returns the value as is.
 */
-// istanbul ignore next
+// v8 ignore next
 const lc = (v) => typeof v === "string" ? v.toLowerCase() : v;
 /**
 * Regex matching numeric strings. Passes for positive/negative integers, decimals,
@@ -102,4 +102,4 @@ Object.defineProperty(exports, "objectKeys", {
 	}
 });
 
-//# sourceMappingURL=objectUtils-ButT0Mng.js.map
+//# sourceMappingURL=objectUtils-Bzug_QfX.js.map

package/dist/objectUtils-Bzug_QfX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectUtils-Bzug_QfX.js","names":["numericQuantityRegex"],"sources":["../src/utils/misc.ts","../src/utils/isRuleGroup.ts","../src/utils/objectUtils.ts"],"sourcesContent":["import { numericRegex as numericQuantityRegex } from 'numeric-quantity';\n\n/**\n * Converts a value to lowercase if it's a string, otherwise returns the value as is.\n */\n// v8 ignore next\nexport const lc = <T>(v: T): T => (typeof v === 'string' ? (v.toLowerCase() as T) : v);\n\n/**\n * Regex matching numeric strings. Passes for positive/negative integers, decimals,\n * and E notation, with optional surrounding whitespace.\n */\nexport const numericRegex: RegExp = new RegExp(\n  numericQuantityRegex.source.replace(/^\\^/, String.raw`^\\s*`).replace(/\\$$/, String.raw`\\s*$`)\n);\n\n/**\n * Determines if a variable is a plain old JavaScript object, aka POJO.\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const isPojo = (obj: any): obj is Record<string, any> =>\n  obj === null || typeof obj !== 'object' ? false : Object.getPrototypeOf(obj) === Object.prototype;\n\n/**\n * Simple helper to determine whether a value is null, undefined, or an empty string.\n */\nexport const nullOrUndefinedOrEmpty = (value: unknown): value is null | undefined | '' =>\n  value === null || value === undefined || value === '';\n","import type { RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleType } from '../types';\nimport { isPojo } from './misc';\n\n/**\n * Determines if an object is a {@link RuleType} (only checks for a `field` property).\n */\nexport const isRuleType = (s: unknown): s is RuleType =>\n  isPojo(s) && 'field' in s && typeof s.field === 'string';\n\n/**\n * Determines if an object is a {@link RuleGroupType} or {@link RuleGroupTypeIC}.\n */\nexport const isRuleGroup = (rg: unknown): rg is RuleGroupTypeAny =>\n  isPojo(rg) && Array.isArray(rg.rules);\n\n/**\n * Determines if an object is a {@link RuleGroupType}.\n */\nexport const isRuleGroupType = (rg: unknown): rg is RuleGroupType =>\n  isRuleGroup(rg) && typeof rg.combinator === 'string';\n\n/**\n * Determines if an object is a {@link RuleGroupTypeIC}.\n */\nexport const isRuleGroupTypeIC = (rg: unknown): rg is RuleGroupTypeIC =>\n  isRuleGroup(rg) && rg.combinator === undefined;\n","// All code in this file is adapted from:\n// npm: https://www.npmjs.com/package/ts-extras\n// src: https://github.com/sindresorhus/ts-extras\n\n/**\n * Original looked like this (not sure why template string is used):\n * ```\n * type ObjectKeys<T extends object> = `${Exclude<keyof T, symbol>}`;\n * ```\n */\ntype ObjectKeys<T extends object> = Exclude<keyof T, symbol>;\n\n/**\n * A strongly-typed version of `Object.keys()`.\n *\n * [Original source](https://github.com/sindresorhus/ts-extras/blob/44f57392c5f027268330771996c4fdf9260b22d6/source/object-keys.ts)\n */\nexport const objectKeys = Object.keys as <Type extends object>(\n  value: Type\n) => Array<ObjectKeys<Type>>;\n\n/**\n * A strongly-typed version of `Object.entries()`.\n *\n * [Original source](https://github.com/sindresorhus/ts-extras/blob/44f57392c5f027268330771996c4fdf9260b22d6/source/object-entries.ts)\n */\nexport const objectEntries = Object.entries as <Type extends Record<PropertyKey, unknown>>(\n  value: Type\n) => Array<[ObjectKeys<Type>, Type[ObjectKeys<Type>]]>;\n\n/**\n * Returns `true` if the key could cause prototype pollution when used\n * as a property name in bracket-notation assignment.\n */\nexport const isUnsafeKey = (key: unknown): boolean =>\n  key === '__proto__' || key === 'constructor' || key === 'prototype';\n"],"mappings":";;;;;;;AAMA,MAAa,MAAS,MAAa,OAAO,MAAM,WAAY,EAAE,aAAa,GAAS;;;;;AAMpF,MAAa,eAAuB,IAAI,OACtCA,iBAAAA,aAAqB,OAAO,QAAQ,OAAO,OAAO,GAAG,OAAO,CAAC,QAAQ,OAAO,OAAO,GAAG,OAAO,CAC9F;;;;AAMD,MAAa,UAAU,QACrB,QAAQ,QAAQ,OAAO,QAAQ,WAAW,QAAQ,OAAO,eAAe,IAAI,KAAK,OAAO;;;;AAK1F,MAAa,0BAA0B,UACrC,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU;;;;;;ACfrD,MAAa,eAAe,OAC1B,OAAO,GAAG,IAAI,MAAM,QAAQ,GAAG,MAAM;;;;AAKvC,MAAa,mBAAmB,OAC9B,YAAY,GAAG,IAAI,OAAO,GAAG,eAAe;;;;AAK9C,MAAa,qBAAqB,OAChC,YAAY,GAAG,IAAI,GAAG,eAAe,KAAA;;;;;;;;ACRvC,MAAa,aAAa,OAAO;;;;;AAiBjC,MAAa,eAAe,QAC1B,QAAQ,eAAe,QAAQ,iBAAiB,QAAQ"}

package/dist/{objectUtils-C0WB-8ex.mjs → objectUtils-D96eEEzL.mjs}

@@ -3,7 +3,7 @@ import { numericRegex } from "numeric-quantity";
 /**
 * Converts a value to lowercase if it's a string, otherwise returns the value as is.
 */
-// istanbul ignore next
+// v8 ignore next
 const lc = (v) => typeof v === "string" ? v.toLowerCase() : v;
 /**
 * Regex matching numeric strings. Passes for positive/negative integers, decimals,
@@ -48,4 +48,4 @@ const isUnsafeKey = (key) => key === "__proto__" || key === "constructor" || key
 //#endregion
 export { isRuleGroupTypeIC as a, nullOrUndefinedOrEmpty as c, isRuleGroupType as i, numericRegex$1 as l, objectKeys as n, isPojo as o, isRuleGroup as r, lc as s, isUnsafeKey as t };
 
-//# sourceMappingURL=objectUtils-C0WB-8ex.mjs.map
+//# sourceMappingURL=objectUtils-D96eEEzL.mjs.map

package/dist/objectUtils-D96eEEzL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectUtils-D96eEEzL.mjs","names":["numericRegex","numericQuantityRegex"],"sources":["../src/utils/misc.ts","../src/utils/isRuleGroup.ts","../src/utils/objectUtils.ts"],"sourcesContent":["import { numericRegex as numericQuantityRegex } from 'numeric-quantity';\n\n/**\n * Converts a value to lowercase if it's a string, otherwise returns the value as is.\n */\n// v8 ignore next\nexport const lc = <T>(v: T): T => (typeof v === 'string' ? (v.toLowerCase() as T) : v);\n\n/**\n * Regex matching numeric strings. Passes for positive/negative integers, decimals,\n * and E notation, with optional surrounding whitespace.\n */\nexport const numericRegex: RegExp = new RegExp(\n  numericQuantityRegex.source.replace(/^\\^/, String.raw`^\\s*`).replace(/\\$$/, String.raw`\\s*$`)\n);\n\n/**\n * Determines if a variable is a plain old JavaScript object, aka POJO.\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const isPojo = (obj: any): obj is Record<string, any> =>\n  obj === null || typeof obj !== 'object' ? false : Object.getPrototypeOf(obj) === Object.prototype;\n\n/**\n * Simple helper to determine whether a value is null, undefined, or an empty string.\n */\nexport const nullOrUndefinedOrEmpty = (value: unknown): value is null | undefined | '' =>\n  value === null || value === undefined || value === '';\n","import type { RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleType } from '../types';\nimport { isPojo } from './misc';\n\n/**\n * Determines if an object is a {@link RuleType} (only checks for a `field` property).\n */\nexport const isRuleType = (s: unknown): s is RuleType =>\n  isPojo(s) && 'field' in s && typeof s.field === 'string';\n\n/**\n * Determines if an object is a {@link RuleGroupType} or {@link RuleGroupTypeIC}.\n */\nexport const isRuleGroup = (rg: unknown): rg is RuleGroupTypeAny =>\n  isPojo(rg) && Array.isArray(rg.rules);\n\n/**\n * Determines if an object is a {@link RuleGroupType}.\n */\nexport const isRuleGroupType = (rg: unknown): rg is RuleGroupType =>\n  isRuleGroup(rg) && typeof rg.combinator === 'string';\n\n/**\n * Determines if an object is a {@link RuleGroupTypeIC}.\n */\nexport const isRuleGroupTypeIC = (rg: unknown): rg is RuleGroupTypeIC =>\n  isRuleGroup(rg) && rg.combinator === undefined;\n","// All code in this file is adapted from:\n// npm: https://www.npmjs.com/package/ts-extras\n// src: https://github.com/sindresorhus/ts-extras\n\n/**\n * Original looked like this (not sure why template string is used):\n * ```\n * type ObjectKeys<T extends object> = `${Exclude<keyof T, symbol>}`;\n * ```\n */\ntype ObjectKeys<T extends object> = Exclude<keyof T, symbol>;\n\n/**\n * A strongly-typed version of `Object.keys()`.\n *\n * [Original source](https://github.com/sindresorhus/ts-extras/blob/44f57392c5f027268330771996c4fdf9260b22d6/source/object-keys.ts)\n */\nexport const objectKeys = Object.keys as <Type extends object>(\n  value: Type\n) => Array<ObjectKeys<Type>>;\n\n/**\n * A strongly-typed version of `Object.entries()`.\n *\n * [Original source](https://github.com/sindresorhus/ts-extras/blob/44f57392c5f027268330771996c4fdf9260b22d6/source/object-entries.ts)\n */\nexport const objectEntries = Object.entries as <Type extends Record<PropertyKey, unknown>>(\n  value: Type\n) => Array<[ObjectKeys<Type>, Type[ObjectKeys<Type>]]>;\n\n/**\n * Returns `true` if the key could cause prototype pollution when used\n * as a property name in bracket-notation assignment.\n */\nexport const isUnsafeKey = (key: unknown): boolean =>\n  key === '__proto__' || key === 'constructor' || key === 'prototype';\n"],"mappings":";;;;;;AAMA,MAAa,MAAS,MAAa,OAAO,MAAM,WAAY,EAAE,aAAa,GAAS;;;;;AAMpF,MAAaA,iBAAuB,IAAI,OACtCC,aAAqB,OAAO,QAAQ,OAAO,OAAO,GAAG,OAAO,CAAC,QAAQ,OAAO,OAAO,GAAG,OAAO,CAC9F;;;;AAMD,MAAa,UAAU,QACrB,QAAQ,QAAQ,OAAO,QAAQ,WAAW,QAAQ,OAAO,eAAe,IAAI,KAAK,OAAO;;;;AAK1F,MAAa,0BAA0B,UACrC,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU;;;;;;ACfrD,MAAa,eAAe,OAC1B,OAAO,GAAG,IAAI,MAAM,QAAQ,GAAG,MAAM;;;;AAKvC,MAAa,mBAAmB,OAC9B,YAAY,GAAG,IAAI,OAAO,GAAG,eAAe;;;;AAK9C,MAAa,qBAAqB,OAChC,YAAY,GAAG,IAAI,GAAG,eAAe,KAAA;;;;;;;;ACRvC,MAAa,aAAa,OAAO;;;;;AAiBjC,MAAa,eAAe,QAC1B,QAAQ,eAAe,QAAQ,iBAAiB,QAAQ"}

package/dist/parseCEL.d.mts

@@ -1,5 +1,5 @@
-import { C as Except, _ as RuleGroupType, d as DefaultRuleGroupTypeIC, g as DefaultRuleGroupType, h as DefaultOperatorName, m as DefaultCombinatorName, p as RuleGroupTypeIC, v as RuleType } from "./basic-CNIjb6rI.mjs";
-import { t as ParserCommonOptions } from "./import-Bltb2mT4.mjs";
+import { C as RuleGroupTypeIC, D as RuleGroupType, E as DefaultRuleGroupType, O as RuleType, T as DefaultOperatorName, j as Except, w as DefaultCombinatorName, x as DefaultRuleGroupTypeIC } from "./index-Lht_Wq3V.mjs";
+import { t as ParserCommonOptions } from "./import-0wp72lLT.mjs";
 
 //#region src/utils/parseCEL/types.d.ts
 type CELExpressionType = "Addition" | "BooleanLiteral" | "BytesLiteral" | "ConditionalAnd" | "ConditionalExpr" | "ConditionalOr" | "Division" | "DynamicPropertyAccessor" | "ExpressionGroup" | "ExpressionList" | "FieldInit" | "FieldInits" | "FieldsObject" | "FloatLiteral" | "FunctionCall" | "Identifier" | "IntegerLiteral" | "List" | "Map" | "MapInit" | "MapInits" | "Member" | "Modulo" | "Multiplication" | "Negation" | "Negative" | "NullLiteral" | "Property" | "Relation" | "StringLiteral" | "Subtraction" | "Unary" | "UnsignedIntegerLiteral" | "LikeExpression" | "SubqueryExpression";