@blokkli/editor 2.0.0-alpha.24 → 2.0.0-alpha.25

package/dist/module.json

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

package/dist/module.mjs

@@ -15,7 +15,7 @@ import fs from 'node:fs';
 import { defu, createDefu } from 'defu';
 
 const name = "@blokkli/editor";
-const version = "2.0.0-alpha.24";
+const version = "2.0.0-alpha.25";
 
 function sortObjectKeys(obj) {
   if (Array.isArray(obj)) {
@@ -660,7 +660,7 @@ class ModuleHelper {
       ),
       TYPES_BLOKK_OPTIONS: relative(
         this.paths.blokkliBuildDir,
-        this.resolvers.module.resolve("./runtime/types/blokkOptions.ts")
+        this.resolvers.module.resolve("./runtime/types/blockOptions.ts")
       )
     };
     const pattern = providedOptions.pattern || [];
@@ -1099,6 +1099,10 @@ const analyzeCategoryText$3 = {
 	source: "Text",
 	translation: "Texte"
 };
+const analyzeClickButton$3 = {
+	source: "Click the button above to run the analysis.",
+	translation: "Klicken Sie auf den Button oben um die Analyse auszuführen."
+};
 const analyzeLastRun$3 = {
 	source: "Last run: @time",
 	translation: "Zuletzt ausgeführt: @time"
@@ -1107,14 +1111,18 @@ const analyzeMoreLink$3 = {
 	source: "More",
 	translation: "Mehr"
 };
+const analyzeNotAvailableInStructureView$3 = {
+	source: "Analyze is not available in structure view.",
+	translation: "«Analysieren» ist in der strukturierten Vorschau nicht verfügbar."
+};
+const analyzeResultsOutdated$3 = {
+	source: "Results are outdated. Click the button to update.",
+	translation: "Resultate sind veraltet. Klicken Sie auf den Button um zu aktualisieren."
+};
 const analyzeSidebarTitle$3 = {
 	source: "Analyze",
 	translation: "Analysieren"
 };
-const analyzeStaleMessage$3 = {
-	source: "The contents of the page have changed since last analyzing the page. Please run the analyzers again to get updated results.",
-	translation: "Die Seiteninhalte wurden seit der letzten Analyse geändert. Bitte führen Sie die Analyse erneut aus um aktuelle Resultate zu sehen."
-};
 const analyzeStatusInapplicable$3 = {
 	source: "Inapplicable",
 	translation: "Nicht anwendbar"
@@ -1127,6 +1135,14 @@ const analyzeStatusPass$3 = {
 	source: "Pass",
 	translation: "Bestanden"
 };
+const analyzeStatusStale$3 = {
+	source: "Stale",
+	translation: "Veraltet"
+};
+const analyzeStatusUpToDate$3 = {
+	source: "Up-to-date",
+	translation: "Aktuell"
+};
 const analyzeStatusViolation$3 = {
 	source: "Violation",
 	translation: "Fehler"
@@ -1263,6 +1279,10 @@ const blockAddListTourTitle$3 = {
 	source: "Favorite blocks",
 	translation: "Favoriten-Blöcke"
 };
+const blockNotImplemented$3 = {
+	source: "Missing component for block bundle <strong>@bundle</strong>.",
+	translation: "Keine Komponente für Block-Typ <strong>@bundle</strong> gefunden."
+};
 const blockOption_bkHiddenGlobally_description$3 = {
 	source: "Always hides the block.",
 	translation: "Den Block immer verstecken."
@@ -2691,10 +2711,14 @@ const transformDialogButtonApply$3 = {
 	source: "Apply changes",
 	translation: "Änderungen annehmen"
 };
-const transformDialogButtonPreview$3 = {
+const transformDialogButtonNewSuggestion$3 = {
 	source: "New suggestion",
 	translation: "Neuer Vorschlag"
 };
+const transformDialogButtonPreview$3 = {
+	source: "Preview",
+	translation: "Vorschau"
+};
 const translationsBannerButton$3 = {
 	source: "Edit source language instead",
 	translation: "Originalsprache bearbeiten"
@@ -2788,13 +2812,17 @@ const de = {
 	analyzeCategoryContent: analyzeCategoryContent$3,
 	analyzeCategorySeo: analyzeCategorySeo$3,
 	analyzeCategoryText: analyzeCategoryText$3,
+	analyzeClickButton: analyzeClickButton$3,
 	analyzeLastRun: analyzeLastRun$3,
 	analyzeMoreLink: analyzeMoreLink$3,
+	analyzeNotAvailableInStructureView: analyzeNotAvailableInStructureView$3,
+	analyzeResultsOutdated: analyzeResultsOutdated$3,
 	analyzeSidebarTitle: analyzeSidebarTitle$3,
-	analyzeStaleMessage: analyzeStaleMessage$3,
 	analyzeStatusInapplicable: analyzeStatusInapplicable$3,
 	analyzeStatusIncomplete: analyzeStatusIncomplete$3,
 	analyzeStatusPass: analyzeStatusPass$3,
+	analyzeStatusStale: analyzeStatusStale$3,
+	analyzeStatusUpToDate: analyzeStatusUpToDate$3,
 	analyzeStatusViolation: analyzeStatusViolation$3,
 	analyzeTourText: analyzeTourText$3,
 	analyzerReadabiliyAverageSentenceLength: analyzerReadabiliyAverageSentenceLength$3,
@@ -2829,6 +2857,7 @@ const de = {
 	assistantPromptPlaceholder: assistantPromptPlaceholder$3,
 	blockAddListTourText: blockAddListTourText$3,
 	blockAddListTourTitle: blockAddListTourTitle$3,
+	blockNotImplemented: blockNotImplemented$3,
 	blockOption_bkHiddenGlobally_description: blockOption_bkHiddenGlobally_description$3,
 	blockOption_bkHiddenGlobally_label: blockOption_bkHiddenGlobally_label$3,
 	blockOption_bkVisibleLanguages_description: blockOption_bkVisibleLanguages_description$3,
@@ -3358,6 +3387,7 @@ const de = {
 	tourPrev: tourPrev$3,
 	tourStartButton: tourStartButton$3,
 	transformDialogButtonApply: transformDialogButtonApply$3,
+	transformDialogButtonNewSuggestion: transformDialogButtonNewSuggestion$3,
 	transformDialogButtonPreview: transformDialogButtonPreview$3,
 	translationsBannerButton: translationsBannerButton$3,
 	translationsBannerText: translationsBannerText$3,
@@ -3456,6 +3486,10 @@ const analyzeCategoryText$2 = {
 	source: "Text",
 	translation: ""
 };
+const analyzeClickButton$2 = {
+	source: "Click the button above to run the analysis.",
+	translation: ""
+};
 const analyzeLastRun$2 = {
 	source: "Last run: @time",
 	translation: ""
@@ -3464,12 +3498,16 @@ const analyzeMoreLink$2 = {
 	source: "More",
 	translation: ""
 };
-const analyzeSidebarTitle$2 = {
-	source: "Analyze",
+const analyzeNotAvailableInStructureView$2 = {
+	source: "Analyze is not available in structure view.",
 	translation: ""
 };
-const analyzeStaleMessage$2 = {
-	source: "The contents of the page have changed since last analyzing the page. Please run the analyzers again to get updated results.",
+const analyzeResultsOutdated$2 = {
+	source: "Results are outdated. Click the button to update.",
+	translation: ""
+};
+const analyzeSidebarTitle$2 = {
+	source: "Analyze",
 	translation: ""
 };
 const analyzeStatusInapplicable$2 = {
@@ -3484,6 +3522,14 @@ const analyzeStatusPass$2 = {
 	source: "Pass",
 	translation: ""
 };
+const analyzeStatusStale$2 = {
+	source: "Stale",
+	translation: ""
+};
+const analyzeStatusUpToDate$2 = {
+	source: "Up-to-date",
+	translation: ""
+};
 const analyzeStatusViolation$2 = {
 	source: "Violation",
 	translation: ""
@@ -3620,6 +3666,10 @@ const blockAddListTourTitle$2 = {
 	source: "Favorite blocks",
 	translation: ""
 };
+const blockNotImplemented$2 = {
+	source: "Missing component for block bundle <strong>@bundle</strong>.",
+	translation: ""
+};
 const blockOption_bkHiddenGlobally_description$2 = {
 	source: "Always hides the block.",
 	translation: ""
@@ -5048,10 +5098,14 @@ const transformDialogButtonApply$2 = {
 	source: "Apply changes",
 	translation: ""
 };
-const transformDialogButtonPreview$2 = {
+const transformDialogButtonNewSuggestion$2 = {
 	source: "New suggestion",
 	translation: ""
 };
+const transformDialogButtonPreview$2 = {
+	source: "Preview",
+	translation: ""
+};
 const translationsBannerButton$2 = {
 	source: "Edit source language instead",
 	translation: ""
@@ -5145,13 +5199,17 @@ const fr = {
 	analyzeCategoryContent: analyzeCategoryContent$2,
 	analyzeCategorySeo: analyzeCategorySeo$2,
 	analyzeCategoryText: analyzeCategoryText$2,
+	analyzeClickButton: analyzeClickButton$2,
 	analyzeLastRun: analyzeLastRun$2,
 	analyzeMoreLink: analyzeMoreLink$2,
+	analyzeNotAvailableInStructureView: analyzeNotAvailableInStructureView$2,
+	analyzeResultsOutdated: analyzeResultsOutdated$2,
 	analyzeSidebarTitle: analyzeSidebarTitle$2,
-	analyzeStaleMessage: analyzeStaleMessage$2,
 	analyzeStatusInapplicable: analyzeStatusInapplicable$2,
 	analyzeStatusIncomplete: analyzeStatusIncomplete$2,
 	analyzeStatusPass: analyzeStatusPass$2,
+	analyzeStatusStale: analyzeStatusStale$2,
+	analyzeStatusUpToDate: analyzeStatusUpToDate$2,
 	analyzeStatusViolation: analyzeStatusViolation$2,
 	analyzeTourText: analyzeTourText$2,
 	analyzerReadabiliyAverageSentenceLength: analyzerReadabiliyAverageSentenceLength$2,
@@ -5186,6 +5244,7 @@ const fr = {
 	assistantPromptPlaceholder: assistantPromptPlaceholder$2,
 	blockAddListTourText: blockAddListTourText$2,
 	blockAddListTourTitle: blockAddListTourTitle$2,
+	blockNotImplemented: blockNotImplemented$2,
 	blockOption_bkHiddenGlobally_description: blockOption_bkHiddenGlobally_description$2,
 	blockOption_bkHiddenGlobally_label: blockOption_bkHiddenGlobally_label$2,
 	blockOption_bkVisibleLanguages_description: blockOption_bkVisibleLanguages_description$2,
@@ -5715,6 +5774,7 @@ const fr = {
 	tourPrev: tourPrev$2,
 	tourStartButton: tourStartButton$2,
 	transformDialogButtonApply: transformDialogButtonApply$2,
+	transformDialogButtonNewSuggestion: transformDialogButtonNewSuggestion$2,
 	transformDialogButtonPreview: transformDialogButtonPreview$2,
 	translationsBannerButton: translationsBannerButton$2,
 	translationsBannerText: translationsBannerText$2,
@@ -5813,6 +5873,10 @@ const analyzeCategoryText$1 = {
 	source: "Text",
 	translation: ""
 };
+const analyzeClickButton$1 = {
+	source: "Click the button above to run the analysis.",
+	translation: ""
+};
 const analyzeLastRun$1 = {
 	source: "Last run: @time",
 	translation: ""
@@ -5821,12 +5885,16 @@ const analyzeMoreLink$1 = {
 	source: "More",
 	translation: ""
 };
-const analyzeSidebarTitle$1 = {
-	source: "Analyze",
+const analyzeNotAvailableInStructureView$1 = {
+	source: "Analyze is not available in structure view.",
 	translation: ""
 };
-const analyzeStaleMessage$1 = {
-	source: "The contents of the page have changed since last analyzing the page. Please run the analyzers again to get updated results.",
+const analyzeResultsOutdated$1 = {
+	source: "Results are outdated. Click the button to update.",
+	translation: ""
+};
+const analyzeSidebarTitle$1 = {
+	source: "Analyze",
 	translation: ""
 };
 const analyzeStatusInapplicable$1 = {
@@ -5841,6 +5909,14 @@ const analyzeStatusPass$1 = {
 	source: "Pass",
 	translation: ""
 };
+const analyzeStatusStale$1 = {
+	source: "Stale",
+	translation: ""
+};
+const analyzeStatusUpToDate$1 = {
+	source: "Up-to-date",
+	translation: ""
+};
 const analyzeStatusViolation$1 = {
 	source: "Violation",
 	translation: ""
@@ -5977,6 +6053,10 @@ const blockAddListTourTitle$1 = {
 	source: "Favorite blocks",
 	translation: ""
 };
+const blockNotImplemented$1 = {
+	source: "Missing component for block bundle <strong>@bundle</strong>.",
+	translation: ""
+};
 const blockOption_bkHiddenGlobally_description$1 = {
 	source: "Always hides the block.",
 	translation: ""
@@ -7405,10 +7485,14 @@ const transformDialogButtonApply$1 = {
 	source: "Apply changes",
 	translation: ""
 };
-const transformDialogButtonPreview$1 = {
+const transformDialogButtonNewSuggestion$1 = {
 	source: "New suggestion",
 	translation: ""
 };
+const transformDialogButtonPreview$1 = {
+	source: "Preview",
+	translation: ""
+};
 const translationsBannerButton$1 = {
 	source: "Edit source language instead",
 	translation: ""
@@ -7502,13 +7586,17 @@ const it = {
 	analyzeCategoryContent: analyzeCategoryContent$1,
 	analyzeCategorySeo: analyzeCategorySeo$1,
 	analyzeCategoryText: analyzeCategoryText$1,
+	analyzeClickButton: analyzeClickButton$1,
 	analyzeLastRun: analyzeLastRun$1,
 	analyzeMoreLink: analyzeMoreLink$1,
+	analyzeNotAvailableInStructureView: analyzeNotAvailableInStructureView$1,
+	analyzeResultsOutdated: analyzeResultsOutdated$1,
 	analyzeSidebarTitle: analyzeSidebarTitle$1,
-	analyzeStaleMessage: analyzeStaleMessage$1,
 	analyzeStatusInapplicable: analyzeStatusInapplicable$1,
 	analyzeStatusIncomplete: analyzeStatusIncomplete$1,
 	analyzeStatusPass: analyzeStatusPass$1,
+	analyzeStatusStale: analyzeStatusStale$1,
+	analyzeStatusUpToDate: analyzeStatusUpToDate$1,
 	analyzeStatusViolation: analyzeStatusViolation$1,
 	analyzeTourText: analyzeTourText$1,
 	analyzerReadabiliyAverageSentenceLength: analyzerReadabiliyAverageSentenceLength$1,
@@ -7543,6 +7631,7 @@ const it = {
 	assistantPromptPlaceholder: assistantPromptPlaceholder$1,
 	blockAddListTourText: blockAddListTourText$1,
 	blockAddListTourTitle: blockAddListTourTitle$1,
+	blockNotImplemented: blockNotImplemented$1,
 	blockOption_bkHiddenGlobally_description: blockOption_bkHiddenGlobally_description$1,
 	blockOption_bkHiddenGlobally_label: blockOption_bkHiddenGlobally_label$1,
 	blockOption_bkVisibleLanguages_description: blockOption_bkVisibleLanguages_description$1,
@@ -8072,6 +8161,7 @@ const it = {
 	tourPrev: tourPrev$1,
 	tourStartButton: tourStartButton$1,
 	transformDialogButtonApply: transformDialogButtonApply$1,
+	transformDialogButtonNewSuggestion: transformDialogButtonNewSuggestion$1,
 	transformDialogButtonPreview: transformDialogButtonPreview$1,
 	translationsBannerButton: translationsBannerButton$1,
 	translationsBannerText: translationsBannerText$1,
@@ -8170,6 +8260,10 @@ const analyzeCategoryText = {
 	source: "Text",
 	translation: "Teggscht"
 };
+const analyzeClickButton = {
+	source: "Click the button above to run the analysis.",
+	translation: ""
+};
 const analyzeLastRun = {
 	source: "Last run: @time",
 	translation: "Zletscht usgfüehrt: @time"
@@ -8178,14 +8272,18 @@ const analyzeMoreLink = {
 	source: "More",
 	translation: "Meh"
 };
+const analyzeNotAvailableInStructureView = {
+	source: "Analyze is not available in structure view.",
+	translation: ""
+};
+const analyzeResultsOutdated = {
+	source: "Results are outdated. Click the button to update.",
+	translation: ""
+};
 const analyzeSidebarTitle = {
 	source: "Analyze",
 	translation: "Analysiere"
 };
-const analyzeStaleMessage = {
-	source: "The contents of the page have changed since last analyzing the page. Please run the analyzers again to get updated results.",
-	translation: "Dr Inhalt vo dr Sitte het sich gänderet sit dr letschte Analyse. Bitte füehr d'Analyse nomol uus zum aktualisierti Resultät z'übercho."
-};
 const analyzeStatusInapplicable = {
 	source: "Inapplicable",
 	translation: "Nid zuetreffe"
@@ -8198,6 +8296,14 @@ const analyzeStatusPass = {
 	source: "Pass",
 	translation: "I Ornig"
 };
+const analyzeStatusStale = {
+	source: "Stale",
+	translation: ""
+};
+const analyzeStatusUpToDate = {
+	source: "Up-to-date",
+	translation: ""
+};
 const analyzeStatusViolation = {
 	source: "Violation",
 	translation: "Verstoss"
@@ -8334,6 +8440,10 @@ const blockAddListTourTitle = {
 	source: "Favorite blocks",
 	translation: "Lieblingsblöck"
 };
+const blockNotImplemented = {
+	source: "Missing component for block bundle <strong>@bundle</strong>.",
+	translation: ""
+};
 const blockOption_bkHiddenGlobally_description = {
 	source: "Always hides the block.",
 	translation: ""
@@ -9762,8 +9872,12 @@ const transformDialogButtonApply = {
 	source: "Apply changes",
 	translation: "Aawände"
 };
-const transformDialogButtonPreview = {
+const transformDialogButtonNewSuggestion = {
 	source: "New suggestion",
+	translation: ""
+};
+const transformDialogButtonPreview = {
+	source: "Preview",
 	translation: "Vorschau"
 };
 const translationsBannerButton = {
@@ -9859,13 +9973,17 @@ const gsw_CH = {
 	analyzeCategoryContent: analyzeCategoryContent,
 	analyzeCategorySeo: analyzeCategorySeo,
 	analyzeCategoryText: analyzeCategoryText,
+	analyzeClickButton: analyzeClickButton,
 	analyzeLastRun: analyzeLastRun,
 	analyzeMoreLink: analyzeMoreLink,
+	analyzeNotAvailableInStructureView: analyzeNotAvailableInStructureView,
+	analyzeResultsOutdated: analyzeResultsOutdated,
 	analyzeSidebarTitle: analyzeSidebarTitle,
-	analyzeStaleMessage: analyzeStaleMessage,
 	analyzeStatusInapplicable: analyzeStatusInapplicable,
 	analyzeStatusIncomplete: analyzeStatusIncomplete,
 	analyzeStatusPass: analyzeStatusPass,
+	analyzeStatusStale: analyzeStatusStale,
+	analyzeStatusUpToDate: analyzeStatusUpToDate,
 	analyzeStatusViolation: analyzeStatusViolation,
 	analyzeTourText: analyzeTourText,
 	analyzerReadabiliyAverageSentenceLength: analyzerReadabiliyAverageSentenceLength,
@@ -9900,6 +10018,7 @@ const gsw_CH = {
 	assistantPromptPlaceholder: assistantPromptPlaceholder,
 	blockAddListTourText: blockAddListTourText,
 	blockAddListTourTitle: blockAddListTourTitle,
+	blockNotImplemented: blockNotImplemented,
 	blockOption_bkHiddenGlobally_description: blockOption_bkHiddenGlobally_description,
 	blockOption_bkHiddenGlobally_label: blockOption_bkHiddenGlobally_label,
 	blockOption_bkVisibleLanguages_description: blockOption_bkVisibleLanguages_description,
@@ -10429,6 +10548,7 @@ const gsw_CH = {
 	tourPrev: tourPrev,
 	tourStartButton: tourStartButton,
 	transformDialogButtonApply: transformDialogButtonApply,
+	transformDialogButtonNewSuggestion: transformDialogButtonNewSuggestion,
 	transformDialogButtonPreview: transformDialogButtonPreview,
 	translationsBannerButton: translationsBannerButton,
 	translationsBannerText: translationsBannerText,
@@ -12053,6 +12173,49 @@ export declare const ${chunkName}: Record<string, { loadComponent: () => Promise
   });
 });
 
+const chunkEditing = defineCodeTemplate(
+  "chunk-editing",
+  (ctx) => {
+    const imports = [];
+    const map = /* @__PURE__ */ new Map();
+    for (const file of ctx.blocks.files.values()) {
+      if (!file.definition) {
+        continue;
+      }
+      if (file.type === "provider") {
+        continue;
+      }
+      if (!fs.existsSync(file.filePath)) {
+        continue;
+      }
+      imports.push(`import ${file.identifier} from '${file.filePath}'`);
+      file.variations.forEach((variation) => {
+        map.set(variation, file.identifier);
+      });
+    }
+    return `
+${imports.sort().join("\n")}
+
+${toObject("allComponents", map)}
+`;
+  },
+  () => {
+    return `
+import type { Component } from 'vue'
+
+/**
+ * A map of block import identifier and block component.
+ *
+ * This should ONLY be imported in editor code, since it imports ALL block components.
+ */
+export declare const allComponents: Record<string, Component>
+`;
+  },
+  {
+    dependencies: ["block-path", "block-content"]
+  }
+);
+
 const TEMPLATES = [
   icons,
   features,
@@ -12069,7 +12232,8 @@ const TEMPLATES = [
   defaultGlobalOptions,
   imports,
   optionsSchema,
-  chunkGroup
+  chunkGroup,
+  chunkEditing
 ];
 
 class CollectedFeatureFile extends CollectedFile {

package/dist/runtime/blokkliPlugins/BlockIndicator/index.vue.d.ts

@@ -1,17 +1,55 @@
 import type { BlokkliIcon } from '#blokkli-build/icons';
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<{
+    /**
+     * Unique identifier for this indicator.
+     *
+     * Should be unique per block instance.
+     */
     id: string;
+    /**
+     * The UUID of the block this indicator is attached to.
+     */
     uuid: string;
+    /**
+     * Optional text label to display in the indicator.
+     */
     label?: string;
+    /**
+     * Which side of the block to display the indicator.
+     *
+     * @default 'left'
+     */
     position?: "left" | "right";
+    /**
+     * Optional icon to display in the indicator.
+     */
     icon?: BlokkliIcon;
 }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     click: () => any;
 }, string, import("vue").PublicProps, Readonly<{
+    /**
+     * Unique identifier for this indicator.
+     *
+     * Should be unique per block instance.
+     */
     id: string;
+    /**
+     * The UUID of the block this indicator is attached to.
+     */
     uuid: string;
+    /**
+     * Optional text label to display in the indicator.
+     */
     label?: string;
+    /**
+     * Which side of the block to display the indicator.
+     *
+     * @default 'left'
+     */
     position?: "left" | "right";
+    /**
+     * Optional icon to display in the indicator.
+     */
     icon?: BlokkliIcon;
 }> & Readonly<{
     onClick?: (() => any) | undefined;

package/dist/runtime/blokkliPlugins/ContextMenu/index.vue.d.ts

@@ -1,7 +1,22 @@
 import type { ContextMenu } from '#blokkli/types';
 type __VLS_Props = {
+    /**
+     * Unique identifier for this context menu.
+     *
+     * Used to track which menu is currently open.
+     */
     id: string;
+    /**
+     * Array of menu items to display.
+     *
+     * Each item can have nested sub-menus.
+     */
     menu: ContextMenu[];
+    /**
+     * The HTML tag to use for the wrapper element.
+     *
+     * @default 'div'
+     */
     tag?: string;
 };
 declare var __VLS_10: {};

package/dist/runtime/blokkliPlugins/DebugOverlay/index.vue.d.ts

@@ -1,5 +1,11 @@
 type __VLS_Props = {
+    /**
+     * Unique identifier for this debug overlay.
+     */
     id: string;
+    /**
+     * The title displayed in the debug overlay selector.
+     */
     title: string;
 };
 declare var __VLS_5: {};

package/dist/runtime/blokkliPlugins/ItemAction/index.vue.d.ts

@@ -1,9 +1,14 @@
 import type { BlokkliIcon } from '#blokkli-build/icons';
 import type { RenderedFieldListItem } from '#blokkli/types';
 type __VLS_Props = {
+    /**
+     * Unique identifier for this item action.
+     */
     id: string;
     /**
      * The title of the action.
+     *
+     * Displayed in the tooltip and keyboard shortcut hints.
      */
     title: string;
     /**
@@ -11,30 +16,50 @@ type __VLS_Props = {
      */
     disabled?: boolean;
     /**
-     * Whether the button should be displayed in an active state (e.g. when it's a dropdown).
+     * Whether the button should be displayed in an active state.
+     *
+     * Useful when the action opens a dropdown or dialog.
      */
     active?: boolean;
     /**
-     * The key code to use for the shortcut.
+     * The key code to use for the keyboard shortcut.
+     *
+     * @example 'c' for the "c" key
      */
     keyCode?: string;
     /**
-     * Wheter the shortcut needs the meta modifier key.
+     * Whether the shortcut needs the meta modifier key.
+     *
+     * On Mac this is Cmd, on Windows/Linux this is Ctrl.
      */
     meta?: boolean;
     /**
      * Whether the action supports multiple items.
+     *
+     * If false, the action is disabled when more than one item is selected.
      */
     multiple?: boolean;
     /**
      * Whether the action is only available in edit mode.
+     *
+     * If true, the action is hidden in preview mode.
      */
     editOnly?: boolean;
     /**
      * The weight, used for positioning the button.
+     *
+     * Lower weights appear first. Use 'last' to always position at the end.
      */
     weight?: number | string | 'last';
+    /**
+     * Optional icon to display in the button.
+     */
     icon?: BlokkliIcon;
+    /**
+     * Optional text for the interactive tour.
+     *
+     * If provided, this action will be included in the editor tour.
+     */
     tourText?: string;
 };
 declare var __VLS_5: {}, __VLS_19: {