@box/metadata-template-editor 2.3.44 → 2.3.46

package/dist/i18n/fr-FR.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Les utilisateurs peuvent sélectionner à partir de n’importe quel niveau de la liste",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Choisir le niveau de taxonomie",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Les utilisateurs doivent sélectionner à partir du niveau suivant :",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Ce type de champ ({fieldType}) n’est plus pris en charge et est en lecture seule. La seule action disponible est de supprimer le champ.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Ce modèle inclut des types de champs qui ne sont plus pris en charge. Ces champs sont en lecture seule ; la seule action disponible est de les supprimer.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Annuler",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Fermer",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Confirmer",

package/dist/i18n/hi-IN.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "उपयोगकर्ता सूची में किसी भी स्तर से चुन सकते हैं",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "वर्गीकरण का स्तर चुनें",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "उपयोगकर्ताओं को निम्नलिखित स्तर में से चुनना अनिवार्य होगा:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "यह फ़ील्ड प्रकार ({fieldType}) अब समर्थित नहीं है और यह केवल पढ़ने के लिए है। एकमात्र उपलब्ध कार्रवाई फ़ील्ड को हटाना है।",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "इस टेम्पलेट में फ़ील्ड प्रकार शामिल हैं जो अब समर्थित नहीं हैं। वे फ़ील्ड्स केवल पढ़ने के लिए हैं; उपलब्ध एकमात्र कार्रवाई उन्हें हटाना है।",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "रद्द करें",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "बंद करें",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "पुष्टि करें",

package/dist/i18n/it-IT.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Gli utenti possono scegliere da qualsiasi livello dell’elenco",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Scegli il livello della tassonomia",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Gli utenti devono scegliere dal seguente livello:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Questo tipo di campo ({fieldType}) non è più supportato ed è di sola lettura. L’unica azione disponibile è rimuovere il campo.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Questo modello include tipi di campi che non sono più supportati. Quei campi sono di sola lettura; l’unica azione disponibile è rimuoverli.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Annulla",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Chiudi",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Conferma",

package/dist/i18n/ko-KR.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "사용자는 목록에서 모든 레벨에서 선택할 수 있습니다",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "분류 체계 레벨을 선택하세요",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "사용자는 다음 레벨에서 선택해야 합니다:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "이 필드 유형({fieldType})은 더 이상 지원되지 않으며 읽기 전용입니다. 사용할 수 있는 유일한 작업은 필드 삭제입니다.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "이 템플릿에는 더 이상 지원되지 않는 필드 유형이 포함됩니다. 이러한 필드는 읽기 전용이며 사용할 수 있는 유일한 작업은 필드 삭제입니다.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "취소",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "닫기",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "확인",

package/dist/i18n/nb-NO.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Brukere kan velge fra et hvilket som helst nivå i listen",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Velg taksonominivået",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Brukere må velge fra følgende nivå:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Denne felttypen ({fieldType}) støttes ikke lenger og er skrivebeskyttet. Den eneste tilgjengelige handlingen er å fjerne feltet.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Denne malen inneholder felttyper som ikke støttes lenger. Disse feltene er skrivebeskyttet; den eneste tilgjengelige handlingen er å fjerne dem.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Avbryt",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Lukk",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Bekreft",

package/dist/i18n/nl-NL.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Gebruikers kunnen kiezen uit elk niveau in de lijst",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Kies het taxonomieniveau",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Gebruikers moeten kiezen uit het volgende niveau:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Dit veldtype ({fieldType}) wordt niet langer ondersteund en is alleen-lezen. De enige beschikbare actie is om het veld te verwijderen.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Dit sjabloon bevat veldtypen die niet langer worden ondersteund. Deze velden zijn alleen-lezen; de enige beschikbare actie is om ze te verwijderen.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Annuleren",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Sluiten",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Bevestigen",

package/dist/i18n/pl-PL.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Użytkownicy mogą wybierać z dowolnego poziomu na liście",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Wybierz poziom taksonomii",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Użytkownicy muszą wybierać z następującego poziomu:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Ten typ pola ({fieldType}) nie jest już obsługiwany i jest tylko do odczytu. Jedynym dostępnym działaniem jest usunięcie pola.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Ten szablon zawiera typy pól, które nie są już obsługiwane. Te pola są tylko do odczytu. jedynym dostępnym działaniem jest ich usunięcie.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Anuluj",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Zamknij",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Potwierdź",

