@agent-native/core 0.101.5 → 0.101.7

package/corpus/templates/content/app/components/editor/DocumentProperties.tsx

@@ -105,6 +105,12 @@ import {
   PopoverTrigger,
 } from "@/components/ui/popover";
 import { Spinner } from "@/components/ui/spinner";
+import { Textarea } from "@/components/ui/textarea";
+import {
+  Tooltip,
+  TooltipContent,
+  TooltipTrigger,
+} from "@/components/ui/tooltip";
 import { applySourceFieldPropertyToDatabaseResponse } from "@/hooks/use-content-database";
 import {
   useConfigureDocumentProperty,
@@ -551,7 +557,8 @@ export function filterPropertyOptions(
   return options.filter(
     (option) =>
       option.name.toLowerCase().includes(normalizedQuery) ||
-      option.id.toLowerCase().includes(normalizedQuery),
+      option.id.toLowerCase().includes(normalizedQuery) ||
+      option.description?.toLowerCase().includes(normalizedQuery),
   );
 }
 
@@ -612,6 +619,76 @@ export function updatePropertyOptionColor(
   );
 }
 
+export function updatePropertyOptionDescription(
+  options: DocumentPropertyOption[],
+  optionId: string,
+  description: string,
+) {
+  return options.map((option) =>
+    option.id === optionId ? { ...option, description } : option,
+  );
+}
+
+/**
+ * Keeps successive option edits based on the same local truth until the
+ * server catches up. A rename followed immediately by a usage-description
+ * edit must not let either request erase the other.
+ */
+export function createPropertyOptionUpdateQueue(
+  initialOptions: DocumentPropertyOption[],
+  persist: (options: DocumentPropertyOption[]) => Promise<unknown>,
+) {
+  let current = initialOptions;
+  let tail: Promise<unknown> = Promise.resolve();
+
+  return {
+    replace(options: DocumentPropertyOption[]) {
+      current = options;
+    },
+    enqueue(
+      update: (options: DocumentPropertyOption[]) => DocumentPropertyOption[],
+    ) {
+      current = update(current);
+      const snapshot = current;
+      tail = tail.catch(() => undefined).then(() => persist(snapshot));
+      return tail;
+    },
+  };
+}
+
+type PropertyMetadataSnapshot = Pick<
+  DocumentProperty["definition"],
+  "name" | "type" | "description" | "visibility" | "options"
+>;
+
+/**
+ * Serializes property-definition edits against one local snapshot. The action
+ * accepts the complete definition, so composing each request from render-time
+ * props would let a fast description save restore the name from before an
+ * overlapping rename completed.
+ */
+export function createPropertyMetadataUpdateQueue(
+  initialMetadata: PropertyMetadataSnapshot,
+  persist: (metadata: PropertyMetadataSnapshot) => Promise<unknown>,
+) {
+  let current = initialMetadata;
+  let tail: Promise<unknown> = Promise.resolve();
+
+  return {
+    replace(metadata: PropertyMetadataSnapshot) {
+      current = metadata;
+    },
+    enqueue(
+      update: (metadata: PropertyMetadataSnapshot) => PropertyMetadataSnapshot,
+    ) {
+      current = update(current);
+      const snapshot = current;
+      tail = tail.catch(() => undefined).then(() => persist(snapshot));
+      return tail;
+    },
+  };
+}
+
 export function removePropertyOption(
   options: DocumentPropertyOption[],
   optionId: string,
@@ -833,7 +910,23 @@ function PropertyRow({
       ) : (
         <div className="flex min-w-0 items-center gap-2 text-muted-foreground">
           <Icon className="size-4 shrink-0" />
-          <span className="truncate">{property.definition.name}</span>
+          {property.definition.description ? (
+            <Tooltip>
+              <TooltipTrigger asChild>
+                <button
+                  type="button"
+                  className="truncate text-left outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                >
+                  {property.definition.name}
+                </button>
+              </TooltipTrigger>
+              <TooltipContent className="max-w-64">
+                {property.definition.description}
+              </TooltipContent>
+            </Tooltip>
+          ) : (
+            <span className="truncate">{property.definition.name}</span>
+          )}
         </div>
       )}
       {canEdit && property.editable ? (
@@ -961,7 +1054,25 @@ export function PropertyManagementPopover({
   const [open, setOpen] = useState(false);
   const [confirmDeleteOpen, setConfirmDeleteOpen] = useState(false);
   const [name, setName] = useState(property.definition.name);
+  const [description, setDescription] = useState(
+    property.definition.description,
+  );
   const [newOption, setNewOption] = useState("");
+  const persistMetadataSnapshotRef = useRef<
+    (metadata: PropertyMetadataSnapshot) => Promise<unknown>
+  >(async () => undefined);
+  const metadataUpdateQueueRef = useRef(
+    createPropertyMetadataUpdateQueue(
+      {
+        name: property.definition.name,
+        type: property.definition.type,
+        description: property.definition.description,
+        visibility: property.definition.visibility,
+        options: property.definition.options,
+      },
+      (metadata) => persistMetadataSnapshotRef.current(metadata),
+    ),
+  );
   const propertyNameInputRef = useRef<HTMLInputElement>(null);
   const typeIsLocked = isComputedPropertyType(property.definition.type);
   const typeNeedsOptions =
@@ -971,7 +1082,15 @@ export function PropertyManagementPopover({
 
   function resetDraft() {
     setName(property.definition.name);
+    setDescription(property.definition.description);
     setNewOption("");
+    metadataUpdateQueueRef.current.replace({
+      name: property.definition.name,
+      type: property.definition.type,
+      description: property.definition.description,
+      visibility: property.definition.visibility,
+      options: property.definition.options,
+    });
   }
 
   useEffect(() => {
@@ -990,17 +1109,34 @@ export function PropertyManagementPopover({
     type?: DocumentPropertyType;
     visibility?: DocumentPropertyVisibility;
     options?: DocumentProperty["definition"]["options"];
+    description?: string;
   }) {
-    const nextType = next.type ?? property.definition.type;
-    await configure.mutateAsync({
+    await metadataUpdateQueueRef.current.enqueue((current) => ({
+      name: next.name?.trim() || current.name,
+      type: next.type ?? current.type,
+      description: next.description ?? current.description,
+      visibility: next.visibility ?? current.visibility,
+      options: next.options ?? current.options,
+    }));
+  }
+
+  async function updateOptions(
+    update: (options: DocumentPropertyOption[]) => DocumentPropertyOption[],
+  ) {
+    await metadataUpdateQueueRef.current.enqueue((current) => ({
+      ...current,
+      options: {
+        options: update(current.options.options ?? []),
+      },
+    }));
+  }
+
+  persistMetadataSnapshotRef.current = (metadata) =>
+    configure.mutateAsync({
       id: property.definition.id,
       documentId,
-      name: next.name?.trim() || property.definition.name,
-      type: nextType,
-      visibility: next.visibility,
-      options: next.options ?? property.definition.options,
+      ...metadata,
     });
-  }
 
   async function renameProperty() {
     const nextName = name.trim();
@@ -1008,6 +1144,12 @@ export function PropertyManagementPopover({
     await configureProperty({ name: nextName });
   }
 
+  async function updateDescription() {
+    const nextDescription = (description ?? "").trim();
+    if (nextDescription === property.definition.description) return;
+    await configureProperty({ description: nextDescription });
+  }
+
   async function updateType(nextType: DocumentPropertyType) {
     if (nextType === property.definition.type) return;
     await configureProperty({
@@ -1042,39 +1184,39 @@ export function PropertyManagementPopover({
   async function addOption() {
     const optionName = newOption.trim();
     if (!optionName) return;
-    const existing = property.definition.options.options ?? [];
-    const option = makeOption(
-      optionName,
-      existing.length,
-      existing.map((item) => item.id),
-    );
-    await configureProperty({
-      options: { options: [...existing, option] },
-    });
+    await updateOptions((existing) => [
+      ...existing,
+      makeOption(
+        optionName,
+        existing.length,
+        existing.map((item) => item.id),
+      ),
+    ]);
     setNewOption("");
   }
 
   async function removeOption(id: string) {
-    await configureProperty({
-      options: {
-        options: (property.definition.options.options ?? []).filter(
-          (option) => option.id !== id,
-        ),
-      },
-    });
+    await updateOptions((options) =>
+      options.filter((option) => option.id !== id),
+    );
   }
 
   async function renameOption(id: string, optionName: string) {
-    const options = property.definition.options.options ?? [];
-    const nextOptions = renamePropertyOption(options, id, optionName);
-    if (nextOptions === options) return;
-    await configureProperty({ options: { options: nextOptions } });
+    await updateOptions((options) =>
+      renamePropertyOption(options, id, optionName),
+    );
   }
 
   async function recolorOption(id: string, color: DocumentPropertyOptionColor) {
-    const options = property.definition.options.options ?? [];
-    const nextOptions = updatePropertyOptionColor(options, id, color);
-    await configureProperty({ options: { options: nextOptions } });
+    await updateOptions((options) =>
+      updatePropertyOptionColor(options, id, color),
+    );
+  }
+
+  async function describeOption(id: string, description: string) {
+    await updateOptions((options) =>
+      updatePropertyOptionDescription(options, id, description),
+    );
   }
 
   return (
@@ -1092,6 +1234,7 @@ export function PropertyManagementPopover({
             aria-label={t("editor.properties.propertyMenuFor", {
               name: property.definition.name,
             })}
+            title={property.definition.description || undefined}
             className={cn(
               "flex min-w-0 items-center gap-2 rounded px-1 py-0.5 text-left text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
               triggerClassName,
@@ -1138,6 +1281,21 @@ export function PropertyManagementPopover({
             />
           </div>
 
+          <div
+            className="px-2 pb-2 pt-1"
+            onKeyDown={(event) => event.stopPropagation()}
+          >
+            <Textarea
+              rows={2}
+              value={description}
+              aria-label={t("editor.properties.description")}
+              placeholder={t("editor.properties.addPropertyDescription")}
+              onChange={(event) => setDescription(event.target.value)}
+              onBlur={() => void updateDescription()}
+              className="block w-full resize-none rounded border border-transparent bg-muted/30 px-2 py-1.5 text-xs leading-5 text-muted-foreground outline-none placeholder:text-muted-foreground/60 focus:border-input focus:bg-background focus:ring-1 focus:ring-ring"
+            />
+          </div>
+
           <DropdownMenuSub>
             <DropdownMenuSubTrigger>
               <Icon className="mr-2 size-4 text-muted-foreground" />
@@ -1217,6 +1375,9 @@ export function PropertyManagementPopover({
                     option={option}
                     disabled={configure.isPending}
                     onRename={(name) => void renameOption(option.id, name)}
+                    onDescriptionChange={(description) =>
+                      void describeOption(option.id, description)
+                    }
                     onColorChange={(color) =>
                       void recolorOption(option.id, color)
                     }
@@ -1424,21 +1585,27 @@ function PropertyOptionSettingsRow({
   option,
   disabled,
   onRename,
+  onDescriptionChange,
   onColorChange,
   onRemove,
 }: {
   option: DocumentPropertyOption;
   disabled: boolean;
   onRename: (name: string) => void;
+  onDescriptionChange: (description: string) => void;
   onColorChange: (color: DocumentPropertyOptionColor) => void;
   onRemove: () => void;
 }) {
   const t = useT();
   const [draftName, setDraftName] = useState(option.name);
+  const [draftDescription, setDraftDescription] = useState(
+    option.description ?? "",
+  );
 
   useEffect(() => {
     setDraftName(option.name);
-  }, [option.name]);
+    setDraftDescription(option.description ?? "");
+  }, [option.description, option.name]);
 
   function submitRename() {
     const nextName = draftName.trim();
@@ -1528,6 +1695,21 @@ function PropertyOptionSettingsRow({
           {t("editor.properties.remove")}
         </button>
       </div>
+      <Textarea
+        rows={1}
+        value={draftDescription}
+        disabled={disabled}
+        aria-label={`${t("editor.properties.description")}: ${option.name}`}
+        placeholder={t("editor.properties.addOptionDescription")}
+        onChange={(event) => setDraftDescription(event.target.value)}
+        onBlur={() => {
+          const nextDescription = draftDescription.trim();
+          if (nextDescription !== (option.description ?? "")) {
+            onDescriptionChange(nextDescription);
+          }
+        }}
+        className="ml-5 block w-[calc(100%-1.25rem)] resize-none rounded border-0 bg-transparent px-1 text-xs leading-5 text-muted-foreground shadow-none placeholder:text-muted-foreground/60 focus:bg-background focus:ring-1 focus:ring-ring"
+      />
     </div>
   );
 }
@@ -2559,7 +2741,14 @@ function OptionValueEditor({
               className="flex w-full items-center justify-between gap-2 rounded px-2 py-1.5 text-left text-sm hover:bg-accent"
               onClick={() => void chooseOption(option)}
             >
-              <OptionPill option={option} />
+              <span className="min-w-0 flex-1">
+                <OptionPill option={option} />
+                {option.description ? (
+                  <span className="mt-0.5 block truncate text-xs text-muted-foreground">
+                    {option.description}
+                  </span>
+                ) : null}
+              </span>
               {checked ? (
                 <IconCheck className="size-4 text-muted-foreground" />
               ) : null}

package/corpus/templates/content/app/components/editor/database/DatabaseView.tsx

@@ -5,6 +5,7 @@ import {
   useBuilderStatus,
   useCodeMode,
   useSession,
+  useT,
 } from "@agent-native/core/client";
 import {
   AlertDialog,
@@ -200,6 +201,7 @@ import {
   BuilderSourceReviewDialog,
   type BuilderReviewPublicationTransitions,
 } from "../database-sources/BuilderSourceReviewDialog";
+import { DescriptionField } from "../DescriptionField";
 import { DocumentBlockFields } from "../DocumentBlockFields";
 import {
   AddProperty,
@@ -514,6 +516,7 @@ function DatabaseTable({
   canEdit: boolean;
   isActive: boolean;
 }) {
+  const t = useT();
   const navigate = useNavigate();
   const queryClient = useQueryClient();
   const [databaseItemLimit, setDatabaseItemLimit] = useState(
@@ -530,6 +533,7 @@ function DatabaseTable({
   const executeBuilderExecution = useExecuteBuilderSourceExecution(document.id);
   const setSourceWriteMode = useSetContentDatabaseSourceWriteMode(document.id);
   const setProperty = useSetDocumentProperty(document.id, document.id);
+  const updateDatabaseDocument = useUpdateDocument();
   const updateView = useUpdateContentDatabaseView(document.id);
   // A deleted/missing database resolves to the unavailable union (no
   // `database` field) — treat it as no data; the inline-block wrapper owns
@@ -1578,6 +1582,19 @@ function DatabaseTable({
 
   return (
     <div className="mt-4 min-w-0 w-full max-w-[calc(100vw-var(--content-sidebar-width,0px)-1.5rem)]">
+      <DescriptionField
+        description={document.description}
+        canEdit={canEdit}
+        label={t("editor.properties.description")}
+        placeholder={t("editor.properties.addDatabaseDescription")}
+        className="mb-3"
+        onSave={(description) =>
+          updateDatabaseDocument.mutateAsync({
+            id: document.id,
+            description,
+          })
+        }
+      />
       <div className="mb-1 flex min-h-8 flex-wrap items-center justify-between gap-x-3 gap-y-1 pb-1">
         <DatabaseViewTabs
           viewConfig={viewConfig}
@@ -12129,8 +12146,10 @@ export function databaseBulkMultiSelectFilteredOptions(
 ) {
   const normalizedQuery = query.trim().toLowerCase();
   if (!normalizedQuery) return options;
-  return options.filter((option) =>
-    option.name.trim().toLowerCase().includes(normalizedQuery),
+  return options.filter(
+    (option) =>
+      option.name.trim().toLowerCase().includes(normalizedQuery) ||
+      option.description?.trim().toLowerCase().includes(normalizedQuery),
   );
 }
 
@@ -13511,7 +13530,14 @@ function DatabaseBulkOptionValueEditor({
                   )
                 }
               >
-                <DatabaseBulkOptionPill option={option} />
+                <span className="min-w-0 flex-1">
+                  <DatabaseBulkOptionPill option={option} />
+                  {option.description ? (
+                    <span className="mt-0.5 block truncate text-xs text-muted-foreground">
+                      {option.description}
+                    </span>
+                  ) : null}
+                </span>
                 {presence.presentInAll ? (
                   <IconCheck className="size-4 shrink-0 text-muted-foreground" />
                 ) : presence.presentInAny ? (
@@ -13560,7 +13586,14 @@ function DatabaseBulkOptionValueEditor({
             disabled={disabled}
             onClick={() => void onApply({ kind: "set", value: option.id })}
           >
-            <DatabaseBulkOptionPill option={option} />
+            <span className="min-w-0 flex-1">
+              <DatabaseBulkOptionPill option={option} />
+              {option.description ? (
+                <span className="mt-0.5 block truncate text-xs text-muted-foreground">
+                  {option.description}
+                </span>
+              ) : null}
+            </span>
           </button>
         ))}
       </div>
@@ -15858,6 +15891,24 @@ function DatabaseGroupedTableSection({
   );
 }
 
+export function databaseItemPropertyForColumn(
+  item: ContentDatabaseItem,
+  columnProperty: DocumentProperty,
+): DocumentProperty {
+  const itemProperty = item.properties.find(
+    (candidate) => candidate.definition.id === columnProperty.definition.id,
+  );
+  if (!itemProperty) return columnProperty;
+
+  // Row payloads own values, not schema meaning. Always pair the row's value
+  // with the database's current canonical definition so a recently described
+  // option cannot remain invisible in an older row snapshot.
+  return {
+    ...itemProperty,
+    definition: columnProperty.definition,
+  };
+}
+
 function DatabaseTableRow({
   item,
   properties,
@@ -15942,10 +15993,7 @@ function DatabaseTableRow({
         onPreview={onPreview}
       />
       {properties.map((property) => {
-        const itemProperty =
-          item.properties.find(
-            (candidate) => candidate.definition.id === property.definition.id,
-          ) ?? property;
+        const itemProperty = databaseItemPropertyForColumn(item, property);
         const bodyCellHydrationPending =
           itemProperty.definition.type === "blocks" &&
           databaseItemBodyHydrationIsPending(item);

package/corpus/templates/content/app/i18n/zh-TW.ts

@@ -357,6 +357,11 @@ const messages = {
       pasteFileOrMediaLink: "貼上檔案或媒體連結",
       personOrEmail: "個人或電子郵件",
       propertyMenuFor: "{{name}} 的屬性選單",
+      description: "說明",
+      addPageDescription: "新增此頁面的說明…",
+      addDatabaseDescription: "新增此資料庫的說明…",
+      addPropertyDescription: "說明此屬性應包含的內容…",
+      addOptionDescription: "何時應使用此選項？",
       propertyName: "物業名稱",
       readOnly: "唯讀",
       remove: "刪除",

package/corpus/templates/content/app/i18n-data.ts

@@ -2271,6 +2271,11 @@ const editorPropertiesMessages = {
   pasteFileOrMediaLink: "Paste file or media link",
   personOrEmail: "Person or email",
   propertyMenuFor: "Property menu for {{name}}",
+  description: "Description",
+  addPageDescription: "Add a description of this page…",
+  addDatabaseDescription: "Add a description of this database…",
+  addPropertyDescription: "Describe what belongs in this property…",
+  addOptionDescription: "When should this option be used?",
   propertyName: "Property name",
   readOnly: "Read-only",
   remove: "Remove",
@@ -5298,6 +5303,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "粘贴文件或媒体链接",
       personOrEmail: "个人或电子邮件",
       propertyMenuFor: "{{name}} 的属性菜单",
+      description: "说明",
+      addPageDescription: "添加此页面的说明…",
+      addDatabaseDescription: "添加此数据库的说明…",
+      addPropertyDescription: "描述此属性中应包含的内容…",
+      addOptionDescription: "何时应使用此选项？",
       propertyName: "物业名称",
       readOnly: "只读",
       remove: "删除",
@@ -5629,6 +5639,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "Pegar archivo o enlace multimedia",
       personOrEmail: "Persona o correo electrónico",
       propertyMenuFor: "Menú de propiedades para {{name}}",
+      description: "Descripción",
+      addPageDescription: "Añade una descripción de esta página…",
+      addDatabaseDescription: "Añade una descripción de esta base de datos…",
+      addPropertyDescription: "Describe qué corresponde a esta propiedad…",
+      addOptionDescription: "¿Cuándo debe usarse esta opción?",
       propertyName: "Nombre de la propiedad",
       readOnly: "Sólo lectura",
       remove: "Quitar",
@@ -5971,6 +5986,12 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "Coller un fichier ou un lien multimédia",
       personOrEmail: "Personne ou email",
       propertyMenuFor: "Menu Propriétés pour {{name}}",
+      description: "Description",
+      addPageDescription: "Ajoutez une description de cette page…",
+      addDatabaseDescription:
+        "Ajoutez une description de cette base de données…",
+      addPropertyDescription: "Décrivez ce qui appartient à cette propriété…",
+      addOptionDescription: "Quand cette option doit-elle être utilisée ?",
       propertyName: "Nom de la propriété",
       readOnly: "Lecture seule",
       remove: "Supprimer",
@@ -6313,6 +6334,12 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "Datei- oder Medienlink einfügen",
       personOrEmail: "Person oder E-Mail",
       propertyMenuFor: "Eigenschaftenmenü für {{name}}",
+      description: "Beschreibung",
+      addPageDescription: "Beschreibung dieser Seite hinzufügen…",
+      addDatabaseDescription: "Beschreibung dieser Datenbank hinzufügen…",
+      addPropertyDescription:
+        "Beschreiben Sie, was in diese Eigenschaft gehört…",
+      addOptionDescription: "Wann sollte diese Option verwendet werden?",
       propertyName: "Eigenschaftsname",
       readOnly: "Schreibgeschützt",
       remove: "Entfernen",
@@ -6655,6 +6682,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "ファイルまたはメディアのリンクを貼り付けます",
       personOrEmail: "個人または電子メール",
       propertyMenuFor: "{{name}}のプロパティメニュー",
+      description: "説明",
+      addPageDescription: "このページの説明を追加…",
+      addDatabaseDescription: "このデータベースの説明を追加…",
+      addPropertyDescription: "このプロパティに入る内容を説明…",
+      addOptionDescription: "このオプションはいつ使いますか？",
       propertyName: "プロパティ名",
       readOnly: "読み取り専用",
       remove: "削除",
@@ -6990,6 +7022,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "파일 또는 미디어 링크 붙여넣기",
       personOrEmail: "개인 또는 이메일",
       propertyMenuFor: "{{name}}의 속성 메뉴",
+      description: "설명",
+      addPageDescription: "이 페이지에 대한 설명 추가…",
+      addDatabaseDescription: "이 데이터베이스에 대한 설명 추가…",
+      addPropertyDescription: "이 속성에 들어갈 내용을 설명…",
+      addOptionDescription: "이 옵션은 언제 사용해야 하나요?",
       propertyName: "속성 이름",
       readOnly: "읽기 전용",
       remove: "제거",
@@ -7328,6 +7365,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "Colar arquivo ou link de mídia",
       personOrEmail: "Pessoa ou e-mail",
       propertyMenuFor: "Menu de propriedades para {{name}}",
+      description: "Descrição",
+      addPageDescription: "Adicione uma descrição desta página…",
+      addDatabaseDescription: "Adicione uma descrição deste banco de dados…",
+      addPropertyDescription: "Descreva o que pertence a esta propriedade…",
+      addOptionDescription: "Quando esta opção deve ser usada?",
       propertyName: "Nome da propriedade",
       readOnly: "Somente leitura",
       remove: "Remover",
@@ -7665,6 +7707,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "फ़ाइल या मीडिया लिंक चिपकाएँ",
       personOrEmail: "व्यक्ति या ईमेल",
       propertyMenuFor: "{{name}} के लिए संपत्ति मेनू",
+      description: "विवरण",
+      addPageDescription: "इस पेज का विवरण जोड़ें…",
+      addDatabaseDescription: "इस डेटाबेस का विवरण जोड़ें…",
+      addPropertyDescription: "बताएं कि इस प्रॉपर्टी में क्या होना चाहिए…",
+      addOptionDescription: "इस विकल्प का उपयोग कब होना चाहिए?",
       propertyName: "संपत्ति का नाम",
       readOnly: "केवल पढ़ने योग्य",
       remove: "हटाओ",
@@ -7996,6 +8043,11 @@ const editorMessagesByLocale = {
       pasteFileOrMediaLink: "الصق الملف أو رابط الوسائط",
       personOrEmail: "الشخص أو البريد الإلكتروني",
       propertyMenuFor: "قائمة الخصائص لـ {{name}}",
+      description: "الوصف",
+      addPageDescription: "أضف وصفًا لهذه الصفحة…",
+      addDatabaseDescription: "أضف وصفًا لقاعدة البيانات هذه…",
+      addPropertyDescription: "صف ما الذي ينتمي إلى هذه الخاصية…",
+      addOptionDescription: "متى يجب استخدام هذا الخيار؟",
       propertyName: "اسم العقار",
       readOnly: "للقراءة فقط",
       remove: "إزالة",

package/corpus/templates/content/changelog/2026-07-14-pages-and-databases-can-describe-themselves-with-guidance-fo.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-14
+---
+
+Pages and databases can describe themselves, with guidance for properties and select options.

package/corpus/templates/content/changelog/2026-07-14-slack-follow-ups-now-retain-created-content-identity-and-per.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-14
+---
+
+Slack follow-ups now retain created Content identity and person-field intent across corrections.