@blokkli/editor 2.0.0-alpha.49 → 2.0.0-alpha.50

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@blokkli/editor",
   "configKey": "blokkli",
-  "version": "2.0.0-alpha.49",
+  "version": "2.0.0-alpha.50",
   "compatibility": {
     "nuxt": ">=3.15.0"
   },

package/dist/module.mjs

@@ -18,7 +18,7 @@ import 'typescript';
 import 'oxc-walker';
 
 const name = "@blokkli/editor";
-const version = "2.0.0-alpha.49";
+const version = "2.0.0-alpha.50";
 
 function validateOption(optionKey, option, icons) {
   const errors = [];
@@ -1554,6 +1554,7 @@ const USED_MATERIAL_ICONS = [
   "bk_mdi_stream",
   "bk_mdi_swap_horiz",
   "bk_mdi_swap_horizontal_circle",
+  "bk_mdi_swap_vert",
   "bk_mdi_text_compare",
   "bk_mdi_text_select_end",
   "bk_mdi_texture",

package/dist/modules/agent/runtime/app/features/agent/types.d.ts

@@ -18,10 +18,6 @@ declare module '#blokkli/editor/types/permissions' {
 }
 declare module '#blokkli/editor/adapter' {
     interface BlokkliAdapter<T> {
-        /**
-         * Swap two blocks.
-         */
-        swapBlocks?: (first: string, second: string) => Promise<MutationResponseLike<T>>;
         /**
          * Rearrange blocks within a field by specifying the desired order.
          *

package/dist/modules/agent/runtime/app/tools/add_paragraphs/index.js

@@ -78,10 +78,14 @@ function validateContentFields(ctx, block, path) {
   }
   return void 0;
 }
-function validateBlockOptions(ctx, block, path) {
+function validateBlockOptions(ctx, block, path, parentBundle) {
   if (!block.options) return void 0;
   const { definitions } = ctx.app;
-  const definition = definitions.getBlockDefinition(block.bundle, "default");
+  const definition = definitions.getBlockDefinition(
+    block.bundle,
+    "default",
+    parentBundle
+  );
   if (!definition) {
     return `${path}: Paragraph definition not found for bundle "${block.bundle}".`;
   }
@@ -103,7 +107,7 @@ function validateBlockOptions(ctx, block, path) {
   }
   return void 0;
 }
-function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix) {
+function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix, parentBundle) {
   const { types } = ctx.app;
   for (let i = 0; i < blocks.length; i++) {
     const block = blocks[i];
@@ -120,7 +124,7 @@ function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix)
     }
     const contentError = validateContentFields(ctx, block, path);
     if (contentError) return contentError;
-    const optionsError = validateBlockOptions(ctx, block, path);
+    const optionsError = validateBlockOptions(ctx, block, path, parentBundle);
     if (optionsError) return optionsError;
     if (block.children) {
       for (const [childFieldName, childBlocks] of Object.entries(
@@ -141,7 +145,8 @@ function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix)
           childBlocks,
           childFieldConfig.allowedBundles,
           childFieldName,
-          `${path} > ${childFieldName} > `
+          `${path} > ${childFieldName} > `,
+          block.bundle
         );
         if (childError) return childError;
       }
@@ -149,7 +154,7 @@ function validateBlockTree(ctx, blocks, allowedBundles, fieldLabel, pathPrefix)
   }
   return void 0;
 }
-function buildEventBlocks(ctx, blocks) {
+function buildEventBlocks(ctx, blocks, parentBundle) {
   const { definitions } = ctx.app;
   return blocks.map((block) => {
     const blockUuid = generateUUID();
@@ -159,7 +164,11 @@ function buildEventBlocks(ctx, blocks) {
     })) : void 0;
     let options;
     if (block.options) {
-      const definition = definitions.getBlockDefinition(block.bundle, "default");
+      const definition = definitions.getBlockDefinition(
+        block.bundle,
+        "default",
+        parentBundle
+      );
       if (definition) {
         const availableOptions = getAvailableOptions(
           definition.options,
@@ -180,7 +189,11 @@ function buildEventBlocks(ctx, blocks) {
       children = {};
       for (const [fieldName, childBlocks] of Object.entries(block.children)) {
         if (childBlocks.length) {
-          children[fieldName] = buildEventBlocks(ctx, childBlocks);
+          children[fieldName] = buildEventBlocks(
+            ctx,
+            childBlocks,
+            block.bundle
+          );
         }
       }
     }
@@ -253,17 +266,23 @@ export default defineBlokkliAgentTool({
         };
       }
     }
+    const topLevelParentBundle = isRootEntity ? null : bundle;
     const validationError = validateBlockTree(
       ctx,
       params.paragraphs,
       field.allowedBundles,
       params.parent.field,
-      ""
+      "",
+      topLevelParentBundle
     );
     if (validationError) {
       return { error: validationError };
     }
-    const eventBlocks = buildEventBlocks(ctx, params.paragraphs);
+    const eventBlocks = buildEventBlocks(
+      ctx,
+      params.paragraphs,
+      topLevelParentBundle
+    );
     const totalCount = countBlocks(eventBlocks);
     const blockUuids = collectAllUuids(eventBlocks);
     const { $t } = ctx.app;

package/dist/modules/agent/runtime/app/tools/get_bundle_info/index.js

@@ -58,7 +58,7 @@ export default defineBlokkliAgentTool({
   paramsSchema,
   resultSchema,
   execute(ctx, params) {
-    const { fields, types, state, definitions, $t } = ctx.app;
+    const { fields, types, state, definitions, $t, context, blocks } = ctx.app;
     const label = $t(
       "aiAgentGetBundleInfoDone",
       "Got bundle info for @field"
@@ -79,6 +79,7 @@ export default defineBlokkliAgentTool({
     const currentCount = state.getFieldBlockCount(fieldKey);
     const allowedBundles = params.bundles ? field.allowedBundles.filter((b) => params.bundles.includes(b)) : field.allowedBundles;
     const includeOptions = allowedBundles.length < 3;
+    const parentBundle = params.parentUuid === context.value.entityUuid ? null : blocks.getBlock(params.parentUuid)?.bundle ?? null;
     const bundles = allowedBundles.map((bundle) => {
       const bundleDefinition = types.getBlockBundleDefinition(bundle);
       const contentFields = {};
@@ -106,7 +107,11 @@ export default defineBlokkliAgentTool({
       }
       let options;
       if (includeOptions) {
-        const definition = definitions.getBlockDefinition(bundle, "default");
+        const definition = definitions.getBlockDefinition(
+          bundle,
+          "default",
+          parentBundle
+        );
         if (definition) {
           const availableOptions = getAvailableOptions(
             definition.options,

package/dist/modules/agent/runtime/app/tools/get_paragraph_context/index.js

@@ -241,7 +241,7 @@ export default defineBlokkliAgentTool({
       const definition = definitions.getBlockDefinition(
         block.bundle,
         selectionItem?.fieldListType ?? "default",
-        selectionItem?.parentBlockBundle
+        selectionItem?.parentBlockBundle ?? null
       );
       if (definition) {
         const availableOptions = getAvailableOptions(

package/dist/modules/agent/runtime/app/tools/get_paragraph_options/index.js

@@ -35,7 +35,7 @@ export default defineBlokkliAgentTool({
       const definition = definitions.getBlockDefinition(
         bundle,
         selectionItem?.fieldListType ?? "default",
-        selectionItem?.parentBlockBundle
+        selectionItem?.parentBlockBundle ?? null
       );
       if (!definition) continue;
       const availableOptions = getAvailableOptions(

package/dist/modules/agent/runtime/app/tools/set_paragraph_options/index.js

@@ -60,7 +60,7 @@ export default defineBlokkliAgentTool({
       const definition = definitions.getBlockDefinition(
         bundle,
         selectionItem?.fieldListType ?? "default",
-        selectionItem?.parentBlockBundle
+        selectionItem?.parentBlockBundle ?? null
       );
       if (!definition) {
         return {

package/dist/modules/agent/runtime/app/tools/swap_paragraphs/index.js

@@ -1,10 +1,7 @@
 import { z } from "zod";
 import { defineBlokkliAgentTool } from "#blokkli/agent/app/composables";
 import { mutationResultSchema } from "../schemas.js";
-import {
-  requireBundlePermission,
-  requireNoRestrictedAncestor
-} from "../../helpers/validation.js";
+import { getSwapDisabledReason } from "#blokkli/editor/helpers/swap";
 const paramsSchema = z.object({
   uuidA: z.string().describe("First paragraph UUID"),
   uuidB: z.string().describe("Second paragraph UUID")
@@ -23,10 +20,7 @@ export default defineBlokkliAgentTool({
   resultSchema: mutationResultSchema,
   requiredAdapterMethods: ["swapBlocks"],
   execute(ctx, params) {
-    const { blocks, types, $t } = ctx.app;
-    if (params.uuidA === params.uuidB) {
-      return { error: "Both UUIDs refer to the same paragraph" };
-    }
+    const { blocks, types, $t, permissions } = ctx.app;
     const blockA = blocks.getBlock(params.uuidA);
     if (!blockA) {
       return { error: `Paragraph not found: ${params.uuidA}` };
@@ -35,46 +29,13 @@ export default defineBlokkliAgentTool({
     if (!blockB) {
       return { error: `Paragraph not found: ${params.uuidB}` };
     }
-    const denied = requireBundlePermission(
-      ctx.app,
-      [blockA.bundle, blockB.bundle],
-      "edit"
-    );
-    if (denied) return denied;
-    const ancestorDenied = requireNoRestrictedAncestor(ctx.app, [
-      params.uuidA,
-      params.uuidB
-    ]);
-    if (ancestorDenied) return ancestorDenied;
-    const fieldConfigA = types.getFieldConfig(
-      blockA.host.type,
-      blockA.host.bundle,
-      blockA.host.fieldName
-    );
-    if (!fieldConfigA) {
-      return {
-        error: `Could not find field config for paragraph A's parent field`
-      };
-    }
-    const fieldConfigB = types.getFieldConfig(
-      blockB.host.type,
-      blockB.host.bundle,
-      blockB.host.fieldName
-    );
-    if (!fieldConfigB) {
-      return {
-        error: `Could not find field config for paragraph B's parent field`
-      };
-    }
-    if (!fieldConfigB.allowedBundles.includes(blockA.bundle)) {
-      return {
-        error: `Cannot swap: bundle "${blockA.bundle}" (uuid: ${params.uuidA}) is not allowed in field "${blockB.host.fieldName}" (parent: ${blockB.host.uuid}). Allowed bundles: ${fieldConfigB.allowedBundles.join(", ")}`
-      };
-    }
-    if (!fieldConfigA.allowedBundles.includes(blockB.bundle)) {
-      return {
-        error: `Cannot swap: bundle "${blockB.bundle}" (uuid: ${params.uuidB}) is not allowed in field "${blockA.host.fieldName}" (parent: ${blockA.host.uuid}). Allowed bundles: ${fieldConfigA.allowedBundles.join(", ")}`
-      };
+    const reason = getSwapDisabledReason(blockA, blockB, {
+      getFieldConfig: types.getFieldConfig,
+      checkBlockBundlePermission: permissions.checkBlockBundlePermission,
+      blockHasRestrictedAncestor: permissions.blockHasRestrictedAncestor
+    });
+    if (reason) {
+      return { error: reason };
     }
     const labelA = types.getBlockLabel(blockA.bundle);
     const labelB = types.getBlockLabel(blockB.bundle);

package/dist/modules/charts/runtime/blokkli/tools/chart_schemas.js

@@ -105,7 +105,7 @@ export function findChartOptionKey(ctx, uuid) {
   const definition = definitions.getBlockDefinition(
     bundle,
     selectionItem?.fieldListType ?? "default",
-    selectionItem?.parentBlockBundle
+    selectionItem?.parentBlockBundle ?? null
   );
   if (!definition?.options) {
     return { error: `Paragraph "${uuid}" (${bundle}) has no chart option.` };

package/dist/modules/charts/runtime/blokkli/tools/get_chart_data/index.js

@@ -38,7 +38,7 @@ export default defineBlokkliAgentTool({
     const chartOption = findChartOptionKey(ctx, params.uuid);
     if ("error" in chartOption) return chartOption;
     const item = state.getFieldListItem(params.uuid);
-    const rawData = item?.options?.[chartOption.key];
+    const rawData = state.mutatedOptions[params.uuid]?.[chartOption.key] || item?.options?.[chartOption.key];
     let data;
     if (rawData) {
       try {

package/dist/modules/charts/runtime/blokkli/tools/update_chart/index.js

@@ -47,7 +47,7 @@ export default defineBlokkliAgentTool({
     if ("error" in chartOption) return chartOption;
     let current;
     const item = state.getFieldListItem(params.uuid);
-    const rawData = item?.options?.[chartOption.key];
+    const rawData = state.mutatedOptions[params.uuid]?.[chartOption.key] || item?.options?.[chartOption.key];
     if (rawData) {
       try {
         current = JSON.parse(rawData);

package/dist/runtime/editor/components/EditProvider.vue

@@ -223,7 +223,8 @@ const fieldValue = fieldValueProviderFn(
   directive,
   state,
   types,
-  definitions
+  definitions,
+  blocks
 );
 const readability = readabilityProviderFn(
   adapters,

package/dist/runtime/editor/components/ItemIcon/index.vue

@@ -24,7 +24,7 @@ const iconName = computed(() => {
   if (props.bundle === fromLibraryBlockBundle) {
     return "reusable";
   } else if (props.bundle) {
-    const name = definitions.getBlockDefinition(props.bundle, "default")?.editor?.icon;
+    const name = definitions.getBlockDefinition(props.bundle, "default", null)?.editor?.icon;
     if (name) {
       return name;
     }

package/dist/runtime/editor/composables/useEditableFieldOverride.js

@@ -12,7 +12,7 @@ const NOOP_OVERRIDE = {
   }
 };
 export function useEditableFieldOverride(fieldName, host) {
-  const { eventBus, state, types, definitions, directive, fieldValue } = useBlokkli();
+  const { eventBus, state, types, definitions, directive, fieldValue, blocks } = useBlokkli();
   const el = directive.findEditableElement(fieldName, host);
   if (!el) {
     return NOOP_OVERRIDE;
@@ -42,7 +42,12 @@ export function useEditableFieldOverride(fieldName, host) {
   );
   let matchingProp = null;
   if (host.type === itemEntityType) {
-    const defintion = definitions.getBlockDefinition(host.bundle, "default");
+    const block = blocks.getBlock(host.uuid);
+    const defintion = definitions.getBlockDefinition(
+      host.bundle,
+      block?.fieldListType ?? "default",
+      block?.parentBlockBundle ?? null
+    );
     if (defintion?.propsFieldMapping) {
       matchingProp = findMatchingProp(defintion.propsFieldMapping);
     }

package/dist/runtime/editor/features/changelog/changelog.json

@@ -1,10 +1,18 @@
 [
+  {
+    "version": "2.0.0-alpha.50",
+    "date": "2026-03-24",
+    "body": {
+      "en": "<h3>New Features</h3>\n<h4>Swap block positions</h4>\n<p>Select two blocks and use the new &quot;Swap block positions&quot; action to exchange\ntheir positions. This works across different fields, as long as both block types\nare allowed in each other&#39;s field.</p>\n<h3>Improvements</h3>\n<ul>\n<li>Blocks with an editor option (e.g. chart data) now show the edit button even\nwhen regular editing is disabled. Clicking it opens the option editor directly.</li>\n</ul>\n",
+      "de": "<h3>Neue Funktionen</h3>\n<h4>Blockpositionen tauschen</h4>\n<p>Zwei Blöcke auswählen und über die neue Aktion «Blockpositionen tauschen» ihre\nPositionen vertauschen. Dies funktioniert auch feldübergreifend, sofern beide\nBlocktypen im jeweiligen Feld erlaubt sind.</p>\n<h3>Verbesserungen</h3>\n<ul>\n<li>Blöcke mit einer Option mit Editor (z.B. Diagrammdaten) zeigen jetzt den\nBearbeiten-Button an, auch wenn die reguläre Bearbeitung deaktiviert ist. Ein\nKlick öffnet direkt den Options-Editor.</li>\n</ul>\n"
+    }
+  },
   {
     "version": "2.0.0-alpha.48",
     "date": "2026-03-20",
     "body": {
       "en": "<h3>Improvements</h3>\n<ul>\n<li>The media library filters now use custom dropdown selects with keyboard\nnavigation and a search field for long lists, replacing the native browser\nselects.</li>\n</ul>\n",
-      "de": "<h3>Verbesserungen</h3>\n<ul>\n<li>Die Filter in der Medienbibliothek verwenden jetzt eigene Dropdown-Auswahlen\nmit Tastaturnavigation und einem Suchfeld bei langen Listen anstelle der\nnativen Browser-Auswahlen.</li>\n</ul>\n"
+      "de": "<h3>Verbesserungen</h3>\n<ul>\n<li>Die Filter in der Medienbibliothek verwenden jetzt eigene Dropdowns mit\nTastaturnavigation und einem Suchfeld bei langen Listen.</li>\n</ul>\n"
     }
   },
   {

package/dist/runtime/editor/features/dragging-overlay/index.vue

@@ -230,7 +230,8 @@ onBlokkliEvent("state:reloaded", async function() {
   eventBus.emit("select", allSelected);
   const definition = definitions.getBlockDefinition(
     newBlock.bundle,
-    newBlock.fieldListType
+    newBlock.fieldListType,
+    newBlock.parentBlockBundle
   );
   const addBehaviour = definition?.editor?.addBehaviour;
   if (addBehaviour?.startsWith("complex-option:")) {

package/dist/runtime/editor/features/edit/index.vue

@@ -29,6 +29,24 @@ const { eventBus, selection, state, $t, adapter, definitions, permissions } = us
 const userCanEditLibraryItems = computed(
   () => permissions.hasPermission("edit_library_item")
 );
+function getComplexOption(item) {
+  const definition = definitions.getBlockDefinition(
+    item.bundle,
+    item.fieldListType,
+    item.parentBlockBundle
+  );
+  if (!definition?.options) {
+    return;
+  }
+  const keys = Object.keys(definition.options);
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    if (!key) continue;
+    const option = definition.options[key];
+    if (option?.type !== "json" || !option.dataType) continue;
+    return { key, dataType: option.dataType };
+  }
+}
 function isFragment(item) {
   return item.bundle === fragmentBlockBundle;
 }
@@ -48,7 +66,7 @@ const editDisabledReason = computed(() => {
     item.fieldListType,
     item.parentBlockBundle
   );
-  if (definition?.editor?.disableEdit) {
+  if (definition?.editor?.disableEdit && !getComplexOption(item)) {
     return $t(
       "editDisabledByDefinition",
       "Editing is disabled for this block type."
@@ -107,32 +125,30 @@ function onClick(items) {
     }
     return;
   }
+  const complexOption = getComplexOption(item);
+  if (complexOption) {
+    eventBus.emit("option:edit-complex", {
+      uuid: item.uuid,
+      key: complexOption.key,
+      dataType: complexOption.dataType
+    });
+    return;
+  }
   eventBus.emit("item:edit", {
     uuid: item.uuid,
     bundle: item.bundle
   });
 }
 onBlokkliEvent("item:doubleClick", function(block) {
-  const definition = definitions.getBlockDefinition(block);
-  if (!definition) {
+  const complexOption = getComplexOption(block);
+  if (complexOption) {
+    eventBus.emit("option:edit-complex", {
+      uuid: block.uuid,
+      key: complexOption.key,
+      dataType: complexOption.dataType
+    });
     return;
   }
-  const options = definition.options;
-  if (options) {
-    const keys = Object.keys(options);
-    for (let i = 0; i < keys.length; i++) {
-      const key = keys[i];
-      if (!key) continue;
-      const option = options[key];
-      if (option?.type !== "json" || !option.dataType) continue;
-      eventBus.emit("option:edit-complex", {
-        uuid: block.uuid,
-        key,
-        dataType: option.dataType
-      });
-      return;
-    }
-  }
   onClick([block]);
 });
 </script>

package/dist/runtime/editor/features/swap/index.d.vue.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/runtime/editor/features/swap/index.vue

@@ -0,0 +1,57 @@
+<template>
+  <PluginItemAction
+    id="swap"
+    edit-only
+    :title="$t('swapButton', 'Swap block positions')"
+    :disabled="swapDisabledReason"
+    :hidden="selection.items.value.length !== 2"
+    multiple
+    icon="bk_mdi_swap_vert"
+    :weight="7e3"
+    @click="onClick"
+  />
+</template>
+
+<script setup>
+import { useBlokkli, defineBlokkliFeature, computed } from "#imports";
+import { PluginItemAction } from "#blokkli/editor/plugins";
+import { getSwapDisabledReason } from "#blokkli/editor/helpers/swap";
+const { state, $t, selection, types, permissions } = useBlokkli();
+const { adapter } = defineBlokkliFeature({
+  id: "swap",
+  icon: "bk_mdi_swap_vert",
+  label: "Swap",
+  description: "Provides an action to swap two selected blocks.",
+  requiredAdapterMethods: ["swapBlocks"]
+});
+const swapDisabledReason = computed(() => {
+  const items = selection.items.value;
+  if (items.length !== 2) {
+    return false;
+  }
+  const reason = getSwapDisabledReason(items[0], items[1], {
+    getFieldConfig: types.getFieldConfig,
+    checkBlockBundlePermission: permissions.checkBlockBundlePermission,
+    blockHasRestrictedAncestor: permissions.blockHasRestrictedAncestor
+  });
+  if (reason) {
+    return $t("swapNotPossible", "Block positions cannot be swapped.");
+  }
+  return false;
+});
+async function onClick(items) {
+  if (items.length !== 2) {
+    return;
+  }
+  await state.mutateWithLoadingState(
+    () => adapter.swapBlocks(items[0].uuid, items[1].uuid),
+    $t("swapError", "The blocks could not be swapped.")
+  );
+}
+</script>
+
+<script>
+export default {
+  name: "Swap"
+};
+</script>

package/dist/runtime/editor/features/swap/index.vue.d.ts

@@ -0,0 +1,3 @@
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/runtime/editor/features/swap/types.d.ts

@@ -0,0 +1,8 @@
+declare module '#blokkli/editor/adapter' {
+    interface BlokkliAdapter<T> {
+        /**
+         * Swap the positions of two blocks.
+         */
+        swapBlocks?: (first: string, second: string) => Promise<MutationResponseLike<T>>;
+    }
+}

package/dist/runtime/editor/helpers/swap.d.ts

@@ -0,0 +1,13 @@
+import type { RenderedFieldListItem } from '../types/field.js';
+import type { FieldConfig } from '../types/definitions.js';
+type SwapValidationContext = {
+    getFieldConfig: (entityType: string, entityBundle: string, fieldName: string) => FieldConfig | undefined;
+    checkBlockBundlePermission: (bundle: string, operation: 'edit') => boolean;
+    blockHasRestrictedAncestor: (uuid: string) => boolean;
+};
+/**
+ * Check whether two blocks can be swapped.
+ * Returns null if swap is possible, or a reason string if not.
+ */
+export declare function getSwapDisabledReason(blockA: RenderedFieldListItem, blockB: RenderedFieldListItem, ctx: SwapValidationContext): string | null;
+export {};

package/dist/runtime/editor/helpers/swap.js

@@ -0,0 +1,31 @@
+export function getSwapDisabledReason(blockA, blockB, ctx) {
+  if (blockA.uuid === blockB.uuid) {
+    return "Cannot swap a block with itself.";
+  }
+  if (!ctx.checkBlockBundlePermission(blockA.bundle, "edit") || !ctx.checkBlockBundlePermission(blockB.bundle, "edit")) {
+    return "You do not have permission to edit one or both blocks.";
+  }
+  if (ctx.blockHasRestrictedAncestor(blockA.uuid) || ctx.blockHasRestrictedAncestor(blockB.uuid)) {
+    return "One or both blocks are inside a parent with restricted editing permissions.";
+  }
+  const fieldConfigA = ctx.getFieldConfig(
+    blockA.host.type,
+    blockA.host.bundle,
+    blockA.host.fieldName
+  );
+  const fieldConfigB = ctx.getFieldConfig(
+    blockB.host.type,
+    blockB.host.bundle,
+    blockB.host.fieldName
+  );
+  if (!fieldConfigA || !fieldConfigB) {
+    return "Could not determine field configuration for one or both blocks.";
+  }
+  if (fieldConfigA.allowedBundles.length && !fieldConfigA.allowedBundles.includes(blockB.bundle)) {
+    return `Bundle "${blockB.bundle}" is not allowed in field "${blockA.host.fieldName}".`;
+  }
+  if (fieldConfigB.allowedBundles.length && !fieldConfigB.allowedBundles.includes(blockA.bundle)) {
+    return `Bundle "${blockA.bundle}" is not allowed in field "${blockB.host.fieldName}".`;
+  }
+  return null;
+}

package/dist/runtime/editor/plugins/ItemAction/index.d.vue.ts

@@ -53,6 +53,12 @@ type __VLS_Props = {
      * Lower weights appear first. Use 'last' to always position at the end.
      */
     weight?: number | string | 'last';
+    /**
+     * Whether the action should be hidden.
+     *
+     * Unlike disabled, this completely hides the button via v-show.
+     */
+    hidden?: boolean;
     /**
      * Optional icon to display in the button.
      */

package/dist/runtime/editor/plugins/ItemAction/index.vue

@@ -2,6 +2,7 @@
   <Teleport to="#bk-blokkli-item-actions">
     <button
       v-if="shouldRender"
+      v-show="!hidden"
       ref="el"
       :disabled="isDisabled"
       class="bk-item-action"
@@ -51,6 +52,7 @@ const props = defineProps({
   multiple: { type: Boolean, required: false },
   editOnly: { type: Boolean, required: false },
   weight: { type: [Number, String], required: false },
+  hidden: { type: Boolean, required: false },
   icon: { type: null, required: false },
   tourText: { type: String, required: false }
 });

package/dist/runtime/editor/plugins/ItemAction/index.vue.d.ts

@@ -53,6 +53,12 @@ type __VLS_Props = {
      * Lower weights appear first. Use 'last' to always position at the end.
      */
     weight?: number | string | 'last';
+    /**
+     * Whether the action should be hidden.
+     *
+     * Unlike disabled, this completely hides the button via v-show.
+     */
+    hidden?: boolean;
     /**
      * Optional icon to display in the button.
      */

package/dist/runtime/editor/providers/definition.d.ts

@@ -19,7 +19,7 @@ export type DefinitionProvider = {
      * @param parentBundle - Optional parent block bundle for nested blocks
      * @returns The block definition, or undefined if not found
      */
-    getBlockDefinition: (bundleOrBlock: string | RenderedFieldListItem, fieldListType?: ValidFieldListTypes | null, parentBundle?: BlockBundleWithNested | null) => BlockDefinition | undefined;
+    getBlockDefinition: (bundleOrBlock: string | RenderedFieldListItem, fieldListType: ValidFieldListTypes | null, parentBundle: BlockBundleWithNested | null) => BlockDefinition | undefined;
     /**
      * Get the default block definition for a bundle.
      *

package/dist/runtime/editor/providers/fieldValue.d.ts

@@ -4,6 +4,7 @@ import type { DefinitionProvider } from './definition.js';
 import type { DirectiveProvider } from './directive.js';
 import type { StateProvider } from './state.js';
 import type { BlockDefinitionProvider } from './types.js';
+import type { BlocksProvider } from './blocks.js';
 import './fieldValueAdapterTypes.js';
 /**
  * Simplified field type for editable fields.
@@ -51,4 +52,4 @@ export type FieldValueProvider = {
      */
     getTextFieldValues: () => Promise<TextFieldValue[]>;
 };
-export default function fieldValueProvider(adapters: AdaptersProvider, directive: DirectiveProvider, state: StateProvider, types: BlockDefinitionProvider, definitions: DefinitionProvider): FieldValueProvider;
+export default function fieldValueProvider(adapters: AdaptersProvider, directive: DirectiveProvider, state: StateProvider, types: BlockDefinitionProvider, definitions: DefinitionProvider, blocks: BlocksProvider): FieldValueProvider;

package/dist/runtime/editor/providers/fieldValue.js

@@ -1,6 +1,6 @@
 import { itemEntityType } from "#blokkli-build/config";
 import "./fieldValueAdapterTypes";
-export default function fieldValueProvider(adapters, directive, state, types, definitions) {
+export default function fieldValueProvider(adapters, directive, state, types, definitions, blocks) {
   function resolveFieldType(entityType, bundle, fieldName) {
     const config = types.editableFieldConfig.forName(
       entityType,
@@ -40,7 +40,12 @@ export default function fieldValueProvider(adapters, directive, state, types, de
     );
     let matchingProp = null;
     if (host.type === itemEntityType) {
-      const definition = definitions.getBlockDefinition(host.bundle, "default");
+      const block = blocks.getBlock(host.uuid);
+      const definition = definitions.getBlockDefinition(
+        host.bundle,
+        block?.fieldListType ?? "default",
+        block?.parentBlockBundle ?? null
+      );
       if (definition?.propsFieldMapping) {
         matchingProp = findMatchingProp(definition.propsFieldMapping, fieldName);
       }

package/dist/runtime/editor/translations/de.json

@@ -1636,7 +1636,7 @@
     "translation": "Dieser Blocktyp ist in diesem Feld nicht erlaubt."
   },
   "edit": {
-    "source": "Edit",
+    "source": "Edit...",
     "translation": "Bearbeiten..."
   },
   "editDisabledByDefinition": {
@@ -2199,6 +2199,14 @@
     "source": "Structure",
     "translation": "Struktur"
   },
+  "feature_swap_description": {
+    "source": "Provides an action to swap two selected blocks.",
+    "translation": ""
+  },
+  "feature_swap_label": {
+    "source": "Swap",
+    "translation": ""
+  },
   "feature_templates_description": {
     "source": "Add blocks from templates.",
     "translation": "Blöcke aus Vorlagen hinzufügen."
@@ -3043,6 +3051,18 @@
     "source": "Shows a structured list of all blocks on the current page. Click on any block to quickly jump to it.",
     "translation": "Zeigt eine strukturierte Liste aller Blöcke auf der aktuellen Seite. Klicken Sie auf einen Block, um ihn auf der Seite anzuzeigen."
   },
+  "swapButton": {
+    "source": "Swap block positions",
+    "translation": "Blockpositionen tauschen"
+  },
+  "swapError": {
+    "source": "The blocks could not be swapped.",
+    "translation": "Die Blöcke konnten nicht getauscht werden."
+  },
+  "swapNotPossible": {
+    "source": "Block positions cannot be swapped.",
+    "translation": "Blockpositionen können nicht getauscht werden."
+  },
   "systemRequirementsDialogButton": {
     "source": "Continue anyway",
     "translation": "Trotzdem fortfahren"

package/dist/runtime/editor/translations/fr.json

@@ -1636,7 +1636,7 @@
     "translation": ""
   },
   "edit": {
-    "source": "Edit",
+    "source": "Edit...",
     "translation": "Modifier"
   },
   "editDisabledByDefinition": {
@@ -2199,6 +2199,14 @@
     "source": "Structure",
     "translation": "Structure"
   },
+  "feature_swap_description": {
+    "source": "Provides an action to swap two selected blocks.",
+    "translation": ""
+  },
+  "feature_swap_label": {
+    "source": "Swap",
+    "translation": ""
+  },
   "feature_templates_description": {
     "source": "Add blocks from templates.",
     "translation": ""
@@ -3043,6 +3051,18 @@
     "source": "Shows a structured list of all blocks on the current page. Click on any block to quickly jump to it.",
     "translation": ""
   },
+  "swapButton": {
+    "source": "Swap block positions",
+    "translation": ""
+  },
+  "swapError": {
+    "source": "The blocks could not be swapped.",
+    "translation": ""
+  },
+  "swapNotPossible": {
+    "source": "Block positions cannot be swapped.",
+    "translation": ""
+  },
   "systemRequirementsDialogButton": {
     "source": "Continue anyway",
     "translation": ""

package/dist/runtime/editor/translations/gsw_CH.json

@@ -1636,7 +1636,7 @@
     "translation": "Dr Blocktyp isch in dem Fäld nid erlaubt."
   },
   "edit": {
-    "source": "Edit",
+    "source": "Edit...",
     "translation": "Bearbeite"
   },
   "editDisabledByDefinition": {
@@ -2199,6 +2199,14 @@
     "source": "Structure",
     "translation": "Struktur"
   },
+  "feature_swap_description": {
+    "source": "Provides an action to swap two selected blocks.",
+    "translation": ""
+  },
+  "feature_swap_label": {
+    "source": "Swap",
+    "translation": ""
+  },
   "feature_templates_description": {
     "source": "Add blocks from templates.",
     "translation": "Blöck us Vorlage drzuefüege."
@@ -3043,6 +3051,18 @@
     "source": "Shows a structured list of all blocks on the current page. Click on any block to quickly jump to it.",
     "translation": "Zeigt e strukturierti Lischt vo allne Blöck uf dr aktuälle Sitte aa. Klick uf e belibige Block zum schnäll dohii z'springe."
   },
+  "swapButton": {
+    "source": "Swap block positions",
+    "translation": ""
+  },
+  "swapError": {
+    "source": "The blocks could not be swapped.",
+    "translation": ""
+  },
+  "swapNotPossible": {
+    "source": "Block positions cannot be swapped.",
+    "translation": ""
+  },
   "systemRequirementsDialogButton": {
     "source": "Continue anyway",
     "translation": "Trotzdem wiiterfahre"

package/dist/runtime/editor/translations/it.json

@@ -1636,7 +1636,7 @@
     "translation": ""
   },
   "edit": {
-    "source": "Edit",
+    "source": "Edit...",
     "translation": "Modifica"
   },
   "editDisabledByDefinition": {
@@ -2199,6 +2199,14 @@
     "source": "Structure",
     "translation": "Struttura"
   },
+  "feature_swap_description": {
+    "source": "Provides an action to swap two selected blocks.",
+    "translation": ""
+  },
+  "feature_swap_label": {
+    "source": "Swap",
+    "translation": ""
+  },
   "feature_templates_description": {
     "source": "Add blocks from templates.",
     "translation": ""
@@ -3043,6 +3051,18 @@
     "source": "Shows a structured list of all blocks on the current page. Click on any block to quickly jump to it.",
     "translation": ""
   },
+  "swapButton": {
+    "source": "Swap block positions",
+    "translation": ""
+  },
+  "swapError": {
+    "source": "The blocks could not be swapped.",
+    "translation": ""
+  },
+  "swapNotPossible": {
+    "source": "Block positions cannot be swapped.",
+    "translation": ""
+  },
   "systemRequirementsDialogButton": {
     "source": "Continue anyway",
     "translation": ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blokkli/editor",
-  "version": "2.0.0-alpha.49",
+  "version": "2.0.0-alpha.50",
   "description": "Interactive page building experience for Nuxt",
   "keywords": [
     "cms",
@@ -186,21 +186,21 @@
     "vue-tsc": "^3.1.8"
   },
   "peerDependencies": {
-    "@anthropic-ai/sdk": "^0.71.2",
-    "@lunarisapp/readability": "^1.0.2",
-    "@thedutchcoder/postcss-rem-to-px": "^0.0.2",
+    "@anthropic-ai/sdk": "*",
+    "@lunarisapp/readability": "*",
+    "@thedutchcoder/postcss-rem-to-px": "*",
     "acorn": "^8.0.0",
-    "axe-core": "^4.10.0",
+    "axe-core": "*",
     "esbuild": ">=0.20.0",
-    "magic-string": "^0.30.0",
+    "magic-string": ">=0.30.0",
     "mammoth": "^1.11.0",
     "micromatch": "^4.0.0",
-    "openai": "^4.0.0",
-    "oxc-walker": "^0.5.0",
-    "postcss": "^8.4.0",
-    "postcss-import": "^16.0.0",
-    "postcss-replace": "^2.0.0",
-    "tailwindcss": "^3.4.0",
+    "openai": "*",
+    "oxc-walker": ">=0.5.0",
+    "postcss": "*",
+    "postcss-import": "*",
+    "postcss-replace": "*",
+    "tailwindcss": "*",
     "turndown": "^7.2.2",
     "typescript": "^5.0.0"
   },