@bloklabs/angular 1.12.0 → 1.14.0

package/README.md

@@ -1,6 +1,6 @@
 # @bloklabs/angular
 
-The Angular block editor bindings for [Blok](https://blokeditor.com) — a headless, Notion-like rich text editor whose content is JSON blocks, not HTML.
+The Angular block editor bindings for [Blok](https://blokeditor.com). Blok is a headless, Notion-like rich text editor whose content is JSON blocks, not HTML.
 
 ## Install
 

package/fesm2022/bloklabs-angular.mjs

@@ -312,10 +312,10 @@ class BlokContentDirective {
         this.registry = undefined;
         this.instance.set(null);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: BlokContentDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
-    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.0.7", type: BlokContentDirective, isStandalone: true, selector: "[blokContent]", inputs: { config: "config", recreateKey: "recreateKey" }, outputs: { ready: "ready" }, ngImport: i0 });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: BlokContentDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.1.4", type: BlokContentDirective, isStandalone: true, selector: "[blokContent]", inputs: { config: "config", recreateKey: "recreateKey" }, outputs: { ready: "ready" }, ngImport: i0 });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: BlokContentDirective, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: BlokContentDirective, decorators: [{
             type: Directive,
             args: [{
                     selector: '[blokContent]',
@@ -2936,6 +2936,17 @@ const applyChildDecoration = (ledger, children, decorators) => {
  */
 const BlockChildrenMounted = 'block:childrenMounted';
 
+/**
+ * Warning text for a controlled `data` change the adapter refuses to render
+ * under collaboration. Kept verbatim in all three adapters (they share no code).
+ * @param doc - the collaboration document id, for the reset endpoint in the text
+ * @returns the message to warn with, once per adapter instance
+ */
+const collaborationDataIgnoredMessage = (doc) => '[Blok] `data` is ignored while collaboration is on: the document lives on the sync service ' +
+    'and is shared with everyone editing it, so replacing it from this editor would overwrite their work. ' +
+    `To replace the whole document, call POST /sync/${doc ?? '{doc}'}/reset on your server — ` +
+    'it reloads the document from your own document endpoint and every open editor picks it up. ' +
+    'To change part of it, use the blocks API (insert/update/delete).';
 /**
  * The blessed all-in-one Angular component for embedding Blok (mirrors React's
  * `BlokEditor`). Delegates instance lifecycle to an internal `BlokContentDirective`
@@ -3107,6 +3118,19 @@ class BlokEditorComponent {
     appliedInlineToolbar;
     seededEditor = null;
     renderChain = Promise.resolve();
+    /** One collaboration warning per component instance (see the data effect). */
+    collaborationWarned = false;
+    /**
+     * The `collaboration` the live editor was CONSTRUCTED with. The key is
+     * mount-fixed, so dropping it from `[config]` (`collaboration: on ? {...} :
+     * undefined`) cannot turn a live session into a single-player editor —
+     * reading the current input instead would let that change fall through into
+     * render(), which refuses under collaboration and rejects with nothing
+     * surfaced anywhere.
+     */
+    constructedCollaboration;
+    /** Editor the capture above belongs to (recaptured on recreate). */
+    collaborationCapturedFor = null;
     /** Registered by `ControlValueAccessor.registerOnChange` (Angular forms). */
     cvaOnChange;
     cvaOnTouched;
@@ -3381,6 +3405,16 @@ class BlokEditorComponent {
         });
     }
     constructor() {
+        // Registered FIRST so the capture lands before the data effect below can
+        // read it. `collaboration` reaches the directive through `buildConfig()`,
+        // which is read once per build; this records what that build received.
+        effect(() => {
+            const editor = this.instance();
+            if (editor !== null && editor !== this.collaborationCapturedFor) {
+                this.collaborationCapturedFor = editor;
+                this.constructedCollaboration = this.escapeHatchConfig().collaboration;
+            }
+        });
         // Each effect reads `instance()` so it re-applies once the editor appears
         // (the Angular analog of React's `editor` effect-dependency).
         effect(() => {
@@ -3516,6 +3550,21 @@ class BlokEditorComponent {
             if (baseline !== undefined && equalsOutputData(data, baseline)) {
                 return;
             }
+            // Under collaboration the document belongs to the sync service, and
+            // render() refuses a wholesale replace — so don't attempt one. The input's
+            // premise ("this value IS the document") does not hold here. Decided
+            // against the MOUNTED config, never the current input: `collaboration` is
+            // mount-fixed, so a host that drops the key is still driving a
+            // collaboration session and deserves the warning rather than a silently
+            // rejected render.
+            const collaboration = this.constructedCollaboration;
+            if (collaboration !== undefined) {
+                if (!this.collaborationWarned) {
+                    this.collaborationWarned = true;
+                    console.warn(collaborationDataIgnoredMessage(collaboration.doc));
+                }
+                return;
+            }
             this.lastRenderedData = data;
             // `data` may be null (a controlled "clear to empty"); render() throws on
             // null, so normalize null → { blocks: [] } at the boundary.
@@ -3571,8 +3620,8 @@ class BlokEditorComponent {
     setDisabledState(isDisabled) {
         this.readOnly$.set(isDisabled);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: BlokEditorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "22.0.7", type: BlokEditorComponent, isStandalone: true, selector: "blok-editor", inputs: { onBeforeRender: "onBeforeRender", onBeforePaste: "onBeforePaste", onError: "onError", readOnly: "readOnly", hideToolbar: "hideToolbar", toolbarPosition: "toolbarPosition", inlineToolbar: "inlineToolbar", theme: "theme", width: "width", placeholder: "placeholder", styleTokens: "styleTokens", i18n: "i18n", autofocus: "autofocus", data: "data", tools: "tools", migrations: "migrations", config: "config", recreateKey: "recreateKey" }, outputs: { ready: "ready", dataChange: "dataChange", save: "save", change: "change", afterRender: "afterRender", themeChange: "themeChange", blocksRendered: "blocksRendered", blockRendered: "blockRendered" }, providers: [
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: BlokEditorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "22.1.4", type: BlokEditorComponent, isStandalone: true, selector: "blok-editor", inputs: { onBeforeRender: "onBeforeRender", onBeforePaste: "onBeforePaste", onError: "onError", readOnly: "readOnly", hideToolbar: "hideToolbar", toolbarPosition: "toolbarPosition", inlineToolbar: "inlineToolbar", theme: "theme", width: "width", placeholder: "placeholder", styleTokens: "styleTokens", i18n: "i18n", autofocus: "autofocus", data: "data", tools: "tools", migrations: "migrations", config: "config", recreateKey: "recreateKey" }, outputs: { ready: "ready", dataChange: "dataChange", save: "save", change: "change", afterRender: "afterRender", themeChange: "themeChange", blocksRendered: "blocksRendered", blockRendered: "blockRendered" }, providers: [
             {
                 provide: NG_VALUE_ACCESSOR,
                 useExisting: forwardRef(() => BlokEditorComponent),
@@ -3580,7 +3629,7 @@ class BlokEditorComponent {
             },
         ], viewQueries: [{ propertyName: "contentQuery", first: true, predicate: BlokContentDirective, descendants: true }], exportAs: ["blok"], ngImport: i0, template: `<div blokContent [config]="buildConfig()" [recreateKey]="recreateKey"></div>`, isInline: true, dependencies: [{ kind: "directive", type: BlokContentDirective, selector: "[blokContent]", inputs: ["config", "recreateKey"], outputs: ["ready"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: BlokEditorComponent, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.4", ngImport: i0, type: BlokEditorComponent, decorators: [{
             type: Component,
             args: [{
                     selector: 'blok-editor',