@vertesia/ui 1.5.0-dev.20260826.064249Z → 1.5.0-dev.20260901.033115Z

package/src/features/store/types/IntakePolicyForm.tsx

@@ -4,7 +4,17 @@ import type {
     IntakeVisionDetail,
     InteractionExecutionConfiguration,
 } from '@vertesia/common';
-import { Button, FormItem, Input, NumberInput, SelectBox, TagsInput, Textarea, VTooltip } from '@vertesia/ui/core';
+import {
+    Button,
+    FormItem,
+    InfoTip,
+    Input,
+    NumberInput,
+    SelectBox,
+    TagsInput,
+    Textarea,
+    VTooltip,
+} from '@vertesia/ui/core';
 import { useUITranslation } from '@vertesia/ui/i18n';
 import { Plus, Trash2 } from 'lucide-react';
 import type { ReactNode } from 'react';
@@ -38,7 +48,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
     if (section === 'overview') {
         return (
             <FormSurface>
-                <FormSection title={t('intakePolicy.section.classification')}>
+                <FormSection
+                    title={t('intakePolicy.section.classification')}
+                    description={t('intakePolicy.help.section.classification')}
+                >
                     <div className="grid gap-4 md:grid-cols-2">
                         <SelectField
                             label={t('intakePolicy.field.mode')}
@@ -65,6 +78,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     />
                     <TextAreaField
                         label={t('intakePolicy.field.distinguishFrom')}
+                        description={t('intakePolicy.help.distinguishFrom')}
                         value={policy.identification?.distinguish_from}
                         onChange={(value) => setValue(['identification', 'distinguish_from'], value)}
                         readonly={readonly}
@@ -86,7 +100,11 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     </FormItem>
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.locate')} last>
+                <FormSection
+                    title={t('intakePolicy.section.locate')}
+                    description={t('intakePolicy.help.section.locate')}
+                    last
+                >
                     <TextAreaField
                         label={t('intakePolicy.field.locateInstructions')}
                         description={t('intakePolicy.help.locateInstructions')}
@@ -99,6 +117,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     <div className="grid gap-4 md:grid-cols-2">
                         <SelectField
                             label={t('intakePolicy.field.contactSheetDetail')}
+                            description={t('intakePolicy.help.contactSheetDetail')}
                             value={policy.locate?.detail}
                             options={[
                                 { value: 8, label: t('intakePolicy.option.pagesPerSheet', { count: 8 }) },
@@ -109,6 +128,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.locateMinPages')}
+                            description={t('intakePolicy.help.locateMinPages')}
                             value={policy.locate?.min_pages}
                             min={0}
                             onChange={(value) => setValue(['locate', 'min_pages'], value)}
@@ -123,7 +143,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
     if (section === 'conversion') {
         return (
             <FormSurface>
-                <FormSection title={t('intakePolicy.section.conversion')}>
+                <FormSection
+                    title={t('intakePolicy.section.conversion')}
+                    description={t('intakePolicy.help.section.conversion')}
+                >
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
                         <TriStateField
                             label={t('intakePolicy.field.enabled')}
@@ -133,6 +156,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <SelectField
                             label={t('intakePolicy.field.method')}
+                            description={t('intakePolicy.help.method')}
                             value={policy.text_conversion?.method}
                             options={options(t, ['auto', 'basic', 'llm', 'custom'])}
                             onChange={(value) => setValue(['text_conversion', 'method'], value)}
@@ -147,6 +171,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <SelectField
                             label={t('intakePolicy.field.pageScope')}
+                            description={t('intakePolicy.help.pageScope')}
                             value={policy.text_conversion?.scope}
                             options={options(t, ['all', 'located'])}
                             onChange={(value) => setValue(['text_conversion', 'scope'], value)}
@@ -154,6 +179,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.renderDpi')}
+                            description={t('intakePolicy.help.renderDpi')}
                             value={policy.text_conversion?.render_dpi}
                             min={72}
                             onChange={(value) => setValue(['text_conversion', 'render_dpi'], value)}
@@ -168,7 +194,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     />
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.conversionModel')}>
+                <FormSection
+                    title={t('intakePolicy.section.conversionModel')}
+                    description={t('intakePolicy.help.section.conversionModel')}
+                >
                     <ModelConfigFields
                         title={t('intakePolicy.field.model')}
                         config={policy.text_conversion?.config}
@@ -178,7 +207,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                 </FormSection>
 
                 {policy.text_conversion?.method === 'custom' && (
-                    <FormSection title={t('intakePolicy.section.customConversion')}>
+                    <FormSection
+                        title={t('intakePolicy.section.customConversion')}
+                        description={t('intakePolicy.help.section.customConversion')}
+                    >
                         <div className="grid gap-4 md:grid-cols-2">
                             <InputField
                                 label={t('intakePolicy.field.interaction')}
@@ -196,7 +228,11 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     </FormSection>
                 )}
 
-                <FormSection title={t('intakePolicy.section.pageRanges')} last>
+                <FormSection
+                    title={t('intakePolicy.section.pageRanges')}
+                    description={t('intakePolicy.help.section.pageRanges')}
+                    last
+                >
                     <PageRangesField
                         value={policy.text_conversion?.page_ranges}
                         onChange={(value) => setValue(['text_conversion', 'page_ranges'], value)}
@@ -210,7 +246,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
     if (section === 'extraction') {
         return (
             <FormSurface>
-                <FormSection title={t('intakePolicy.section.extraction')}>
+                <FormSection
+                    title={t('intakePolicy.section.extraction')}
+                    description={t('intakePolicy.help.section.extraction')}
+                >
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
                         <TriStateField
                             label={t('intakePolicy.field.enabled')}
@@ -220,6 +259,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <SelectField
                             label={t('intakePolicy.field.source')}
+                            description={t('intakePolicy.help.extractionSource')}
                             value={policy.extraction?.source}
                             options={options(t, ['auto', 'text', 'vision', 'mixed'])}
                             onChange={(value) => setValue(['extraction', 'source'], value)}
@@ -227,6 +267,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <SelectField
                             label={t('intakePolicy.field.pageScope')}
+                            description={t('intakePolicy.help.pageScope')}
                             value={policy.extraction?.scope}
                             options={options(t, ['all', 'located'])}
                             onChange={(value) => setValue(['extraction', 'scope'], value)}
@@ -234,6 +275,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.maxPages')}
+                            description={t('intakePolicy.help.extractionMaxPages')}
                             value={policy.extraction?.max_pages}
                             min={1}
                             onChange={(value) => setValue(['extraction', 'max_pages'], value)}
@@ -242,6 +284,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     </div>
                     <InputField
                         label={t('intakePolicy.field.interaction')}
+                        description={t('intakePolicy.help.extractionInteraction')}
                         value={policy.extraction?.interaction}
                         onChange={(value) => setValue(['extraction', 'interaction'], value)}
                         readonly={readonly}
@@ -259,7 +302,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     />
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.extractionModel')}>
+                <FormSection
+                    title={t('intakePolicy.section.extractionModel')}
+                    description={t('intakePolicy.help.section.extractionModel')}
+                >
                     <ModelConfigFields
                         title={t('intakePolicy.field.model')}
                         config={policy.extraction?.config}
@@ -268,22 +314,28 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     />
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.visionBudget')}>
+                <FormSection
+                    title={t('intakePolicy.section.visionBudget')}
+                    description={t('intakePolicy.help.section.visionBudget')}
+                >
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-3">
                         <SelectField
                             label={t('intakePolicy.field.defaultDetail')}
+                            description={t('intakePolicy.help.visionDetail')}
                             value={policy.extraction?.vision?.default_detail}
                             options={options(t, ['low', 'standard', 'high'])}
                             onChange={(value) => setValue(['extraction', 'vision', 'default_detail'], value)}
                             readonly={readonly}
                         />
                         <VisionDetailsField
+                            description={t('intakePolicy.help.visionDetail')}
                             value={policy.extraction?.vision?.allowed_details}
                             onChange={(value) => setValue(['extraction', 'vision', 'allowed_details'], value)}
                             readonly={readonly}
                         />
                         <NumberField
                             label={t('intakePolicy.field.maxImageTokens')}
+                            description={t('intakePolicy.help.maxImageTokens')}
                             value={policy.extraction?.vision?.max_image_tokens}
                             min={1}
                             onChange={(value) => setValue(['extraction', 'vision', 'max_image_tokens'], value)}
@@ -291,6 +343,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.maxPayloadMb')}
+                            description={t('intakePolicy.help.maxPayloadMb')}
                             value={policy.extraction?.vision?.max_payload_mb}
                             min={1}
                             onChange={(value) => setValue(['extraction', 'vision', 'max_payload_mb'], value)}
@@ -366,7 +419,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
         const review = grounding?.review;
         return (
             <FormSurface>
-                <FormSection title={t('intakePolicy.section.grounding')}>
+                <FormSection
+                    title={t('intakePolicy.section.grounding')}
+                    description={t('intakePolicy.help.section.grounding')}
+                >
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
                         <TriStateField
                             label={t('intakePolicy.field.enabled')}
@@ -383,6 +439,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.windowPages')}
+                            description={t('intakePolicy.help.windowPages')}
                             value={grounding?.window_pages}
                             min={1}
                             onChange={(value) => setValue(['extraction', 'grounding', 'window_pages'], value)}
@@ -398,30 +455,35 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-3">
                         <TriStateField
                             label={t('intakePolicy.field.useVision')}
+                            description={t('intakePolicy.help.useVision')}
                             value={grounding?.use_vision}
                             onChange={(value) => setValue(['extraction', 'grounding', 'use_vision'], value)}
                             readonly={readonly}
                         />
                         <TriStateField
                             label={t('intakePolicy.field.forceOcr')}
+                            description={t('intakePolicy.help.forceOcr')}
                             value={grounding?.force_ocr}
                             onChange={(value) => setValue(['extraction', 'grounding', 'force_ocr'], value)}
                             readonly={readonly}
                         />
                         <TriStateField
                             label={t('intakePolicy.field.refreshOcr')}
+                            description={t('intakePolicy.help.refreshOcr')}
                             value={grounding?.refresh_ocr}
                             onChange={(value) => setValue(['extraction', 'grounding', 'refresh_ocr'], value)}
                             readonly={readonly}
                         />
                         <TriStateField
                             label={t('intakePolicy.field.omitBlockBoxes')}
+                            description={t('intakePolicy.help.omitBlockBoxes')}
                             value={grounding?.omit_block_boxes}
                             onChange={(value) => setValue(['extraction', 'grounding', 'omit_block_boxes'], value)}
                             readonly={readonly}
                         />
                         <TriStateField
                             label={t('intakePolicy.field.updateProperties')}
+                            description={t('intakePolicy.help.updateProperties')}
                             value={grounding?.update_properties}
                             onChange={(value) => setValue(['extraction', 'grounding', 'update_properties'], value)}
                             readonly={readonly}
@@ -429,7 +491,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     </div>
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.models')}>
+                <FormSection
+                    title={t('intakePolicy.section.models')}
+                    description={t('intakePolicy.help.section.models')}
+                >
                     <ModelConfigFields
                         title={t('intakePolicy.field.primaryModel')}
                         config={grounding?.config}
@@ -445,6 +510,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     <div className="grid gap-4 md:grid-cols-2">
                         <NumberField
                             label={t('intakePolicy.field.hardnessThreshold')}
+                            description={t('intakePolicy.help.hardnessThreshold')}
                             value={grounding?.hardness_threshold}
                             min={0}
                             max={1}
@@ -454,6 +520,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.minCitationDensity')}
+                            description={t('intakePolicy.help.minCitationDensity')}
                             value={grounding?.min_citation_density}
                             min={0}
                             max={1}
@@ -464,7 +531,11 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     </div>
                 </FormSection>
 
-                <FormSection title={t('intakePolicy.section.review')} last>
+                <FormSection
+                    title={t('intakePolicy.section.review')}
+                    description={t('intakePolicy.help.section.review')}
+                    last
+                >
                     <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
                         <TriStateField
                             label={t('intakePolicy.field.enabled')}
@@ -474,6 +545,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <TriStateField
                             label={t('intakePolicy.field.forceReview')}
+                            description={t('intakePolicy.help.forceReview')}
                             value={review?.force}
                             onChange={(value) => setValue(['extraction', 'grounding', 'review', 'force'], value)}
                             readonly={readonly}
@@ -489,6 +561,7 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                         />
                         <NumberField
                             label={t('intakePolicy.field.coverageThreshold')}
+                            description={t('intakePolicy.help.coverageThreshold')}
                             value={review?.coverage_threshold}
                             min={0}
                             max={1}
@@ -512,7 +585,10 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
 
     return (
         <FormSurface>
-            <FormSection title={t('intakePolicy.section.rendering')}>
+            <FormSection
+                title={t('intakePolicy.section.rendering')}
+                description={t('intakePolicy.help.section.rendering')}
+            >
                 <TextAreaField
                     label={t('intakePolicy.field.renderingTemplate')}
                     description={t('intakePolicy.help.renderingTemplate')}
@@ -523,7 +599,11 @@ export function IntakePolicyForm({ policy, section, onChange, readonly = false }
                     minLines={8}
                 />
             </FormSection>
-            <FormSection title={t('intakePolicy.section.embeddings')} last>
+            <FormSection
+                title={t('intakePolicy.section.embeddings')}
+                description={t('intakePolicy.help.section.embeddings')}
+                last
+            >
                 <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
                     <TriStateField
                         label={t('intakePolicy.field.textEmbedding')}
@@ -559,10 +639,24 @@ function FormSurface({ children }: { children: ReactNode }) {
     return <div className="mx-auto w-full max-w-6xl px-1 py-4">{children}</div>;
 }
 
-function FormSection({ title, children, last = false }: { title: string; children: ReactNode; last?: boolean }) {
+function FormSection({
+    title,
+    description,
+    children,
+    last = false,
+}: {
+    title: string;
+    /** Tooltip on an Info icon beside the heading. Hover-only, like every `InfoTip`. */
+    description?: ReactNode;
+    children: ReactNode;
+    last?: boolean;
+}) {
     return (
         <section className={last ? 'pb-3' : 'mb-6 border-b pb-6'}>
-            <h3 className="mb-4 text-sm font-semibold">{title}</h3>
+            <div className="mb-4 flex items-center gap-2">
+                <h3 className="text-sm font-semibold">{title}</h3>
+                <InfoTip description={description} />
+            </div>
             <div className="space-y-4">{children}</div>
         </section>
     );
@@ -621,6 +715,7 @@ function TextAreaField({
 
 function NumberField({
     label,
+    description,
     value,
     onChange,
     readonly,
@@ -629,6 +724,7 @@ function NumberField({
     step,
 }: {
     label: string;
+    description?: string;
     value?: number;
     onChange: (value: number | undefined) => void;
     readonly: boolean;
@@ -637,7 +733,7 @@ function NumberField({
     step?: number;
 }) {
     return (
-        <FormItem label={label}>
+        <FormItem label={label} description={description}>
             <NumberInput
                 value={value}
                 onChange={(value) => onChange(value === undefined || Number.isFinite(value) ? value : undefined)}
@@ -688,11 +784,13 @@ function SelectField<T extends string | number>({
 
 function TriStateField({
     label,
+    description,
     value,
     onChange,
     readonly,
 }: {
     label: string;
+    description?: string;
     value?: boolean;
     onChange: (value: boolean | undefined) => void;
     readonly: boolean;
@@ -705,7 +803,7 @@ function TriStateField({
     ] as const;
     const selectedValue = value === undefined ? 'inherit' : value ? 'enabled' : 'disabled';
     return (
-        <FormItem label={label}>
+        <FormItem label={label} description={description}>
             <SelectBox
                 options={[...choices]}
                 value={choices.find((option) => option.value === selectedValue)}
@@ -719,10 +817,12 @@ function TriStateField({
 }
 
 function VisionDetailsField({
+    description,
     value,
     onChange,
     readonly,
 }: {
+    description?: string;
     value?: IntakeVisionDetail[];
     onChange: (value: IntakeVisionDetail[] | undefined) => void;
     readonly: boolean;
@@ -730,7 +830,7 @@ function VisionDetailsField({
     const { t } = useUITranslation();
     const choices = options(t, ['low', 'standard', 'high'] as const);
     return (
-        <FormItem label={t('intakePolicy.field.allowedDetails')}>
+        <FormItem label={t('intakePolicy.field.allowedDetails')} description={description}>
             <SelectBox<SelectOption<IntakeVisionDetail>>
                 multiple
                 options={choices}

package/src/i18n/locales/ar.json

@@ -1063,20 +1063,55 @@
     "intakePolicy.field.updateProperties": "تحديث الخصائص",
     "intakePolicy.field.useVision": "استخدام الرؤية",
     "intakePolicy.field.windowPages": "الصفحات لكل نافذة",
+    "intakePolicy.help.contactSheetDetail": "عدد الصفحات في ورقة المصغرات. صفحات أقل تعني مصغرات أكبر وأسهل قراءة.",
+    "intakePolicy.help.coverageThreshold": "راجع عندما تنخفض تغطية الاستشهادات في صفحة عن هذا الحد، وهو مؤشر على احتمال إغفال محتوى.",
     "intakePolicy.help.defaultView": "العرض الأولي المفضل لكائنات هذا النوع.",
+    "intakePolicy.help.distinguishFrom": "الأنواع التي يسهل الخلط بينها وبين هذا النوع.",
     "intakePolicy.help.embeddings": "مفاتيح اختيارية حسب النوع لتضمين النص والصورة والخصائص.",
     "intakePolicy.help.examples": "معرّفات كائنات الأمثلة المؤكدة بشرياً لهذا النوع من المحتوى.",
+    "intakePolicy.help.extractionInteraction": "استبدل المستخرج المدمج بتفاعلك الخاص.",
+    "intakePolicy.help.extractionMaxPages": "حد أقصى لعدد الصفحات التي تصل إلى الاستخراج.",
     "intakePolicy.help.extractionSource": "اختر أدلة نصية أو مرئية أو مجمعة للاستخراج.",
+    "intakePolicy.help.forceOcr": "تطبيق OCR على كل صفحة، حتى الصفحات التي تحتوي طبقة نص.",
+    "intakePolicy.help.forceReview": "راجع كل مستند مهما كانت درجة صعوبته.",
     "intakePolicy.help.grounding": "أنشئ استشهادات على مستوى الكتلة وأدلة مشروحة لاستخراج الخصائص.",
+    "intakePolicy.help.hardnessThreshold": "الدرجة التي يتولى عندها نموذج المحتوى الصعب المهمة.",
     "intakePolicy.help.identification": "إرشادات اختيار النوع تلقائياً قبل الاستخراج.",
     "intakePolicy.help.identificationGuidance": "صف نوع المحتوى هذا ومتى يجب اختياره.",
     "intakePolicy.help.locateInstructions": "فعّل هذا لتحديد الصفحات ذات الصلة قبل التحويل والاستخراج.",
+    "intakePolicy.help.locateMinPages": "يُتخطى تحديد الصفحات في المستندات الأقصر من ذلك.",
+    "intakePolicy.help.maxImageTokens": "الميزانية التي تقيّد فعليًا: تقدير رموز الصورة لكل استدعاء.",
+    "intakePolicy.help.maxPayloadMb": "حد للنقل، وليس إعداد جودة.",
+    "intakePolicy.help.method": "ما إذا كان النص يأتي من التحليل المدمج أو من نموذج أو من تفاعلك الخاص.",
+    "intakePolicy.help.minCitationDensity": "إذا قلّت الاستشهادات لكل قيمة مستخرجة، تُعاد المحاولة.",
     "intakePolicy.help.mode": "الإدخال البرمجي هو الافتراضي؛ يفوض الإدخال الوكيلي التنسيق إلى وكيل.",
+    "intakePolicy.help.omitBlockBoxes": "إزالة إطارات الكتل من الموجّه. آمن فقط عند تفعيل استخدام الرؤية.",
     "intakePolicy.help.pageRanges": "صفحتا البداية والنهاية مشمولتان. تُحسب القيم السالبة من نهاية المستند.",
+    "intakePolicy.help.pageScope": "كل الصفحات، أو الصفحات التي حددها المحدد فقط.",
+    "intakePolicy.help.refreshOcr": "إعادة تشغيل OCR بدلاً من استخدام النتيجة المخزّنة.",
+    "intakePolicy.help.renderDpi": "الدقة التي تُعرض بها كل صفحة للنموذج. القيمة 150 تناسب معظم الحالات؛ ارفعها فقط مع الخط الدقيق جدًا.",
     "intakePolicy.help.renderingTemplate": "قالب Handlebars لتحويل الخصائص المستخرجة إلى نص الكائن.",
     "intakePolicy.help.review": "مراجعة اختيارية بالنموذج للصفحات الصعبة أو منخفضة التغطية.",
+    "intakePolicy.help.section.classification": "كيف يتعرّف Vertesia على هذا النوع، وكيف تُفتح كائناته افتراضيًا.",
+    "intakePolicy.help.section.conversion": "يحوّل الملف المصدر إلى نص قابل للقراءة قبل استخراج أي شيء.",
+    "intakePolicy.help.section.conversionModel": "النموذج الذي يحوّل الصفحات إلى نص. غالبًا أرخص من نموذج الاستخراج.",
+    "intakePolicy.help.section.customConversion": "تفاعلك الخاص أو وكيلك بدلًا من المحوّل المدمج.",
+    "intakePolicy.help.section.embeddings": "ما تتم فهرسته للبحث، وما إذا كانت قائمة محتويات ستُنشأ.",
+    "intakePolicy.help.section.extraction": "كيف تُعبَّأ خصائص مخطط هذا النوع من المستندات.",
+    "intakePolicy.help.section.extractionModel": "النموذج الذي يقرأ المستند ويعبّئ الخصائص.",
+    "intakePolicy.help.section.grounding": "يربط كل قيمة مستخرجة بالكتلة أو الموضع المرئي في الصفحة التي جاءت منها.",
+    "intakePolicy.help.section.locate": "مسح بصري سريع يحدّد الصفحات المهمة قبل بدء العمل الفعلي.",
+    "intakePolicy.help.section.models": "النموذج المستخدم بحسب صعوبة قراءة صفحات المستند.",
+    "intakePolicy.help.section.pageRanges": "صفحات ثابتة للتحويل. لها الأولوية على نطاق الصفحات؛ وتُحسب القيم السالبة من النهاية.",
+    "intakePolicy.help.section.rendering": "القالب الذي يحوّل الخصائص المستخرجة إلى نص الكائن.",
+    "intakePolicy.help.section.review": "تمريرة إضافية على الصفحات قليلة الاستشهاد أو الصعبة القراءة.",
+    "intakePolicy.help.section.visionBudget": "مقدار صور الصفحات الذي يمكن أن يحمله استدعاء استخراج واحد.",
     "intakePolicy.help.textConversion": "يتحكم في إنشاء Markdown أو النص قبل الاستخراج والتضمين.",
     "intakePolicy.help.title": "دليل الحقول",
+    "intakePolicy.help.updateProperties": "كتابة النتائج المسنَدة في خصائص الكائن.",
+    "intakePolicy.help.useVision": "إرسال صور الصفحات المشروحة مع النص.",
+    "intakePolicy.help.visionDetail": "ملفات تعريف جودة الصورة المتاحة لهذا النوع. تحدد المنصة الملفات نفسها.",
+    "intakePolicy.help.windowPages": "عدد الصفحات في استدعاء إسناد واحد قبل التقسيم.",
     "intakePolicy.option.agentic": "وكيلي",
     "intakePolicy.option.all": "كل الصفحات",
     "intakePolicy.option.auto": "تلقائي",

package/src/i18n/locales/de.json

@@ -1019,20 +1019,55 @@
     "intakePolicy.field.updateProperties": "Eigenschaften aktualisieren",
     "intakePolicy.field.useVision": "Vision verwenden",
     "intakePolicy.field.windowPages": "Seiten pro Fenster",
+    "intakePolicy.help.contactSheetDetail": "Seiten pro Miniaturbogen. Weniger Seiten bedeuten größere, besser lesbare Kacheln.",
+    "intakePolicy.help.coverageThreshold": "Prüfen, wenn die Zitatabdeckung einer Seite darunter fällt — ein Hinweis, dass Inhalt übersehen worden sein könnte.",
     "intakePolicy.help.defaultView": "Bevorzugte erste Ansicht für Objekte dieses Typs.",
+    "intakePolicy.help.distinguishFrom": "Typen, mit denen dieser leicht verwechselt wird.",
     "intakePolicy.help.embeddings": "Optionale typspezifische Schalter für Text-, Bild- und Eigenschaften-Embeddings.",
     "intakePolicy.help.examples": "Objekt-IDs von menschlich bestätigten Beispielen dieses Inhaltstyps.",
+    "intakePolicy.help.extractionInteraction": "Ersetzen Sie den integrierten Extraktor durch Ihre eigene Interaktion.",
+    "intakePolicy.help.extractionMaxPages": "Obergrenze für die Anzahl der Seiten, die zur Extraktion gelangen.",
     "intakePolicy.help.extractionSource": "Wählt Text-, Bild- oder kombinierte Belege für die Extraktion.",
+    "intakePolicy.help.forceOcr": "Jede Seite per OCR lesen, auch Seiten mit vorhandener Textebene.",
+    "intakePolicy.help.forceReview": "Jedes Dokument prüfen, unabhängig vom Schwierigkeitswert.",
     "intakePolicy.help.grounding": "Erstellt Zitate auf Blockebene und kommentierte Belege für die Eigenschaftsextraktion.",
+    "intakePolicy.help.hardnessThreshold": "Ab diesem Wert übernimmt das Modell für schwierige Inhalte.",
     "intakePolicy.help.identification": "Hinweise zur automatischen Typauswahl vor der Extraktion.",
     "intakePolicy.help.identificationGuidance": "Beschreiben Sie diesen Inhaltstyp und wann er ausgewählt werden soll.",
     "intakePolicy.help.locateInstructions": "Damit werden relevante Seiten vor Konvertierung und Extraktion ermittelt.",
+    "intakePolicy.help.locateMinPages": "Bei kürzeren Dokumenten wird die Seitensuche übersprungen.",
+    "intakePolicy.help.maxImageTokens": "Das tatsächlich bindende Budget: geschätzte Bild-Tokens pro Aufruf.",
+    "intakePolicy.help.maxPayloadMb": "Eine Transportgrenze, keine Qualitätseinstellung.",
+    "intakePolicy.help.method": "Ob der Text aus der integrierten Analyse, einem Modell oder Ihrer eigenen Interaktion stammt.",
+    "intakePolicy.help.minCitationDensity": "Zu wenige Zitate je extrahiertem Wert, und der Durchlauf wird wiederholt.",
     "intakePolicy.help.mode": "Programmatische Aufnahme ist Standard; agentische Aufnahme delegiert die Orchestrierung an einen Agenten.",
+    "intakePolicy.help.omitBlockBoxes": "Blockrahmen aus dem Prompt entfernen. Nur mit aktivierter Vision sinnvoll.",
     "intakePolicy.help.pageRanges": "Start- und Endseite einschließlich. Negative Werte zählen vom Dokumentende.",
+    "intakePolicy.help.pageScope": "Alle Seiten oder nur die vom Finder ausgewählten.",
+    "intakePolicy.help.refreshOcr": "OCR neu ausführen, statt gespeicherte OCR-Ergebnisse zu verwenden.",
+    "intakePolicy.help.renderDpi": "Auflösung, mit der jede Seite für das Modell gerendert wird. 150 passt fast immer; erhöhen Sie den Wert nur bei sehr kleiner Schrift.",
     "intakePolicy.help.renderingTemplate": "Handlebars-Vorlage, die extrahierte Eigenschaften als Objekttext materialisiert.",
     "intakePolicy.help.review": "Optionale Modellprüfung für schwierige Seiten oder geringe Abdeckung.",
+    "intakePolicy.help.section.classification": "Wie Vertesia diesen Typ erkennt und wie seine Objekte standardmäßig geöffnet werden.",
+    "intakePolicy.help.section.conversion": "Wandelt die Quelldatei in lesbaren Text um, bevor irgendetwas extrahiert wird.",
+    "intakePolicy.help.section.conversionModel": "Modell für die Umwandlung von Seiten in Text. Oft günstiger als das der Extraktion.",
+    "intakePolicy.help.section.customConversion": "Ihre eigene Interaktion oder ein Agent anstelle des integrierten Konverters.",
+    "intakePolicy.help.section.embeddings": "Was für die Suche indexiert wird und ob ein Inhaltsverzeichnis entsteht.",
+    "intakePolicy.help.section.extraction": "Wie die Schema-Eigenschaften dieses Typs aus den Dokumenten befüllt werden.",
+    "intakePolicy.help.section.extractionModel": "Modell, das das Dokument liest und die Eigenschaften befüllt.",
+    "intakePolicy.help.section.grounding": "Verknüpft jeden extrahierten Wert mit dem Block oder der visuellen Stelle der Seite, aus der er stammt.",
+    "intakePolicy.help.section.locate": "Ein günstiger visueller Überblick, der vor der eigentlichen Arbeit die wichtigen Seiten findet.",
+    "intakePolicy.help.section.models": "Welches Modell verwendet wird, je nachdem wie schwer die Dokumentseiten zu lesen sind.",
+    "intakePolicy.help.section.pageRanges": "Feste Seiten für die Konvertierung. Hat Vorrang vor dem Seitenumfang; negative Werte zählen vom Ende.",
+    "intakePolicy.help.section.rendering": "Die Vorlage, die extrahierte Eigenschaften in den Textkörper des Objekts umwandelt.",
+    "intakePolicy.help.section.review": "Ein zusätzlicher Durchgang über Seiten mit wenigen Zitaten oder schwer lesbarem Inhalt.",
+    "intakePolicy.help.section.visionBudget": "Wie viel Seitenbildmaterial ein Extraktionsaufruf mitführen darf.",
     "intakePolicy.help.textConversion": "Steuert die Markdown- oder Texterzeugung vor Extraktion und Embedding.",
     "intakePolicy.help.title": "Feldleitfaden",
+    "intakePolicy.help.updateProperties": "Belegte Ergebnisse zurück in die Eigenschaften des Objekts schreiben.",
+    "intakePolicy.help.useVision": "Kommentierte Seitenbilder zusammen mit dem Text senden.",
+    "intakePolicy.help.visionDetail": "Bildqualitätsprofile, die dieser Typ verwenden darf. Die Profile selbst gibt die Plattform vor.",
+    "intakePolicy.help.windowPages": "Wie viele Seiten ein Beleg-Aufruf umfasst, bevor er aufgeteilt wird.",
     "intakePolicy.option.agentic": "Agentisch",
     "intakePolicy.option.all": "Alle Seiten",
     "intakePolicy.option.auto": "Automatisch",

package/src/i18n/locales/en.json

@@ -506,20 +506,55 @@
     "intakePolicy.field.updateProperties": "Update properties",
     "intakePolicy.field.useVision": "Use vision",
     "intakePolicy.field.windowPages": "Pages per window",
+    "intakePolicy.help.contactSheetDetail": "Pages per thumbnail sheet. Fewer pages means bigger, more readable tiles.",
+    "intakePolicy.help.coverageThreshold": "Review when a page's citation coverage drops below this, a sign content may have been missed.",
     "intakePolicy.help.defaultView": "Preferred first view for objects of this type.",
+    "intakePolicy.help.distinguishFrom": "Types this one is easily confused with.",
     "intakePolicy.help.embeddings": "Optional per-type text, image, and properties embedding switches.",
     "intakePolicy.help.examples": "Object IDs of human-confirmed examples for this content type.",
+    "intakePolicy.help.extractionInteraction": "Replace the built-in extractor with your own interaction.",
+    "intakePolicy.help.extractionMaxPages": "Cap on how many pages reach extraction.",
     "intakePolicy.help.extractionSource": "Selects text, visual, or combined evidence for extraction.",
+    "intakePolicy.help.forceOcr": "OCR every page, even ones that already have a text layer.",
+    "intakePolicy.help.forceReview": "Review every document, whatever its hardness score.",
     "intakePolicy.help.grounding": "Creates block-level citations and annotated proof for property extraction.",
+    "intakePolicy.help.hardnessThreshold": "Score at or above which the hard-content model takes over.",
     "intakePolicy.help.identification": "Guidance for automatic type selection before extraction.",
     "intakePolicy.help.identificationGuidance": "Describe what this content type is and when it should be selected.",
     "intakePolicy.help.locateInstructions": "Set this to identify relevant pages before conversion and extraction.",
+    "intakePolicy.help.locateMinPages": "Skip the locate pass on documents shorter than this.",
+    "intakePolicy.help.maxImageTokens": "The budget that actually binds — estimated image tokens per call.",
+    "intakePolicy.help.maxPayloadMb": "A transport guard, not a quality setting.",
+    "intakePolicy.help.method": "Whether the text comes from built-in parsing, a model, or your own interaction.",
+    "intakePolicy.help.minCitationDensity": "Too few citations per extracted value and the pass retries.",
     "intakePolicy.help.mode": "Programmatic intake is the default; agentic intake delegates orchestration to an agent.",
+    "intakePolicy.help.omitBlockBoxes": "Drop block outlines from the prompt. Only safe with Use vision on.",
     "intakePolicy.help.pageRanges": "Inclusive start and end pages. Negative values count from the end of the document.",
+    "intakePolicy.help.pageScope": "Every page, or only the ones the locator picked.",
+    "intakePolicy.help.refreshOcr": "Re-run OCR instead of reusing stored OCR output.",
+    "intakePolicy.help.renderDpi": "Resolution each page is rendered at for the model. 150 suits almost everything; raise it only for very fine print.",
     "intakePolicy.help.renderingTemplate": "Handlebars template used to materialize extracted properties into object text.",
     "intakePolicy.help.review": "Optional model review for hard or low-coverage pages.",
+    "intakePolicy.help.section.classification": "How Vertesia recognizes this type, and how objects of it open by default.",
+    "intakePolicy.help.section.conversion": "Turns the source file into readable text, before anything is extracted.",
+    "intakePolicy.help.section.conversionModel": "Which model does the page-to-text pass. Often a cheaper one than extraction.",
+    "intakePolicy.help.section.customConversion": "Your own interaction or agent, in place of the built-in converter.",
+    "intakePolicy.help.section.embeddings": "What gets indexed for search, and whether a contents list is built.",
+    "intakePolicy.help.section.extraction": "How the type's schema properties are filled in from the documents.",
+    "intakePolicy.help.section.extractionModel": "Which model reads the document and fills in the properties.",
+    "intakePolicy.help.section.grounding": "Ties every extracted value back to the block or visual location on the page it came from.",
+    "intakePolicy.help.section.locate": "A cheap visual scan that picks out which pages matter, before the real work starts.",
+    "intakePolicy.help.section.models": "The model to use based on how hard document pages are to read.",
+    "intakePolicy.help.section.pageRanges": "Fixed pages to convert. Overrides Page scope when set; negative numbers count back from the end.",
+    "intakePolicy.help.section.rendering": "The template that turns extracted properties into the object's text body.",
+    "intakePolicy.help.section.review": "An extra pass over pages that came back as thinly cited or hard to read.",
+    "intakePolicy.help.section.visionBudget": "How much page imagery one extraction call is allowed to carry.",
     "intakePolicy.help.textConversion": "Controls markdown or text generation before extraction and embedding.",
     "intakePolicy.help.title": "Field Guide",
+    "intakePolicy.help.updateProperties": "Write grounded results back onto the object's properties.",
+    "intakePolicy.help.useVision": "Send annotated page images along with the text.",
+    "intakePolicy.help.visionDetail": "Image quality profiles this type may use. The profiles themselves are set by the platform.",
+    "intakePolicy.help.windowPages": "How many pages go into one grounding call before it splits.",
     "intakePolicy.option.agentic": "Agentic",
     "intakePolicy.option.all": "All pages",
     "intakePolicy.option.auto": "Automatic",