The open alternative to Salesforce, designed for AI.
TypeScript crmcrm-systemcustomergood-first-issuegraphqlhacktoberfestjavascriptmarketingmonoreponestjsopen-sourcepostgresqlreactreactjssalestypescriptweb
i18n - docs translations (#29092)
twenty-pr[bot]d28aadb32940
diff --git a/packages/twenty-docs/ar/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/ar/developers/contribute/capabilities/local-setup.mdxindex 6ad7a84f7b6..9694c39ce3f 100644--- a/packages/twenty-docs/ar/developers/contribute/capabilities/local-setup.mdx+++ b/packages/twenty-docs/ar/developers/contribute/capabilities/local-setup.mdx@@ -12,13 +12,12 @@ import { PageBanner } from "/snippets/page-banner.mdx"قبل أن تتمكن من تثبيت واستخدام Twenty، تأكد من تثبيت الأمور التالية على جهاز الكمبيوتر الخاص بك:* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)-* [Node v24.5.0](https://nodejs.org/en/download)+* [Node الإصدار 26](https://nodejs.org/en/download)* [yarn v4](https://yarnpkg.com/getting-started/install)* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)<Warning>-لن يعمل `npm` ، يجب عليك استخدام `yarn` بدلًا من ذلك. يأتي Yarn الآن مع Node.js، لذا لست بحاجة إلى تثبيته بشكل منفصل.-عليك فقط تشغيل `corepack enable` لتفعيل Yarn إذا لم تقم بذلك بعد.+لن يعمل `npm` ، يجب عليك استخدام `yarn` بدلًا من ذلك. لم يعد Node 26 يتضمن Corepack، لذا ثبّته مرة واحدة باستخدام `npm install -g corepack`، ثم شغّل `corepack enable` لتمكين Yarn.</Warning></Tab>@@ -64,6 +63,7 @@ nvm install # installs recommended node versionnvm use # use recommended node version+npm install -g corepackcorepack enable```diff --git a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdxindex 5eaab74b0cd..de346d82eb6 100644--- a/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/config/roles.mdx@@ -207,6 +207,7 @@ export default defineApplicationRole({* يُسمح بوجود **استدعاء واحد فقط** لـ `defineApplicationRole(...)` لكل تطبيق — سيفشل إنشاء بيان التطبيق (manifest) إذا عثر على أكثر من واحد.* استخدم `defineRole()` (وليس `defineApplicationRole()`) لأي أدوار **إضافية** يأتي بها تطبيقك.* لا يزال تعيين `defaultRoleUniversalIdentifier` صراحةً على `defineApplication()` مدعومًا للتوافق مع الإصدارات السابقة، ولكنه مُهمَل لصالح `defineApplicationRole()`. يجب أن يتطابق المعرّف مع دور يحدده تطبيقك، وإلا فسيفشل الإصدار.+* يُعد الدور الذي يمكن إسناده إلى أعضاء مساحة العمل أو مفاتيح API (`canBeAssignedToUsers` أو `canBeAssignedToApiKeys`، وكلاهما `true` عند حذفه) دورًا مخصصًا، ويتطلب **خطة Organization أو أعلى**: في الخطط الأخرى يُرفض التثبيت. أبقِ كليهما `false` في الأدوار التي لا يعمل بها سوى تطبيقك ووكلائه.### أدوار الوكلاءdiff --git a/packages/twenty-docs/ar/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/ar/developers/extend/apps/data/extending-objects.mdxindex 098e586c3e1..18e574f280e 100644--- a/packages/twenty-docs/ar/developers/extend/apps/data/extending-objects.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/data/extending-objects.mdx@@ -48,8 +48,6 @@ export default defineField({* موقع الملف متروك لك. المتعارف عليه هو `src/fields/\<name>.field.ts`، لكن واجهة CLI تكتشف الحقول في أي مكان داخل `src/`.-* يمكن أيضًا تعيين `writability` على مستوى الحقل: يقتصر السماح بالكتابة في حالة `MetadataWritability.APPLICATION` على دوال منطق تطبيقك نفسها، بينما يُخصَّص `MetadataWritability.SYSTEM` للبيانات المُدارة بواسطة المنصة. لا يمكن أن يكون مستوى قابلية الكتابة للحقل إلا أكثر تقييدًا من مستوى الكائن الذي ينتمي إليه، ولا تتأثر عمليات القراءة بذلك. راجع [Objects](/ar/developers/extend/apps/data/objects) للاطّلاع على الدلالات الكاملة.-* يمكن تعيين `isSearchable: true` على `defineField()` مع القيود نفسها المطبقة على الحقول المضمنة (كائن هدف قابل للبحث، ونوع حقل متوافق مع النص)، بحيث تصبح سجلات كائن الهدف قابلة للعثور عليها من خلال قيم حقلك في البحث بالنص الكامل.* يمكن ضبط `isAuditLogged: false` على `defineField()` لإبقاء تغييرات الحقل خارج المخطط الزمني لسجل الهدف، وهو أمر مهم للغاية للحقول التي يعيد تطبيقك كتابتها وفق جدول زمني.diff --git a/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdxindex d706af21716..c7d60f1e34f 100644--- a/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/data/objects.mdx@@ -103,17 +103,7 @@ export default defineObject({* يتطلب كل حقل `name` و`type` و`label` ومعرّف `universalIdentifier` ثابتًا خاصًا به.* المصفوفة `fields` اختيارية — يمكنك تعريف كائنات بدون حقول مخصصة.* `openRecordIn` يحدد أين تُفتح سجلات هذا الكائن عند النقر عليها: `ObjectOpenRecordIn.USER_CHOICE` (الإعداد الافتراضي، الذي يتبع تفضيل كل عضو في مساحة العمل من Settings → Experience)، أو `ObjectOpenRecordIn.SIDE_PANEL`، أو `ObjectOpenRecordIn.RECORD_PAGE`. ثبِّتها على `RECORD_PAGE` للسجلات التي تحتاج إلى صفحة كاملة لتكون قابلة للاستخدام، كما هو الحال في سير العمل ولوحات المعلومات، أو على `SIDE_PANEL` للسجلات التي لا تكون منطقية إلا كلوحة سريعة، كما هو الحال في أحداث التقويم.-* تتحكم الخاصية `writability` في من يمكنه كتابة سجلات الكائن من الأساس، قبل تطبيق أذونات الأدوار: `MetadataWritability.OPEN` (القيمة الافتراضية — أدوار مساحة العمل هي التي تقرر)، أو `MetadataWritability.APPLICATION` (يمكن لوظائف منطق تطبيقك فقط إنشاء السجلات أو تحديثها أو حذفها؛ استخدم هذا لكائنات تشبه التهيئة التي تمنح سجلاتها سلوكًا، بحيث لا يتمكن أعضاء مساحة العمل الذين لديهم وصول واسع إلى السجلات من تعديلها عبر واجهة برمجة التطبيقات API)، أو `MetadataWritability.SYSTEM` (محجوزة للبيانات التي تُدار من قبل المنصّة). لا تتأثر عمليات القراءة — يتم فرض هذا من جانب الخادم، على عكس `isUIEditable`، التي تقتصر على إخفاء عناصر واجهة المستخدم. توجد هذه الخاصية أيضًا على مستوى الحقل، حيث لا يمكن أن تكون إلا أكثر تقييدًا من مستوى الكائن.-* يُعرّف `readability` من يمكنه قراءة سجلات الكائن: `MetadataReadability.OPEN` (الإعداد الافتراضي — تحدد أدوار مساحة العمل ذلك)، و`MetadataReadability.PRIVATE` (فقط الكيانات الرئيسية التي تمت مشاركة السجل معها)، و`MetadataReadability.INHERITED` (أيًّا كان من يقرأ السجل الأصل)، و`MetadataReadability.APPLICATION` (فقط دوال المنطق الخاصة بتطبيقك)، أو `MetadataReadability.SYSTEM` (البيانات التي تديرها المنصة). يتم دائمًا فرض جميع سياسات سهولة القراءة.-* يتوافق `readabilityParentFieldUniversalIdentifiers` مع `MetadataReadability.INHERITED`: المعرّفات العامة لحقول العلاقة التي تؤدي إلى السجلات الأصلية.- * يسمّي حقل متعدد إلى واحد السجل الذي يشير إليه الصف. إن تعريف حقل واحد لعلاقة مورفية يغطي كل هدف لتلك العلاقة.- * يسمّي حقل واحد إلى متعدد كائناً تابعاً تشير صفوفه مجدداً إلى السجل، مثل صفوف الربط لعلاقة متعدد إلى متعدد. يمكن عندئذ قراءة السجل عندما يؤدي صف واحد على الأقل من تلك الصفوف إلى سجل قابل للقراءة: تتبع الملاحظة الأشخاص والشركات والفرص التي تربطها بها أهداف الملاحظة الخاصة بها.- * تُدمج عدة سجلات أصلية كاتحاد: يكفي سجل أصلي واحد قابل للقراءة.- * يمنح الكائن الأصل حق الوصول بموجب سياسته الكاملة، وهي السياسة التي ينطبق استعلام للكائن الأصل عليها: إذن القارئ على الكائن الأصل، والقيود على مستوى الصف الخاصة بدوره، وقابلية قراءة الكائن الأصل نفسه. لا يظهر سجل مطلقًا عبر كائن أصل لا يستطيع قارئه الاستعلام عنه. تحدد الاشتراكات وخطافات الويب ومسارات العمل ودوال المنطق ما يصل من حدث لسجل `INHERITED` بموجب تلك السياسة نفسها.- * تمنح صفوف المشاركة الموجودة على السجل نفسه حق الوصول تمامًا كما في سجل `PRIVATE`. يحصل منشئه على واحد عند إنشاء السجل أثناء تمكين مشاركة السجلات، لذا يظل أي شخص أنشأ سجلًا قادرًا على رؤيته، ويكون السجل الذي تكون جميع حقول الكائن الأصل فيه فارغة مرئيًا لمن تمت مشاركته معهم مباشرةً.- * يتصرف كائن `INHERITED` الذي لا يحدد أي حقل أصل قابل للاستخدام مثل كائن `PRIVATE`.-* يحدد `sharingReach` مدى إمكانية مشاركة سجل لكائن ما بالاسم: `ObjectSharingReach.WORKSPACE` (الإعداد الافتراضي، يمكن مشاركة سجل مع أي شخص في مساحة العمل، حتى مع شخص لا يتيح دوره الوصول إلى الكائن أو يخفي عامل التصفية على مستوى الصف السجل؛ ولا يحصل إلا على ذلك السجل، لعرضه أو تعديله) أو `ObjectSharingReach.ROLE_ACCESS` (لا تتجاوز المشاركات أبدًا أذونات الدور وعلى مستوى الصف). اختر `ROLE_ACCESS` للكائنات الحساسة التي يجب أن يعني فيها عدم الوصول عدم الوصول. الأدوار التي يمكنها تحديث جميع الإعدادات ترى كل سجل لكائن `OPEN` بغض النظر عن قيود مشاركته؛ ولا تزال أذونات الكائن ومرشحات مستوى الصف تنطبق عليها. ينطبق ذلك فقط عندما تكون مشاركة السجلات مفعّلة في مساحة العمل، وفقط على الكائنات التي يمكن مشاركة سجلاتها: كائنات `MetadataReadability.OPEN` و`PRIVATE` و`INHERITED` التي ليست كائنات نظام. لا تتم مشاركة كائنات `APPLICATION` و`SYSTEM` أبدًا.-* يسرد `disabledObjectPermissionActions` أذونات الكائن التي لا يمكن منحها على الكائن: أي من `'canReadObjectRecords'` و`'canUpdateObjectRecords'` و`'canSoftDeleteObjectRecords'` و`'canDestroyObjectRecords'`، وهي العلامات نفسها التي يعيّنها الدور لكل كائن. يؤدي حفظ إذن كائن يمنح أحدها على هذا الكائن إلى الفشل، فعلى سبيل المثال يمنع `disabledObjectPermissionActions: ['canDestroyObjectRecords']` منح أي دور صلاحية التدمير عليه تحديدًا. لا يغيّر ذلك ما يمكن أن تفعله الأدوار التي تمنح إجراءً على جميع الكائنات.+* يسرد `disabledObjectPermissionActions` أذونات الكائن التي لا يمكن منحها على الكائن: أي من `'canReadObjectRecords'` و`'canUpdateObjectRecords'` و`'canSoftDeleteObjectRecords'` و`'canDestroyObjectRecords'`، وهي العلامات نفسها التي يعيّنها الدور لكل كائن. لا يحصل المستخدمون ومفاتيح API والوكلاء مطلقًا على هذه الإجراءات على الكائن، مهما كانت الصلاحيات التي يمنحها دورهم، ويفشل حفظ إذن كائن يمنح أحدها. تحتفظ بها دوال المنطق الخاصة بتطبيقك. على سبيل المثال، يجعل `['canUpdateObjectRecords', 'canSoftDeleteObjectRecords', 'canDestroyObjectRecords']` الكائن قابلًا للكتابة بواسطة تطبيقك فقط، للسجلات الشبيهة بالإعدادات التي تمنح سلوكًا.* يضبط `color` لون الإبراز للكائن في واجهة المستخدم. احذفه، وسيختار Twenty واحدًا للكائن.* يسمّي `imageIdentifierFieldMetadataUniversalIdentifier` الحقل الذي تُعرض قيمته بوصفها الصورة الرمزية للسجل. احذفه للسماح لـ Twenty باختيار القيمة الافتراضية.* يحافظ `isLabelSyncedWithName`، على كائن أو حقل، على مزامنة اسم API مع التسمية عند تحرير التسمية في الإعدادات. تكون القيمة الافتراضية `false`، لذا تترك التسمية المعاد تسميتها الاسم دون تغيير.diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdxindex 39443a46033..d9813f30f23 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## قبل أن تبدأ-استخدم Node.js 24.5+ وYarn 4. ثبّت واجهة سطر الأوامر بشكل عام؛ يحتفظ تطبيقك بتبعيات SDK الخاصة به.+استخدم Node.js 24.5+ أو 26.5+ وYarn 4 (عبر Corepack: `corepack enable`؛ في Node 26، ثبّته أولاً باستخدام `npm install -g corepack`). ثبّت واجهة سطر الأوامر بشكل عام؛ يحتفظ تطبيقك بتبعيات SDK الخاصة به.<Note>يُدعم رسميًا إنشاء تطبيقات Twenty على أنظمة Unix (macOS وLinux) فقط. على Windows، اعمل ضمن WSL 2.diff --git a/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdxindex c9741a22619..413becf5d72 100644--- a/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/getting-started/troubleshooting.mdx@@ -8,8 +8,8 @@ import { PageBanner } from "/snippets/page-banner.mdx"## المشكلات الشائعة* **أخطاء الخادم المحلي**، تحقّق من بيئة تطوير Docker أو المستودع لديك. لا تدير واجهة CLI المستقلة الحاويات.-* **إصدار Node غير صحيح** — تحتاج إلى 24.5+ (`engines.node: ^24.5.0`). تحقّق باستخدام `node -v`.-* **Yarn 4 غير موجود** — شغّل `corepack enable`.+* **إصدار Node غير صحيح** — تحتاج إلى 24.5+ أو 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). تحقّق باستخدام `node -v`.+* **Yarn 4 غير موجود** — شغّل `corepack enable` (على Node 26، نفّذ أولاً `npm install -g corepack`).* **تبعيات تالفة** — `rm -rf node_modules && yarn install`.* **ملف `yarn.lock` فارغ** — يفشل البناء مع ظهور "yarn.lock is empty" عندما يكون ملف القفل موجودًا ولكنه لا يحتوي على أي محتوى؛ شغّل `yarn install` لإعادة إنشائه.* **أخطاء `twenty-sdk` بعد الترقية إلى v2.8.0** — تم نقله من `dependencies` إلى `devDependencies` في الإصدار v2.8.0. انظر إلى [بنية المشروع → التبعيات](/ar/developers/extend/apps/getting-started/project-structure#dependencies).diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdxindex 795482d447a..fd94829c021 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/logic-functions.mdx@@ -1039,7 +1039,7 @@ const { createCompany } = await client.mutation({},});-// Only on an object whose readability is PRIVATE: choose who can read the created record+// Only on an object whose records are private: choose who can read the created recordconst { createContract } = await client.mutation({createContract: {__args: {@@ -1058,7 +1058,7 @@ const { createContract } = await client.mutation({});```-لا يهم `shareWith` إلا في كائن تكون قابلية قراءته `PRIVATE`؛ فجميع الكائنات تكون `OPEN` افتراضيًا، وفي كائن `OPEN` يتم تجاهل الوسيطة. في كائن `PRIVATE`، يسرد من يحصل على حق الوصول إلى السجل المنشأ: يستهدف كل إدخال واحدًا فقط من `workspaceMemberId` أو `roleId` أو `everyone: true` بمستوى وصول `READ` أو `READ_WRITE` أو `FULL`. يتلقى عضو مساحة العمل الذي ينشئ سجلًا دائمًا منحة مالك `FULL`، لذا تكون الوسيطة اختيارية بالنسبة إليه؛ كما تتلقى دالة منطقية تعمل كتطبيقها أو مفتاح API منحة `FULL` لدورها، ويجب على هؤلاء المستدعين، مثل مستدعٍ للنظام، تمرير `shareWith` وإلا فسيتم رفض الإنشاء. يجب أن يحدد كل إدخال عضوًا أو دورًا في مساحة العمل. تشارك الدالة المنطقية أو مفتاح API عبر دوره، بحيث يحصل كل من لديه ذلك الدور على نفس إمكانية الوصول إلى السجلات التي ينشئها؛ امنح المفتاح الذي يجب أن تظل سجلاته خاصة به دورًا خاصًا به.+لا يهم `shareWith` إلا في كائن تكون سجلاته خاصة؛ وفي غير ذلك، يتم تجاهل الوسيطة. في مثل هذا الكائن، تسرد هذه الخاصية من يحصل على حق الوصول إلى السجل المُنشأ: يستهدف كل إدخال واحدًا فقط من `workspaceMemberId` أو `roleId` أو `everyone: true` مع `accessLevel` بقيمة `READ` أو `READ_WRITE` أو `FULL`. يتلقى عضو مساحة العمل الذي ينشئ سجلًا دائمًا منحة مالك `FULL`، لذا تكون الوسيطة اختيارية بالنسبة إليه؛ كما تتلقى دالة منطقية تعمل كتطبيقها أو مفتاح API منحة `FULL` لدورها، ويجب على هؤلاء المستدعين، مثل مستدعٍ للنظام، تمرير `shareWith` وإلا فسيتم رفض الإنشاء. يجب أن يحدد كل إدخال عضوًا أو دورًا في مساحة العمل. تشارك الدالة المنطقية أو مفتاح API عبر دوره، بحيث يحصل كل من لديه ذلك الدور على نفس إمكانية الوصول إلى السجلات التي ينشئها؛ امنح المفتاح الذي يجب أن تظل سجلاته خاصة به دورًا خاصًا به.يستخدم العميل صياغة مجموعة اختيار: مرِّر `true` لتضمين حقل، واستخدم `__args` للوسيطات، وعشّش الكائنات للعلاقات. ستحصل على إكمال تلقائي كامل وفحص للأنواع يعتمد على مخطط مساحة العمل لديك.diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdxindex 8d9f23ba92e..5bf96883388 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/skills-and-agents.mdx@@ -69,6 +69,8 @@ export default defineAgent({* `modelId` (اختياري) يتجاوز نموذج الذكاء الاصطناعي الافتراضي الذي يستخدمه الوكيل.* `responseFormat` (اختياري) يحدد شكل الإخراج الافتراضي للوكيل. القيمة الافتراضية هي `{ type: 'text' }` للنص الحر. استخدم `{ type: 'json', schema }` لفرض مخرجات JSON منظمة. يمكن لاستدعاء `runAgent()` أو لخطوة ذكاء اصطناعي في سير عمل طلب شكل مختلف، ويكون له الأسبقية.* يربط `roleUniversalIdentifier` (اختياري) الوكيل بدور يحدده تطبيقك. يجب ألا يمنح ذلك الدور صلاحيات أكثر من دور التطبيق، وإلا فسيفشل الإصدار؛ راجع [أدوار الوكلاء](/ar/developers/extend/apps/config/roles#agent-roles).+* يُفعّل `modelConfiguration` (اختياري) الأدوات الأصلية للنموذج، كما تفعل صفحة إعدادات الوكيل: `{ webSearch: { enabled: true }, twitterSearch: { enabled: true } }`. لا تعمل كل أداة إلا مع النماذج التي تدعمها. اتركه خارجًا لإبقائها معطلة.+* يُخفي `isSystem` (اختياري، وقيمته الافتراضية `false`) الوكيل من قوائم الوكلاء، مثل الوكلاء الذين ينشئهم Twenty لخطوات الذكاء الاصطناعي لسير العمل. إنه يغيّر ما يُعرض فقط: لا يمكن تغيير وكلاء التطبيق إلا من خلال التطبيق، بغض النظر عما تقوله هذه العلامة.بشكل افتراضي، يعيد الوكيل نصًا حرًا. للحصول على مخرجات منظمة، عيّن `responseFormat` إلى `{ type: 'json' }` ووفّر `schema`:diff --git a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdxindex 39c12d61f97..d883079afcc 100644--- a/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/logic/workflows.mdx@@ -72,6 +72,7 @@ export default defineWorkflow({* يربط `nextStepIds` الرسم البياني. يشير المشغّل إلى الخطوات الأولى، وتشير كل خطوة إلى الخطوات التي تُنفَّذ بعدها.* تقرأ الخطوة مخرجات سابقة باستخدام `{{trigger.\<path>}}` أو `{{\<step universalIdentifier>.\<path>}}`.* يتحقق البناء من التعريف بالكامل: إذ تؤدي أنواع المشغّلات أو الخطوات غير المدعومة، وروابط الخطوات المعطّلة، والمراجع إلى خطوات غير معروفة إلى فشله.+* `isSystem` (اختياري، القيمة الافتراضية هي `false`) يُخفي سير العمل من القوائم التي تستبعد مهام سير العمل الخاصة بالنظام. إنه يغيّر فقط ما يتم عرضه.## الإشارة إلى كيانات أخرىdiff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdxindex eab0103508c..ce519e46463 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/cli.mdx@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## تشغيل واجهة سطر الأوامر-تتصل واجهة سطر الأوامر `twenty` بمساحات عمل Twenty من طرفيتك. استخدمها لفحص البيانات الوصفية، وقراءة السجلات، وإرسال طلبات API، وإنشاء التطبيقات ومزامنتها وتصحيح أخطائها. تتطلب **Node.js 24.5 أو إصدارًا أحدث**.+تتصل واجهة سطر الأوامر `twenty` بمساحات عمل Twenty من طرفيتك. استخدمها لفحص البيانات الوصفية، وقراءة السجلات، وإرسال طلبات API، وإنشاء التطبيقات ومزامنتها وتصحيح أخطائها. يتطلب **Node.js 24.5+ أو 26.5+**.شغّل أي أمر عبر `npx`، من دون تثبيت أي شيء:diff --git a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdxindex ac2657c3ae5..7ec29fa79d1 100644--- a/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ar/developers/extend/apps/operations/publishing.mdx@@ -103,7 +103,7 @@ twenty app publish --private"name": "twenty-my-app","version": "1.0.0","engines": {- "node": "^24.5.0",+ "node": "^24.5.0 || ^26.5.1","twenty": ">=2.3.0"}}diff --git a/packages/twenty-docs/ar/ui/components/input/form-field-row.mdx b/packages/twenty-docs/ar/ui/components/input/form-field-row.mdxindex 43431bec5d2..287797c187b 100644--- a/packages/twenty-docs/ar/ui/components/input/form-field-row.mdx+++ b/packages/twenty-docs/ar/ui/components/input/form-field-row.mdx@@ -51,6 +51,10 @@ export const SubjectField = () => {الجذر هو مجموعة تُسمّى بواسطة `label`. وفّر `aria-label` أو `aria-labelledby` عند حذف التسمية المرئية، وسمِّ كل إدخال متداخل بشكل منفصل. لا ينقل الصف التركيز ولا يعطّل عناصر التحكم المتداخلة. تحتفظ عناصر التحكم هذه بسلوك لوحة المفاتيح وأنماط التركيز الخاصة بها.+تكون القيمة الافتراضية لـ `contentPaddingInline` هي رمز النسق `--t-spacing-2`، الذي يبلغ 8 بكسلات في النسق القياسي، ويقبل قيمة حشو CSS. تستخدم القيم الرقمية البكسلات. عيّن `contentPaddingInline={0}` لمحاذاة شرائح المستلمين وحقل إدخال مع المسافة البادئة للصف عند عدم وجود تسمية مرئية.++<StoryEmbed storyId="ui-input-formfieldrow--without-label" title="صف المستلمين بدون تسمية مرئية" height={110} />+## الأحداث والتخصيصتُطبَّق السمات الأصلية ومعالجات الأحداث و`className` و`style` و`ref` و`render` على جذر المجموعة. مرّر props وref الموفَّرين عند استبدال الجذر عبر `render`. يعرض معالج `onClick` مؤشرًا على شكل سهم. يتحكم المستدعي في سلوك النقر للتركيز، ويحمي الأحداث من عناصر التحكم المتداخلة أو البوابات عند الحاجة. يتيح `isHoverable` بشكل مستقل خلفية تمرير محايدة.diff --git a/packages/twenty-docs/es/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/es/developers/contribute/capabilities/local-setup.mdxindex e59f2430073..9e53576bf21 100644--- a/packages/twenty-docs/es/developers/contribute/capabilities/local-setup.mdx+++ b/packages/twenty-docs/es/developers/contribute/capabilities/local-setup.mdx@@ -12,13 +12,12 @@ import { PageBanner } from "/snippets/page-banner.mdx"Antes de que puedas instalar y usar Twenty, asegúrate de instalar lo siguiente en tu computadora:* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)-* [Node v24.5.0](https://nodejs.org/en/download)+* [Node v26](https://nodejs.org/en/download)* [yarn v4](https://yarnpkg.com/getting-started/install)* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)<Warning>-`npm` no funcionará, deberías usar `yarn` en su lugar. Yarn ahora se envía con Node.js, por lo que no necesitas instalarlo por separado.-Solo tienes que ejecutar `corepack enable` para habilitar Yarn si aún no lo has hecho.+`npm` no funcionará, deberías usar `yarn` en su lugar. Node 26 ya no incluye Corepack, así que instálalo una vez con `npm install -g corepack` y, luego, ejecuta `corepack enable` para habilitar Yarn.</Warning></Tab>@@ -64,6 +63,7 @@ nvm install # installs recommended node versionnvm use # use recommended node version+npm install -g corepackcorepack enable```diff --git a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdxindex 8e3fb2c3bfa..0d050b0b44b 100644--- a/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/config/roles.mdx@@ -207,6 +207,7 @@ Notas:* Se permite exactamente **una** llamada a `defineApplicationRole(...)` por aplicación; la compilación del manifiesto fallará si encuentra más de una.* Usa `defineRole()` (no `defineApplicationRole()`) para cualquier rol **adicional** que distribuya tu aplicación.* Configurar `defaultRoleUniversalIdentifier` explícitamente en `defineApplication()` sigue siendo compatible por motivos de retrocompatibilidad, pero está en desuso en favor de `defineApplicationRole()`. El identificador debe coincidir con un rol que defina tu aplicación; de lo contrario, la compilación falla.+* Un rol al que se pueden asignar miembros del espacio de trabajo o claves de API (`canBeAssignedToUsers` o `canBeAssignedToApiKeys`, ambos `true` cuando se omiten) es un rol personalizado y requiere el **plan Organization o superior**: en otros planes, se rechaza la instalación. Mantén ambos en `false` en los roles que solo tu aplicación y sus agentes asumen.### Roles de Agentediff --git a/packages/twenty-docs/es/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/es/developers/extend/apps/data/extending-objects.mdxindex 16af679b54f..35a6b98dd6c 100644--- a/packages/twenty-docs/es/developers/extend/apps/data/extending-objects.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/data/extending-objects.mdx@@ -48,8 +48,6 @@ export default defineField({* La ubicación del archivo depende de ti. La convención es `src/fields/\<name>.field.ts`, pero la CLI detecta campos en cualquier lugar de `src/`.-* La `writability` también se puede configurar por campo: `MetadataWritability.APPLICATION` restringe las escrituras a las funciones lógicas de tu propia app, `MetadataWritability.SYSTEM` está reservado para los datos gestionados por la plataforma. La capacidad de escritura de un campo solo puede ser más estricta que el nivel de su objeto, y las lecturas no se ven afectadas. Consulta [Objetos](/es/developers/extend/apps/data/objects) para ver la semántica completa.-* Se puede establecer `isSearchable: true` en `defineField()` con las mismas restricciones que los campos en línea (objeto de destino en el que se pueden realizar búsquedas, tipo de campo compatible con texto), de modo que los registros del objeto de destino se puedan encontrar mediante los valores de su campo en la búsqueda de texto completo.* Se puede establecer `isAuditLogged: false` en `defineField()` para mantener los cambios del campo fuera de la cronología del registro de destino, lo cual es especialmente importante para los campos que tu aplicación reescribe según una programación.diff --git a/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/es/developers/extend/apps/data/objects.mdxindex a866d6d60fe..768a463d305 100644--- a/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/data/objects.mdx@@ -103,17 +103,7 @@ export default defineObject({* Cada campo requiere `name`, `type`, `label` y su propio `universalIdentifier` estable.* La matriz `fields` es opcional: puedes definir objetos sin campos personalizados.* `openRecordIn` establece dónde se abren los registros de este objeto al hacer clic: `ObjectOpenRecordIn.USER_CHOICE` (el valor predeterminado, que sigue la preferencia de cada miembro del espacio de trabajo en Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` o `ObjectOpenRecordIn.RECORD_PAGE`. Fíjalo en `RECORD_PAGE` para los registros que necesitan una página completa para ser utilizables, como ocurre con los flujos de trabajo y los paneles, o en `SIDE_PANEL` para los registros que solo tienen sentido como un panel rápido, como los eventos del calendario.-* `writability` controla quién puede escribir registros del objeto en general, antes de que se apliquen los permisos por rol: `MetadataWritability.OPEN` (predeterminado — lo deciden los roles del espacio de trabajo), `MetadataWritability.APPLICATION` (solo las funciones de lógica de tu aplicación pueden crear, actualizar o eliminar registros; usa esto para objetos de configuración cuyos registros definen el comportamiento, de modo que los miembros del espacio de trabajo con amplio acceso a registros no puedan editarlos a través de la API) o `MetadataWritability.SYSTEM` (reservado para datos gestionados por la plataforma). Las lecturas no se ven afectadas: esto se aplica en el lado del servidor, a diferencia de `isUIEditable`, que solo oculta las funcionalidades de la interfaz de usuario. También existe por campo, donde solo puede ser más restrictivo que el nivel del objeto.-* `readability` declara quién puede leer los registros del objeto: `MetadataReadability.OPEN` (el valor predeterminado; los roles del espacio de trabajo deciden), `MetadataReadability.PRIVATE` (solo las entidades principales con las que se compartió el registro), `MetadataReadability.INHERITED` (quien lea el registro principal), `MetadataReadability.APPLICATION` (solo las funciones lógicas de tu propia aplicación) o `MetadataReadability.SYSTEM` (datos administrados por la plataforma). Todas las políticas de legibilidad siempre se aplican.-* `readabilityParentFieldUniversalIdentifiers` va con `MetadataReadability.INHERITED`: los identificadores universales de los campos de relación que conducen a los registros padre.- * Un campo de muchos a uno nombra el registro al que apunta la fila. Declarar un campo de una relación polimórfica abarca todos los destinos de esa relación.- * Un campo de uno a muchos nombra un objeto secundario cuyas filas apuntan de vuelta al registro, como las filas de unión de una relación de muchos a muchos. El registro se puede leer entonces cuando al menos una de esas filas conduce a un registro legible: una nota sigue a las personas, empresas y oportunidades a las que la adjuntan los destinos de su nota.- * Varios registros padre se combinan como una unión: basta con que uno de ellos sea legible.- * Un padre concede acceso conforme a su política completa, la que se aplica a una consulta del padre: el permiso del lector sobre el objeto padre, las restricciones a nivel de fila de su función y la propia capacidad de lectura del padre. Un registro nunca se muestra a través de un padre que su lector no pudiera consultar. Las suscripciones, los webhooks, los flujos de trabajo y las funciones lógicas deciden qué alcanza un evento de un registro `INHERITED` conforme a esa misma política.- * Las filas de uso compartido del propio registro conceden acceso exactamente igual que en un registro `PRIVATE`. Su creador recibe una cuando se crea el registro mientras está habilitado el uso compartido de registros, de modo que quien haya creado un registro siga viéndolo, y un registro cuyos campos padre estén todos vacíos sea visible para aquellos con quienes se compartió directamente.- * Un objeto `INHERITED` que no nombra ningún campo principal utilizable se comporta como uno `PRIVATE`.-* `sharingReach` establece hasta qué punto se puede compartir por nombre un registro del objeto: `ObjectSharingReach.WORKSPACE` (el valor predeterminado: un registro puede compartirse con cualquier persona del espacio de trabajo, incluso alguien cuyo rol no pueda acceder al objeto o cuyo filtro de nivel de fila oculte el registro; solo obtiene ese registro, para verlo o editarlo) o `ObjectSharingReach.ROLE_ACCESS` (las comparticiones nunca van más allá de los permisos de rol y de nivel de fila). Elige `ROLE_ACCESS` para objetos confidenciales en los que ningún acceso debe significar ningún acceso. Los roles que pueden actualizar todos los ajustes ven todos los registros de un objeto `OPEN`, independientemente de sus restricciones de uso compartido; sus permisos de objeto y filtros de nivel de fila siguen aplicándose. Solo se aplica mientras el uso compartido de registros esté habilitado en el espacio de trabajo, y solo a objetos cuyos registros pueden compartirse: objetos `MetadataReadability.OPEN`, `PRIVATE` e `INHERITED` que no sean objetos del sistema. Los objetos `APPLICATION` y `SYSTEM` nunca se comparten.-* `disabledObjectPermissionActions` enumera los permisos de objeto que no se pueden conceder sobre el objeto: cualquiera de `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` y `'canDestroyObjectRecords'`, las mismas marcas que un rol establece por objeto. No se puede guardar un permiso de objeto que conceda uno de ellos sobre este objeto; por ejemplo, `disabledObjectPermissionActions: ['canDestroyObjectRecords']` impide específicamente que se conceda a cualquier rol la acción de destruirlo. No cambia lo que pueden hacer los roles que conceden una acción sobre todos los objetos.+* `disabledObjectPermissionActions` enumera los permisos de objeto que no se pueden conceder sobre el objeto: cualquiera de `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` y `'canDestroyObjectRecords'`, las mismas marcas que un rol establece por objeto. Los usuarios, las claves de API y los agentes nunca obtienen estas acciones sobre el objeto, independientemente de lo que conceda su rol, y falla al guardar un permiso de objeto que concede una de ellas. Las funciones de lógica propias de tu aplicación las conservan. Por ejemplo, `['canUpdateObjectRecords', 'canSoftDeleteObjectRecords', 'canDestroyObjectRecords']` hace que un objeto solo pueda ser escrito por tu aplicación, para registros similares a configuraciones que conceden comportamiento.* `color` establece el color de acento del objeto en la IU. Omítelo y Twenty elegirá uno para el objeto.* `imageIdentifierFieldMetadataUniversalIdentifier` nombra el campo cuyo valor se muestra como el avatar del registro. Omítelo para que Twenty elija el predeterminado.* `isLabelSyncedWithName`, en un objeto o en un campo, mantiene el nombre de la API sincronizado con la etiqueta cuando esta se edita en Configuración. De forma predeterminada es `false`, por lo que una etiqueta renombrada deja el nombre sin cambios.diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdxindex 4fe02eafaf6..23537ac4ee7 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Antes de empezar-Usa Node.js 24.5+ y Yarn 4. Instala la CLI globalmente; tu aplicación conserva sus propias dependencias del SDK.+Usa Node.js 24.5+ o 26.5+ y Yarn 4 (mediante Corepack: `corepack enable`; en Node 26, instálalo primero con `npm install -g corepack`). Instala la CLI globalmente; tu aplicación conserva sus propias dependencias del SDK.<Note>La compilación de aplicaciones Twenty solo es compatible oficialmente con sistemas Unix (macOS y Linux). En Windows, trabaja dentro de WSL 2.diff --git a/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdxindex 6958c857911..ffd27c91c82 100644--- a/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/getting-started/troubleshooting.mdx@@ -8,8 +8,8 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Problemas comunes* **Errores del servidor local**, comprueba tu entorno de desarrollo de Docker o del repositorio. La CLI independiente no administra contenedores.-* **Versión de Node incorrecta** — Se necesita la versión 24.5 o superior (`engines.node: ^24.5.0`). Compruébalo con `node -v`.-* **Falta Yarn 4** — Ejecuta `corepack enable`.+* **Versión de Node incorrecta** — Se necesita 24.5+ o 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Compruébalo con `node -v`.+* **Falta Yarn 4** — Ejecuta `corepack enable` (en Node 26, primero `npm install -g corepack`).* **Dependencias rotas** — `rm -rf node_modules && yarn install`.* **`yarn.lock` vacío** — La compilación falla con "yarn.lock is empty" cuando el archivo de bloqueo existe pero no tiene contenido; ejecuta `yarn install` para regenerarlo.* **Errores de `twenty-sdk` tras actualizar a la v2.8.0** — Pasó de `dependencies` a `devDependencies` en la v2.8.0. Consulta [Estructura del proyecto → Dependencias](/es/developers/extend/apps/getting-started/project-structure#dependencies).diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdxindex 90c5052c05f..3b206339319 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/logic-functions.mdx@@ -1040,7 +1040,7 @@ const { createCompany } = await client.mutation({},});-// Only on an object whose readability is PRIVATE: choose who can read the created record+// Only on an object whose records are private: choose who can read the created recordconst { createContract } = await client.mutation({createContract: {__args: {@@ -1059,7 +1059,7 @@ const { createContract } = await client.mutation({});```-`shareWith` solo importa en un objeto cuya legibilidad sea `PRIVATE`; todos los objetos son `OPEN` de forma predeterminada y, en un objeto `OPEN`, se ignora el argumento. En un objeto `PRIVATE`, enumera quién obtiene acceso al registro creado: cada entrada se dirige exactamente a uno de `workspaceMemberId`, `roleId` o `everyone: true` con un `accessLevel` de `READ`, `READ_WRITE` o `FULL`. Un miembro del espacio de trabajo que crea un registro siempre recibe una concesión de propietario `FULL`, por lo que el argumento es opcional para él; una función lógica que actúa como su aplicación o una clave de API también recibe una concesión `FULL` para su rol, y quienes realizan dichas llamadas, al igual que una llamada del sistema, deben pasar `shareWith` o se rechaza la creación. Cada entrada debe indicar un miembro o un rol del espacio de trabajo. Una función lógica o clave de API comparte mediante su rol, por lo que cada titular de ese rol obtiene el mismo acceso a los registros que crea; asigne a una clave cuyos registros deban permanecer privados para ella un rol propio.+`shareWith` solo es relevante en un objeto cuyos registros son privados; en otros casos, el argumento se ignora. En dicho objeto, enumera quién obtiene acceso al registro creado: cada entrada se dirige exactamente a uno de `workspaceMemberId`, `roleId` o `everyone: true` con un `accessLevel` de `READ`, `READ_WRITE` o `FULL`. Un miembro del espacio de trabajo que crea un registro siempre recibe una concesión de propietario `FULL`, por lo que el argumento es opcional para él; una función lógica que actúa como su aplicación o una clave de API también recibe una concesión `FULL` para su rol, y quienes realizan dichas llamadas, al igual que una llamada del sistema, deben pasar `shareWith` o se rechaza la creación. Cada entrada debe indicar un miembro o un rol del espacio de trabajo. Una función lógica o clave de API comparte mediante su rol, por lo que cada titular de ese rol obtiene el mismo acceso a los registros que crea; asigne a una clave cuyos registros deban permanecer privados para ella un rol propio.El cliente usa una sintaxis de conjunto de selección: pasa `true` para incluir un campo, usa `__args` para los argumentos y anida objetos para las relaciones. Obtienes autocompletado completo y verificación de tipos basados en el esquema de tu espacio de trabajo.diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdxindex 954f7fa9754..b9cc69f41f3 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/skills-and-agents.mdx@@ -69,6 +69,8 @@ Puntos clave:* `modelId` (opcional) reemplaza el modelo de IA predeterminado usado por el agente.* `responseFormat` (opcional) establece la estructura de salida predeterminada del agente. De forma predeterminada es `{ type: 'text' }` para texto de formato libre. Usa `{ type: 'json', schema }` para forzar una salida JSON estructurada. Una llamada a `runAgent()` o un paso de IA de un flujo de trabajo puede solicitar una estructura diferente, que tiene prioridad.* `roleUniversalIdentifier` (opcional) vincula el agente a un rol que define tu aplicación. Ese rol no debe otorgar más que el rol de la aplicación, o la compilación falla; consulta [Roles de agente](/es/developers/extend/apps/config/roles#agent-roles).+* `modelConfiguration` (opcional) activa las herramientas nativas del modelo, como lo hace la página de configuración del agente: `{ webSearch: { enabled: true }, twitterSearch: { enabled: true } }`. Cada herramienta solo funciona con los modelos que la admiten. Omítelo para mantenerlas desactivadas.+* `isSystem` (opcional, el valor predeterminado es `false`) oculta el agente de las listas de agentes, como los agentes que Twenty crea para los pasos de IA de flujo de trabajo. Solo cambia lo que se muestra: los agentes de una aplicación solo se pueden cambiar mediante la aplicación, independientemente de lo que indique esta marca.De forma predeterminada, un agente devuelve texto de formato libre. Para obtener una salida estructurada, establece `responseFormat` en `{ type: 'json' }` y proporciona un `schema`:diff --git a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdxindex 6898f93880a..3a9841cfc1f 100644--- a/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/logic/workflows.mdx@@ -72,6 +72,7 @@ Puntos clave:* `nextStepIds` conecta el grafo. El desencadenador apunta a los primeros pasos, y cada paso apunta a los pasos que se ejecutan después de él.* Un paso lee la salida anterior con `{{trigger.\<path>}}` o `{{\<step universalIdentifier>.\<path>}}`.* La compilación valida toda la definición: los tipos de desencadenador o de paso no compatibles, los enlaces de pasos rotos y las referencias a pasos desconocidos hacen que falle.+* `isSystem` (opcional, el valor predeterminado es `false`) oculta el flujo de trabajo de las listas que excluyen los flujos de trabajo del sistema. Solo cambia lo que se muestra.## Referencia a otras entidadesdiff --git a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdxindex 2202a58b614..5e8d95080f9 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/cli.mdx@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Ejecutar la CLI-La CLI `twenty` se conecta a espacios de trabajo de Twenty desde tu terminal. Úsala para inspeccionar metadatos, leer registros, enviar solicitudes de API y crear, sincronizar y depurar aplicaciones. Requiere **Node.js 24.5 o posterior**.+La CLI `twenty` se conecta a espacios de trabajo de Twenty desde tu terminal. Úsala para inspeccionar metadatos, leer registros, enviar solicitudes de API y crear, sincronizar y depurar aplicaciones. Necesita **Node.js 24.5+ o 26.5+**.Ejecuta cualquier comando mediante `npx`, sin instalar nada:diff --git a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdxindex fbedc23432a..84b1660c46e 100644--- a/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/es/developers/extend/apps/operations/publishing.mdx@@ -104,7 +104,7 @@ Si tu app usa una función introducida en una versión específica del servidor"name": "twenty-my-app","version": "1.0.0","engines": {- "node": "^24.5.0",+ "node": "^24.5.0 || ^26.5.1","twenty": ">=2.3.0"}}diff --git a/packages/twenty-docs/es/ui/components/input/form-field-row.mdx b/packages/twenty-docs/es/ui/components/input/form-field-row.mdxindex 171408b8884..1817fd92080 100644--- a/packages/twenty-docs/es/ui/components/input/form-field-row.mdx+++ b/packages/twenty-docs/es/ui/components/input/form-field-row.mdx@@ -51,6 +51,10 @@ export const SubjectField = () => {La raíz es un grupo denominado por `label`. Proporcione `aria-label` o `aria-labelledby` cuando se omita la etiqueta visible y etiquete cada entrada anidada por separado. La fila no mueve el foco ni deshabilita los controles anidados. Esos controles conservan su propio comportamiento de teclado y estilo de foco.+`contentPaddingInline` usa de forma predeterminada el token de tema `--t-spacing-2`, que equivale a 8 píxeles en el tema estándar, y acepta un valor CSS de relleno. Los valores numéricos usan píxeles. Establece `contentPaddingInline={0}` para alinear las fichas de destinatarios y un campo de entrada con la sangría de la fila cuando no hay una etiqueta visible.++<StoryEmbed storyId="ui-input-formfieldrow--without-label" title="Fila de destinatarios sin una etiqueta visible" height={110} />+## Eventos y personalizaciónLos atributos nativos, los controladores de eventos, `className`, `style`, `ref` y `render` se aplican a la raíz del grupo. Reenvíe las props proporcionadas y ref al reemplazar la raíz mediante `render`. Un controlador `onClick` muestra un cursor de puntero. Quien realiza la llamada controla el comportamiento de hacer clic para enfocar y, cuando es necesario, protege los eventos de los controles anidados o portales. `isHoverable` habilita de forma independiente un fondo neutro al pasar el cursor.diff --git a/packages/twenty-docs/it/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/it/developers/contribute/capabilities/local-setup.mdxindex 7dc74865129..cd4ffff042a 100644--- a/packages/twenty-docs/it/developers/contribute/capabilities/local-setup.mdx+++ b/packages/twenty-docs/it/developers/contribute/capabilities/local-setup.mdx@@ -12,13 +12,12 @@ import { PageBanner } from "/snippets/page-banner.mdx"Prima di poter installare e usare Twenty, assicurati di installare quanto segue sul tuo computer:* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)-* [Node v24.5.0](https://nodejs.org/en/download)+* [Node v26](https://nodejs.org/en/download)* [yarn v4](https://yarnpkg.com/getting-started/install)* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)<Warning>-`npm` non funzionerà, dovresti usare `yarn` invece. Yarn è ora incluso con Node.js, quindi non è necessario installarlo separatamente.-Devi solo eseguire `corepack enable` per abilitare Yarn se non l'hai ancora fatto.+`npm` non funzionerà, dovresti usare `yarn` invece. Node 26 non include più Corepack, quindi installalo una volta con `npm install -g corepack`, quindi esegui `corepack enable` per abilitare Yarn.</Warning></Tab>@@ -64,6 +63,7 @@ nvm install # installs recommended node versionnvm use # use recommended node version+npm install -g corepackcorepack enable```diff --git a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdxindex 4368fd3afd3..9523acb248d 100644--- a/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/config/roles.mdx@@ -213,6 +213,7 @@ Note:* È consentita esattamente **una** chiamata a `defineApplicationRole(...)` per app — la build del manifest avrà esito negativo se ne trova più di una.* Usa `defineRole()` (non `defineApplicationRole()`) per qualsiasi ruolo **aggiuntivo** fornito dalla tua app.* L’impostazione esplicita di `defaultRoleUniversalIdentifier` in `defineApplication()` è ancora supportata per retrocompatibilità, ma è deprecata a favore di `defineApplicationRole()`. L'identificatore deve corrispondere a un ruolo definito dall'app, altrimenti la build non riesce.+* Un ruolo a cui possono essere assegnati membri dello spazio di lavoro o chiavi API (`canBeAssignedToUsers` o `canBeAssignedToApiKeys`, entrambi `true` se omessi) è un ruolo personalizzato e richiede il **piano Organization o superiore**: con altri piani l'installazione viene rifiutata. Mantieni entrambi su `false` per i ruoli che vengono eseguiti solo dalla tua app e dai relativi agenti.### Ruoli agentediff --git a/packages/twenty-docs/it/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/it/developers/extend/apps/data/extending-objects.mdxindex fee63910908..61ac3ddc82f 100644--- a/packages/twenty-docs/it/developers/extend/apps/data/extending-objects.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/data/extending-objects.mdx@@ -48,8 +48,6 @@ export default defineField({* Il percorso del file dipende da te. La convenzione è `src/fields/\<name>.field.ts`, ma la CLI rileva i campi ovunque in `src/`.-* La `writability` può anche essere impostata per singolo campo: `MetadataWritability.APPLICATION` limita le scritture alle sole funzioni di logica della tua app, mentre `MetadataWritability.SYSTEM` è riservata ai dati gestiti dalla piattaforma. La writability di un campo può essere solo più restrittiva rispetto al livello del relativo oggetto e le letture non sono influenzate. Consulta [Objects](/it/developers/extend/apps/data/objects) per i dettagli completi sulla semantica.-* È possibile impostare `isSearchable: true` su `defineField()` con gli stessi vincoli dei campi inline (oggetto di destinazione ricercabile, tipo di campo compatibile con il testo), in modo che i record dell'oggetto di destinazione siano individuabili tramite i valori del campo nella ricerca full-text.* È possibile impostare `isAuditLogged: false` su `defineField()` per escludere le modifiche del campo dalla cronologia del record di destinazione, il che è particolarmente importante per i campi che l'app riscrive secondo una pianificazione.diff --git a/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/it/developers/extend/apps/data/objects.mdxindex 621120b1a4f..ce4296cc4af 100644--- a/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/data/objects.mdx@@ -103,17 +103,7 @@ export default defineObject({* Ogni campo richiede un `name`, `type`, `label` e il proprio `universalIdentifier` stabile.* L'array `fields` è facoltativo: puoi definire oggetti senza campi personalizzati.* `openRecordIn` imposta dove si aprono i record di questo oggetto quando vengono cliccati: `ObjectOpenRecordIn.USER_CHOICE` (l'impostazione predefinita, che segue la preferenza di ciascun membro dell'area di lavoro da Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` oppure `ObjectOpenRecordIn.RECORD_PAGE`. Fissalo su `RECORD_PAGE` per i record che devono occupare un'intera pagina per essere usabili, come avviene per i workflow e le dashboard, oppure su `SIDE_PANEL` per i record che hanno senso solo come pannello rapido, come avviene per gli eventi di calendario.-* `writability` controlla chi può scrivere i record dell'oggetto in generale, prima che si applichino le autorizzazioni basate sui ruoli: `MetadataWritability.OPEN` (impostazione predefinita — i ruoli dello spazio di lavoro decidono), `MetadataWritability.APPLICATION` (solo le funzioni logiche della tua app possono creare, aggiornare o eliminare record; usa questa impostazione per oggetti simili a configurazioni i cui record determinano il comportamento, in modo che i membri dello spazio di lavoro con un ampio accesso ai record non possano modificarli tramite l'API) oppure `MetadataWritability.SYSTEM` (riservato ai dati gestiti dalla piattaforma). Le letture non sono influenzate — questo è applicato lato server, diversamente da `isUIEditable`, che si limita a nascondere gli elementi dell'interfaccia utente. Esiste anche per singolo campo, dove può essere soltanto più restrittivo rispetto al livello dell'oggetto.-* `readability` dichiara chi può leggere i record dell'oggetto: `MetadataReadability.OPEN` (l'impostazione predefinita — decidono i ruoli dell'area di lavoro), `MetadataReadability.PRIVATE` (solo i principali con cui è stato condiviso il record), `MetadataReadability.INHERITED` (chiunque legga il record padre), `MetadataReadability.APPLICATION` (solo le funzioni logiche della tua app) o `MetadataReadability.SYSTEM` (dati gestiti dalla piattaforma). Tutti i criteri di leggibilità vengono sempre applicati.-* `readabilityParentFieldUniversalIdentifiers` va con `MetadataReadability.INHERITED`: gli identificatori universali dei campi di relazione che conducono ai record padre.- * Un campo molti-a-uno denomina il record a cui punta la riga. La dichiarazione di un campo di una relazione morfica copre ogni destinazione di tale relazione.- * Un campo uno-a-molti denomina un oggetto figlio le cui righe puntano al record, come le righe di collegamento di una relazione molti-a-molti. Il record è quindi leggibile quando almeno una di tali righe conduce a un record leggibile: una nota segue le persone, le aziende e le opportunità a cui la collegano le destinazioni della nota.- * Più elementi padre si combinano come un'unione: è sufficiente un elemento padre leggibile.- * Un elemento padre concede l'accesso in base alla sua policy completa, quella applicata da una query dell'elemento padre: l'autorizzazione del lettore sull'oggetto padre, le restrizioni a livello di riga del suo ruolo e la leggibilità dell'elemento padre stesso. Un record non viene mai mostrato tramite un elemento padre su cui il suo lettore non potrebbe eseguire una query. Le sottoscrizioni, i webhook, i flussi di lavoro e le funzioni logiche determinano cosa raggiunge un evento di un record `INHERITED` secondo quella stessa policy.- * Le righe di condivisione sul record stesso concedono l'accesso esattamente come su un record `PRIVATE`. Il suo creatore ne riceve una quando il record viene creato mentre la condivisione dei record è abilitata, quindi chiunque abbia creato un record continua a vederlo e un record i cui campi padre sono tutti vuoti è visibile a coloro con cui è stato condiviso direttamente.- * Un oggetto `INHERITED` che non specifica alcun campo padre utilizzabile si comporta come uno `PRIVATE`.-* `sharingReach` imposta fino a che punto un record dell'oggetto può essere condiviso per nome: `ObjectSharingReach.WORKSPACE` (il valore predefinito: un record può essere condiviso con chiunque nello spazio di lavoro, anche con qualcuno il cui ruolo non può accedere all'oggetto o il cui filtro a livello di riga nasconde il record; questa persona ottiene solo quel record, da visualizzare o modificare) oppure `ObjectSharingReach.ROLE_ACCESS` (le condivisioni non vanno mai oltre le autorizzazioni del ruolo e a livello di riga). Scegli `ROLE_ACCESS` per gli oggetti sensibili per i quali nessun accesso deve significare nessun accesso. I ruoli che possono aggiornare tutte le impostazioni vedono ogni record di un oggetto `OPEN`, indipendentemente dalle relative restrizioni di condivisione; si applicano comunque le loro autorizzazioni per gli oggetti e i filtri a livello di riga. Si applica solo quando la condivisione dei record è abilitata nello spazio di lavoro e solo agli oggetti i cui record possono essere condivisi: oggetti `MetadataReadability.OPEN`, `PRIVATE` e `INHERITED` che non sono oggetti di sistema. Gli oggetti `APPLICATION` e `SYSTEM` non vengono mai condivisi.-* `disabledObjectPermissionActions` elenca le autorizzazioni degli oggetti che non possono essere concesse sull'oggetto: una qualsiasi tra `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` e `'canDestroyObjectRecords'`, gli stessi flag che un ruolo imposta per ciascun oggetto. Il salvataggio di un'autorizzazione dell'oggetto che concede una di esse su questo oggetto non riesce; ad esempio, `disabledObjectPermissionActions: ['canDestroyObjectRecords']` impedisce che a qualsiasi ruolo venga concessa l'eliminazione definitiva specificamente su di esso. Non modifica ciò che possono fare i ruoli che concedono un'azione su tutti gli oggetti.+* `disabledObjectPermissionActions` elenca le autorizzazioni degli oggetti che non possono essere concesse sull'oggetto: una qualsiasi tra `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` e `'canDestroyObjectRecords'`, gli stessi flag che un ruolo imposta per ciascun oggetto. Gli utenti, le chiavi API e gli agenti non ottengono mai queste azioni sull'oggetto, indipendentemente da ciò che concede il loro ruolo, e il salvataggio di un'autorizzazione per l'oggetto che ne concede una non riesce. Le funzioni della logica della tua app le mantengono. Ad esempio, `['canUpdateObjectRecords', 'canSoftDeleteObjectRecords', 'canDestroyObjectRecords']` rende un oggetto scrivibile solo dalla tua app, per record simili a configurazioni che concedono comportamenti.* `color` imposta il colore di accento dell'oggetto nell'interfaccia utente. Omettilo e Twenty ne sceglierà uno per l'oggetto.* `imageIdentifierFieldMetadataUniversalIdentifier` denomina il campo il cui valore viene mostrato come avatar del record. Omettilo per consentire a Twenty di scegliere quello predefinito.* `isLabelSyncedWithName`, su un oggetto o su un campo, mantiene il nome API sincronizzato con l'etichetta quando quest'ultima viene modificata in Impostazioni. Per impostazione predefinita è `false`, quindi un'etichetta rinominata lascia invariato il nome.diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdxindex 57025df11f0..ea8ccb6fa69 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Prima di iniziare-Usa Node.js 24.5+ e Yarn 4. Installa il CLI a livello globale; la tua app mantiene le proprie dipendenze SDK.+Usa Node.js 24.5+ o 26.5+ e Yarn 4 (tramite Corepack: `corepack enable`; su Node 26, installalo prima con `npm install -g corepack`). Installa il CLI a livello globale; la tua app mantiene le proprie dipendenze SDK.<Note>La compilazione delle app Twenty è supportata ufficialmente solo sui sistemi Unix (macOS e Linux). Su Windows, lavora all'interno di WSL 2.diff --git a/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdxindex 5715ed177fc..3e4292bdad9 100644--- a/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/getting-started/troubleshooting.mdx@@ -8,8 +8,8 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Problemi comuni* **Errori del server locale**, controlla l'ambiente di sviluppo Docker o del repository. La CLI standalone non gestisce i container.-* **Versione di Node errata** — È necessaria la versione 24.5+ (`engines.node: ^24.5.0`). Verifica con `node -v`.-* **Manca Yarn 4** — Esegui `corepack enable`.+* **Versione di Node errata** — È necessaria la versione 24.5+ o 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Verifica con `node -v`.+* **Yarn 4 mancante** — Esegui `corepack enable` (su Node 26, prima `npm install -g corepack`).* **Dipendenze danneggiate** — `rm -rf node_modules && yarn install`.* **`yarn.lock` vuoto** — La build non riesce e mostra "yarn.lock is empty" quando il file di lock esiste ma non contiene alcun contenuto; esegui `yarn install` per rigenerarlo.* **Errori di `twenty-sdk` dopo l'aggiornamento alla v2.8.0** — è stato spostato da `dependencies` a `devDependencies` nella v2.8.0. Vedi [Struttura del progetto → Dipendenze](/it/developers/extend/apps/getting-started/project-structure#dependencies).diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdxindex 23178d8e7de..8a24a00e1ed 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/logic-functions.mdx@@ -1040,7 +1040,7 @@ const { createCompany } = await client.mutation({},});-// Only on an object whose readability is PRIVATE: choose who can read the created record+// Only on an object whose records are private: choose who can read the created recordconst { createContract } = await client.mutation({createContract: {__args: {@@ -1059,7 +1059,7 @@ const { createContract } = await client.mutation({});```-`shareWith` ha effetto solo su un oggetto la cui leggibilità è `PRIVATE`; per impostazione predefinita ogni oggetto è `OPEN` e, su un oggetto `OPEN`, l'argomento viene ignorato. Su un oggetto `PRIVATE`, elenca chi ottiene l'accesso al record creato: ogni voce si riferisce esattamente a uno tra `workspaceMemberId`, `roleId` o `everyone: true`, con un `accessLevel` pari a `READ`, `READ_WRITE` o `FULL`. Un membro dello spazio di lavoro che crea un record riceve sempre un'autorizzazione proprietario `FULL`, quindi l'argomento è facoltativo per lui; anche una funzione logica che agisce come relativa applicazione o una chiave API riceve un'autorizzazione `FULL` per il proprio ruolo e tali chiamanti, come un chiamante di sistema, devono passare `shareWith`, altrimenti la creazione viene rifiutata. Ogni voce deve indicare un membro o un ruolo dello spazio di lavoro. Una funzione logica o una chiave API condivide tramite il proprio ruolo, quindi ogni titolare di tale ruolo ottiene lo stesso accesso ai record che crea; assegna a una chiave i cui record devono rimanere privati un ruolo proprio.+`shareWith` è rilevante solo su un oggetto i cui record sono privati; altrove l'argomento viene ignorato. Su un oggetto di questo tipo, elenca chi ottiene l'accesso al record creato: ogni voce si rivolge esattamente a uno tra `workspaceMemberId`, `roleId` o `everyone: true`, con un `accessLevel` pari a `READ`, `READ_WRITE` o `FULL`. Un membro dello spazio di lavoro che crea un record riceve sempre un'autorizzazione proprietario `FULL`, quindi l'argomento è facoltativo per lui; anche una funzione logica che agisce come relativa applicazione o una chiave API riceve un'autorizzazione `FULL` per il proprio ruolo e tali chiamanti, come un chiamante di sistema, devono passare `shareWith`, altrimenti la creazione viene rifiutata. Ogni voce deve indicare un membro o un ruolo dello spazio di lavoro. Una funzione logica o una chiave API condivide tramite il proprio ruolo, quindi ogni titolare di tale ruolo ottiene lo stesso accesso ai record che crea; assegna a una chiave i cui record devono rimanere privati un ruolo proprio.Il client utilizza una sintassi a selection-set: passa `true` per includere un campo, usa `__args` per gli argomenti e annida oggetti per le relazioni. Ottieni completamento automatico e controllo dei tipi completi basati sullo schema del tuo spazio di lavoro.diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdxindex 4789db2a5a9..d96728e935b 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/skills-and-agents.mdx@@ -69,6 +69,8 @@ Punti chiave:* `modelId` (opzionale) sostituisce il modello di IA predefinito utilizzato dall'agente.* `responseFormat` (facoltativo) imposta il formato di output predefinito dell'agente. Per il testo in formato libero, il valore predefinito è `{ type: 'text' }`. Usa `{ type: 'json', schema }` per forzare un output JSON strutturato. Una chiamata a `runAgent()` o un passaggio AI di un workflow può richiedere un formato diverso, che ha la precedenza.* `roleUniversalIdentifier` (facoltativo) associa l'agente a un ruolo definito dalla tua app. Quel ruolo non deve concedere più del ruolo dell'applicazione, altrimenti la build non riesce; vedi [Ruoli degli agenti](/it/developers/extend/apps/config/roles#agent-roles).+* `modelConfiguration` (facoltativo) attiva gli strumenti nativi del modello, come fa la pagina delle impostazioni dell'agente: `{ webSearch: { enabled: true }, twitterSearch: { enabled: true } }`. Ogni strumento funziona solo con i modelli che lo supportano. Omettilo per mantenerli disattivati.+* `isSystem` (facoltativo, il valore predefinito è `false`) nasconde l'agente dagli elenchi di agenti, come gli agenti che Twenty crea per i passaggi IA dei workflow. Modifica solo ciò che viene visualizzato: gli agenti di un'app possono essere modificati solo tramite l'app, indipendentemente da quanto indica questo flag.Per impostazione predefinita, un agente restituisce testo in formato libero. Per ottenere un output strutturato, imposta `responseFormat` su `{ type: 'json' }` e fornisci uno `schema`:diff --git a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdxindex 0fbe935bcbf..628a21e0548 100644--- a/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/logic/workflows.mdx@@ -72,6 +72,7 @@ Punti chiave:* `nextStepIds` collega il grafo. Il trigger punta ai primi passaggi e ogni passaggio punta ai passaggi eseguiti dopo di esso.* Un passaggio legge l'output precedente con `{{trigger.\<path>}}` o `{{\<step universalIdentifier>.\<path>}}`.* La build convalida l'intera definizione: tipi di trigger o passaggio non supportati, collegamenti tra passaggi non validi e riferimenti a passaggi sconosciuti causano l'errore.+* `isSystem` (facoltativo, il valore predefinito è `false`) nasconde il workflow dagli elenchi che escludono i workflow di sistema. Modifica solo ciò che viene visualizzato.## Riferimento ad altre entitàdiff --git a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdxindex c5432ad7d01..4176bb7250e 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/cli.mdx@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Esecuzione della CLI-La CLI `twenty` si connette agli spazi di lavoro Twenty dal tuo terminale. Usala per ispezionare i metadati, leggere i record, inviare richieste API e creare, sincronizzare ed eseguire il debug delle app. Richiede **Node.js 24.5 o versione successiva**.+La CLI `twenty` si connette agli spazi di lavoro Twenty dal tuo terminale. Usala per ispezionare i metadati, leggere i record, inviare richieste API e creare, sincronizzare ed eseguire il debug delle app. Richiede **Node.js 24.5+ o 26.5+**.Esegui qualsiasi comando tramite `npx`, senza installare nulla:diff --git a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdxindex 7ba3cc268b7..2522e2829e0 100644--- a/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/it/developers/extend/apps/operations/publishing.mdx@@ -104,7 +104,7 @@ Se la tua app utilizza una funzionalità introdotta in una specifica versione de"name": "twenty-my-app","version": "1.0.0","engines": {- "node": "^24.5.0",+ "node": "^24.5.0 || ^26.5.1","twenty": ">=2.3.0"}}diff --git a/packages/twenty-docs/it/ui/components/input/form-field-row.mdx b/packages/twenty-docs/it/ui/components/input/form-field-row.mdxindex 765c1188f9f..2a72e0e0ce3 100644--- a/packages/twenty-docs/it/ui/components/input/form-field-row.mdx+++ b/packages/twenty-docs/it/ui/components/input/form-field-row.mdx@@ -51,6 +51,10 @@ export const SubjectField = () => {La radice è un gruppo denominato da `label`. Fornisci `aria-label` o `aria-labelledby` quando l'etichetta visibile è omessa ed etichetta separatamente ogni input annidato. La riga non sposta lo stato attivo né disabilita i controlli annidati. Tali controlli mantengono il proprio comportamento da tastiera e lo stile dello stato attivo.+`contentPaddingInline` usa per impostazione predefinita il token del tema `--t-spacing-2`, che nel tema standard corrisponde a 8 pixel, e accetta un valore CSS di padding. I valori numerici usano i pixel. Imposta `contentPaddingInline={0}` per allineare i chip dei destinatari e un input al rientro della riga quando non è presente alcuna etichetta visibile.++<StoryEmbed storyId="ui-input-formfieldrow--without-label" title="Riga dei destinatari senza un'etichetta visibile" height={110} />+## Eventi e personalizzazioneGli attributi nativi, i gestori di eventi, `className`, `style`, `ref` e `render` si applicano alla radice del gruppo. Inoltra le props e il ref forniti quando sostituisci la radice tramite `render`. Un gestore `onClick` mostra un cursore a forma di puntatore. Il chiamante gestisce il comportamento di messa a fuoco al clic e, se necessario, protegge gli eventi dai controlli annidati o dai portali. `isHoverable` abilita in modo indipendente uno sfondo neutro al passaggio del mouse.diff --git a/packages/twenty-docs/ro/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/ro/developers/contribute/capabilities/local-setup.mdxindex 9a7186afd49..26cca907c54 100644--- a/packages/twenty-docs/ro/developers/contribute/capabilities/local-setup.mdx+++ b/packages/twenty-docs/ro/developers/contribute/capabilities/local-setup.mdx@@ -12,13 +12,12 @@ import { PageBanner } from "/snippets/page-banner.mdx"Înainte de a instala și utiliza Twenty, asigurați-vă că instalați următoarele pe computerul dvs:* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)-* [Node v24.5.0](https://nodejs.org/en/download)+* [Node v26](https://nodejs.org/en/download)* [yarn v4](https://yarnpkg.com/getting-started/install)* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)<Warning>-`npm` nu va funcționa, ar trebui să folosiți `yarn` în schimb. Yarn este acum livrat cu Node.js, așa că nu este nevoie să-l instalați separat.-Trebuie doar să rulați `corepack enable` pentru a activa Yarn dacă nu ați făcut acest lucru deja.+`npm` nu va funcționa, ar trebui să folosiți `yarn` în schimb. Node 26 nu mai include Corepack, deci instalați-l o dată cu `npm install -g corepack`, apoi rulați `corepack enable` pentru a activa Yarn.</Warning></Tab>@@ -64,6 +63,7 @@ nvm install # installs recommended node versionnvm use # use recommended node version+npm install -g corepackcorepack enable```diff --git a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdxindex 31769267227..2e4f3d3f1db 100644--- a/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/config/roles.mdx@@ -217,6 +217,7 @@ Notițe:* Exact **un** `defineApplicationRole(...)` este permis per aplicație — build-ul manifestului va eșua dacă găsește mai mult de unul.* Utilizați `defineRole()` (nu `defineApplicationRole()`) pentru orice roluri **suplimentare** cu care este livrată aplicația.* Setarea explicită a `defaultRoleUniversalIdentifier` în `defineApplication()` este în continuare acceptată pentru compatibilitate retroactivă, dar este considerată învechită în favoarea `defineApplicationRole()`. Identificatorul trebuie să corespundă unui rol definit de aplicația dvs., altfel compilarea eșuează.+* Un rol căruia îi pot fi alocați membri ai spațiului de lucru sau chei API (`canBeAssignedToUsers` sau `canBeAssignedToApiKeys`, ambele `true` când sunt omise) este un rol personalizat și necesită **planul Organization sau unul superior**: pe alte planuri, instalarea este refuzată. Păstrează-le pe ambele ca `false` pentru rolurile pe care rulează doar aplicația ta și agenții acesteia.### Roluri agentdiff --git a/packages/twenty-docs/ro/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/ro/developers/extend/apps/data/extending-objects.mdxindex 7c1a5f52b44..b70afd5ed13 100644--- a/packages/twenty-docs/ro/developers/extend/apps/data/extending-objects.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/data/extending-objects.mdx@@ -48,8 +48,6 @@ export default defineField({* Locația fișierului depinde de dumneavoastră. Convenția este `src/fields/\<name>.field.ts`, dar CLI-ul detectează câmpuri oriunde în `src/`.-* `writability` poate fi de asemenea setată per câmp: `MetadataWritability.APPLICATION` restricționează scrierile la propriile funcții logice ale aplicației tale, `MetadataWritability.SYSTEM` este rezervat pentru date administrate de platformă. Capacitatea de scriere a unui câmp poate fi doar mai strictă decât nivelul obiectului său, iar citirile nu sunt afectate. Vezi [Objects](/ro/developers/extend/apps/data/objects) pentru semantica completă.-* `isSearchable: true` poate fi setat pe `defineField()` cu aceleași constrângeri ca și câmpurile inline (obiect țintă căutabil, tip de câmp compatibil cu textul), astfel încât înregistrările obiectului țintă să poată fi găsite prin valorile câmpului dvs. în căutarea în text complet.* `isAuditLogged: false` poate fi setat pe `defineField()` pentru a păstra modificările câmpului în afara cronologiei înregistrării țintă, ceea ce este important mai ales pentru câmpurile pe care aplicația dvs. le rescrie conform unui program.diff --git a/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdxindex b40d72502d8..ccd30f022d9 100644--- a/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/data/objects.mdx@@ -103,17 +103,7 @@ export default defineObject({* Fiecare câmp necesită un `name`, un `type`, un `label` și propriul `universalIdentifier` stabil.* Tabloul `fields` este opțional — puteți defini obiecte fără câmpuri personalizate.* `openRecordIn` stabilește unde se deschid înregistrările acestui obiect când se face clic pe ele: `ObjectOpenRecordIn.USER_CHOICE` (valoarea implicită, care respectă preferința fiecărui membru al spațiului de lucru din Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` sau `ObjectOpenRecordIn.RECORD_PAGE`. Fixează-l la `RECORD_PAGE` pentru înregistrările care au nevoie de o pagină completă pentru a fi utilizabile, așa cum este cazul fluxurilor de lucru și al dashboard-urilor, sau la `SIDE_PANEL` pentru înregistrările care au sens doar ca un panou rapid, așa cum este cazul evenimentelor din calendar.-* `writability` controlează cine poate scrie înregistrări ale obiectului, înainte ca permisiunile pe roluri să se aplice: `MetadataWritability.OPEN` (valoarea implicită — rolurile din spațiul de lucru decid), `MetadataWritability.APPLICATION` (numai funcțiile de logică ale aplicației tale pot crea, actualiza sau șterge înregistrări; folosește acest lucru pentru obiecte de tip configurație ale căror înregistrări determină comportamentul, astfel încât membrii spațiului de lucru cu acces extins la înregistrări să nu le poată edita prin API) sau `MetadataWritability.SYSTEM` (rezervat pentru date administrate de platformă). Operațiunile de citire nu sunt afectate — acest lucru este impus la nivel de server, spre deosebire de `isUIEditable`, care doar ascunde elementele din interfața cu utilizatorul. Se aplică și la nivel de câmp, unde poate fi doar mai restrictivă decât la nivelul obiectului.-* `readability` declară cine poate citi înregistrările obiectului: `MetadataReadability.OPEN` (valoarea implicită — rolurile spațiului de lucru decid), `MetadataReadability.PRIVATE` (numai entitățile principale cu care a fost partajată înregistrarea), `MetadataReadability.INHERITED` (oricine citește înregistrarea părinte), `MetadataReadability.APPLICATION` (numai funcțiile logice ale propriei aplicații) sau `MetadataReadability.SYSTEM` (date gestionate de platformă). Toate politicile de lizibilitate sunt aplicate întotdeauna.-* `readabilityParentFieldUniversalIdentifiers` se utilizează cu `MetadataReadability.INHERITED`: identificatorii universali ai câmpurilor de relație care conduc la înregistrările părinte.- * Un câmp de tip mulți-la-unu denumește înregistrarea către care indică rândul. Declararea unui câmp al unei relații morfice acoperă fiecare țintă a relației respective.- * Un câmp de tip unu-la-mulți denumește un obiect copil ale cărui rânduri indică înapoi către înregistrare, cum ar fi rândurile de asociere ale unei relații mulți-la-mulți. Înregistrarea poate fi apoi citită atunci când cel puțin unul dintre acele rânduri conduce la o înregistrare care poate fi citită: o notă urmărește persoanele, companiile și oportunitățile de care o atașează țintele notei sale.- * Mai mulți părinți se combină ca o reuniune: este suficient un părinte care poate fi citit.- * Un părinte acordă acces în conformitate cu politica sa completă, cea care se aplică unei interogări a părintelui: permisiunea cititorului asupra obiectului părinte, restricțiile la nivel de rând ale rolului său și posibilitatea de citire a părintelui însuși. O înregistrare nu este afișată niciodată printr-un părinte pe care cititorul său nu îl poate interoga. Abonamentele, webhookurile, fluxurile de lucru și funcțiile logice stabilesc la ce ajunge un eveniment al unei înregistrări `INHERITED` conform aceleiași politici.- * Rândurile de partajare ale înregistrării înseși acordă acces exact ca în cazul unei înregistrări `PRIVATE`. Creatorul său primește un astfel de rând atunci când înregistrarea este creată în timp ce partajarea înregistrărilor este activată, astfel încât oricine a creat o înregistrare continuă să o vadă, iar o înregistrare ale cărei câmpuri părinte sunt toate goale este vizibilă pentru cei cu care a fost partajată direct.- * Un obiect `INHERITED` care nu specifică niciun câmp părinte utilizabil se comportă ca unul `PRIVATE`.-* `sharingReach` stabilește cât de departe poate fi partajată după nume o înregistrare a obiectului: `ObjectSharingReach.WORKSPACE` (valoarea implicită, o înregistrare poate fi partajată cu oricine din spațiul de lucru, chiar și cu cineva al cărui rol nu poate accesa obiectul sau al cărui filtru la nivel de rând ascunde înregistrarea; aceștia primesc numai înregistrarea respectivă, pentru a o vizualiza sau edita) sau `ObjectSharingReach.ROLE_ACCESS` (partajările nu depășesc niciodată permisiunile de rol și la nivel de rând). Alegeți `ROLE_ACCESS` pentru obiectele sensibile, pentru care lipsa accesului trebuie să însemne lipsa accesului. Rolurile care pot actualiza toate setările văd fiecare înregistrare a unui obiect `OPEN`, indiferent de restricțiile sale de partajare; permisiunile lor pentru obiecte și filtrele la nivel de rând se aplică în continuare. Se aplică numai cât timp partajarea înregistrărilor este activată în spațiul de lucru și numai obiectelor ale căror înregistrări pot fi partajate: obiecte `MetadataReadability.OPEN`, `PRIVATE` și `INHERITED` care nu sunt obiecte de sistem. Obiectele `APPLICATION` și `SYSTEM` nu sunt niciodată partajate.-* `disabledObjectPermissionActions` enumeră permisiunile pentru obiecte care nu pot fi acordate pentru obiect: oricare dintre `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` și `'canDestroyObjectRecords'`, aceleași indicatori pe care îi stabilește un rol pentru fiecare obiect. Salvarea unei permisiuni pentru obiect care acordă una dintre acestea pentru acest obiect eșuează; de exemplu, `disabledObjectPermissionActions: ['canDestroyObjectRecords']` împiedică acordarea oricărui rol a permisiunii de distrugere în mod specific pentru acesta. Nu modifică ceea ce pot face rolurile care acordă o acțiune pentru toate obiectele.+* `disabledObjectPermissionActions` enumeră permisiunile pentru obiecte care nu pot fi acordate pentru obiect: oricare dintre `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` și `'canDestroyObjectRecords'`, aceleași indicatori pe care îi stabilește un rol pentru fiecare obiect. Utilizatorii, cheile API și agenții nu primesc niciodată aceste acțiuni asupra obiectului, indiferent de ce permite rolul lor, iar salvarea unei permisiuni pentru obiect care acordă una dintre acestea eșuează. Funcțiile logice proprii ale aplicației tale le păstrează. De exemplu, `['canUpdateObjectRecords', 'canSoftDeleteObjectRecords', 'canDestroyObjectRecords']` face ca un obiect să poată fi modificat numai de aplicația ta, pentru înregistrări similare configurației care acordă comportament.* `color` setează culoarea de accent a obiectului în interfața cu utilizatorul. Omiteți-l și Twenty alege una pentru obiect.* `imageIdentifierFieldMetadataUniversalIdentifier` denumește câmpul a cărui valoare este afișată drept avatarul înregistrării. Omiteți-l pentru ca Twenty să aleagă valoarea implicită.* `isLabelSyncedWithName`, pe un obiect sau pe un câmp, menține numele API sincronizat cu eticheta atunci când eticheta este editată în Setări. Valoarea implicită este `false`, astfel încât o etichetă redenumită lasă numele neschimbat.diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdxindex 2cba9935ed4..c43829be397 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Înainte de a începe-Utilizați Node.js 24.5+ și Yarn 4. Instalați CLI-ul la nivel global; aplicația dvs. își păstrează propriile dependențe SDK.+Utilizați Node.js 24.5+ sau 26.5+ și Yarn 4 (prin Corepack: `corepack enable`; pe Node 26, instalați-l mai întâi cu `npm install -g corepack`). Instalați CLI-ul la nivel global; aplicația dvs. își păstrează propriile dependențe SDK.<Note>Construirea aplicațiilor Twenty este acceptată oficial numai pe sistemele Unix (macOS și Linux). Pe Windows, lucrați în WSL 2.diff --git a/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdxindex c9ba2c5bb1d..09d3384f80f 100644--- a/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/getting-started/troubleshooting.mdx@@ -8,8 +8,8 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Probleme comune* **Erori ale serverului local**, verificați mediul de dezvoltare Docker sau al depozitului. CLI-ul autonom nu gestionează containere.-* **Versiune Node greșită** — Este nevoie de 24.5+ (`engines.node: ^24.5.0`). Verificați cu `node -v`.-* **Lipsește Yarn 4** — Rulați `corepack enable`.+* **Versiune Node greșită** — Este necesară versiunea 24.5+ sau 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Verificați cu `node -v`.+* **Yarn 4 lipsește** — Rulați `corepack enable` (pe Node 26, mai întâi `npm install -g corepack`).* **Dependențe nefuncționale** — `rm -rf node_modules && yarn install`.* **`yarn.lock` gol** — Compilarea eșuează cu "yarn.lock is empty" atunci când fișierul de blocare există, dar nu are conținut; rulați `yarn install` pentru a-l regenera.* **Erori ale `twenty-sdk` după actualizarea la v2.8.0** — A fost mutat din `dependencies` în `devDependencies` în v2.8.0. Vezi [Structura proiectului → Dependințe](/ro/developers/extend/apps/getting-started/project-structure#dependencies).diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdxindex 7e0637c889e..5936dcb1ec3 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/logic-functions.mdx@@ -1041,7 +1041,7 @@ const { createCompany } = await client.mutation({},});-// Only on an object whose readability is PRIVATE: choose who can read the created record+// Only on an object whose records are private: choose who can read the created recordconst { createContract } = await client.mutation({createContract: {__args: {@@ -1060,7 +1060,7 @@ const { createContract } = await client.mutation({});```-`shareWith` contează doar pentru un obiect a cărui vizibilitate este `PRIVATE`; fiecare obiect este `OPEN` în mod implicit, iar pentru un obiect `OPEN` argumentul este ignorat. Pentru un obiect `PRIVATE`, acesta enumeră cine primește acces la înregistrarea creată: fiecare intrare vizează exact unul dintre `workspaceMemberId`, `roleId` sau `everyone: true`, cu un `accessLevel` de `READ`, `READ_WRITE` sau `FULL`. Un membru al spațiului de lucru care creează o înregistrare primește întotdeauna o acordare de proprietar `FULL`, astfel că argumentul este opțional pentru acesta; o funcție logică care acționează ca aplicația sa sau o cheie API primește, de asemenea, o acordare `FULL` pentru rolul său, iar astfel de apelanți, precum un apelant de sistem, trebuie să transmită `shareWith`, altfel crearea este respinsă. Fiecare intrare trebuie să indice un membru sau un rol al spațiului de lucru. O funcție logică sau o cheie API partajează prin intermediul rolului său, astfel încât fiecare deținător al acelui rol primește același acces la înregistrările pe care le creează; atribuiți unei chei ale cărei înregistrări trebuie să rămână private un rol propriu.+`shareWith` contează numai pentru un obiect ale cărui înregistrări sunt private; în rest, argumentul este ignorat. Pentru un astfel de obiect, acesta enumeră cine primește acces la înregistrarea creată: fiecare intrare vizează exact unul dintre `workspaceMemberId`, `roleId` sau `everyone: true`, cu un `accessLevel` de `READ`, `READ_WRITE` sau `FULL`. Un membru al spațiului de lucru care creează o înregistrare primește întotdeauna o acordare de proprietar `FULL`, astfel că argumentul este opțional pentru acesta; o funcție logică care acționează ca aplicația sa sau o cheie API primește, de asemenea, o acordare `FULL` pentru rolul său, iar astfel de apelanți, precum un apelant de sistem, trebuie să transmită `shareWith`, altfel crearea este respinsă. Fiecare intrare trebuie să indice un membru sau un rol al spațiului de lucru. O funcție logică sau o cheie API partajează prin intermediul rolului său, astfel încât fiecare deținător al acelui rol primește același acces la înregistrările pe care le creează; atribuiți unei chei ale cărei înregistrări trebuie să rămână private un rol propriu.Clientul folosește o sintaxă de tip selection-set: transmiteți `true` pentru a include un câmp, folosiți `__args` pentru argumente și imbricați obiecte pentru relații. Obțineți autocompletare și verificare completă a tipurilor, pe baza schemei spațiului dvs. de lucru.diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdxindex cb0fd8f2b92..d6bdb0f834f 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/skills-and-agents.mdx@@ -69,6 +69,8 @@ Puncte cheie:* `modelId` (opțional) suprascrie modelul AI implicit utilizat de agent.* `responseFormat` (opțional) stabilește formatul implicit al ieșirii agentului. Valoarea implicită este `{ type: 'text' }` pentru text liber. Folosește `{ type: 'json', schema }` pentru a impune ieșire JSON structurată. Un apel `runAgent()` sau un pas AI dintr-un flux de lucru poate solicita un format diferit, care are prioritate.* `roleUniversalIdentifier` (opțional) leagă agentul de un rol definit de aplicația ta. Acel rol nu trebuie să acorde mai multe permisiuni decât rolul aplicației, altfel compilarea eșuează; consultați [Roluri de agent](/ro/developers/extend/apps/config/roles#agent-roles).+* `modelConfiguration` (opțional) activează instrumentele native ale modelului, așa cum face pagina de setări a agentului: `{ webSearch: { enabled: true }, twitterSearch: { enabled: true } }`. Fiecare instrument funcționează numai pe modelele care îl acceptă. Omiteți-l pentru a le menține dezactivate.+* `isSystem` (opțional, are implicit valoarea `false`) ascunde agentul din listele de agenți, la fel ca agenții pe care Twenty îi creează pentru pașii de IA din fluxurile de lucru. Schimbă doar ceea ce este afișat: agenții unei aplicații pot fi modificați numai prin intermediul aplicației, indiferent de valoarea acestei opțiuni.În mod implicit, un agent returnează text liber. Pentru a obține o ieșire structurată, setează `responseFormat` la `{ type: 'json' }` și furnizează `schema`:diff --git a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdxindex bbac3b85628..1aca8492490 100644--- a/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/logic/workflows.mdx@@ -72,6 +72,7 @@ Puncte cheie:* `nextStepIds` conectează graful. Declanșatorul indică spre primii pași, iar fiecare pas indică spre pașii care se execută după acesta.* Un pas citește rezultatul anterior cu `{{trigger.\<path>}}` sau `{{\<step universalIdentifier>.\<path>}}`.* Compilarea validează întreaga definiție: tipurile de declanșatoare sau pași neacceptate, legăturile de pași defecte și referințele la pași necunoscuți o fac să eșueze.+* `isSystem` (opțional, implicit `false`) ascunde fluxul de lucru din listele care omit fluxurile de lucru de sistem. Modifică doar ceea ce este afișat.## Referirea la alte entitățidiff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdxindex 0c3079e0b07..9d3e4999efb 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/cli.mdx@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Rularea CLI-ului-CLI-ul `twenty` se conectează la spațiile de lucru Twenty din terminalul dvs. Folosiți-l pentru a inspecta metadatele, a citi înregistrări, a trimite solicitări API și a crea, sincroniza și depana aplicații. Necesită **Node.js 24.5 sau o versiune ulterioară**.+CLI-ul `twenty` se conectează la spațiile de lucru Twenty din terminalul dvs. Folosiți-l pentru a inspecta metadatele, a citi înregistrări, a trimite solicitări API și a crea, sincroniza și depana aplicații. Necesită **Node.js 24.5+ sau 26.5+**.Rulați orice comandă prin `npx`, fără a instala nimic:diff --git a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdxindex eca81c529df..f242f37d41d 100644--- a/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ro/developers/extend/apps/operations/publishing.mdx@@ -104,7 +104,7 @@ Dacă aplicația ta folosește o funcționalitate introdusă într-o anumită ve"name": "twenty-my-app","version": "1.0.0","engines": {- "node": "^24.5.0",+ "node": "^24.5.0 || ^26.5.1","twenty": ">=2.3.0"}}diff --git a/packages/twenty-docs/ro/ui/components/input/form-field-row.mdx b/packages/twenty-docs/ro/ui/components/input/form-field-row.mdxindex e72aa25f67b..cceba8cdabd 100644--- a/packages/twenty-docs/ro/ui/components/input/form-field-row.mdx+++ b/packages/twenty-docs/ro/ui/components/input/form-field-row.mdx@@ -51,6 +51,10 @@ export const SubjectField = () => {Rădăcina este un grup denumit prin `label`. Furnizați `aria-label` sau `aria-labelledby` atunci când eticheta vizibilă este omisă și etichetați separat fiecare intrare imbricată. Rândul nu mută focalizarea și nu dezactivează controalele imbricate. Aceste controale își păstrează propriul comportament de la tastatură și propriul stil de focalizare.+`contentPaddingInline` utilizează implicit tokenul de temă `--t-spacing-2`, care este de 8 pixeli în tema standard, și acceptă o valoare CSS pentru spațiere internă. Valorile numerice folosesc pixeli. Setați `contentPaddingInline={0}` pentru a alinia chipurile destinatarilor și un câmp de introducere cu indentarea rândului atunci când nu există nicio etichetă vizibilă.++<StoryEmbed storyId="ui-input-formfieldrow--without-label" title="Rând de destinatari fără etichetă vizibilă" height={110} />+## Evenimente și personalizareAtributele native, gestionarii de evenimente, `className`, `style`, `ref` și `render` se aplică rădăcinii grupului. Transmiteți mai departe props și ref furnizate atunci când înlocuiți rădăcina prin `render`. Un gestionar `onClick` afișează un cursor indicator. Apelantul gestionează comportamentul de focalizare la clic și, când este necesar, protejează evenimentele provenite de la controale imbricate sau portaluri. `isHoverable` activează independent un fundal neutru la trecerea cursorului.diff --git a/packages/twenty-docs/ru/developers/contribute/capabilities/local-setup.mdx b/packages/twenty-docs/ru/developers/contribute/capabilities/local-setup.mdxindex ef9b75cfe65..51d20e9a840 100644--- a/packages/twenty-docs/ru/developers/contribute/capabilities/local-setup.mdx+++ b/packages/twenty-docs/ru/developers/contribute/capabilities/local-setup.mdx@@ -12,13 +12,12 @@ import { PageBanner } from "/snippets/page-banner.mdx"Прежде чем установить и использовать Twenty, убедитесь, что у вас установлено следующее:* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)-* [Node v24.5.0](https://nodejs.org/en/download)+* [Node v26](https://nodejs.org/en/download)* [yarn v4](https://yarnpkg.com/getting-started/install)* [nvm](https://github.com/nvm-sh/nvm/blob/master/README.md)<Warning>-`npm` не будет работать, используйте `yarn`. Yarn теперь поставляется в комплекте с Node.js, так что устанавливать его отдельно не нужно.-Нужно лишь выполнить `corepack enable`, чтобы активировать Yarn, если вы еще этого не сделали.+`npm` не будет работать, используйте `yarn`. Node 26 больше не поставляется с Corepack, поэтому однократно установите его с помощью `npm install -g corepack`, а затем выполните `corepack enable`, чтобы включить Yarn.</Warning></Tab>@@ -64,6 +63,7 @@ nvm install # installs recommended node versionnvm use # use recommended node version+npm install -g corepackcorepack enable```diff --git a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdxindex 3b927e0d014..9007b1e622b 100644--- a/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/config/roles.mdx@@ -210,6 +210,7 @@ export default defineApplicationRole({* Допускается ровно **один** вызов `defineApplicationRole(...)` на приложение — сборка манифеста завершится с ошибкой, если будет найдено более одного.* Используйте `defineRole()` (а не `defineApplicationRole()`) для любых **дополнительных** ролей, которые ставятся вместе с вашим приложением.* Явная установка `defaultRoleUniversalIdentifier` в `defineApplication()` всё ещё поддерживается для обратной совместимости, но считается устаревшей по сравнению с `defineApplicationRole()`. Идентификатор должен соответствовать роли, определённой вашим приложением, иначе сборка завершится с ошибкой.+* Роль, которую можно назначать участникам рабочего пространства или ключам API (`canBeAssignedToUsers` или `canBeAssignedToApiKeys`, оба значения `true`, если они не указаны), является пользовательской ролью и требует **план Organization или выше**: на других планах установка отклоняется. Оставьте оба значения `false` для ролей, от имени которых работают только ваше приложение и его агенты.### Роли агентовdiff --git a/packages/twenty-docs/ru/developers/extend/apps/data/extending-objects.mdx b/packages/twenty-docs/ru/developers/extend/apps/data/extending-objects.mdxindex bd9b07d130a..a9833161dde 100644--- a/packages/twenty-docs/ru/developers/extend/apps/data/extending-objects.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/data/extending-objects.mdx@@ -48,8 +48,6 @@ export default defineField({* Расположение файла зависит от вас. Принятое соглашение — `src/fields/\<name>.field.ts`, но CLI обнаруживает поля в любом месте внутри `src/`.-* `writability` также может задаваться для каждого поля: `MetadataWritability.APPLICATION` ограничивает запись логическими функциями только вашего приложения, `MetadataWritability.SYSTEM` зарезервирован для данных, управляемых платформой. Изменяемость поля может быть только более строгой, чем уровень его объекта, и чтение при этом не затрагивается. Смотрите раздел [Objects](/ru/developers/extend/apps/data/objects) для полного описания семантики.-* `isSearchable: true` можно задать для `defineField()` с теми же ограничениями, что и для встроенных полей (целевой объект с возможностью поиска, тип поля, совместимый с текстом), чтобы записи целевого объекта можно было находить по значениям вашего поля с помощью полнотекстового поиска.* `isAuditLogged: false` можно задать в `defineField()`, чтобы изменения поля не отображались на временной шкале целевой записи, что особенно важно для полей, которые ваше приложение переписывает по расписанию.diff --git a/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx b/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdxindex 73aa8544bfd..26043219301 100644--- a/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/data/objects.mdx@@ -103,17 +103,7 @@ export default defineObject({* Каждому полю требуются `name`, `type`, `label` и собственный стабильный `universalIdentifier`.* Массив `fields` необязателен — вы можете определять объекты без пользовательских полей.* `openRecordIn` определяет, где открываются записи этого объекта при щелчке: `ObjectOpenRecordIn.USER_CHOICE` (по умолчанию, в соответствии с индивидуальными настройками каждого участника рабочего пространства в Settings → Experience), `ObjectOpenRecordIn.SIDE_PANEL` или `ObjectOpenRecordIn.RECORD_PAGE`. Закрепите его на `RECORD_PAGE` для записей, которым для полноценного использования нужна целая страница (как у рабочих процессов и дашбордов), или на `SIDE_PANEL` для записей, которые уместны только в виде быстрой боковой панели (как события календаря).-* `writability` определяет, кто в принципе может выполнять операции записи с записями объекта — до того, как начнут действовать разрешения ролей: `MetadataWritability.OPEN` (значение по умолчанию — решают роли рабочего пространства), `MetadataWritability.APPLICATION` (создавать, обновлять и удалять записи могут только собственные логические функции вашего приложения; используйте это для «конфигурационных» объектов, чьи записи задают поведение, чтобы участники рабочего пространства с широким доступом к записям не могли редактировать их через API) или `MetadataWritability.SYSTEM` (зарезервировано для данных, управляемых платформой). Операции чтения не затрагиваются — это ограничение применяется на стороне сервера, в отличие от `isUIEditable`, который лишь скрывает элементы интерфейса. Оно также существует на уровне отдельного поля, где может быть только более строгим, чем на уровне объекта.-* `readability` определяет, кто может читать записи объекта: `MetadataReadability.OPEN` (по умолчанию — роли рабочего пространства определяют), `MetadataReadability.PRIVATE` (только субъекты, которым предоставлен доступ к записи), `MetadataReadability.INHERITED` (тот, кто читает родительскую запись), `MetadataReadability.APPLICATION` (только собственные функции логики вашего приложения) или `MetadataReadability.SYSTEM` (данные, управляемые платформой). Все политики читаемости всегда применяются.-* `readabilityParentFieldUniversalIdentifiers` используется с `MetadataReadability.INHERITED`: универсальные идентификаторы полей связей, ведущих к родительским записям.- * Поле «многие к одному» указывает запись, на которую ссылается строка. Объявление одного поля морф-связи охватывает каждый целевой объект этой связи.- * Поле «один ко многим» указывает дочерний объект, строки которого ссылаются обратно на запись, например строки связи отношения «многие ко многим». Затем запись доступна для чтения, если хотя бы одна из этих строк ведет к доступной для чтения записи: заметка следует за людьми, компаниями и возможностями, к которым ее привязывают целевые объекты заметки.- * Несколько родительских записей объединяются как объединение: достаточно одной записи, доступной для чтения.- * Родительский объект предоставляет доступ в соответствии со своей полной политикой — той, которая применяется при запросе родительского объекта: разрешением читателя для родительского объекта, ограничениями на уровне строк его роли и доступностью для чтения самого родительского объекта. Запись никогда не отображается через родительский объект, который её читатель не мог бы запросить. Подписки, вебхуки, рабочие процессы и логические функции определяют, кого достигает событие записи `INHERITED` в соответствии с той же политикой.- * Строки общего доступа в самой записи предоставляют доступ точно так же, как в записи `PRIVATE`. Её создатель получает строку общего доступа при создании записи, если общий доступ к записям включён, поэтому любой, кто создал запись, продолжает её видеть, а запись, у которой все родительские поля пусты, видна тем, с кем ею поделились напрямую.- * Объект `INHERITED`, в котором не указано пригодное для использования родительское поле, ведет себя как объект `PRIVATE`.-* `sharingReach` задает, насколько далеко запись объекта может быть предоставлена по имени: `ObjectSharingReach.WORKSPACE` (по умолчанию: запись может быть предоставлена любому пользователю в рабочем пространстве, даже если его роль не позволяет получить доступ к объекту или фильтр на уровне строк скрывает запись; такой пользователь получает только эту запись для просмотра или редактирования) либо `ObjectSharingReach.ROLE_ACCESS` (предоставленный доступ никогда не выходит за пределы разрешений роли и на уровне строк). Выберите `ROLE_ACCESS` для конфиденциальных объектов, для которых отсутствие доступа должно означать отсутствие доступа. Роли, которые могут обновлять все настройки, видят каждую запись объекта `OPEN` независимо от ограничений совместного доступа; их разрешения на объект и фильтры уровня строк по-прежнему применяются. Это применяется только при включенном предоставлении доступа к записям в рабочем пространстве и только к объектам, записи которых могут быть предоставлены: объекты `MetadataReadability.OPEN`, `PRIVATE` и `INHERITED`, не являющиеся системными объектами. Объекты `APPLICATION` и `SYSTEM` никогда не предоставляются.-* `disabledObjectPermissionActions` перечисляет разрешения объекта, которые нельзя предоставить для объекта: любое из `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` и `'canDestroyObjectRecords'` — те же флаги, которые роль задает для каждого объекта. Не удается сохранить разрешение объекта, предоставляющее одно из них для этого объекта; например, `disabledObjectPermissionActions: ['canDestroyObjectRecords']` не позволяет предоставить какой-либо роли право на уничтожение именно для него. Это не меняет возможностей ролей, предоставляющих действие для всех объектов.+* `disabledObjectPermissionActions` перечисляет разрешения объекта, которые нельзя предоставить для объекта: любое из `'canReadObjectRecords'`, `'canUpdateObjectRecords'`, `'canSoftDeleteObjectRecords'` и `'canDestroyObjectRecords'` — те же флаги, которые роль задает для каждого объекта. Пользователи, API-ключи и агенты никогда не получают эти действия для объекта, независимо от того, что позволяет их роль, и сохранение разрешения объекта, предоставляющего одно из них, завершается ошибкой. Их сохраняют собственные логические функции вашего приложения. Например, `['canUpdateObjectRecords', 'canSoftDeleteObjectRecords', 'canDestroyObjectRecords']` делает объект доступным для записи только вашему приложению, для записей, подобных конфигурационным, которые определяют поведение.* `color` задаёт цвет акцента объекта в пользовательском интерфейсе. Не указывайте его, и Twenty выберет его для объекта.* `imageIdentifierFieldMetadataUniversalIdentifier` указывает поле, значение которого отображается в качестве аватара записи. Не указывайте его, чтобы Twenty выбрала значение по умолчанию.* `isLabelSyncedWithName` для объекта или поля синхронизирует имя API с меткой при редактировании метки в настройках. По умолчанию используется значение `false`, поэтому переименование метки не изменяет имя.diff --git a/packages/twenty-docs/ru/developers/extend/apps/getting-started/quick-start.mdx b/packages/twenty-docs/ru/developers/extend/apps/getting-started/quick-start.mdxindex ba2a2d1f26c..b2014f84c96 100644--- a/packages/twenty-docs/ru/developers/extend/apps/getting-started/quick-start.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/getting-started/quick-start.mdx@@ -8,7 +8,7 @@ import { CardTitle } from "/snippets/card-title.mdx"## Перед началом-Используйте Node.js 24.5+ и Yarn 4. Установите CLI глобально; ваше приложение сохраняет собственные зависимости SDK.+Используйте Node.js 24.5+ или 26.5+ и Yarn 4 (через Corepack: `corepack enable`; в Node 26 сначала установите его с помощью `npm install -g corepack`). Установите CLI глобально; ваше приложение сохраняет собственные зависимости SDK.<Note>Сборка приложений Twenty официально поддерживается только в системах Unix (macOS и Linux). В Windows работайте в WSL 2.diff --git a/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx b/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdxindex 6ea9edcaa3a..7bd395c1b23 100644--- a/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/getting-started/troubleshooting.mdx@@ -8,8 +8,8 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Распространённые проблемы* **Ошибки локального сервера**: проверьте среду разработки Docker или репозитория. Автономный CLI не управляет контейнерами.-* **Неверная версия Node** — требуется 24.5+ (`engines.node: ^24.5.0`). Проверьте с помощью `node -v`.-* **Отсутствует Yarn 4** — выполните `corepack enable`.+* **Неверная версия Node** — требуется 24.5+ или 26.5+ (`engines.node: ^24.5.0 || ^26.5.1`). Проверьте с помощью `node -v`.+* **Yarn 4 отсутствует** — выполните `corepack enable` (в Node 26 сначала выполните `npm install -g corepack`).* **Зависимости повреждены** — `rm -rf node_modules && yarn install`.* **Пустой `yarn.lock`** — Сборка завершается ошибкой «yarn.lock is empty», когда файл блокировки существует, но не содержит данных; выполните `yarn install`, чтобы пересоздать его.* **Ошибки `twenty-sdk` после обновления до v2.8.0** — он был перенесен из `dependencies` в `devDependencies` в v2.8.0. См. [Структура проекта → Зависимости](/ru/developers/extend/apps/getting-started/project-structure#dependencies).diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdxindex 9586768a9a7..b1e20702767 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/logic-functions.mdx@@ -1036,7 +1036,7 @@ const { createCompany } = await client.mutation({},});-// Only on an object whose readability is PRIVATE: choose who can read the created record+// Only on an object whose records are private: choose who can read the created recordconst { createContract } = await client.mutation({createContract: {__args: {@@ -1055,7 +1055,7 @@ const { createContract } = await client.mutation({});```-`shareWith` имеет значение только для объекта с доступностью `PRIVATE`; по умолчанию каждый объект имеет `OPEN`, и для объекта с `OPEN` аргумент игнорируется. Для объекта `PRIVATE` он указывает, кто получит доступ к созданной записи: каждая запись предназначена ровно для одного из `workspaceMemberId`, `roleId` или `everyone: true` с уровнем доступа `READ`, `READ_WRITE` или `FULL`. Участник рабочего пространства, создающий запись, всегда получает разрешение владельца `FULL`, поэтому этот аргумент для него необязателен; логическая функция, действующая как её приложение, или ключ API также получает разрешение `FULL` для своей роли, и такие вызывающие стороны, как и системный вызывающий объект, должны передать `shareWith`, иначе операция создания будет отклонена. В каждой записи должен быть указан участник или роль рабочего пространства. Логическая функция или ключ API предоставляет общий доступ через свою роль, поэтому каждый обладатель этой роли получает одинаковый доступ к создаваемым ею записям; назначьте ключу, записи которого должны оставаться доступными только ему, отдельную роль.+`shareWith` имеет значение только для объекта, записи которого являются приватными; в остальных случаях аргумент игнорируется. Для такого объекта он указывает, кто получает доступ к созданной записи: каждая запись нацелена ровно на один из `workspaceMemberId`, `roleId` или `everyone: true` с уровнем доступа `READ`, `READ_WRITE` или `FULL`. Участник рабочего пространства, создающий запись, всегда получает разрешение владельца `FULL`, поэтому этот аргумент для него необязателен; логическая функция, действующая как её приложение, или ключ API также получает разрешение `FULL` для своей роли, и такие вызывающие стороны, как и системный вызывающий объект, должны передать `shareWith`, иначе операция создания будет отклонена. В каждой записи должен быть указан участник или роль рабочего пространства. Логическая функция или ключ API предоставляет общий доступ через свою роль, поэтому каждый обладатель этой роли получает одинаковый доступ к создаваемым ею записям; назначьте ключу, записи которого должны оставаться доступными только ему, отдельную роль.Клиент использует синтаксис selection-set: передайте `true`, чтобы включить поле, используйте `__args` для аргументов и вкладывайте объекты для отношений. Вы получаете полное автодополнение и проверку типов на основе схемы вашего рабочего пространства.diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdxindex a9fce7fb7b8..b6fb5a2271c 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/skills-and-agents.mdx@@ -69,6 +69,8 @@ export default defineAgent({* `modelId` (необязательно) переопределяет модель ИИ по умолчанию, используемую агентом.* `responseFormat` (необязательно) задаёт формат вывода агента. По умолчанию для свободного текста используется `{ type: 'text' }`. Используйте `{ type: 'json', schema }`, чтобы принудительно получать структурированный JSON-вывод. Вызов `runAgent()` или ИИ-шаг рабочего процесса может запросить другой формат, который имеет приоритет.* `roleUniversalIdentifier` (необязательно) связывает агента с ролью, определённой вашим приложением. Эта роль не должна предоставлять больше прав, чем роль приложения, иначе сборка завершится с ошибкой; см. [Роли агентов](/ru/developers/extend/apps/config/roles#agent-roles).+* `modelConfiguration` (необязательный параметр) включает встроенные инструменты модели, как на странице настроек агента: `{ webSearch: { enabled: true }, twitterSearch: { enabled: true } }`. Каждый инструмент работает только с моделями, которые его поддерживают. Не указывайте его, чтобы они оставались отключенными.+* `isSystem` (необязательный параметр, по умолчанию `false`) скрывает агента из списков агентов, как агентов, которых Twenty создает для шагов ИИ в рабочих процессах. Он изменяет только отображаемое: агентов приложения можно изменять только через приложение, независимо от значения этого флага.По умолчанию агент возвращает свободный текст. Чтобы получить структурированный вывод, установите для `responseFormat` значение `{ type: 'json' }` и укажите `schema`:diff --git a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdxindex 5a4dd9e25e6..54144fecf12 100644--- a/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/logic/workflows.mdx@@ -72,6 +72,7 @@ export default defineWorkflow({* `nextStepIds` связывает граф. Триггер указывает на первые шаги, а каждый шаг указывает на шаги, выполняемые после него.* Шаг считывает предыдущий вывод с помощью `{{trigger.\<path>}}` или `{{\<step universalIdentifier>.\<path>}}`.* Сборка проверяет всё определение: неподдерживаемые типы триггеров или шагов, повреждённые связи между шагами и ссылки на неизвестные шаги приводят к её сбою.+* `isSystem` (необязательный, по умолчанию `false`) скрывает рабочий процесс из списков, в которых не отображаются системные рабочие процессы. Изменяется только отображаемое содержимое.## Ссылки на другие сущностиdiff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdxindex 283e1050498..405ae531e1a 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/cli.mdx@@ -7,7 +7,7 @@ import { PageBanner } from "/snippets/page-banner.mdx"## Запуск CLI-CLI `twenty` подключается к рабочим пространствам Twenty из вашего терминала. Используйте его для проверки метаданных, чтения записей, отправки API-запросов, а также создания, синхронизации и отладки приложений. Для него требуется **Node.js 24.5 или более поздней версии**.+CLI `twenty` подключается к рабочим пространствам Twenty из вашего терминала. Используйте его для проверки метаданных, чтения записей, отправки API-запросов, а также создания, синхронизации и отладки приложений. Требуется **Node.js 24.5+ или 26.5+**.Запускайте любую команду через `npx` без установки чего-либо:diff --git a/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdxindex 1f178da5447..4ea5a3bf4dd 100644--- a/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx+++ b/packages/twenty-docs/ru/developers/extend/apps/operations/publishing.mdx@@ -104,7 +104,7 @@ twenty app publish --private"name": "twenty-my-app","version": "1.0.0","engines": {- "node": "^24.5.0",+ "node": "^24.5.0 || ^26.5.1","twenty": ">=2.3.0"}}diff --git a/packages/twenty-docs/ru/ui/components/input/form-field-row.mdx b/packages/twenty-docs/ru/ui/components/input/form-field-row.mdxindex 1dac26386c7..5ce53c4dfbf 100644--- a/packages/twenty-docs/ru/ui/components/input/form-field-row.mdx+++ b/packages/twenty-docs/ru/ui/components/input/form-field-row.mdx@@ -51,6 +51,10 @@ export const SubjectField = () => {Корневой элемент — это группа, имя которой задаётся `label`. Укажите `aria-label` или `aria-labelledby`, если видимая метка отсутствует, и назначьте отдельную метку каждому вложенному полю ввода. Строка не перемещает фокус и не отключает вложенные элементы управления. Эти элементы управления сохраняют собственное поведение клавиатуры и стилизацию фокуса.+`contentPaddingInline` по умолчанию имеет значение токена темы `--t-spacing-2`, равное 8 пикселям в стандартной теме, и принимает значение CSS padding. Для числовых значений используются пиксели. Установите `contentPaddingInline={0}`, чтобы выровнять чипы получателей и поле ввода по отступу строки, когда видимая метка отсутствует.++<StoryEmbed storyId="ui-input-formfieldrow--without-label" title="Строка получателей без видимой метки" height={110} />+## События и настройкаНативные атрибуты, обработчики событий, `className`, `style`, `ref` и `render` применяются к корневому элементу группы. Передавайте предоставленные props и ref при замене корневого элемента через `render`. Обработчик `onClick` отображает курсор-указатель. Вызывающая сторона отвечает за поведение при щелчке для установки фокуса и при необходимости защищает события от вложенных элементов управления или порталов. `isHoverable` независимо включает нейтральный фон при наведении.