package/dist/i18n/pt-BR.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Os usuários podem escolher a partir de qualquer nível da lista",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Escolher o nível da taxonomia",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Os usuários devem escolher a partir do seguinte nível:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Esse tipo de campo ({fieldType}) não é mais compatível e é somente leitura. A única ação disponível é remover o campo.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Esse modelo inclui tipos de campos que não são mais compatíveis. Esses campos são somente leitura; a única ação disponível é removê-los.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Cancelar",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Fechar",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Confirmar",

package/dist/i18n/ru-RU.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Пользователи могут выбирать с любого уровня в списке",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Выберите уровень таксономии",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Пользователи должны выбирать из следующего уровня:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Этот тип поля ({fieldType}) больше не поддерживается и предназначен только для чтения. Единственное доступное действие — удаление поля.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Этот шаблон включает типы полей, которые больше не поддерживаются. Эти поля предназначены только для чтения. Единственное доступное действие — их удаление.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Отменить",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Закрыть",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Подтвердить",

package/dist/i18n/sv-SE.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Användare kan välja från vilken nivå som helst i listan",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Välj taxonominivå",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Användare måste välja från följande nivå:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Den här fälttypen ({fieldType}) stöds inte längre och är skrivskyddad. Den enda tillgängliga åtgärden är att ta bort fältet.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Den här mallen innehåller fälttyper som inte längre stöds. Dessa fält är skrivskyddade; den enda tillgängliga åtgärden är att ta bort dem.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "Avbryt",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Stäng",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Godkänn",

package/dist/i18n/tr-TR.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "Kullanıcılar listedeki herhangi bir seviyeden seçim yapabilir",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "Taksonomi düzeyini seçin",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "Kullanıcılar aşağıdaki seviyeden seçim yapmalıdır:",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "Bu alan türü ({fieldType}) artık desteklenmiyor ve salt okunur. Bu alan için sadece kaldırma işlemi yapılabilir.",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "Bu şablon artık desteklenmeyen alan türleri içeriyor. Bu alanlar salt okunur olduğundan yapılabilecek tek işlem bunları kaldırmaktır.",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "İptal et",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "Kapat",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "Onayla",

package/dist/i18n/zh-CN.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "用户可以从列表中的任何级别选取值",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "选择分类法级别",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "用户必须从以下级别中选取：",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "此字段类型({fieldType})不再受支持，且为只读状态。唯一可执行的操作是移除该字段。",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "此模板包含已不再受支持的字段类型。这些字段为只读；唯一可执行的操作是将其移除。",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "取消",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "关闭",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "确认",

package/dist/i18n/zh-TW.js

