@react-querybuilder/core 8.14.4 → 8.16.0

package/dist/{import-BwQqExpO.d.mts → import-BHlzBLM_.d.mts}

@@ -1,4 +1,4 @@
-import { O as OptionList, v as FullField, y as ValueSources } from "./index-CYT4Saz-.mjs";
+import { b as ValueSources, k as OptionList, y as FullField } from "./index-D-Iej37L.mjs";
 
 //#region src/types/import.d.ts
 /**
@@ -24,4 +24,4 @@ interface ParserCommonOptions {
 }
 //#endregion
 export { ParserCommonOptions as t };
-//# sourceMappingURL=import-BwQqExpO.d.mts.map
+//# sourceMappingURL=import-BHlzBLM_.d.mts.map

package/dist/{import-CrJf23Nf.d.ts → import-C6imciDf.d.ts}

@@ -1,4 +1,4 @@
-import { O as OptionList, v as FullField, y as ValueSources } from "./index-DBlQeLax.js";
+import { b as ValueSources, k as OptionList, y as FullField } from "./index-Cjapnb-H.js";
 
 //#region src/types/import.d.ts
 /**
@@ -24,4 +24,4 @@ interface ParserCommonOptions {
 }
 //#endregion
 export { ParserCommonOptions as t };
-//# sourceMappingURL=import-CrJf23Nf.d.ts.map
+//# sourceMappingURL=import-C6imciDf.d.ts.map

package/dist/{index-CYT4Saz-.d.mts → index-Cjapnb-H.d.ts}

@@ -2,7 +2,7 @@ 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).
+Convert a union type to an intersection type.
 
 Inspired by [this Stack Overflow answer](https://stackoverflow.com/a/50375286/2172153).
 
@@ -899,7 +899,7 @@ type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Requ
 //#endregion
 //#region ../../node_modules/type-fest/source/set-required.d.ts
 /**
-Create a type that makes the given keys required. The remaining keys are kept as is. The sister of the `SetOptional` type.
+Create a type that makes the given keys required, while keeping the remaining keys as is.
 
 Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are required.
 
@@ -925,8 +925,8 @@ type ArrayExample = SetRequired<[number?, number?, number?], 0 | 1>;
 */
 type SetRequired<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetRequired<BaseType, Keys>;
 type _SetRequired<BaseType, Keys extends keyof BaseType> = BaseType extends UnknownArray ? SetArrayRequired<BaseType, Keys> extends infer ResultantArray ? If<IsArrayReadonly<BaseType>, Readonly<ResultantArray>, ResultantArray> : never : Simplify< // Pick just the keys that are optional from the base type.
-Except<BaseType, Keys> & // Pick the keys that should be required from the base type and make them required.
-Required<HomomorphicPick<BaseType, Keys>>>;
+Except<BaseType, Keys> // Pick the keys that should be required from the base type and make them required.
+& Required<HomomorphicPick<BaseType, Keys>>>;
 /**
 Remove the optional modifier from the specified keys in an array.
 */
