@blokkli/editor 2.0.0-alpha.46 → 2.0.0-alpha.47

package/dist/runtime/editor/features/hover/Renderer/vertex.glsl

@@ -31,6 +31,7 @@ uniform vec3 u_color_accent;
 uniform vec3 u_color_teal;
 uniform vec3 u_color_white;
 uniform vec3 u_color_lime;
+uniform vec3 u_color_yellow;
 
 // The transformed quad for the fragment shader.
 out vec4 v_quad;
@@ -140,8 +141,10 @@ void main() {
   v_dash_cycle = 14.0 - u_scale * 1.0;
   v_rect_size_artboard = vec2(hoverPos.z, hoverPos.w);
 
-  // Select color based on type: 0 = mono, 1 = accent, 2 = teal, 3 = white (inverted), 4 = lime (library)
-  if (hoverType > 3.5) {
+  // Select color based on type: 0 = mono, 1 = accent, 2 = teal, 3 = white (inverted), 4 = lime (library), 5 = yellow (restricted)
+  if (hoverType > 4.5) {
+    v_color = u_color_yellow;
+  } else if (hoverType > 3.5) {
     v_color = u_color_lime;
   } else if (hoverType > 2.5) {
     v_color = u_color_white;

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

@@ -3,6 +3,7 @@
     v-if="isReusable"
     id="library_detach"
     :title="$t('libraryDetach', 'Detach from library')"
+    :disabled="detachDisabledReason"
     icon="reusable-detach"
     edit-only
     multiple
@@ -13,7 +14,7 @@
     v-else-if="!isReusable"
     id="library_make_reusable"
     :title="$t('libraryAdd', 'Add to library...')"
-    :disabled="!canMakeReusable"
+    :disabled="makeReusableDisabledReason"
     edit-only
     icon="reusable"
     :weight="-70"
@@ -82,6 +83,12 @@ const showReusableDialog = useDialog("library-reusable", "center");
 const userCanCreateLibraryItem = computed(
   () => permissions.hasPermission("create_library_item")
 );
+const canAddFromLibrary = computed(
+  () => permissions.checkBlockBundlePermission(fromLibraryBlockBundle, "add")
+);
+const canEditFromLibrary = computed(
+  () => permissions.checkBlockBundlePermission(fromLibraryBlockBundle, "edit")
+);
 async function selectNewlyAdded(cb) {
   const uuidsBefore = state.getAllUuids();
   await cb();
@@ -93,7 +100,7 @@ async function selectNewlyAdded(cb) {
   eventBus.emit("select", newUuid);
 }
 const onDetach = async () => {
-  if (!adapter.detachReusableBlock || !selection.uuids.value.length) {
+  if (!adapter.detachReusableBlock || !selection.uuids.value.length || detachDisabledReason.value) {
     return;
   }
   await selectNewlyAdded(
@@ -106,7 +113,7 @@ const onDetach = async () => {
 };
 const placedAction = ref(null);
 const onAddLibraryItem = async (uuid) => {
-  if (!placedAction.value || !adapter.addLibraryItem) {
+  if (!placedAction.value || !adapter.addLibraryItem || !canAddFromLibrary.value) {
     return;
   }
   await state.mutateWithLoadingState(
@@ -166,9 +173,46 @@ const fromLibraryAllowedInList = computed(() => {
   }
   return types.allowedTypesInList.value.includes(fromLibraryBlockBundle);
 });
-const canMakeReusable = computed(
-  () => !isReusable.value && itemBundle?.value?.allowReusable && fromLibraryAllowedInList.value && userCanCreateLibraryItem.value
-);
+const detachDisabledReason = computed(() => {
+  if (!canEditFromLibrary.value) {
+    return $t(
+      "libraryDetachNoPermission",
+      "You do not have permission to detach this block."
+    );
+  }
+  return false;
+});
+const makeReusableDisabledReason = computed(() => {
+  if (isReusable.value) {
+    return false;
+  }
+  if (!userCanCreateLibraryItem.value) {
+    return $t(
+      "libraryAddNoPermission",
+      "You do not have permission to create library items."
+    );
+  }
+  const item = selection.item.value;
+  if (item && !permissions.checkBlockBundlePermission(item.bundle, "edit")) {
+    return $t(
+      "libraryAddNoEditPermission",
+      "You do not have permission to edit this block."
+    );
+  }
+  if (!itemBundle?.value?.allowReusable) {
+    return $t(
+      "libraryAddNotSupported",
+      "This block type cannot be made reusable."
+    );
+  }
+  if (!fromLibraryAllowedInList.value) {
+    return $t(
+      "libraryAddNotAllowedInField",
+      "Reusable blocks are not allowed in this field."
+    );
+  }
+  return false;
+});
 const editingLibraryItem = ref(null);
 onBlokkliEvent("library:edit-item", function(e) {
   editingLibraryItem.value = {
@@ -186,7 +230,7 @@ function onSubmitLibraryItem() {
 }
 defineDropHandler("reusable", {
   async execute({ items, host, afterUuid }) {
-    if (adapter.addLibraryItem) {
+    if (adapter.addLibraryItem && canAddFromLibrary.value) {
       await state.mutateWithLoadingState(
         () => adapter.addLibraryItem({
           libraryItemUuid: items[0].libraryItemUuid,
@@ -198,7 +242,7 @@ defineDropHandler("reusable", {
   }
 });
 defineAddAction(() => {
-  if (!adapter.addLibraryItem || !adapter.getLibraryItems || !isSupportedOnEntity.value) {
+  if (!adapter.addLibraryItem || !adapter.getLibraryItems || !isSupportedOnEntity.value || !canAddFromLibrary.value) {
     return;
   }
   return {

package/dist/runtime/editor/features/media-library/index.vue

@@ -30,7 +30,7 @@ defineBlokkliFeature({
   description: "Implements a media library to easily drag and drop media like images or videos.",
   requiredAdapterMethods: ["mediaLibraryGetResults", "mediaLibraryAddBlock"]
 });
-const { $t, adapter, state, types, directive } = useBlokkli();
+const { $t, adapter, state, types, directive, permissions } = useBlokkli();
 const ERROR_MESSAGE = $t(
   "mediaLibraryReplaceFailed",
   "Failed to replace media."
@@ -55,6 +55,9 @@ defineDropAreas((dragItems) => {
       return;
     }
     const isBlock = field.type === itemEntityType;
+    if (isBlock && (!permissions.checkBlockBundlePermission(field.bundle, "edit") || permissions.blockHasRestrictedAncestor(field.uuid))) {
+      return;
+    }
     const draggableHost = {
       uuid: field.uuid,
       type: field.type,
@@ -106,7 +109,9 @@ defineDropHandler("media_library", {
       return [];
     }
     const item = items[0];
-    return field.allowedBundles.filter((b) => item.itemBundles.includes(b));
+    return field.allowedBundles.filter(
+      (b) => item.itemBundles.includes(b) && permissions.checkBlockBundlePermission(b, "add")
+    );
   },
   async execute({ items, host, afterUuid, bundle }) {
     if (adapter.mediaLibraryAddBlock && items.length === 1) {

package/dist/runtime/editor/features/multi-select/Renderer/index.vue

@@ -15,7 +15,7 @@ import {
 } from "twgl.js";
 import { RectangleBufferCollector } from "#blokkli/editor/helpers/webgl";
 import { defineRenderer, useDebugLogger } from "#blokkli/editor/composables";
-const { eventBus, dom, theme, animation, ui, blocks } = useBlokkli();
+const { eventBus, dom, theme, animation, ui, blocks, permissions } = useBlokkli();
 const logger = useDebugLogger();
 const props = defineProps({
   startX: { type: Number, required: true },
@@ -43,6 +43,9 @@ class MultiSelectRectangleBufferCollector extends RectangleBufferCollector {
       if (!block) {
         continue;
       }
+      if (permissions.blockHasRestrictedAncestor(uuid)) {
+        continue;
+      }
       const el = dom.getDragElement(block);
       if (!el) {
         continue;

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

@@ -58,7 +58,7 @@ defineBlokkliFeature({
   label: "Search",
   description: "Provides an overlay with shortcut to search for blocks on the current page or existing content to add as blocks."
 });
-const { $t, selection, ui, adapter, state, types, directive } = useBlokkli();
+const { $t, selection, ui, adapter, state, types, directive, permissions } = useBlokkli();
 const ERROR_MESSAGE = $t(
   "searchContentReplaceFailed",
   "Failed to replace content."
@@ -79,6 +79,9 @@ defineDropAreas((dragItems) => {
     if (field.type !== itemEntityType) {
       return;
     }
+    if (!permissions.checkBlockBundlePermission(field.bundle, "edit") || permissions.blockHasRestrictedAncestor(field.uuid)) {
+      return;
+    }
     const config = types.getDroppableFieldConfig(field.fieldName, field);
     const allowedBundles = config.allowed.find(
       (v) => v.type === searchItem.entityType
@@ -115,7 +118,9 @@ defineDropAreas((dragItems) => {
 defineDropHandler("search_content", {
   resolveBundles({ items, field }) {
     const item = items[0];
-    return field.allowedBundles.filter((b) => item.itemBundles.includes(b));
+    return field.allowedBundles.filter(
+      (b) => item.itemBundles.includes(b) && permissions.checkBlockBundlePermission(b, "add")
+    );
   },
   async execute({ items, host, afterUuid, bundle }) {
     if (!adapter.addContentSearchItem) {

package/dist/runtime/editor/features/selection/AddButtons/Renderer/index.vue

@@ -52,7 +52,7 @@ const currentUuid = ref("");
 const currentBundleLabel = ref("");
 const currentSingleAllowedBundleLabel = ref(null);
 const tooltipData = computed(() => {
-  if (hoveredCircle.value < 0) {
+  if (hoveredCircle.value < 0 || ui.openTooltip.value) {
     return null;
   }
   const index = hoveredCircle.value;

package/dist/runtime/editor/features/selection/AddButtons/index.vue

@@ -8,9 +8,11 @@
         :anchor-el="addData.anchorEl"
         :anchor-coordinates="addData.anchorCoordinates"
         :label="addData.label"
+        :field="addData.field"
         @select="onSelectBundle"
         @close="closeOverlay"
         @action="onSelectAction"
+        @fragment="onSelectFragment"
       />
     </BlokkliTransition>
   </Teleport>
@@ -59,7 +61,9 @@ const {
   fields,
   animation,
   context,
-  selection
+  selection,
+  permissions,
+  adapter
 } = useBlokkli();
 const isLocked = ref(false);
 const shouldRender = computed(() => {
@@ -258,6 +262,21 @@ function onSelectAction(action) {
   });
   closeOverlay();
 }
+async function onSelectFragment(name) {
+  const fragmentsAddBlock = adapter.fragmentsAddBlock;
+  if (!addData.value || !fragmentsAddBlock) {
+    return;
+  }
+  const { host, preceedingUuid } = addData.value;
+  closeOverlay();
+  await state.mutateWithLoadingState(
+    () => fragmentsAddBlock({
+      name,
+      host: { ...host },
+      preceedingUuid
+    })
+  );
+}
 const cache = /* @__PURE__ */ new Map();
 function clearAllCache() {
   cache.clear();
@@ -349,7 +368,12 @@ onBlokkliEvent("state:reloaded", () => {
   }
 });
 function setAddData(key, field, label, preceedingUuid, anchorEl, anchorCoordinates) {
-  const allowedBundles = field.allowedBundles;
+  if (field.hostEntityType === itemEntityType && (!permissions.checkBlockBundlePermission(field.hostEntityBundle, "edit") || permissions.blockHasRestrictedAncestor(field.hostEntityUuid))) {
+    return;
+  }
+  const allowedBundles = field.allowedBundles.filter(
+    (v) => permissions.checkBlockBundlePermission(v, "add")
+  );
   if (allowedBundles.length === 0) {
     return;
   }

package/dist/runtime/editor/features/selection/Renderer/index.vue

@@ -22,7 +22,7 @@ const props = defineProps({
   blocks: { type: Array, required: true },
   hasHostSelected: { type: Boolean, required: true }
 });
-const { animation, theme, dom, ui, state } = useBlokkli();
+const { animation, theme, dom, ui, state, permissions } = useBlokkli();
 class SelectionRectangleBufferCollector extends RectangleBufferCollector {
   uuids = [];
   lastCount = 0;
@@ -50,7 +50,8 @@ class SelectionRectangleBufferCollector extends RectangleBufferCollector {
             y: 0,
             radius: [0, 0, 0, 0],
             isInverted: false,
-            isFromLibrary: false
+            isFromLibrary: false,
+            isRestricted: false
           },
           3
           // Type 3 = host selection
@@ -70,8 +71,11 @@ class SelectionRectangleBufferCollector extends RectangleBufferCollector {
         }
         const style = ui.lowPerformanceMode.value ? null : theme.getDraggableStyle(el);
         const isFromLibrary = state.fromLibraryUuids.value.includes(block.uuid);
+        const isRestricted = !permissions.checkBlockBundlePermission(block.bundle, "edit") || !permissions.checkBlockBundlePermission(block.bundle, "delete") || !permissions.checkBlockBundlePermission(block.bundle, "add");
         let type = 0;
-        if (isFromLibrary) {
+        if (isRestricted) {
+          type = 4;
+        } else if (isFromLibrary) {
           type = 2;
         } else if (style?.isInverted) {
           type = 1;
@@ -85,7 +89,8 @@ class SelectionRectangleBufferCollector extends RectangleBufferCollector {
             y: rect.y,
             radius: style?.radius ?? [0, 0, 0, 0],
             isInverted: !!style?.isInverted,
-            isFromLibrary
+            isFromLibrary,
+            isRestricted
           },
           type
         );
@@ -141,6 +146,15 @@ const getColorLibrary = useTransitionedValue(() => {
   }
   return theme.lime.value.normal;
 });
+const getColorRestricted = useTransitionedValue(() => {
+  if (selectionColorOverride.value) {
+    return selectionColorOverride.value;
+  }
+  if (hasTransformingStyle.value) {
+    return theme.orange.value.normal;
+  }
+  return theme.yellow.value.normal;
+});
 const getColorHost = useTransitionedValue(() => {
   return theme.mono.value[700];
 });
@@ -161,6 +175,7 @@ const { collector } = defineRenderer("selection-overlay", {
       u_color_default: toShaderColor(getColorDefault()),
       u_color_inverted: toShaderColor(getColorInverted()),
       u_color_library: toShaderColor(getColorLibrary()),
+      u_color_restricted: toShaderColor(getColorRestricted()),
       u_color_host: toShaderColor(getColorHost()),
       u_artboard_size: [
         ui.artboardSize.value.width,
@@ -187,6 +202,7 @@ const { collector } = defineRenderer("selection-overlay", {
     const colorDefault = rgbaToCss(getColorDefault());
     const colorInverted = rgbaToCss(getColorInverted());
     const colorLibrary = rgbaToCss(getColorLibrary());
+    const colorRestricted = rgbaToCss(getColorRestricted());
     const colorHost = rgbaToCss(getColorHost());
     const smoothstepValue = Math.max(
       0,
@@ -196,7 +212,9 @@ const { collector } = defineRenderer("selection-overlay", {
     for (let i = 0; i < rects.length; i++) {
       const rect = rects[i];
       let strokeColor = colorDefault;
-      if (rect.isFromLibrary) {
+      if (rect.isRestricted) {
+        strokeColor = colorRestricted;
+      } else if (rect.isFromLibrary) {
         strokeColor = colorLibrary;
       } else if (rect.isInverted) {
         strokeColor = colorInverted;

package/dist/runtime/editor/features/selection/Renderer/vertex.glsl

@@ -21,6 +21,7 @@ uniform vec2 u_resolution;
 uniform vec3 u_color_default;
 uniform vec3 u_color_inverted;
 uniform vec3 u_color_library;
+uniform vec3 u_color_restricted;
 uniform vec3 u_color_host;
 
 // The transformed quad for the fragment shader.
@@ -86,9 +87,11 @@ void main() {
 
   v_rect_width = adjusted_quad.x;
 
-  // Set color based on type: 0=default, 1=inverted, 2=library, 3=host
+  // Set color based on type: 0=default, 1=inverted, 2=library, 3=host, 4=restricted
   v_color = u_color_default;
-  if (a_rect_type > 2.5) {
+  if (a_rect_type > 3.5) {
+    v_color = u_color_restricted;
+  } else if (a_rect_type > 2.5) {
     v_color = u_color_host;
   } else if (a_rect_type > 1.5) {
     v_color = u_color_library;

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

@@ -52,7 +52,8 @@ const {
   types,
   state,
   blocks,
-  element
+  element,
+  permissions
 } = useBlokkli();
 const originatesFromTextInput = (e) => e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement;
 const getSelectionOrder = useStateBasedCache(
@@ -223,11 +224,22 @@ function selectInList(prev) {
   }
   const selectionOrder = getSelectionOrder();
   const currentIndex = selectionOrder.indexOf(currentUuid);
+  if (currentIndex === -1) {
+    return;
+  }
   const delta = prev ? -1 : 1;
-  const newIndex = modulo(currentIndex + delta, selectionOrder.length);
-  const newUuid = selectionOrder[newIndex];
-  if (newUuid) {
-    selectBlock(newUuid);
+  const length = selectionOrder.length;
+  for (let step = 1; step < length; step++) {
+    const newIndex = modulo(currentIndex + delta * step, length);
+    const candidate = selectionOrder[newIndex];
+    if (!candidate) {
+      continue;
+    }
+    const resolved = permissions.getRestrictedAncestor(candidate) ?? candidate;
+    if (resolved !== currentUuid) {
+      selectBlock(candidate);
+      return;
+    }
   }
 }
 onBlokkliEvent("keyPressed", (e) => {

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

@@ -55,7 +55,7 @@
   <PluginItemAction
     v-if="isTranslating"
     id="translate"
-    :disabled="!canTranslateBlock"
+    :disabled="translateDisabledReason"
     :title="$t('translationsItemAction', 'Translate')"
     icon="bk_mdi_translate"
     :weight="-100"
@@ -117,13 +117,16 @@ const items = computed(() => {
     return null;
   }).filter(falsy);
 });
-const canTranslateBlock = computed(() => {
+const translateDisabledReason = computed(() => {
   const block = selection.item.value;
   if (!block) {
     return false;
   }
   if (block.library?.libraryItemUuid) {
-    return false;
+    return $t(
+      "translateLibraryBlock",
+      "Reusable blocks cannot be translated here."
+    );
   }
   const definition = definitions.getBlockDefinition(
     block.bundle,
@@ -131,16 +134,19 @@ const canTranslateBlock = computed(() => {
     block.parentBlockBundle
   );
   if (definition?.editor?.disableEdit) {
-    return false;
+    return $t(
+      "translateEditDisabled",
+      "Editing is disabled for this block type."
+    );
   }
   const type = types.getBlockBundleDefinition(block.bundle);
-  if (!type) {
-    return false;
-  }
-  if (!type.isTranslatable) {
-    return false;
+  if (!type || !type.isTranslatable) {
+    return $t(
+      "translateNotTranslatable",
+      "This block type is not translatable."
+    );
   }
-  return true;
+  return false;
 });
 function onClick(item, event) {
   if (item.translation?.exists) {
@@ -161,7 +167,7 @@ function onTranslate(items2) {
   }
 }
 onBlokkliEvent("item:doubleClick", function(block) {
-  if (isTranslating.value && canTranslateBlock.value) {
+  if (isTranslating.value && !translateDisabledReason.value) {
     onTranslate([block]);
   }
 });

package/dist/runtime/editor/helpers/dropTargets/index.d.ts

@@ -3,4 +3,4 @@ export type Orientation = 'horizontal' | 'vertical';
 export declare const MIN_GAP = 20;
 export declare function getGapSize(orientation: Orientation, element: HTMLElement): number;
 export declare function getChildrenOrientation(element: HTMLElement): Orientation;
-export declare function determineCanAddChildren(field: BlokkliFieldElement, children: HTMLElement[], uuids: string[], currentCount: number, itemsToAdd: number, draggingBundles?: string[], draggingFragments?: string[]): boolean;
+export declare function determineCanAddChildren(field: BlokkliFieldElement, children: HTMLElement[], uuids: string[], currentCount: number, itemsToAdd: number, draggingBundles?: string[], draggingFragments?: string[], isBundlePermitted?: (bundle: string) => boolean): boolean;

package/dist/runtime/editor/helpers/dropTargets/index.js

@@ -31,7 +31,7 @@ export function getChildrenOrientation(element) {
   }
   return "vertical";
 }
-export function determineCanAddChildren(field, children, uuids, currentCount, itemsToAdd, draggingBundles, draggingFragments) {
+export function determineCanAddChildren(field, children, uuids, currentCount, itemsToAdd, draggingBundles, draggingFragments, isBundlePermitted) {
   if (field.cardinality !== -1) {
     const childrenThatAreSelection = children.filter((child) => {
       const uuid = child.dataset.bkUuid;
@@ -50,7 +50,7 @@ export function determineCanAddChildren(field, children, uuids, currentCount, it
   }
   if (!uuids.length) {
     return draggingBundles.some(
-      (bundle) => field.allowedBundles.includes(bundle)
+      (bundle) => field.allowedBundles.includes(bundle) && (!isBundlePermitted || isBundlePermitted(bundle))
     );
   }
   const bundlesAllowed = draggingBundles.every(

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

@@ -12,8 +12,11 @@ type __VLS_Props = {
     title: string;
     /**
      * Whether the action is disabled.
+     *
+     * When a string is provided, the button is disabled and the string is
+     * displayed as the tooltip text explaining why.
      */
-    disabled?: boolean;
+    disabled?: boolean | string;
     /**
      * Whether the button should be displayed in an active state.
      *

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

@@ -25,6 +25,9 @@
           group="blocks"
           @pressed="onClick"
         />
+        <div v-if="disabledReason" class="bk-item-action-disabled-reason">
+          <span>{{ disabledReason }}</span>
+        </div>
       </div>
     </button>
   </Teleport>
@@ -41,7 +44,7 @@ const uuids = computed(() => selection.uuids.value);
 const props = defineProps({
   id: { type: String, required: true },
   title: { type: String, required: true },
-  disabled: { type: Boolean, required: false },
+  disabled: { type: [Boolean, String], required: false },
   active: { type: Boolean, required: false },
   keyCode: { type: String, required: false },
   meta: { type: Boolean, required: false },
@@ -52,7 +55,10 @@ const props = defineProps({
   tourText: { type: String, required: false }
 });
 const isDisabled = computed(
-  () => props.disabled || !props.multiple && selection.items.value.length > 1
+  () => !!props.disabled || !props.multiple && selection.items.value.length > 1
+);
+const disabledReason = computed(
+  () => typeof props.disabled === "string" ? props.disabled : null
 );
 const shouldRender = computed(() => {
   if (props.editOnly) {
@@ -72,7 +78,7 @@ defineCommands(() => ({
   group: "selection",
   label: props.title,
   icon: props.icon,
-  disabled: props.disabled || !selection.items.value.length,
+  disabled: isDisabled.value || !selection.items.value.length,
   callback: onClick
 }));
 defineTourItem(() => {

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

@@ -12,8 +12,11 @@ type __VLS_Props = {
     title: string;
     /**
      * Whether the action is disabled.
+     *
+     * When a string is provided, the button is disabled and the string is
+     * displayed as the tooltip text explaining why.
      */
-    disabled?: boolean;
+    disabled?: boolean | string;
     /**
      * Whether the button should be displayed in an active state.
      *

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

@@ -1,6 +1,27 @@
 import type { BlokkliAdapter } from '#blokkli/editor/adapter';
+import type { BlockPermission } from '../types/definitions.js';
 import type { UserPermissions } from '../types/permissions.js';
+import type { BlocksProvider } from './blocks.js';
 export type PermissionsProvider = {
     hasPermission: (permission: UserPermissions) => boolean;
+    checkBlockBundlePermission: (bundle: string, operation: BlockPermission) => boolean;
+    filterDeniedBundles: (bundles: string[], operation: BlockPermission) => string[];
+    /**
+     * Check if a block has any ancestor whose bundle lacks 'edit' permission.
+     *
+     * When an ancestor is restricted, all descendants are considered restricted
+     * too — the user cannot add, edit, or delete blocks inside a restricted
+     * parent.
+     */
+    blockHasRestrictedAncestor: (uuid: string) => boolean;
+    /**
+     * Get the nearest ancestor block that restricts editing.
+     *
+     * Walks up the parent chain and returns the UUID of the first ancestor
+     * whose bundle lacks 'edit' permission, or undefined if no ancestor is
+     * restricted.
+     */
+    getRestrictedAncestor: (uuid: string) => string | undefined;
+    getBlockBundlePermissions: (bundle: string) => BlockPermission[];
 };
-export default function (adapter: BlokkliAdapter<any>): Promise<PermissionsProvider>;
+export default function (adapter: BlokkliAdapter<any>, blocks: BlocksProvider): Promise<PermissionsProvider>;