@@ -46,6 +46,8 @@ export default {
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.anyLevelSelection": "使用者可以從清單中的任何等級挑選",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.chooseTaxonomyLevel": "選擇分類等級",
     "groupSharedFeatures.metadataTemplateEditor.configurator.taxonomy.selection.requiredSelection": "使用者必須從以下等級挑選：",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldNotice": "此欄位類型 ({fieldType}) 已不再受支援，屬於唯讀。唯一可用的動作是移除欄位。",
+    "groupSharedFeatures.metadataTemplateEditor.configurator.unsupportedFieldsBanner": "此範本包含已不再支援的欄位類型。這些欄位為唯讀；唯一可用的動作是移除欄位。",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.cancelButtonText": "取消",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.closeButtonAriaLabel": "關閉",
     "groupSharedFeatures.metadataTemplateEditor.confirmationModal.confirmButtonText": "確認",

package/dist/styles/taxonomy-field-configuration.css

@@ -1 +1 @@
-._taxonomyFieldConfiguration_1smhd_1{gap:var(--space-4);grid-template-rows:auto;grid-template-columns:1fr;display:grid}
+._taxonomyFieldConfiguration_l14xl_1{gap:var(--space-4);grid-template-rows:auto;grid-template-columns:1fr;display:grid}._statusContainer_l14xl_8{align-items:flex-start;gap:var(--bp-space-020);flex-direction:column;display:flex}._loadingIndicator_l14xl_15._loadingIndicator_l14xl_15{margin:0;position:relative;left:auto;right:auto}

package/dist/styles/taxonomy-selector.css

@@ -1 +1 @@
-._taxonomySelectorLabel_fuxhs_1{padding:var(--space-2) var(--space-3);display:block}._listWrapper_fuxhs_6{max-height:200px;overflow-y:auto}._listWrapperWithPadding_fuxhs_11{padding:var(--space-2);min-width:150px}._taxonomyItem_fuxhs_16{text-align:left;justify-content:flex-start;width:100%}._statusContainer_fuxhs_22{justify-content:center;align-items:center;gap:var(--space-2);flex-direction:column;min-width:190px;min-height:80px;display:flex}
+._taxonomySelectorLabel_m3x8t_1{padding:var(--space-2) var(--space-3);display:block}._listWrapper_m3x8t_6{max-height:200px;overflow-y:auto}._listWrapperWithPadding_m3x8t_11{padding:var(--space-2);min-width:150px}._taxonomyItem_m3x8t_16{text-align:left;justify-content:flex-start;width:100%}._statusContainer_m3x8t_22{justify-content:center;align-items:center;gap:var(--bp-space-020);flex-direction:column;min-width:190px;min-height:80px;display:flex}

package/dist/types/lib/components/metadata-field-configurator/components/type-specific-configuration/taxonomy/useTaxonomySelect.d.ts

@@ -1,5 +1,5 @@
-import { FieldConfiguratorContextValue } from '../../../context/field-configurator-context';
 import { TaxonomyOption } from '../../../../../types';
+import { FieldConfiguratorContextValue } from '../../../context/field-configurator-context';
 export declare const useTaxonomySelect: (ctx: Pick<FieldConfiguratorContextValue, "values" | "setFieldValue">) => {
     onTaxonomySelect: (option: TaxonomyOption) => void;
 };

package/dist/types/lib/components/metadata-field-configurator/components/type-specific-configuration/taxonomy/utils.d.ts

@@ -1,2 +1,3 @@
 import { TaxonomyOption } from '../../../../../types';
 export declare const filterTaxonomiesByValue: (taxonomies: TaxonomyOption[], value: string) => TaxonomyOption[];
+export declare const mapTaxonomiesWithSelection: (taxonomies: TaxonomyOption[], selected: Pick<TaxonomyOption, "namespace" | "taxonomyKey">) => TaxonomyOption[];

package/dist/types/lib/components/metadata-field-configurator/context/field-configurator-context.d.ts

@@ -33,6 +33,11 @@ export interface FieldConfiguratorContextValue {
     handleBlur(e: React.FocusEvent<unknown>): void;
     /** Trigger validation. The parent decides the validation strategy. */
     validateForm(): Promise<void>;
+    /**
+     * Whether this field's accordion item is currently expanded.
+     * Stories and standalone `FieldConfiguratorProvider` usage default to `true`.
+     */
+    isExpanded: boolean;
 }
 export declare const FieldConfiguratorContext: React.Context<FieldConfiguratorContextValue | null>;
 /**

package/dist/types/lib/components/metadata-field-configurator/context/taxonomy-options-context.d.ts

@@ -1,9 +1,9 @@
 import { TaxonomyOption } from '../../../types';
 export type TaxonomyFetchStatus = 'idle' | 'loading' | 'success' | 'error';
 export type TaxonomyContextValue = {
-    /** Currently available taxonomy options. Empty while loading. */
+    /** Currently available taxonomy options. Empty while the catalogue is loading. */
     options: TaxonomyOption[];
-    /** Fetch lifecycle state. `'idle'` before first open, `'success'` once loaded. */
+    /** Catalogue fetch lifecycle state. `'idle'` before first open, `'success'` once loaded. */
     status: TaxonomyFetchStatus;
     /**
      * Called when the taxonomy selector popover opens.
@@ -11,9 +11,26 @@ export type TaxonomyContextValue = {
      * On error, calling this again retries the fetch.
      */
     onSelectorOpen: () => void;
+    /**
+     * Resolves a single taxonomy by namespace + key. Cached for the lifetime of the provider.
+     * No-op when the taxonomy is already in `options`.
+     * On error, calling this again retries the lookup.
+     */
+    resolveTaxonomy?: (namespace: string, taxonomyKey: string) => void;
+    /**
+     * Per-key status for `resolveTaxonomy`.
+     * Returns `'success'` if the taxonomy is already in `options` (including the static catalogue).
+     */
+    getResolveStatus: (namespace: string, taxonomyKey: string) => TaxonomyFetchStatus;
 };
 export declare const TaxonomyOptionsContext: import('react').Context<TaxonomyContextValue>;
 export declare function useTaxonomyOptions(): TaxonomyContextValue;