@@ -1072,7 +1072,7 @@ interface CommonRuleAndGroupProperties {
 * The main rule type. The `field`, `operator`, and `value` properties
 * can be narrowed with generics.
 */
-interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string> extends CommonRuleAndGroupProperties {
+interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string, M = Record<string, any>> extends CommonRuleAndGroupProperties {
   field: F;
   operator: O;
   value: V;
@@ -1082,6 +1082,13 @@ interface RuleType<F extends string = string, O extends string = string, V = any
   * Only used when adding a rule to a query that uses independent combinators.
   */
   combinatorPreceding?: C;
+  /**
+  * Opaque metadata for use by extension packages. The core library
+  * preserves this property but does not read or interpret it.
+  * Extensions like `@react-querybuilder/graph` use `meta` to store
+  * domain-specific context (e.g., graph pattern information).
+  */
+  meta?: M;
 }
 /**
 * The main rule group type. This type is used for query definitions as well as
@@ -1216,7 +1223,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;
 };
@@ -1304,13 +1311,13 @@ type ParseNumbersPropConfig = boolean | `${ParseNumberMethodName}${ParseNumbersM
 *
 * @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";
+type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "prisma" | "sequelize" | "cypher" | "gql" | "sparql" | "gremlin" | "diagnostics";
 /**
 * Export formats for {@link formatQuery} that produce objects instead of strings.
 *
 * @group Export
 */
-type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query";
+type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query" | "diagnostics";
 /**
 * Available presets for the "sql" export format.
 *
@@ -1685,6 +1692,150 @@ interface ParameterizedNamedSQL {
   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 {
@@ -1744,5 +1895,5 @@ type NLTranslationKey = "and" | "or" | "true" | "false" | `groupPrefix${ZeroOrMo
 */
 type NLTranslations = Partial<Record<NLTranslationKey, string>>;
 //#endregion
-export { Except as A, DefaultCombinatorName as C, RuleType as D, RuleGroupType as E, OptionList as O, RuleGroupTypeIC as S, DefaultRuleGroupType as T, ValueProcessorOptions as _, FormatQueryOptions as a, DefaultRuleGroupTypeIC as b, NLTranslations as c, RQBJsonLogic as d, RuleGroupProcessor as f, ValueProcessorLegacy as g, ValueProcessorByRule as h, ExportOperatorMap as i, SetRequired as k, ParameterizedNamedSQL as l, SQLPreset as m, ExportFormat as n, GroupVariantCondition as o, RuleProcessor as p, ExportObjectFormats as r, NLTranslationKey as s, ConstituentWordOrder as t, ParameterizedSQL as u, FullField as v, DefaultOperatorName as w, RuleGroupTypeAny as x, ValueSources as y };
-//# sourceMappingURL=index-CYT4Saz-.d.mts.map
+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-Cjapnb-H.d.ts.map

package/dist/{index-DBlQeLax.d.ts → index-D-Iej37L.d.mts}

@@ -2,7 +2,7 @@ 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).
+Convert a union type to an intersection type.
 
 Inspired by [this Stack Overflow answer](https://stackoverflow.com/a/50375286/2172153).
 
@@ -899,7 +899,7 @@ type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Requ
 //#endregion
 //#region ../../node_modules/type-fest/source/set-required.d.ts
 /**
-Create a type that makes the given keys required. The remaining keys are kept as is. The sister of the `SetOptional` type.
+Create a type that makes the given keys required, while keeping the remaining keys as is.
 
 Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are required.
 
@@ -925,8 +925,8 @@ type ArrayExample = SetRequired<[number?, number?, number?], 0 | 1>;
 */
 type SetRequired<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetRequired<BaseType, Keys>;
 type _SetRequired<BaseType, Keys extends keyof BaseType> = BaseType extends UnknownArray ? SetArrayRequired<BaseType, Keys> extends infer ResultantArray ? If<IsArrayReadonly<BaseType>, Readonly<ResultantArray>, ResultantArray> : never : Simplify< // Pick just the keys that are optional from the base type.
-Except<BaseType, Keys> & // Pick the keys that should be required from the base type and make them required.
-Required<HomomorphicPick<BaseType, Keys>>>;
+Except<BaseType, Keys> // Pick the keys that should be required from the base type and make them required.
+& Required<HomomorphicPick<BaseType, Keys>>>;
 /**
 Remove the optional modifier from the specified keys in an array.
 */
@@ -1072,7 +1072,7 @@ interface CommonRuleAndGroupProperties {
 * The main rule type. The `field`, `operator`, and `value` properties
 * can be narrowed with generics.
 */
-interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string> extends CommonRuleAndGroupProperties {
+interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string, M = Record<string, any>> extends CommonRuleAndGroupProperties {
   field: F;
   operator: O;
   value: V;
@@ -1082,6 +1082,13 @@ interface RuleType<F extends string = string, O extends string = string, V = any
   * Only used when adding a rule to a query that uses independent combinators.
   */
   combinatorPreceding?: C;
+  /**
+  * Opaque metadata for use by extension packages. The core library
+  * preserves this property but does not read or interpret it.
+  * Extensions like `@react-querybuilder/graph` use `meta` to store
+  * domain-specific context (e.g., graph pattern information).
+  */
+  meta?: M;
 }
 /**
 * The main rule group type. This type is used for query definitions as well as
@@ -1216,7 +1223,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;
 };
@@ -1304,13 +1311,13 @@ type ParseNumbersPropConfig = boolean | `${ParseNumberMethodName}${ParseNumbersM
 *
 * @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";
+type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "prisma" | "sequelize" | "cypher" | "gql" | "sparql" | "gremlin" | "diagnostics";
 /**
 * Export formats for {@link formatQuery} that produce objects instead of strings.
 *
 * @group Export
 */
-type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query";
+type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query" | "diagnostics";
 /**
 * Available presets for the "sql" export format.
 *
@@ -1685,6 +1692,150 @@ interface ParameterizedNamedSQL {
   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 {
@@ -1744,5 +1895,5 @@ type NLTranslationKey = "and" | "or" | "true" | "false" | `groupPrefix${ZeroOrMo
 */
 type NLTranslations = Partial<Record<NLTranslationKey, string>>;
 //#endregion
-export { Except as A, DefaultCombinatorName as C, RuleType as D, RuleGroupType as E, OptionList as O, RuleGroupTypeIC as S, DefaultRuleGroupType as T, ValueProcessorOptions as _, FormatQueryOptions as a, DefaultRuleGroupTypeIC as b, NLTranslations as c, RQBJsonLogic as d, RuleGroupProcessor as f, ValueProcessorLegacy as g, ValueProcessorByRule as h, ExportOperatorMap as i, SetRequired as k, ParameterizedNamedSQL as l, SQLPreset as m, ExportFormat as n, GroupVariantCondition as o, RuleProcessor as p, ExportObjectFormats as r, NLTranslationKey as s, ConstituentWordOrder as t, ParameterizedSQL as u, FullField as v, DefaultOperatorName as w, RuleGroupTypeAny as x, ValueSources as y };
-//# sourceMappingURL=index-DBlQeLax.d.ts.map
+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-D-Iej37L.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 { A as Except, C as DefaultCombinatorName, D as RuleType, E as RuleGroupType, S as RuleGroupTypeIC, T as DefaultRuleGroupType, b as DefaultRuleGroupTypeIC, w as DefaultOperatorName } from "./index-CYT4Saz-.mjs";
-import { t as ParserCommonOptions } from "./import-BwQqExpO.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-D-Iej37L.mjs";
+import { t as ParserCommonOptions } from "./import-BHlzBLM_.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";

package/dist/parseCEL.d.ts

@@ -1,5 +1,5 @@
-import { A as Except, C as DefaultCombinatorName, D as RuleType, E as RuleGroupType, S as RuleGroupTypeIC, T as DefaultRuleGroupType, b as DefaultRuleGroupTypeIC, w as DefaultOperatorName } from "./index-DBlQeLax.js";
-import { t as ParserCommonOptions } from "./import-CrJf23Nf.js";
+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-Cjapnb-H.js";
+import { t as ParserCommonOptions } from "./import-C6imciDf.js";
 
 //#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";