@blokkli/editor 2.0.0-alpha.63 → 2.0.0-alpha.65

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

@@ -3,7 +3,7 @@ import type { BlockDefinition, FragmentDefinition, ProviderDefinition } from '#b
 import type { ValidFieldListTypes, BlockBundleWithNested, ValidProviderTypes } from '#blokkli-build/generated-types';
 import type { DeepReadonly } from 'vue';
 import type { BlockDefinitionOptionsInput } from '../../types/definitions.js';
-import type { RuntimeBlockOptionArray } from '../../../global/types/blockOptions.js';
+import type { DefinitionString, RuntimeBlockOptionArray } from '../../../global/types/blockOptions.js';
 import type { RenderedFieldListItem } from '../types/field.js';
 export type DefinitionProvider = {
     /**
@@ -14,7 +14,7 @@ export type DefinitionProvider = {
      * 2. Parent bundle specific (e.g., bundle__parent:accordion)
      * 3. Default bundle definition
      *
-     * @param bundle - The block bundle name
+     * @param bundleOrBlock - The block bundle name, or a rendered field list item
      * @param fieldListType - The field list type context
      * @param parentBundle - Optional parent block bundle for nested blocks
      * @returns The block definition, or undefined if not found
@@ -95,5 +95,6 @@ export type DefinitionProvider = {
      * Block bundles that can be added automatically without showing the form.
      */
     bundlesWithAutoAdd: ComputedRef<string[]>;
+    resolveDefinitionString: (definitionString: DefinitionString) => string;
 };
-export default function (providerType: ValidProviderTypes): DefinitionProvider;
+export default function (providerType: ValidProviderTypes, interfaceLanguage: ComputedRef<string>): DefinitionProvider;

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

@@ -1,7 +1,8 @@
 import { computed, ref, readonly } from "#imports";
 import definitions from "#blokkli-build/definitions";
 import { OPTIONS } from "#blokkli-build/runtime-options";
-export default function(providerType) {
+import { resolveDefinitionString as resolveDefinitionStringBase } from "../helpers/options/index.js";
+export default function(providerType, interfaceLanguage) {
   const blocks = ref(definitions.blocks);
   const fragments = ref(definitions.fragments);
   const providers = ref(definitions.providers);
@@ -114,6 +115,12 @@ export default function(providerType) {
       return addBehaviour === "no-form" || addBehaviour.startsWith("editable:");
     }).map((v) => v.bundle);
   });