+/**
+ * True when a parent already owns `TaxonomyOptionsContext` (e.g. `MetadataFieldList`).
+ * Providers always pass a new value object, so identity inequality with `DEFAULT_CONTEXT`
+ * means this tree is already wrapped and must not create a second cache.
+ */
+export declare function useHasTaxonomyOptionsProvider(): boolean;
 /**
  * Creates a static (pre-fetched) taxonomy context value.
  * Use in stories, tests, or when you already have the options available.

package/dist/types/lib/components/metadata-field-configurator/hooks/useFieldConfiguratorBehavior.d.ts

@@ -1,7 +1,6 @@
 import { FieldConfiguratorExtension } from '../context/field-extensions-context';
 import { FieldConfiguratorContextValue } from '../context/field-configurator-context';
-import { TaxonomyContextValue } from '../context/taxonomy-options-context';
-import { FieldData, TaxonomyOption } from '../../../types';
+import { FieldData } from '../../../types';
 export declare const EDIT_TAB_ID = "edit";
 export type UseFieldConfiguratorBehaviorParams = {
     values: FieldData;
@@ -10,16 +9,12 @@ export type UseFieldConfiguratorBehaviorParams = {
     isExpanded?: boolean;
     onExpandedChange?: (expanded: boolean) => void;
     submitAttemptCount?: number;
-    taxonomyOptions?: TaxonomyOption[];
-    fetchTaxonomies?: () => Promise<TaxonomyOption[]>;
     fieldExtensionsProp?: FieldConfiguratorExtension[];
     onValidationChange?: (isValid: boolean) => void;
 };
 export type FieldConfiguratorBehavior = {
     /** Value for `FieldConfiguratorContext.Provider`. */
     contextValue: FieldConfiguratorContextValue;
-    /** Value for `TaxonomyOptionsContext.Provider` (only used in standalone mode). */
-    taxonomyContextValue: TaxonomyContextValue;
     /** Resolved extension list (prop wins over context). */
     extensions: FieldConfiguratorExtension[];
     /** Whether the accordion item is currently open. */
@@ -55,4 +50,4 @@ export type FieldConfiguratorBehavior = {
  * Separated from the rendering layer so the component file stays focused on
  * structure and the hook can be read, tested, and reasoned about in isolation.
  */
-export declare function useFieldConfiguratorBehavior({ values, onValuesChange, onDelete, isExpanded, onExpandedChange, submitAttemptCount, taxonomyOptions, fetchTaxonomies, fieldExtensionsProp, onValidationChange, }: UseFieldConfiguratorBehaviorParams): FieldConfiguratorBehavior;
+export declare function useFieldConfiguratorBehavior({ values, onValuesChange, onDelete, isExpanded, onExpandedChange, submitAttemptCount, fieldExtensionsProp, onValidationChange, }: UseFieldConfiguratorBehaviorParams): FieldConfiguratorBehavior;

package/dist/types/lib/components/metadata-field-configurator/hooks/useTaxonomyFetch.d.ts

@@ -1,19 +1,24 @@
-import { TaxonomyOption } from '../../../types';
+import { FetchTaxonomyByKey, TaxonomyOption } from '../../../types';
 import { TaxonomyContextValue } from '../context/taxonomy-options-context';
+export type UseTaxonomyFetchParams = {
+    fetchTaxonomies?: () => Promise<TaxonomyOption[]>;
+    staticOptions?: TaxonomyOption[];
+    fetchTaxonomyByKey?: FetchTaxonomyByKey;
+};
 /**
  * Manages lazy, on-demand fetching of taxonomy options for use with `TaxonomyOptionsContext`.
  *
- * When `fetchTaxonomies` is not provided, returns a static no-fetch context (status `'success'`,
- * empty options, no-op `onSelectorOpen`) so the taxonomy selector renders normally with whatever
- * options were pre-supplied via the `taxonomyOptions` prop.
+ * When `fetchTaxonomyByKey` is provided, existing taxonomy fields can hydrate their display
+ * name and levels from the namespace and key stored by the template API.
  *
  * When `fetchTaxonomies` is provided:
  * - Fetch is deferred until `onSelectorOpen` is called (i.e. the popover opens).
  * - Results are cached: a successful fetch is never repeated on subsequent opens.
  * - On error, calling `onSelectorOpen` again (via the retry button) restarts the fetch.
  *
- * @param fetchTaxonomies - An async function that resolves to an array of taxonomy options.
- *   The function is called by the shared feature — consumers do not need to manage loading state.
- * @param staticOptions - Fallback options used when `fetchTaxonomies` is not provided.
+ * `resolveTaxonomy(namespace, taxonomyKey)` looks up one taxonomy and caches it by key.
+ * Lookups are skipped when the taxonomy is already resolved by key, or already in `options`
+ * with levels. Thin catalogue rows still trigger a by-key fetch.
+ * On error, calling `resolveTaxonomy` again retries that key.
  */
-export declare function useTaxonomyFetch(fetchTaxonomies?: () => Promise<TaxonomyOption[]>, staticOptions?: TaxonomyOption[]): TaxonomyContextValue;
+export declare function useTaxonomyFetch({ fetchTaxonomies, staticOptions, fetchTaxonomyByKey, }: UseTaxonomyFetchParams): TaxonomyContextValue;

package/dist/types/lib/components/metadata-field-configurator/messages/taxonomy-messages.d.ts

@@ -39,5 +39,20 @@ declare const _default: {
         description: string;
         id: string;
     };
+    loadingTaxonomy: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    loadTaxonomyError: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
+    retryLoadTaxonomy: {
+        defaultMessage: string;
+        description: string;
+        id: string;
+    };
 };
 export default _default;

