@frt-platform/report-core 1.2.1 → 1.4.0

package/dist/index.d.mts

@@ -68,80 +68,36 @@ declare const ReportTemplateSchemaValidator: z.ZodObject<{
 }>;
 type ReportTemplateSchema = z.infer<typeof ReportTemplateSchemaValidator>;
 
-declare const DEFAULT_FIELD_LABEL = "Untitled question";
-declare const CORE_FIELD_DEFAULTS: Record<ReportTemplateFieldType, Record<string, unknown>>;
-
-declare function createUniqueId(prefix: string, existing: Iterable<string>): string;
-
 declare function migrateLegacySchema(raw: unknown): unknown;
 
 declare function normalizeReportTemplateSchema(schema: ReportTemplateSchema): ReportTemplateSchema;
 declare function parseReportTemplateSchema(raw: unknown): ReportTemplateSchema;
 declare function parseReportTemplateSchemaFromString(raw: string): ReportTemplateSchema;
-declare function serializeReportTemplateSchema(schema: ReportTemplateSchema): string;
-
-declare function buildBaseFieldSchema(field: ReportTemplateField): ZodTypeAny;
-declare function buildResponseSchemaWithConditions(template: ReportTemplateSchema, response: Record<string, any>): z.ZodObject<Record<string, ZodTypeAny>>;
-declare function validateReportResponse(template: ReportTemplateSchema, data: unknown): Record<string, unknown>;
-type FieldErrorCode = "response.invalid_root" | "field.required" | "field.invalid_type" | "field.too_small" | "field.too_big" | "field.invalid_option" | "field.custom";
-interface ResponseFieldError {
-    /** field id (template-level id) */
-    fieldId: string;
-    /** section id that owns this field (if known) */
-    sectionId?: string;
-    /** section title (if available in template) */
-    sectionTitle?: string;
-    /** human label of the field */
-    label?: string;
-    /** normalized error code */
-    code: FieldErrorCode;
-    /** human-readable message (already enriched with section / label) */
-    message: string;
-    /** original Zod issue (for debugging / logging) */
-    rawIssue?: ZodIssue;
+interface SerializeOptions {
+    /**
+     * If true (default), output human-readable JSON with 2-space indentation.
+     * If false, output a compact single-line JSON string.
+     */
+    pretty?: boolean;
+    /**
+     * If true, sections will be sorted by their `id` before serialization.
+     * This is useful for deterministic diffs across environments.
+     */
+    sortSectionsById?: boolean;
+    /**
+     * If true, fields within each section will be sorted by their `id`
+     * before serialization. Also useful for stable diffs.
+     */
+    sortFieldsById?: boolean;
 }
 /**
- * Validates a response against a template, but instead of throwing,
- * returns a structured error object with:
- *  - section title
- *  - field label
- *  - normalized error code
+ * Serialize a template schema into JSON.
  *
- * Ideal for UI error display.
+ * - Optional pretty-printing (default: true)
+ * - Optional deterministic sorting of sections and fields by ID
+ *   to make git diffs and code reviews cleaner.
  */
-declare function validateReportResponseDetailed(template: ReportTemplateSchema, data: unknown): {
-    success: true;
-    value: Record<string, unknown>;
-} | {
-    success: false;
-    errors: ResponseFieldError[];
-};
-type TemplateFieldUnion<TTemplate> = TTemplate extends {
-    sections: readonly (infer S)[];
-} ? S extends {
-    fields: readonly (infer F)[];
-} ? F : never : never;
-type BaseFieldValue<TField extends {
-    type: ReportTemplateFieldType;
-    required?: boolean;
-    options?: readonly string[] | string[];
-}> = TField["type"] extends "shortText" | "longText" ? string : TField["type"] extends "number" ? number : TField["type"] extends "date" ? string : TField["type"] extends "checkbox" ? boolean : TField["type"] extends "singleSelect" ? (TField["options"] extends readonly (infer O)[] ? O : TField["options"] extends (infer O)[] ? O : string) : TField["type"] extends "multiSelect" ? (TField["options"] extends readonly (infer O)[] ? O[] : TField["options"] extends (infer O)[] ? O[] : string[]) : unknown;
-type FieldResponseValue<TField extends {
-    type: ReportTemplateFieldType;
-    required?: boolean;
-}> = TField["required"] extends true ? BaseFieldValue<TField> : BaseFieldValue<TField> | undefined;
-type InferResponse<TTemplate extends {
-    sections: readonly {
-        fields: readonly {
-            id: string;
-            type: ReportTemplateFieldType;
-            required?: boolean;
-            options?: readonly string[] | string[];
-        }[];
-    }[];
-}> = {
-    [F in TemplateFieldUnion<TTemplate> as F["id"]]: FieldResponseValue<F>;
-};
+declare function serializeReportTemplateSchema(schema: ReportTemplateSchema, options?: SerializeOptions): string;
 
 interface TemplateDiff {
     addedSections: Array<{
@@ -201,6 +157,53 @@ interface TemplateDiff {
 }
 declare function diffTemplates(before: ReportTemplateSchema, after: ReportTemplateSchema): TemplateDiff;
 
+/**
+ * Minimal JSON Schema type for our purposes.
+ * Flexible, with an index signature to allow vendor extensions (x-frt-*).
+ */
+interface JSONSchema {
+    $schema?: string;
+    $id?: string;
+    type?: "object" | "string" | "number" | "boolean" | "array" | "null";
+    properties?: Record<string, JSONSchema>;
+    items?: JSONSchema;
+    required?: string[];
+    enum?: any[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    description?: string;
+    title?: string;
+    default?: any;
+    format?: string;
+    additionalProperties?: boolean;
+    [key: string]: any;
+}
+/**
+ * Export a report template as a JSON Schema "object" definition.
+ *
+ * - Each field becomes a property keyed by its `id`
+ * - Unconditional `required: true` fields are added to the JSON Schema `required` array
+ * - Conditional logic is preserved via `x-frt-visibleIf` / `x-frt-requiredIf`
+ *   but NOT enforced in the core JSON Schema (since it's beyond standard JSON Schema).
+ */
+declare function exportJSONSchema(template: ReportTemplateSchema): JSONSchema;
+
+declare const DEFAULT_FIELD_LABEL = "Untitled question";
+declare const CORE_FIELD_DEFAULTS: Record<ReportTemplateFieldType, Record<string, unknown>>;
+
+/**
+ * Helper for generating a unique id in a *local* namespace, typically in
+ * UI/builders when adding new sections/fields client-side.
+ *
+ * Note: Core template normalization uses its own normalizeId/ensureUniqueId
+ * logic so that persisted IDs stay stable and backwards compatible.
+ */
+declare function createUniqueId(prefix: string, existing: Iterable<string>): string;
+
 /** -------------------------------------------------------------
  * FieldRegistryEntry
  * --------------------------------------------------------------
@@ -250,39 +253,90 @@ declare const FieldRegistry: FieldRegistryClass;
  */
 declare function evaluateCondition(condition: SimpleCondition, response: Record<string, any>): boolean;
 
+declare function buildBaseFieldSchema(field: ReportTemplateField): ZodTypeAny;
+declare function buildResponseSchemaWithConditions(template: ReportTemplateSchema, response: Record<string, any>): z.ZodObject<Record<string, ZodTypeAny>>;
 /**
- * Minimal JSON Schema type for our purposes.
- * Flexible, with an index signature to allow vendor extensions (x-frt-*).
+ * Build a Zod object schema for a template *without* needing a response object.
+ *
+ * Notes:
+ * - All conditional logic is evaluated against an empty response `{}`.
+ * - This means:
+ *   - `visibleIf` / `requiredIf` that depend on other fields will typically
+ *     evaluate to false.
+ *
+ * This is mainly useful for:
+ * - Static type inference
+ * - Generic tooling / OpenAPI style usage
+ * - Situations where you just want the overall "shape" of a response.
  */
-interface JSONSchema {
-    $schema?: string;
-    $id?: string;
-    type?: "object" | "string" | "number" | "boolean" | "array" | "null";
-    properties?: Record<string, JSONSchema>;
-    items?: JSONSchema;
-    required?: string[];
-    enum?: any[];
-    minLength?: number;
-    maxLength?: number;
-    minimum?: number;
-    maximum?: number;
-    minItems?: number;
-    maxItems?: number;
-    description?: string;
-    title?: string;
-    default?: any;
-    format?: string;
-    additionalProperties?: boolean;
-    [key: string]: any;
+declare function buildResponseSchema(template: ReportTemplateSchema): z.ZodObject<Record<string, ZodTypeAny>>;
+declare function validateReportResponse(template: ReportTemplateSchema, data: unknown): Record<string, unknown>;
+type FieldErrorCode = "response.invalid_root" | "field.required" | "field.invalid_type" | "field.too_small" | "field.too_big" | "field.invalid_option" | "field.custom";
+interface ResponseFieldError {
+    /** field id (template-level id) */
+    fieldId: string;
+    /** section id that owns this field (if known) */
+    sectionId?: string;
+    /** section title (if available in template) */
+    sectionTitle?: string;
+    /** human label of the field */
+    label?: string;
+    /** normalized error code */
+    code: FieldErrorCode;
+    /** human-readable message (already enriched with section / label) */
+    message: string;
+    /** original Zod issue (for debugging / logging) */
+    rawIssue?: ZodIssue;
 }
 /**
- * Export a report template as a JSON Schema "object" definition.
+ * Validates a response against a template, but instead of throwing,
+ * returns a structured error object with:
+ *  - section title
+ *  - field label
+ *  - normalized error code
  *
- * - Each field becomes a property keyed by its `id`
- * - Unconditional `required: true` fields are added to the JSON Schema `required` array
- * - Conditional logic is preserved via `x-frt-visibleIf` / `x-frt-requiredIf`
- *   but NOT enforced in the core JSON Schema (since it's beyond standard JSON Schema).
+ * Ideal for UI error display.
  */
-declare function exportJSONSchema(template: ReportTemplateSchema): JSONSchema;
+declare function validateReportResponseDetailed(template: ReportTemplateSchema, data: unknown): {
+    success: true;
+    value: Record<string, unknown>;
+} | {
+    success: false;
+    errors: ResponseFieldError[];
+};
+/**
+ * Helper to turn a thrown ZodError (e.g. from validateReportResponse)
+ * into the same ResponseFieldError[] shape used by
+ * validateReportResponseDetailed.
+ *
+ * Returns null if the error is not a ZodError.
+ */
+declare function explainValidationError(template: ReportTemplateSchema, error: unknown): ResponseFieldError[] | null;
+type TemplateFieldUnion<TTemplate> = TTemplate extends {
+    sections: readonly (infer S)[];
+} ? S extends {
+    fields: readonly (infer F)[];
+} ? F : never : never;
+type BaseFieldValue<TField extends {
+    type: ReportTemplateFieldType;
+    required?: boolean;
+    options?: readonly string[] | string[];
+}> = TField["type"] extends "shortText" | "longText" ? string : TField["type"] extends "number" ? number : TField["type"] extends "date" ? string : TField["type"] extends "checkbox" ? boolean : TField["type"] extends "singleSelect" ? (TField["options"] extends readonly (infer O)[] ? O : TField["options"] extends (infer O)[] ? O : string) : TField["type"] extends "multiSelect" ? (TField["options"] extends readonly (infer O)[] ? O[] : TField["options"] extends (infer O)[] ? O[] : string[]) : TField["type"] extends "repeatGroup" ? Array<Record<string, unknown>> : unknown;
+type FieldResponseValue<TField extends {
+    type: ReportTemplateFieldType;
+    required?: boolean;
+}> = TField["required"] extends true ? BaseFieldValue<TField> : BaseFieldValue<TField> | undefined;
+type InferResponse<TTemplate extends {
+    sections: readonly {
+        fields: readonly {
+            id: string;
+            type: ReportTemplateFieldType;
+            required?: boolean;
+            options?: readonly string[] | string[];
+        }[];
+    }[];
+}> = {
+    [F in TemplateFieldUnion<TTemplate> as F["id"]]: FieldResponseValue<F>;
+};
 
-export { CORE_FIELD_DEFAULTS, Condition, DEFAULT_FIELD_LABEL, type FieldErrorCode, FieldRegistry, type FieldRegistryEntry, type InferResponse, type JSONSchema, REPORT_TEMPLATE_FIELD_TYPES, REPORT_TEMPLATE_VERSION, RepeatGroupFieldSchema, type ReportTemplateField, ReportTemplateFieldSchema, type ReportTemplateFieldType, type ReportTemplateSchema, ReportTemplateSchemaValidator, type ReportTemplateSection, ReportTemplateSectionSchema, type ResponseFieldError, type SimpleCondition, type TemplateDiff, buildBaseFieldSchema, buildResponseSchemaWithConditions, createUniqueId, diffTemplates, evaluateCondition, exportJSONSchema, migrateLegacySchema, normalizeReportTemplateSchema, parseReportTemplateSchema, parseReportTemplateSchemaFromString, serializeReportTemplateSchema, validateReportResponse, validateReportResponseDetailed };
+export { CORE_FIELD_DEFAULTS, Condition, DEFAULT_FIELD_LABEL, type FieldErrorCode, FieldRegistry, type FieldRegistryEntry, type InferResponse, type JSONSchema, REPORT_TEMPLATE_FIELD_TYPES, REPORT_TEMPLATE_VERSION, RepeatGroupFieldSchema, type ReportTemplateField, ReportTemplateFieldSchema, type ReportTemplateFieldType, type ReportTemplateSchema, ReportTemplateSchemaValidator, type ReportTemplateSection, ReportTemplateSectionSchema, type ResponseFieldError, type SerializeOptions, type SimpleCondition, type TemplateDiff, buildBaseFieldSchema, buildResponseSchema, buildResponseSchemaWithConditions, createUniqueId, diffTemplates, evaluateCondition, explainValidationError, exportJSONSchema, migrateLegacySchema, normalizeReportTemplateSchema, parseReportTemplateSchema, parseReportTemplateSchemaFromString, serializeReportTemplateSchema, validateReportResponse, validateReportResponseDetailed };

package/dist/index.d.ts

@@ -68,80 +68,36 @@ declare const ReportTemplateSchemaValidator: z.ZodObject<{
 }>;
 type ReportTemplateSchema = z.infer<typeof ReportTemplateSchemaValidator>;
 
-declare const DEFAULT_FIELD_LABEL = "Untitled question";
-declare const CORE_FIELD_DEFAULTS: Record<ReportTemplateFieldType, Record<string, unknown>>;
-
-declare function createUniqueId(prefix: string, existing: Iterable<string>): string;
-
 declare function migrateLegacySchema(raw: unknown): unknown;
 
 declare function normalizeReportTemplateSchema(schema: ReportTemplateSchema): ReportTemplateSchema;
 declare function parseReportTemplateSchema(raw: unknown): ReportTemplateSchema;
 declare function parseReportTemplateSchemaFromString(raw: string): ReportTemplateSchema;
-declare function serializeReportTemplateSchema(schema: ReportTemplateSchema): string;
-
-declare function buildBaseFieldSchema(field: ReportTemplateField): ZodTypeAny;
-declare function buildResponseSchemaWithConditions(template: ReportTemplateSchema, response: Record<string, any>): z.ZodObject<Record<string, ZodTypeAny>>;
-declare function validateReportResponse(template: ReportTemplateSchema, data: unknown): Record<string, unknown>;
-type FieldErrorCode = "response.invalid_root" | "field.required" | "field.invalid_type" | "field.too_small" | "field.too_big" | "field.invalid_option" | "field.custom";
-interface ResponseFieldError {
-    /** field id (template-level id) */
-    fieldId: string;
-    /** section id that owns this field (if known) */
-    sectionId?: string;
-    /** section title (if available in template) */
-    sectionTitle?: string;
-    /** human label of the field */
-    label?: string;
-    /** normalized error code */
-    code: FieldErrorCode;
-    /** human-readable message (already enriched with section / label) */
-    message: string;
-    /** original Zod issue (for debugging / logging) */
-    rawIssue?: ZodIssue;
+interface SerializeOptions {
+    /**
+     * If true (default), output human-readable JSON with 2-space indentation.
+     * If false, output a compact single-line JSON string.
+     */
+    pretty?: boolean;
+    /**
+     * If true, sections will be sorted by their `id` before serialization.
+     * This is useful for deterministic diffs across environments.
+     */
+    sortSectionsById?: boolean;
+    /**
+     * If true, fields within each section will be sorted by their `id`
+     * before serialization. Also useful for stable diffs.
+     */
+    sortFieldsById?: boolean;
 }
 /**
- * Validates a response against a template, but instead of throwing,
- * returns a structured error object with:
- *  - section title
- *  - field label
- *  - normalized error code
+ * Serialize a template schema into JSON.
  *
- * Ideal for UI error display.
+ * - Optional pretty-printing (default: true)
+ * - Optional deterministic sorting of sections and fields by ID
+ *   to make git diffs and code reviews cleaner.
  */
-declare function validateReportResponseDetailed(template: ReportTemplateSchema, data: unknown): {
-    success: true;
-    value: Record<string, unknown>;
-} | {
-    success: false;
-    errors: ResponseFieldError[];
-};
-type TemplateFieldUnion<TTemplate> = TTemplate extends {
-    sections: readonly (infer S)[];
-} ? S extends {
-    fields: readonly (infer F)[];
-} ? F : never : never;
-type BaseFieldValue<TField extends {
-    type: ReportTemplateFieldType;
-    required?: boolean;
-    options?: readonly string[] | string[];
-}> = TField["type"] extends "shortText" | "longText" ? string : TField["type"] extends "number" ? number : TField["type"] extends "date" ? string : TField["type"] extends "checkbox" ? boolean : TField["type"] extends "singleSelect" ? (TField["options"] extends readonly (infer O)[] ? O : TField["options"] extends (infer O)[] ? O : string) : TField["type"] extends "multiSelect" ? (TField["options"] extends readonly (infer O)[] ? O[] : TField["options"] extends (infer O)[] ? O[] : string[]) : unknown;
-type FieldResponseValue<TField extends {
-    type: ReportTemplateFieldType;
-    required?: boolean;
-}> = TField["required"] extends true ? BaseFieldValue<TField> : BaseFieldValue<TField> | undefined;
-type InferResponse<TTemplate extends {
-    sections: readonly {
-        fields: readonly {
-            id: string;
-            type: ReportTemplateFieldType;
-            required?: boolean;
-            options?: readonly string[] | string[];
-        }[];
-    }[];
-}> = {
-    [F in TemplateFieldUnion<TTemplate> as F["id"]]: FieldResponseValue<F>;
-};
+declare function serializeReportTemplateSchema(schema: ReportTemplateSchema, options?: SerializeOptions): string;
 
 interface TemplateDiff {
     addedSections: Array<{
@@ -201,6 +157,53 @@ interface TemplateDiff {
 }
 declare function diffTemplates(before: ReportTemplateSchema, after: ReportTemplateSchema): TemplateDiff;
 
+/**
+ * Minimal JSON Schema type for our purposes.
+ * Flexible, with an index signature to allow vendor extensions (x-frt-*).
+ */
+interface JSONSchema {
+    $schema?: string;
+    $id?: string;
+    type?: "object" | "string" | "number" | "boolean" | "array" | "null";
+    properties?: Record<string, JSONSchema>;
+    items?: JSONSchema;
+    required?: string[];
+    enum?: any[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    description?: string;
+    title?: string;
+    default?: any;
+    format?: string;
+    additionalProperties?: boolean;
+    [key: string]: any;
+}
+/**
+ * Export a report template as a JSON Schema "object" definition.
+ *
+ * - Each field becomes a property keyed by its `id`
+ * - Unconditional `required: true` fields are added to the JSON Schema `required` array
+ * - Conditional logic is preserved via `x-frt-visibleIf` / `x-frt-requiredIf`
+ *   but NOT enforced in the core JSON Schema (since it's beyond standard JSON Schema).
+ */
+declare function exportJSONSchema(template: ReportTemplateSchema): JSONSchema;
+
+declare const DEFAULT_FIELD_LABEL = "Untitled question";
+declare const CORE_FIELD_DEFAULTS: Record<ReportTemplateFieldType, Record<string, unknown>>;
+
+/**
+ * Helper for generating a unique id in a *local* namespace, typically in
+ * UI/builders when adding new sections/fields client-side.
+ *
+ * Note: Core template normalization uses its own normalizeId/ensureUniqueId
+ * logic so that persisted IDs stay stable and backwards compatible.
+ */
+declare function createUniqueId(prefix: string, existing: Iterable<string>): string;
+
 /** -------------------------------------------------------------
  * FieldRegistryEntry
  * --------------------------------------------------------------
@@ -250,39 +253,90 @@ declare const FieldRegistry: FieldRegistryClass;
  */
 declare function evaluateCondition(condition: SimpleCondition, response: Record<string, any>): boolean;
 
+declare function buildBaseFieldSchema(field: ReportTemplateField): ZodTypeAny;
+declare function buildResponseSchemaWithConditions(template: ReportTemplateSchema, response: Record<string, any>): z.ZodObject<Record<string, ZodTypeAny>>;
 /**
- * Minimal JSON Schema type for our purposes.
- * Flexible, with an index signature to allow vendor extensions (x-frt-*).
+ * Build a Zod object schema for a template *without* needing a response object.
+ *
+ * Notes:
+ * - All conditional logic is evaluated against an empty response `{}`.
+ * - This means:
+ *   - `visibleIf` / `requiredIf` that depend on other fields will typically
+ *     evaluate to false.
+ *
+ * This is mainly useful for:
+ * - Static type inference
+ * - Generic tooling / OpenAPI style usage
+ * - Situations where you just want the overall "shape" of a response.
  */
-interface JSONSchema {
-    $schema?: string;
-    $id?: string;
-    type?: "object" | "string" | "number" | "boolean" | "array" | "null";
-    properties?: Record<string, JSONSchema>;
-    items?: JSONSchema;
-    required?: string[];
-    enum?: any[];
-    minLength?: number;
-    maxLength?: number;
-    minimum?: number;
-    maximum?: number;
-    minItems?: number;
-    maxItems?: number;
-    description?: string;
-    title?: string;
-    default?: any;
-    format?: string;
-    additionalProperties?: boolean;
-    [key: string]: any;
+declare function buildResponseSchema(template: ReportTemplateSchema): z.ZodObject<Record<string, ZodTypeAny>>;
+declare function validateReportResponse(template: ReportTemplateSchema, data: unknown): Record<string, unknown>;
+type FieldErrorCode = "response.invalid_root" | "field.required" | "field.invalid_type" | "field.too_small" | "field.too_big" | "field.invalid_option" | "field.custom";
+interface ResponseFieldError {
+    /** field id (template-level id) */
+    fieldId: string;
+    /** section id that owns this field (if known) */
+    sectionId?: string;
+    /** section title (if available in template) */
+    sectionTitle?: string;
+    /** human label of the field */
+    label?: string;
+    /** normalized error code */
+    code: FieldErrorCode;
+    /** human-readable message (already enriched with section / label) */
+    message: string;
+    /** original Zod issue (for debugging / logging) */
+    rawIssue?: ZodIssue;
 }
 /**
- * Export a report template as a JSON Schema "object" definition.
+ * Validates a response against a template, but instead of throwing,
+ * returns a structured error object with:
+ *  - section title
+ *  - field label
+ *  - normalized error code
  *
- * - Each field becomes a property keyed by its `id`
- * - Unconditional `required: true` fields are added to the JSON Schema `required` array
- * - Conditional logic is preserved via `x-frt-visibleIf` / `x-frt-requiredIf`
- *   but NOT enforced in the core JSON Schema (since it's beyond standard JSON Schema).
+ * Ideal for UI error display.
  */
-declare function exportJSONSchema(template: ReportTemplateSchema): JSONSchema;
+declare function validateReportResponseDetailed(template: ReportTemplateSchema, data: unknown): {
+    success: true;
+    value: Record<string, unknown>;
+} | {
+    success: false;
+    errors: ResponseFieldError[];
+};
+/**
+ * Helper to turn a thrown ZodError (e.g. from validateReportResponse)
+ * into the same ResponseFieldError[] shape used by
+ * validateReportResponseDetailed.
+ *
+ * Returns null if the error is not a ZodError.
+ */
+declare function explainValidationError(template: ReportTemplateSchema, error: unknown): ResponseFieldError[] | null;
+type TemplateFieldUnion<TTemplate> = TTemplate extends {
+    sections: readonly (infer S)[];
+} ? S extends {
+    fields: readonly (infer F)[];
+} ? F : never : never;
+type BaseFieldValue<TField extends {
+    type: ReportTemplateFieldType;
+    required?: boolean;
+    options?: readonly string[] | string[];
+}> = TField["type"] extends "shortText" | "longText" ? string : TField["type"] extends "number" ? number : TField["type"] extends "date" ? string : TField["type"] extends "checkbox" ? boolean : TField["type"] extends "singleSelect" ? (TField["options"] extends readonly (infer O)[] ? O : TField["options"] extends (infer O)[] ? O : string) : TField["type"] extends "multiSelect" ? (TField["options"] extends readonly (infer O)[] ? O[] : TField["options"] extends (infer O)[] ? O[] : string[]) : TField["type"] extends "repeatGroup" ? Array<Record<string, unknown>> : unknown;
+type FieldResponseValue<TField extends {
+    type: ReportTemplateFieldType;
+    required?: boolean;
+}> = TField["required"] extends true ? BaseFieldValue<TField> : BaseFieldValue<TField> | undefined;
+type InferResponse<TTemplate extends {
+    sections: readonly {
+        fields: readonly {
+            id: string;
+            type: ReportTemplateFieldType;
+            required?: boolean;
+            options?: readonly string[] | string[];
+        }[];
+    }[];
+}> = {
+    [F in TemplateFieldUnion<TTemplate> as F["id"]]: FieldResponseValue<F>;
+};
 
-export { CORE_FIELD_DEFAULTS, Condition, DEFAULT_FIELD_LABEL, type FieldErrorCode, FieldRegistry, type FieldRegistryEntry, type InferResponse, type JSONSchema, REPORT_TEMPLATE_FIELD_TYPES, REPORT_TEMPLATE_VERSION, RepeatGroupFieldSchema, type ReportTemplateField, ReportTemplateFieldSchema, type ReportTemplateFieldType, type ReportTemplateSchema, ReportTemplateSchemaValidator, type ReportTemplateSection, ReportTemplateSectionSchema, type ResponseFieldError, type SimpleCondition, type TemplateDiff, buildBaseFieldSchema, buildResponseSchemaWithConditions, createUniqueId, diffTemplates, evaluateCondition, exportJSONSchema, migrateLegacySchema, normalizeReportTemplateSchema, parseReportTemplateSchema, parseReportTemplateSchemaFromString, serializeReportTemplateSchema, validateReportResponse, validateReportResponseDetailed };
+export { CORE_FIELD_DEFAULTS, Condition, DEFAULT_FIELD_LABEL, type FieldErrorCode, FieldRegistry, type FieldRegistryEntry, type InferResponse, type JSONSchema, REPORT_TEMPLATE_FIELD_TYPES, REPORT_TEMPLATE_VERSION, RepeatGroupFieldSchema, type ReportTemplateField, ReportTemplateFieldSchema, type ReportTemplateFieldType, type ReportTemplateSchema, ReportTemplateSchemaValidator, type ReportTemplateSection, ReportTemplateSectionSchema, type ResponseFieldError, type SerializeOptions, type SimpleCondition, type TemplateDiff, buildBaseFieldSchema, buildResponseSchema, buildResponseSchemaWithConditions, createUniqueId, diffTemplates, evaluateCondition, explainValidationError, exportJSONSchema, migrateLegacySchema, normalizeReportTemplateSchema, parseReportTemplateSchema, parseReportTemplateSchemaFromString, serializeReportTemplateSchema, validateReportResponse, validateReportResponseDetailed };