+  function resolveDefinitionString(definitionString) {
+    return resolveDefinitionStringBase(
+      definitionString,
+      interfaceLanguage.value
+    );
+  }
   return {
     getBlockDefinition,
     getFragmentDefinition,
@@ -126,7 +133,8 @@ export default function(providerType) {
     globalOptions: readonly(allGlobalOptions),
     runtimeOptions: readonly(runtimeOptions),
     renderKey: readonly(renderKey),
-    bundlesWithAutoAdd
+    bundlesWithAutoAdd,
+    resolveDefinitionString
   };
 }
 if (import.meta.hot) {

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

@@ -47,6 +47,7 @@ export type ViewOption = {
     keyCode?: string;
     tourText?: string;
     weight?: number;
+    default?: boolean;
 };
 type ViewOptionFunction = PluginAddFunction<ViewOption>;
 type PluginFunctionMap = {

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

@@ -1,5 +1,5 @@
 import { type Ref, type ComputedRef } from 'vue';
-import type { BlokkliAdapter, AdapterContext } from '../adapter/index.js';
+import type { BlokkliAdapter, AdapterContext, MutationResponseLike } from '../adapter/index.js';
 import type { FieldListItem } from '#blokkli/types';
 import { type BlokkliEventBus } from '#blokkli/editor/events';
 import type { TextProvider } from './texts.js';
@@ -78,6 +78,14 @@ export type StateProvider = {
      * -1 indicates no mutations, 0+ indicates active mutation index.
      */
     currentMutationIndex: Readonly<Ref<number>>;
+    /**
+     * Unix timestamp (in seconds) of when the edit state was last changed, or
+     * `null` if there are no changes yet. Updates after every mutation.
+     *
+     * Distinct from `publishOptions.lastChanged`, which is the published entity's
+     * change time.
+     */
+    lastChanged: Readonly<Ref<number | null>>;
     /**
      * Validation violations for the current state.
      *
@@ -108,6 +116,22 @@ export type StateProvider = {
      *   response, or `null`/`undefined` to no-op.
      */
     applyMutationState: (rawState: unknown) => void;
+    /**
+     * Run an adapter mutation with the loading lock, but return the raw response
+     * instead of a boolean and never emit an error toast.
+     *
+     * Like {@link mutateWithLoadingState} it locks the body for the duration of
+     * the call and applies any returned `state`, but it does NOT throw or show a
+     * global error message on failure. The caller receives the full
+     * {@link MutationResponseLike} and is responsible for surfacing violations —
+     * used by the agent tool runner, where the conversation UI already indicates
+     * that a tool errored and a global editor toast would be redundant.
+     *
+     * @param callback - Function that performs the mutation.
+     * @returns The raw mutation response, or `undefined` if no callback was
+     *   provided or it resolved to no response.
+     */
+    applyMutationSilently: (callback: () => Promise<MutationResponseLike<any>> | undefined) => Promise<MutationResponseLike<any> | undefined>;
     /**
      * Current edit mode.
      *

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

@@ -49,6 +49,7 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
   });
   const currentMutationIndex = ref(-1);
   const isLoading = ref(false);
+  const lastChanged = ref(null);
   const entity = ref({
     label: "",
     status: false,
@@ -135,6 +136,7 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
     entity.value.label = context2?.entity?.label;
     entity.value.status = context2?.entity?.status;
     entity.value.bundleLabel = context2?.entity?.bundleLabel || "";
+    lastChanged.value = context2?.lastChanged ?? null;
     updatePublishOptions(mapPublishOptions(context2));
     translation.value.isTranslatable = !!context2?.translationState?.isTranslatable;
     translation.value.translations = context2?.translationState?.translations?.filter(falsy) || [];
@@ -317,6 +319,19 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
     unlockBody();
     return false;
   };
+  const applyMutationSilently = async (callback) => {
+    if (!callback) {
+      return void 0;
+    }
+    lockBody();
+    try {
+      const response = await callback();
+      applyMutationState(response?.state);
+      return response;
+    } finally {
+      unlockBody();
+    }
+  };
   async function loadState() {
     try {
       const state = await adapter.loadState();
@@ -396,8 +411,10 @@ export default async function(eventBus, adapter, context, $t, providerKey, permi
     mutations,
     violations,
     currentMutationIndex,
+    lastChanged: readonly(lastChanged),
     mutateWithLoadingState,
     applyMutationState,
+    applyMutationSilently,
     editMode,
     canEdit,
     isLoading: readonly(isLoading),

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

@@ -585,6 +585,7 @@
   "editableFieldFullscreen": "Vollbild",
   "editableFieldTranslateTooltip": "Den aktuellen Text automatisch übersetzen.",
   "editingDisabled": "Bearbeiten ist für diesen Blocktyp deaktiviert.",
+  "entityTitleLastChanged": "Zuletzt geändert",
   "entityTitleTourText": "<p>Zeigt den Titel und Status der aktuellen Seite an.</p><p>Klicken Sie auf den Titel um das Bearbeitungsformular anzuzeigen.</p>",
   "entityTitleTourTitle": "Seite",
   "errorCapturedMessage": "Fehler in «@label»: @errorMessage",
@@ -783,6 +784,7 @@
   "relatedContent": "Verwandte Inhalte",
   "relatedContentNoEntitiesFound": "Keine verwandten Inhalte gefunden",
   "relatedContentTooltip": "Inhalte wie Seiten oder Bilder, die von diesem Block referenziert oder verlinkt werden.",
+  "relativeTimeJustNow": "gerade eben",
   "remove": "Entfernen",
   "replaceField": "@field ersetzen",
   "reply": "Antworten",

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

@@ -98,6 +98,7 @@
   "duplicate": "Dupliquer",
   "duplicateError": "Les éléments n'ont pas pu être dupliqués.",
   "edit": "Modifier",
+  "entityTitleLastChanged": "Dernière modification",
   "exitDescription": "Fermer l’éditeur sans publier",
   "failedToConvert": "L'élément n'a pas pu être converti.",
   "failedToTransform": "The action \"@name\" could not be executed.",
@@ -150,6 +151,7 @@
   "readabilityTooShort": "Trop court",
   "readabilityTooShortTooltip": "Le texte nécessite au moins @count mots pour l'analyse de lisibilité.",
   "readabilityTooltipDescription": "@label mesure la facilité de lecture du texte.",
+  "relativeTimeJustNow": "à l'instant",
   "revertDialogLead": "Cela supprimera toutes les modifications et restaurera l’état actuellement publié. Cette action est irréversible.",
   "revertDialogSubmit": "Annuler les modifications",
   "revertDialogTitle": "Annuler les modifications de façon irréversible",

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

@@ -585,6 +585,7 @@
   "editableFieldFullscreen": "Vollbild",
   "editableFieldTranslateTooltip": "Den aktuellen Text automatisch übersetzen.",
   "editingDisabled": "Bearbeiten ist für diesen Blocktyp deaktiviert.",
+  "entityTitleLastChanged": "Zletscht gänderet",
   "entityTitleTourText": "<p>Zeigt dr Titel und Status vo dr aktuälle Sitte aa.</p><p>Klick uf dr Titel zum s'Sitte-Bearbeitsformular z'öffne.</p>",
   "entityTitleTourTitle": "Sitte",
   "errorCapturedMessage": "Fähler in «@label»: @errorMessage",
@@ -783,6 +784,7 @@
   "relatedContent": "Verwandte Inhalte",
   "relatedContentNoEntitiesFound": "Keine verwandten Inhalte gefunden",
   "relatedContentTooltip": "Inhalte wie Seiten oder Bilder, die von diesem Block referenziert oder verlinkt werden.",
+  "relativeTimeJustNow": "grad ebe",
   "remove": "Entfernen",
   "replaceField": "@field ersetzen",
   "reply": "Antworten",

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

@@ -98,6 +98,7 @@
   "duplicate": "Duplica",
   "duplicateError": "Gli elementi non possono essere duplicati.",
   "edit": "Modifica",
+  "entityTitleLastChanged": "Ultima modifica",
   "exitDescription": "Chiudi l'editor senza pubblicare",
   "failedToConvert": "L'elemento non può essere convertito.",
   "failedToTransform": "The action \"@name\" could not be executed.",
@@ -150,6 +151,7 @@
   "readabilityTooShort": "Troppo breve",
   "readabilityTooShortTooltip": "Il testo necessita di almeno @count parole per l'analisi della leggibilità.",
   "readabilityTooltipDescription": "@label misura quanto è facile leggere il testo.",
+  "relativeTimeJustNow": "proprio ora",
   "revertDialogLead": "Questo eliminerà tutte le modifiche e ripristinerà lo stato attualmente pubblicato. Questa azione non può essere annullata.",
   "revertDialogSubmit": "Scarta modifiche",
   "revertDialogTitle": "Scarta irrevocabilmente le modifiche",

package/dist/runtime/editor/types/state.d.ts

@@ -50,6 +50,13 @@ export interface MappedState {
     mutations: MutationItem[];
     currentUserIsOwner: boolean;
     ownerName: string;
+    /**
+     * Unix timestamp (in seconds) of when the edit state was last changed.
+     *
+     * This is the edit state's own `changed` time (it bumps on every mutation),
+     * distinct from `publishOptions.lastChanged`, which is the published entity's.
+     */
+    lastChanged?: number;
     ownerId?: string;
     mutatedState?: {
         mutatedOptions?: any;

package/dist/runtime/editor/types/ui.d.ts

@@ -43,5 +43,6 @@ export type BlockIndicator = {
     uuid: string;
     element: HTMLElement;
     position: 'left' | 'right';
+    sticky?: boolean;
 };
 export type Placement = 'above-before' | 'above-left' | 'above-center' | 'above-right' | 'above-after' | 'below-before' | 'below-left' | 'below-center' | 'below-right' | 'below-after' | 'top-before' | 'top-after' | 'center-before' | 'center-after' | 'bottom-before' | 'bottom-after';

package/dist/shared/{editor.Gu7mgJ5Q.mjs → editor.BGemL1Oh.mjs}

@@ -1,151 +1,6 @@
 import * as ts from 'typescript';
 import { parseAndWalk } from 'oxc-walker';
 
-class CollectedFile {
-  constructor(filePath, fileContents) {
-    this.filePath = filePath;
-    this.fileContents = fileContents;
-  }
-  async handleChange(_helper) {
-    return Promise.resolve(true);
-  }
-  /**
-   * Validate the collected file and return any errors.
-   * Override this method in subclasses to add validation logic.
-   */
-  validate(_icons) {
-    return [];
-  }
-}
-class Collector {
-  constructor(helper) {
-    this.helper = helper;
-    this.files = /* @__PURE__ */ new Map();
-  }
-  files;
-  needsFileContents = true;
-  async addFile(filePath) {
-    if (this.needsFileContents) {
-      const contents = await this.helper.fileCache.read(filePath);
-      const file = this.createCollectedFile(filePath, contents.toString());
-      await file.handleChange(this.helper);
-      this.files.set(filePath, file);
-    } else {
-      const file = this.createCollectedFile(filePath);
-      await file.handleChange(this.helper);
-      this.files.set(filePath, file);
-    }
-  }
-  async handleAdd(filePath) {
-    const applies = await this.applies(filePath);
-    if (applies) {
-      await this.addFile(filePath);
-      return true;
-    }
-    return false;
-  }
-  async handleChange(filePath) {
-    const applies = await this.applies(filePath);
-    if (!applies) {
-      return this.handleUnlink(filePath);
-    }
-    const file = this.files.get(filePath);
-    if (!file) {
-      return false;
-    }
-    if (this.needsFileContents) {
-      const contents = await this.helper.fileCache.read(filePath);
-      file.fileContents = contents.toString();
-      return await file.handleChange(this.helper);
-    }
-    return true;
-  }
-  handleUnlink(filePath) {
-    if (this.files.has(filePath)) {
-      this.files.delete(filePath);
-      return true;
-    }
-    return false;
-  }
-  handleAddDir() {
-    return false;
-  }
-  handleUnlinkDir(folderPath) {
-    const allKeys = [...this.files.keys()];
-    const toRemove = allKeys.filter((filePath) => filePath.includes(folderPath));
-    if (toRemove.length) {
-      toRemove.forEach((key) => this.files.delete(key));
-      return true;
-    }
-    return false;
-  }
-  async handleWatchEvent(event, filePath) {
-    let hasChanged = false;
-    if (event === "add") {
-      hasChanged = await this.handleAdd(filePath);
-    } else if (event === "change") {
-      hasChanged = await this.handleChange(filePath);
-    } else if (event === "unlink") {
-      hasChanged = await this.handleUnlink(filePath);
-    } else if (event === "addDir") {
-      hasChanged = this.handleAddDir();
-    } else if (event === "unlinkDir") {
-      hasChanged = this.handleUnlinkDir(filePath);
-    }
-    return { hasChanged };
-  }
-  /**
-   * Validate all collected files and log any errors/warnings to the console.
-   * @returns true if there are validation errors (not warnings), false otherwise.
-   */
-  validate(icons) {
-    const allIssues = [];
-    for (const file of this.files.values()) {
-      const issues = file.validate(icons);
-      if (issues.length > 0) {
-        allIssues.push({ filePath: file.filePath, issues });
-      }
-    }
-    if (allIssues.length === 0) {
-      return false;
-    }
-    const errors = [];
-    const warnings = [];
-    for (const { filePath, issues } of allIssues) {
-      const fileErrors = issues.filter((i) => i.severity !== "warning");
-      const fileWarnings = issues.filter((i) => i.severity === "warning");
-      if (fileErrors.length > 0) {
-        errors.push({ filePath, issues: fileErrors });
-      }
-      if (fileWarnings.length > 0) {
-        warnings.push({ filePath, issues: fileWarnings });
-      }
-    }
-    if (warnings.length > 0) {
-      const lines = warnings.flatMap(({ filePath, issues }) => [
-        `  ${filePath}:`,
-        ...issues.map((e) => `    - ${e.message}`)
-      ]);
-      this.helper.logger.warn(
-        `bl\xF6kkli validation warnings:
-${lines.join("\n")}`
-      );
-    }
-    if (errors.length > 0) {
-      const lines = errors.flatMap(({ filePath, issues }) => [
-        `  ${filePath}:`,
-        ...issues.map((e) => `    - ${e.message}`)
-      ]);
-      this.helper.logger.error(
-        `bl\xF6kkli validation errors:
-${lines.join("\n")}`
-      );
-      return true;
-    }
-    return false;
-  }
-}
-
 function sortObjectKeys(obj) {
   if (Array.isArray(obj)) {
     return obj.map(sortObjectKeys);
@@ -317,4 +172,149 @@ function onlyUnique(value, index, self) {
   return self.indexOf(value) === index;
 }
 
-export { Collector as C, CollectedFile as a, extractStringProperty as b, extractObjectLiteral as c, extractFirstStringArg as e, falsy as f, onlyUnique as o, parseTsObject as p, sortObjectKeys as s, toValidVariableName as t };
+class CollectedFile {
+  constructor(filePath, fileContents) {
+    this.filePath = filePath;
+    this.fileContents = fileContents;
+  }
+  async handleChange(_helper) {
+    return Promise.resolve(true);
+  }
+  /**
+   * Validate the collected file and return any errors.
+   * Override this method in subclasses to add validation logic.
+   */
+  validate(_icons) {
+    return [];
+  }
+}
+class Collector {
+  constructor(helper) {
+    this.helper = helper;
+    this.files = /* @__PURE__ */ new Map();
+  }
+  files;
+  needsFileContents = true;
+  async addFile(filePath) {
+    if (this.needsFileContents) {
+      const contents = await this.helper.fileCache.read(filePath);
+      const file = this.createCollectedFile(filePath, contents.toString());
+      await file.handleChange(this.helper);
+      this.files.set(filePath, file);
+    } else {
+      const file = this.createCollectedFile(filePath);
+      await file.handleChange(this.helper);
+      this.files.set(filePath, file);
+    }
+  }
+  async handleAdd(filePath) {
+    const applies = await this.applies(filePath);
+    if (applies) {
+      await this.addFile(filePath);
+      return true;
+    }
+    return false;
+  }
+  async handleChange(filePath) {
+    const applies = await this.applies(filePath);
+    if (!applies) {
+      return this.handleUnlink(filePath);
+    }
+    const file = this.files.get(filePath);
+    if (!file) {
+      return false;
+    }
+    if (this.needsFileContents) {
+      const contents = await this.helper.fileCache.read(filePath);
+      file.fileContents = contents.toString();
+      return await file.handleChange(this.helper);
+    }
+    return true;
+  }
+  handleUnlink(filePath) {
+    if (this.files.has(filePath)) {
+      this.files.delete(filePath);
+      return true;
+    }
+    return false;
+  }
+  handleAddDir() {
+    return false;
+  }
+  handleUnlinkDir(folderPath) {
+    const allKeys = [...this.files.keys()];
+    const toRemove = allKeys.filter((filePath) => filePath.includes(folderPath));
+    if (toRemove.length) {
+      toRemove.forEach((key) => this.files.delete(key));
+      return true;
+    }
+    return false;
+  }
+  async handleWatchEvent(event, filePath) {
+    let hasChanged = false;
+    if (event === "add") {
+      hasChanged = await this.handleAdd(filePath);
+    } else if (event === "change") {
+      hasChanged = await this.handleChange(filePath);
+    } else if (event === "unlink") {
+      hasChanged = await this.handleUnlink(filePath);
+    } else if (event === "addDir") {
+      hasChanged = this.handleAddDir();
+    } else if (event === "unlinkDir") {
+      hasChanged = this.handleUnlinkDir(filePath);
+    }
+    return { hasChanged };
+  }
+  /**
+   * Validate all collected files and log any errors/warnings to the console.
+   * @returns true if there are validation errors (not warnings), false otherwise.
+   */
+  validate(icons) {
+    const allIssues = [];
+    for (const file of this.files.values()) {
+      const issues = file.validate(icons);
+      if (issues.length > 0) {
+        allIssues.push({ filePath: file.filePath, issues });
+      }
+    }
+    if (allIssues.length === 0) {
+      return false;
+    }
+    const errors = [];
+    const warnings = [];
+    for (const { filePath, issues } of allIssues) {
+      const fileErrors = issues.filter((i) => i.severity !== "warning");
+      const fileWarnings = issues.filter((i) => i.severity === "warning");
+      if (fileErrors.length > 0) {
+        errors.push({ filePath, issues: fileErrors });
+      }
+      if (fileWarnings.length > 0) {
+        warnings.push({ filePath, issues: fileWarnings });
+      }
+    }
+    if (warnings.length > 0) {
+      const lines = warnings.flatMap(({ filePath, issues }) => [
+        `  ${filePath}:`,
+        ...issues.map((e) => `    - ${e.message}`)
+      ]);
+      this.helper.logger.warn(
+        `bl\xF6kkli validation warnings:
+${lines.join("\n")}`
+      );
+    }
+    if (errors.length > 0) {
+      const lines = errors.flatMap(({ filePath, issues }) => [
+        `  ${filePath}:`,
+        ...issues.map((e) => `    - ${e.message}`)
+      ]);
+      this.helper.logger.error(
+        `bl\xF6kkli validation errors:
+${lines.join("\n")}`
+      );
+      return true;
+    }
+    return false;
+  }
+}
+
+export { Collector as C, CollectedFile as a, extractFirstStringArg as b, extractObjectLiteral as c, extractStringProperty as e, falsy as f, onlyUnique as o, parseTsObject as p, sortObjectKeys as s, toValidVariableName as t };