package/dist/types/lib/components/metadata-field-configurator/metadata-field-configurator.d.ts

@@ -1,7 +1,7 @@
 import { DraggableAttributes } from '@dnd-kit/core';
 import { useSortable } from '@dnd-kit/sortable';
 import { default as React } from 'react';
-import { FieldData, TaxonomyOption } from '../../types';
+import { FieldData, FetchTaxonomyByKey, TaxonomyOption } from '../../types';
 import { FieldConfiguratorExtension } from './context/field-extensions-context';
 type ValidatableFieldNames = 'name' | 'description' | 'key' | 'type' | 'hidden' | 'taxonomy' | 'dropdown';
 /** Externally supplied validation state that overrides internal errors when present. */
@@ -98,6 +98,28 @@ export type MetadataFieldConfiguratorProps = GeneralComponentProps & (NativeDrag
      * Mutually exclusive with `taxonomyOptions`.
      */
     fetchTaxonomies?: () => Promise<TaxonomyOption[]>;
+    /**
+     * Optional async function that resolves a single taxonomy by namespace and key.
+     *
+     * Called automatically when an existing taxonomy field is expanded and its display name
+     * and levels are not already known (the template API does not return them). Results are
+     * cached by key for the lifetime of the component. Loading and error states (including a
+     * retry button) are handled internally.
+     *
+     * Independent of `fetchTaxonomies` / `taxonomyOptions`, which feed the taxonomy picker.
+     *
+     * @example
+     * ```tsx
+     * fetchTaxonomyByKey={async ({ namespace, taxonomyKey }) => {
+     *   const taxonomy = await api.getTaxonomyByKey(namespace, taxonomyKey);
+     *   return {
+     *     label: taxonomy.displayName,
+     *     levels: taxonomy.levels.map(level => ({ name: level.displayName, level: level.level })),
+     *   };
+     * }}
+     * ```
+     */
+    fetchTaxonomyByKey?: FetchTaxonomyByKey;
     /**
      * Domain-specific extensions to inject into this field's configurator panel.
      *
@@ -143,59 +165,5 @@ export type MetadataFieldConfiguratorProps = GeneralComponentProps & (NativeDrag
      */
     onValidationChange?: (isValid: boolean) => void;
 };
