@pimcore/data-hub 2026.1.2 → 2026.1.4

package/dist/build/types/components/base-detail-view/components/config-toolbar/config-toolbar.d.ts

@@ -17,7 +17,11 @@ export interface ConfigToolbarProps {
     onSave: () => void;
     onRefresh: () => void;
     onDelete: () => void;
+    /** When false, the delete button is hidden. Defaults to shown. */
+    canDelete?: boolean;
+    /** Translation key for the disabled-save tooltip. Defaults to config_not_writeable. */
+    saveDisabledTooltipKey?: string;
     additionalButtons?: ReactNode[];
     leftAdditionalContent?: ReactNode;
 }
-export declare function ConfigToolbar({ configName, isWriteable, isLoading, isSaving, isDirty, onSave, onRefresh, onDelete, additionalButtons, leftAdditionalContent }: ConfigToolbarProps): React.JSX.Element;
+export declare function ConfigToolbar({ configName, isWriteable, isLoading, isSaving, isDirty, onSave, onRefresh, onDelete, canDelete, saveDisabledTooltipKey, additionalButtons, leftAdditionalContent }: ConfigToolbarProps): React.JSX.Element;

package/dist/build/types/components/base-detail-view/hooks/use-detail-view.d.ts

@@ -14,6 +14,8 @@ export interface UseDetailViewProps<TFormValues, TBackendConfig> {
     modificationDate: number | undefined;
     isLoading: boolean;
     requestId: string | undefined;
+    /** When false, saving is blocked centrally (read-only / location-locked configuration). Defaults to true. */
+    isWriteable?: boolean;
     transformToForm: (backendConfig: TBackendConfig, configName: string) => TFormValues;
     transformToBackend: (formValues: TFormValues, existingConfig: TBackendConfig) => TBackendConfig;
     onSave: (updatedConfig: TBackendConfig, modificationDate: number) => Promise<{
@@ -29,4 +31,4 @@ export interface UseDetailViewReturn<TFormValues> {
     handleSave: () => void;
     handleValuesChange: () => void;
 }
-export declare function useDetailView<TFormValues extends Record<string, any>, TBackendConfig extends Record<string, any>>({ configName, configData, modificationDate, isLoading, requestId, transformToForm, transformToBackend, onSave, onChange, successMessageKey }: UseDetailViewProps<TFormValues, TBackendConfig>): UseDetailViewReturn<TFormValues>;
+export declare function useDetailView<TFormValues extends Record<string, any>, TBackendConfig extends Record<string, any>>({ configName, configData, modificationDate, isLoading, requestId, isWriteable, transformToForm, transformToBackend, onSave, onChange, successMessageKey }: UseDetailViewProps<TFormValues, TBackendConfig>): UseDetailViewReturn<TFormValues>;

package/dist/build/types/components/base-detail-view/index.d.ts

@@ -10,3 +10,4 @@
 export * from './base-detail-view';
 export * from './components/config-toolbar';
 export * from './hooks';
+export * from './track-config-error';

package/dist/build/types/components/base-detail-view/track-config-error.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+/**
+ * Tracks an API error coming from a Data Hub config load/save.
+ *
+ * For a generic validation failure the backend returns the human-readable reason
+ * in `message` (e.g. "Please define a schema for the export"), while the default
+ * ApiError handling would only show the translated "Validation failed" error key
+ * and discard that reason. In that case we surface the message instead so the user
+ * sees what is actually wrong.
+ */
+export declare const trackConfigError: (error: unknown) => void;

package/dist/build/types/modules/config/components/column-config-modal/base-column-editor.d.ts

@@ -25,5 +25,7 @@ export interface BaseColumnEditorProps {
     language?: string;
     /** Called when the user changes the preview language inside the modal. */
     onLanguageChange?: (language: string) => void;
+    /** When true, only columns marked as exportable are offered in the add-column dropdown. */
+    exportableOnly?: boolean;
 }
 export declare const BaseColumnEditor: React.ForwardRefExoticComponent<BaseColumnEditorProps & React.RefAttributes<ColumnEditorHandle<SchemaColumn>>>;

package/dist/build/types/modules/config/components/column-config-modal/base-column-editor.styles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+export declare const useStyles: (props?: unknown) => import("antd-style").ReturnStyles<{
+    body: import("antd-style").SerializedStyles;
+    fieldsPanel: import("antd-style").SerializedStyles;
+    list: import("antd-style").SerializedStyles;
+}>;

package/dist/build/types/modules/config/components/column-config-modal/column-config-modal.d.ts

@@ -21,6 +21,8 @@ export interface EditorRenderProps<TColumns = SchemaColumn> {
     entity: string;
     /** True in the split migration view — the editor should hide its own Apply/Discard toolbar. */
     hideToolbar: boolean;
+    /** When true, only columns marked as exportable are offered in the add-column dropdown. */
+    exportableOnly: boolean;
     onApply: (columns: TColumns[]) => void;
     onCancel: () => void;
     /** The currently persisted preview language for this entity. */
@@ -50,6 +52,8 @@ export interface ColumnConfigModalProps<TColumns = SchemaColumn> {
     language?: string;
     /** Called when the user changes the preview language so the adapter can persist it. */
     onLanguageChange?: (language: string) => void;
+    /** When true, only columns marked as exportable are offered in the add-column dropdown. */
+    exportableOnly?: boolean;
     /**
      * Render prop that returns the adapter-specific column editor element.
      * The consumer MUST forward the `ref` to their editor component (forwardRef).
@@ -66,4 +70,4 @@ export interface ColumnConfigModalProps<TColumns = SchemaColumn> {
  * migration path (MigrationModal with split view). The adapter-specific
  * editor is injected via the `renderEditor` render prop.
  */
-export declare const ColumnConfigModal: <TColumns = SchemaColumn>({ entity, classDefinitionId, columns, columnConfig, open, title, onApply, onCancel, language, onLanguageChange, renderEditor }: ColumnConfigModalProps<TColumns>) => React.JSX.Element;
+export declare const ColumnConfigModal: <TColumns = SchemaColumn>({ entity, classDefinitionId, columns, columnConfig, open, title, onApply, onCancel, language, onLanguageChange, exportableOnly, renderEditor }: ColumnConfigModalProps<TColumns>) => React.JSX.Element;

package/dist/build/types/modules/config/components/column-config-modal/fields-to-add-panel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import React from 'react';
+import { type ColumnPickerGroup } from '@pimcore/studio-ui-bundle/components';
+import { type GridColumnConfiguration } from '@pimcore/studio-ui-bundle/api/data-object';
+export interface FieldsToAddPanelProps {
+    groups: Array<ColumnPickerGroup<GridColumnConfiguration>>;
+    onColumnSelect: (column: GridColumnConfiguration) => void;
+    onClose: () => void;
+}
+/**
+ * Embedded "Fields to add" panel shown inside the migrated column editor: the
+ * searchable ColumnPicker tree with a collapsible header.
+ */
+export declare const FieldsToAddPanel: ({ groups, onColumnSelect, onClose }: FieldsToAddPanelProps) => React.JSX.Element;

package/dist/build/types/modules/config/components/column-config-modal/index.d.ts

@@ -8,7 +8,7 @@
  *  @license    Pimcore Open Core License (POCL)
  */
 export * from './column-config-modal';
-export * from './use-add-column-dropdown';
+export * from './use-add-column-groups';
 export * from './types';
 export * from './column-preview';
 export * from './column-pipeline-form';

package/dist/build/types/modules/config/components/column-config-modal/types.d.ts

@@ -70,6 +70,12 @@ export interface AdvancedEditorColumn {
     /** Whether this column supports per-column locale selection. */
     localizable?: boolean;
     locale?: string | null;
+    /**
+     * Frontend-only: true for columns added during the current editing session.
+     * Drives the initial collapse state — only freshly added advanced columns mount
+     * expanded, while columns loaded from the persisted config stay collapsed. Never persisted.
+     */
+    isNew?: boolean;
 }
 /**
  * Converts a persisted SchemaColumn into an AdvancedEditorColumn draft.

package/dist/build/types/modules/config/components/column-config-modal/use-add-column-groups.d.ts

@@ -0,0 +1,17 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import { type ColumnPickerGroup } from '@pimcore/studio-ui-bundle/components';
+import { type GridColumnConfiguration } from '@pimcore/studio-ui-bundle/api/data-object';
+/**
+ * Builds grouped, selectable column groups for the studio ColumnPicker from a
+ * flat list of GridColumnConfiguration entries. Each leaf carries its column in
+ * `meta`, so the picker's `onSelect` can hand it back to the add-column handler.
+ */
+export declare const useAddColumnGroups: (availableColumns: GridColumnConfiguration[]) => Array<ColumnPickerGroup<GridColumnConfiguration>>;

package/dist/build/types/modules/config/components/column-config-modal/use-column-editor-state.d.ts

@@ -9,20 +9,24 @@
  */
 import { type GridColumnConfiguration } from '@pimcore/studio-ui-bundle/api/data-object';
 import { type AdvancedEditorColumn, type SchemaColumn } from './types';
-import { type AddColumnDropdownMenu } from './use-add-column-dropdown';
+import { type ColumnPickerGroup } from '@pimcore/studio-ui-bundle/components';
 interface UseColumnEditorStateOptions {
     entity: string;
     classDefinitionId?: string;
     columns: SchemaColumn[];
     onApply: (columns: SchemaColumn[]) => void;
     onCancel: () => void;
+    /** When true, only columns marked as exportable are offered in the add-column dropdown. */
+    exportableOnly?: boolean;
 }
 interface UseColumnEditorStateResult {
     draft: AdvancedEditorColumn[];
     isLoading: boolean;
     objectId: number | null;
     availableFields: GridColumnConfiguration[];
-    addColumnMenu: AddColumnDropdownMenu;
+    columnGroups: Array<ColumnPickerGroup<GridColumnConfiguration>>;
+    /** Adds an advanced (pipeline) column, or undefined when the schema offers none. */
+    onAddAdvancedColumn?: () => void;
     openElementSelector: () => void;
     handleAddColumnOfType: (column: GridColumnConfiguration) => void;
     handlePipelineChange: (id: string, pipeline: Record<string, any>) => void;
@@ -33,5 +37,5 @@ interface UseColumnEditorStateResult {
     handleReorder: (ids: string[]) => void;
     getColumns: () => SchemaColumn[];
 }
-export declare const useColumnEditorState: ({ entity, classDefinitionId, columns, onApply, onCancel }: UseColumnEditorStateOptions) => UseColumnEditorStateResult;
+export declare const useColumnEditorState: ({ entity, classDefinitionId, columns, onApply, onCancel, exportableOnly }: UseColumnEditorStateOptions) => UseColumnEditorStateResult;
 export {};

package/dist/build/types/modules/config/components/migration-modal/compact-layout-context.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This source file is available under the terms of the
+ * Pimcore Open Core License (POCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (https://www.pimcore.com)
+ *  @license    Pimcore Open Core License (POCL)
+ */
+import React from 'react';
+export interface CompactLayoutContextProps {
+    /**
+     * True when the editor is rendered in a horizontally constrained context
+     * (e.g. the migration modal's split view). Forms should collapse side-by-side
+     * layouts into tabs when this is set.
+     */
+    compact: boolean;
+}
+export interface CompactLayoutProviderProps extends Partial<CompactLayoutContextProps> {
+    children: React.ReactNode;
+}
+export declare const CompactLayoutProvider: ({ children, compact }: CompactLayoutProviderProps) => React.JSX.Element;
+export declare const useCompactLayout: () => CompactLayoutContextProps;

package/dist/build/types/modules/config/components/migration-modal/index.d.ts

@@ -8,3 +8,4 @@
  *  @license    Pimcore Open Core License (POCL)
  */
 export * from './migration-modal';
+export * from './compact-layout-context';