-/**
- * A form-backed accordion item for configuring a single metadata field.
- *
- * Supports two operating modes:
- * - **Standalone**: manages its own Accordion root and open/closed state internally.
- * - **List mode**: when `isExpanded` is provided, the parent `MetadataFieldList` owns
- *   the shared Accordion root and controls open/closed state.
- *
- * Drag-and-drop can be handled via native HTML5 events or dnd-kit (mutually exclusive).
- *
- * All state, effects, and callbacks live in {@link useFieldConfiguratorBehavior}.
- * The edit form is rendered by {@link FieldEditContent}.
- * The accordion header toolbar is rendered by {@link FieldActionSlot}.
- *
- * @example
- * ```tsx
- * // Standalone usage — host owns values state
- * const [values, setValues] = useState<FieldData>(
- *   createDefaultFieldValues(FieldType.Text),
- * );
- * const [isValid, setIsValid] = useState(false);
- *
- * <MetadataFieldConfigurator
- *   index={0}
- *   maxIndex={0}
- *   values={values}
- *   onValuesChange={setValues}
- *   onValidationChange={setIsValid}
- *   onDelete={key => console.log('deleted', key)}
- *   onReorderFields={(from, to) => console.log('reorder', from, to)}
- *   // Native HTML5 drag — swap for dndDragHandleProps when using dnd-kit
- *   onDragStart={(e, i) => {}}
- *   onDragEnd={(e, i) => {}}
- *   onTouchStart={(e, i) => {}}
- *   fetchTaxonomies={() => api.getTaxonomies()}
- * />
- * <button disabled={!isValid}>Save</button>
- * ```
- *
- * @example
- * ```tsx
- * // With dnd-kit drag handle (e.g. inside a custom sortable list)
- * const { attributes, listeners } = useSortable({ id: values.id });
- *
- * <MetadataFieldConfigurator
- *   index={index}
- *   maxIndex={maxIndex}
- *   values={values}
- *   onValuesChange={setValues}
- *   onReorderFields={handleReorder}
- *   dndDragHandleProps={{ listeners, attributes }}
- * />
- * ```
- */
-export declare const MetadataFieldConfigurator: ({ index, maxIndex, values, onValuesChange, onDelete, onDuplicate, onReorderFields, onTouchStart, onDragStart, onDragEnd, externalErrors, externalTouched, dndDragHandleProps, fieldCollapsedText, isExpanded, onExpandedChange, taxonomyOptions, fetchTaxonomies, submitAttemptCount, fieldExtensions: fieldExtensionsProp, onValidationChange, readOnly, }: MetadataFieldConfiguratorProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MetadataFieldConfigurator: ({ index, maxIndex, values, onValuesChange, onDelete, onDuplicate, onReorderFields, onTouchStart, onDragStart, onDragEnd, externalErrors, externalTouched, dndDragHandleProps, fieldCollapsedText, isExpanded, onExpandedChange, taxonomyOptions, fetchTaxonomies, fetchTaxonomyByKey, submitAttemptCount, fieldExtensions: fieldExtensionsProp, onValidationChange, readOnly, }: MetadataFieldConfiguratorProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/lib/components/metadata-field-list/metadata-field-list.d.ts

@@ -1,7 +1,7 @@
 import { MetadataFieldConfiguratorProps } from '../metadata-field-configurator';
 import { TaxonomyInitialStateLabels } from '../metadata-field-configurator/context/editor-config-context';
 import { FieldConfiguratorExtension } from '../metadata-field-configurator/context/field-extensions-context';
-import { FieldData, FieldType } from '../../types';
+import { FetchTaxonomyByKey, FieldData, FieldType } from '../../types';
 /**
  * Imperative handle exposed by `MetadataFieldList` via `forwardRef`.
  * Use it to programmatically scroll to and expand a specific field.
@@ -35,6 +35,11 @@ export type MetadataFieldListProps = {
      * of the list. Mutually exclusive with `taxonomyOptions`.
      */
     readonly fetchTaxonomies?: MetadataFieldConfiguratorProps['fetchTaxonomies'];
+    /**
+     * Async function called to resolve a single taxonomy by namespace and key.
+     * Lookups are cached across fields for the lifetime of the list. Independent of `fetchTaxonomies`.
+     */
+    readonly fetchTaxonomyByKey: FetchTaxonomyByKey;
     /**
      * Field types that are disabled/hidden from the field type picker (defaults to none).
      */
@@ -106,6 +111,7 @@ export type MetadataFieldListProps = {
  * <MetadataFieldList
  *   fields={fields}
  *   onChangeFields={setFields}
+ *   fetchTaxonomyByKey={({ namespace, taxonomyKey }) => api.getTaxonomyByKey(namespace, taxonomyKey)}
  * />
  *
  * // With validation gating, lazy taxonomy loading, and an API delete side-effect
@@ -117,6 +123,7 @@ export type MetadataFieldListProps = {
  *   onDeleteFieldAtIndex={(index, field) => api.deleteField(field.key)}
  *   onValidationChange={setAllValid}
  *   fetchTaxonomies={() => api.getTaxonomies()}
+ *   fetchTaxonomyByKey={({ namespace, taxonomyKey }) => api.getTaxonomyByKey(namespace, taxonomyKey)}
  * />
  * <button disabled={!allValid}>Save</button>
  * ```

package/dist/types/lib/components/metadata-template-editor-form/metadata-template-editor-form.d.ts

@@ -5,6 +5,7 @@ type MetadataTemplateEditorFormProps = {
     onCancel?: () => void;
     taxonomyOptions?: MetadataFieldListProps['taxonomyOptions'];
     fetchTaxonomies?: MetadataFieldListProps['fetchTaxonomies'];
+    fetchTaxonomyByKey: MetadataFieldListProps['fetchTaxonomyByKey'];
     hideActions?: boolean;
     isEditMode?: boolean;
     /**
@@ -25,5 +26,5 @@ type MetadataTemplateEditorFormProps = {
      */
     fieldExtensions?: FieldConfiguratorExtension[];
 };
-declare const MetadataTemplateEditorForm: ({ formId, onCancel, taxonomyOptions, fetchTaxonomies, hideActions, isEditMode, readOnly, onDirtyStateChange, onValidationChange, fieldExtensions, }: MetadataTemplateEditorFormProps) => import("react/jsx-runtime").JSX.Element;
+declare const MetadataTemplateEditorForm: ({ formId, onCancel, taxonomyOptions, fetchTaxonomies, fetchTaxonomyByKey, hideActions, isEditMode, readOnly, onDirtyStateChange, onValidationChange, fieldExtensions, }: MetadataTemplateEditorFormProps) => import("react/jsx-runtime").JSX.Element;
 export default MetadataTemplateEditorForm;

package/dist/types/lib/metadata-template-editor.d.ts

@@ -1,7 +1,7 @@
 import { TaxonomyInitialStateLabels } from './components/metadata-field-configurator/context/editor-config-context';
 import { FieldConfiguratorExtension } from './components/metadata-field-configurator/context/field-extensions-context';
 import { MetadataFieldListProps } from './components/metadata-field-list';
-import { FieldType, MetadataTemplateApiResponse, MetadataTemplateCreateBody, MetadataTemplateEditorMode, MetadataTemplatePatchItem } from './types';
+import { FetchTaxonomyByKey, FieldType, MetadataTemplateApiResponse, MetadataTemplateCreateBody, MetadataTemplateEditorMode, MetadataTemplatePatchItem } from './types';
 type MetadataTemplateEditorCommonProps = {
     /** Called when the user dismisses the form without saving. */
     onCancel?: () => void;
@@ -110,6 +110,30 @@ type MetadataTemplateEditorCommonProps = {
      * ```
      */
     fetchTaxonomies?: MetadataFieldListProps['fetchTaxonomies'];
+    /**
+     * Resolves a single taxonomy by namespace and key.
+     *
+     * The template API returns only `taxonomyKey` and `namespace` for a taxonomy field, so this
+     * is the only way the editor can render that field's display name and levels. The editor
+     * calls it when such a field is expanded, caches the result by key, and handles loading,
+     * error, and retry internally.
+     *
+     * Independent of `fetchTaxonomies`, which feeds the taxonomy picker for new fields.
+     *
+     * @example
+     * ```tsx
+     * <MetadataTemplateEditor
+     *   fetchTaxonomyByKey={async ({ namespace, taxonomyKey }) => {
+     *     const taxonomy = await api.getTaxonomyByKey(namespace, taxonomyKey);
+     *     return {
+     *       label: taxonomy.displayName,
+     *       levels: taxonomy.levels.map(level => ({ name: level.displayName, level: level.level })),
+     *     };
+     *   }}
+     * />
+     * ```
+     */
+    fetchTaxonomyByKey: FetchTaxonomyByKey;
     /**
      * Field types that are disabled/hidden from the field type picker (defaults to none).
      */

package/dist/types/lib/types.d.ts

@@ -112,6 +112,35 @@ export interface TaxonomyOption {
     taxonomyKey: string;
     namespace: string;
 }
+/**
+ * Looks up a single taxonomy by namespace and key.
+ *
+ * Used to hydrate an existing field's display name and levels from
+ * `GET /metadata_taxonomies/:namespace/:taxonomyKey` without loading the full catalogue.
+ *
+ * The shared feature stamps `id`, `namespace`, `taxonomyKey`, and `selected` from the
+ * request. Hosts only need to return display metadata (`label` and `levels`).
+ *
+ * The Box API field is `key`, not `taxonomyKey`.
+ *
+ * @example
+ * ```tsx
+ * <MetadataTemplateEditor
+ *   fetchTaxonomyByKey={async ({ namespace, taxonomyKey }) => {
+ *     const taxonomy = await api.getTaxonomyByKey(namespace, taxonomyKey);
+ *     return {
+ *       label: taxonomy.displayName,
+ *       levels: taxonomy.levels.map(level => ({ name: level.displayName, level: level.level })),
+ *     };
+ *   }}
+ * />
+ * ```
+ */
+export type FetchedTaxonomyDetails = Pick<TaxonomyOption, 'label' | 'levels'> & Partial<TaxonomyOption>;
+export type FetchTaxonomyByKey = (params: {
+    namespace: string;
+    taxonomyKey: string;
+}) => Promise<FetchedTaxonomyDetails>;
 /**
  * Represents a taxonomy level.
  */

package/dist/types/lib/utils/taxonomy-identity.d.ts

@@ -0,0 +1,12 @@
+import { TaxonomyOption } from '../types';
+/**
+ * Stable identity for a taxonomy is `namespace` + `taxonomyKey`, never `id`.
+ * Two catalogues can reuse the same key (or even the same id) across namespaces.
+ *
+ * Also used as a React list key and as the stamped `id` on by-key lookup results.
+ */
+export declare const taxonomyCacheKey: (namespace: string, taxonomyKey: string) => string;
+export declare const isSameTaxonomyIdentity: (taxonomy: Pick<TaxonomyOption, "namespace" | "taxonomyKey">, identity: Pick<TaxonomyOption, "namespace" | "taxonomyKey">) => boolean;
+export declare const findTaxonomyOption: (options: TaxonomyOption[], identity: Pick<TaxonomyOption, "namespace" | "taxonomyKey">) => TaxonomyOption | undefined;
+/** Catalogue list rows often omit levels; those still need a by-key lookup. */
+export declare const hasHydratedLevels: (taxonomy: Pick<TaxonomyOption, "levels"> | undefined) => boolean;

package/package.json

@@ -1,10 +1,10 @@
 {
     "name": "@box/metadata-template-editor",
-    "version": "2.3.44",
+    "version": "2.3.46",
     "license": "SEE LICENSE IN LICENSE",
     "peerDependencies": {
-        "@box/blueprint-web": "^17.5.2",
-        "@box/blueprint-web-assets": "^5.9.8",
+        "@box/blueprint-web": "^17.5.3",
+        "@box/blueprint-web-assets": "^5.9.9",
         "@dnd-kit/core": "^6.1.0",
         "@dnd-kit/sortable": "^8.0.0",
         "@dnd-kit/utilities": "^3.2.2",
@@ -17,10 +17,10 @@
         "yup": "^1.6.1"
     },
     "devDependencies": {
-        "@box/blueprint-web": "^17.5.2",
-        "@box/blueprint-web-assets": "^5.9.8",
-        "@box/eslint-plugin-blueprint": "2.2.12",
-        "@box/storybook-utils": "1.2.39",
+        "@box/blueprint-web": "^17.5.3",
+        "@box/blueprint-web-assets": "^5.9.9",
+        "@box/eslint-plugin-blueprint": "2.2.13",
+        "@box/storybook-utils": "1.2.40",
         "@dnd-kit/core": "^6.1.0",
         "@dnd-kit/sortable": "^8.0.0",
         "@dnd-kit/utilities": "^3.2.2",