@kywi-software/core 0.10.0 → 0.12.0

package/dist/admin/layout-editor/module-overlay.d.ts

@@ -1,21 +1,31 @@
 import React from 'react';
 import type { OverlayAction } from './section-overlay.js';
+import type { InlineTextProp, InlineTextBindingTarget } from './inline-text.js';
 /**
- * Inline text editing for one module (kywi-cms#94). The overlay makes its own
- * wrapper — which contains the module's real rendered element — contenteditable
- * so the owner types on the page, in the page's styling. Commit reads the value
+ * Inline text editing for one module (kywi-cms#94, kywi-cms#145). The overlay
+ * makes the element that renders ONE prop contenteditable — the real `<h3>` a
+ * card's title is drawn in — so the owner types on the page, in the page's
+ * styling, and a commit can only ever write that prop. Commit reads the value
  * back out of the DOM (see `readInlineTextValue`); the parent turns that into an
  * `UPDATE_PROPS` dispatch, so the edit goes through history like any other.
+ *
+ * Which element that is is resolved per gesture rather than per module: see
+ * `resolveInlineBinding`, which the parent wires into `resolve` below.
  */
 export interface InlineTextBinding {
     /** True while THIS module is the one being text-edited. */
     active: boolean;
-    /** Whether the bound prop holds HTML (Enter inserts a line break instead of committing). */
-    html: boolean;
+    /**
+     * Resolve the element + prop a gesture at `target` binds, or null when there
+     * is nothing safe to bind — in which case the gesture falls through to
+     * `onInlineFallback` (the props rail) instead of editing anything
+     * (kywi-cms#145).
+     */
+    resolve: (wrapper: HTMLElement, target: Element | null) => InlineTextBindingTarget | null;
     /** Begin editing (double-click, or a click on an already-selected module). */
     onActivate: () => void;
-    /** Commit the value currently in `host` and end the edit. */
-    onCommit: (host: HTMLElement) => void;
+    /** Commit the value currently in `host` to `prop` and end the edit. */
+    onCommit: (host: HTMLElement, prop: InlineTextProp) => void;
     /** Abandon the edit and end it, leaving the stored props untouched. */
     onCancel: () => void;
 }
@@ -49,16 +59,28 @@ interface ModuleOverlayProps {
     /** Inline text editing binding, when this module carries a primary text prop. */
     inlineText?: InlineTextBinding | null;
     /**
-     * Double-click fallback for a module with no primary text prop (kywi-cms#118).
-     * Without a text prop to bind, double-click otherwise no-ops and reads as
-     * "dead" — this routes the gesture to the props rail instead: select the
-     * module, then focus its first field there. Only meaningful in in-place mode
-     * (see `inlineTextBindingFor`'s own `!inPlace` short-circuit); admin canvas
-     * never carries `inlineEdit`, so it never gets this either.
+     * Double-click fallback for a gesture with nothing safe to bind
+     * (kywi-cms#118, widened by kywi-cms#145). That is a module with no text prop
+     * at all, and now also one whose text props the renderer does not anchor
+     * individually — where the old wrapper binding was the corruption. Without it
+     * double-click no-ops and reads as "dead", so this routes the gesture to the
+     * props rail instead: select the module, then focus its first field there.
+     * Only meaningful in in-place mode (see `inlineTextBindingFor`'s own `!inPlace`
+     * short-circuit); admin canvas never carries `inlineEdit`, so it never gets
+     * this either.
      */
     onInlineFallback?: () => void;
+    /**
+     * The component this module is a linked instance of (kywi-cms#147). Stamps
+     * `data-component-id` (the same hook the public renderer emits), switches the
+     * wrapper to the linked outline, and names the component in a pill beside the
+     * type chip — a linked module is otherwise indistinguishable from an ordinary
+     * one, which is how an owner edits eleven pages by accident.
+     */
+    componentId?: string;
+    componentName?: string | null;
     children: React.ReactNode;
 }
-export declare function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelected, onSelect, actions, typeLabel, inPlace, moduleType, inlineText, onInlineFallback, children, }: ModuleOverlayProps): import("react/jsx-runtime").JSX.Element;
+export declare function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelected, onSelect, actions, typeLabel, inPlace, moduleType, inlineText, onInlineFallback, componentId, componentName, children, }: ModuleOverlayProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=module-overlay.d.ts.map

package/dist/admin/layout-editor/module-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-overlay.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/module-overlay.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAA;IACf,4FAA4F;IAC5F,IAAI,EAAE,OAAO,CAAA;IACb,8EAA8E;IAC9E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IACrC,uEAAuE;IACvE,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;sDAKkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACrC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,QAAQ,GACT,EAAE,kBAAkB,2CA6MpB"}
+{"version":3,"file":"module-overlay.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/module-overlay.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAI/E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,uBAAuB,GAAG,IAAI,CAAA;IACzF,8EAA8E;IAC9E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,uEAAuE;IACvE,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IAC3D,uEAAuE;IACvE,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;sDAKkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;IACzB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACrC;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,KAAK,EACL,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,QAAQ,GACT,EAAE,kBAAkB,2CAqapB"}

package/dist/admin/layout-editor/module-overlay.js

@@ -4,7 +4,8 @@ import React from 'react';
 import { useSortable } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
 import { EditorIcon } from './editor-icons.js';
-export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelected, onSelect, actions, typeLabel, inPlace = false, moduleType, inlineText, onInlineFallback, children, }) {
+import { LinkedComponentPill } from './linked-component.js';
+export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelected, onSelect, actions, typeLabel, inPlace = false, moduleType, inlineText, onInlineFallback, componentId, componentName, children, }) {
     const { attributes, listeners, setNodeRef, transform, transition } = useSortable({
         id: moduleId,
         // `moduleType` (kywi-cms#139 review): without it, `useEditorDnd`'s
@@ -18,20 +19,131 @@ export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelecte
     // Escape must not commit: turning contenteditable off blurs the host, and the
     // blur handler would otherwise save the very edit the owner just abandoned.
     const cancellingRef = React.useRef(false);
+    /** The element + prop the CURRENT edit is bound to (kywi-cms#145). */
+    const boundRef = React.useRef(null);
+    // Read inside effects and event handlers, which must see the latest binding
+    // without re-running the editing effect (which would re-focus and re-place the
+    // caret) every time the parent re-creates the binding object.
+    const inlineTextRef = React.useRef(inlineText);
+    inlineTextRef.current = inlineText;
     const setRefs = React.useCallback((node) => {
         hostRef.current = node;
         setNodeRef(node);
     }, [setNodeRef]);
     const isEditing = Boolean(inlineText?.active);
-    // Focus the editing host and drop the caret at the end of the text, so typing
-    // continues the copy rather than replacing it.
+    /**
+     * Recovery counter for an edit whose element went away (kywi-cms#145 review).
+     * Bumping it re-runs the attach effect below against the DOM that is actually
+     * on the page now.
+     */
+    const [attachNonce, setAttachNonce] = React.useState(0);
+    const reattach = React.useCallback(() => setAttachNonce(n => n + 1), []);
+    /**
+     * Set once a session has failed to re-resolve and has asked to end. Without
+     * it the recovery effect and the attach effect would take turns forever on a
+     * module that genuinely has nothing left to bind.
+     */
+    const abandonedRef = React.useRef(false);
+    /**
+     * True when a live edit has no element on the page any more.
+     *
+     * The module's inner DOM can be replaced under an edit — undo emptying a
+     * heading swaps the renderer for the #134 empty state, a prop change re-keys
+     * a subtree. `contenteditable` is then sitting on a detached node: it can
+     * never fire `focusout`, so the edit can never commit, and the gesture
+     * handlers below would swallow every click as "already editing", leaving the
+     * module inert until a window-level Escape (kywi-cms#145 review).
+     */
+    function isOrphanedEdit() {
+        const bound = boundRef.current;
+        return !bound || !bound.element.isConnected;
+    }
+    /** Resolve + remember what a gesture at `target` would edit. */
+    function bind(target) {
+        const wrapper = hostRef.current;
+        const binding = inlineTextRef.current;
+        if (!wrapper || !binding)
+            return null;
+        const bound = binding.resolve(wrapper, target);
+        boundRef.current = bound;
+        return bound;
+    }
+    /**
+     * Take an orphaned session over with THIS gesture: re-resolve from where the
+     * pointer landed and re-attach. Returns false — and ends the session — when
+     * nothing resolves, so the gesture falls through to select/rail rather than
+     * being eaten by an edit that can no longer go anywhere.
+     *
+     * `bind` has already stored the answer by the time `reattach` runs, and the
+     * attach effect below is written to consume it (kywi-cms#145 review round 2):
+     * the pointer is the ONLY thing that can say which of a card's remaining
+     * anchors the owner meant, so losing it here would strand every recovery on a
+     * module with two or more of them.
+     */
+    function recoverOrphanedEdit(target) {
+        if (bind(target)) {
+            reattach();
+            return true;
+        }
+        inlineTextRef.current?.onCancel();
+        return false;
+    }
+    // Reset per session, ahead of the attach effect below (effects run in
+    // declaration order), so a session that ended in failure does not poison the
+    // next one.
+    React.useEffect(() => {
+        if (isEditing)
+            abandonedRef.current = false;
+    }, [isEditing]);
+    // Turn contenteditable on for the BOUND ELEMENT — not the wrapper, unless the
+    // wrapper is what resolution chose (kywi-cms#145) — then focus it and drop the
+    // caret at the end of the text, so typing continues the copy rather than
+    // replacing it. Imperative rather than a rendered `contentEditable` prop
+    // because the bound element belongs to the module's own renderer, not to this
+    // component's JSX.
     React.useEffect(() => {
-        if (!isEditing)
+        if (!isEditing) {
+            // Where the binding is forgotten — deliberately NOT in the cleanup below
+            // (kywi-cms#145 review round 2). React runs a cleanup BEFORE the next
+            // effect body, so clearing it there also cleared it on an `attachNonce`
+            // re-run: `recoverOrphanedEdit` resolved a binding from the gesture, the
+            // cleanup threw it away, and this body fell back to resolving with no
+            // pointer at all — which returns null, and so CANCELS the session, on any
+            // module that still has two or more anchors (rule 2 is ambiguous there).
+            // This effect only re-runs on `isEditing`/`attachNonce`, and the nonce
+            // only moves while an edit is live, so reaching here means the session
+            // itself has ended.
+            boundRef.current = null;
             return;
-        const host = hostRef.current;
-        if (!host)
+        }
+        const wrapper = hostRef.current;
+        if (!wrapper)
+            return;
+        // An activation this component did not start (the parent set `editingId`
+        // directly) has no gesture to resolve from — resolve pointer-lessly. Same
+        // for a binding whose element has since left the document (kywi-cms#145
+        // review): re-resolve rather than attach to a node nobody can see. A
+        // binding a recovering gesture just resolved passes all three checks and is
+        // used as-is, which is the point of the recovery.
+        let bound = boundRef.current;
+        if (!bound ||
+            !bound.element.isConnected ||
+            (bound.element !== wrapper && !wrapper.contains(bound.element))) {
+            bound = inlineTextRef.current?.resolve(wrapper, null) ?? null;
+            boundRef.current = bound;
+        }
+        if (!bound) {
+            // Active with nothing bindable — the module re-rendered out from under an
+            // edit, say. End the session rather than leave the owner in an "editing"
+            // module that swallows nothing and cannot be typed in.
+            abandonedRef.current = true;
+            inlineTextRef.current?.onCancel();
             return;
+        }
+        const host = bound.element;
         cancellingRef.current = false;
+        host.setAttribute('contenteditable', 'true');
+        host.setAttribute('spellcheck', 'true');
         host.focus();
         const selection = window.getSelection?.();
         if (selection && typeof document.createRange === 'function') {
@@ -41,7 +153,61 @@ export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelecte
             selection.removeAllRanges();
             selection.addRange(range);
         }
-    }, [isEditing]);
+        // A `<summary>` anchor — the accordion's title, the FAQ's question — keeps
+        // its activation behaviour while contenteditable (kywi-cms#145 review): in
+        // Chrome a click that only meant "put the caret here" also toggles the
+        // panel out from under the caret, and Space toggles as well as typing.
+        // Both reach the toggle as the CLICK event's default action (the keyboard
+        // ones through a synthesized click), so cancelling that one event stops the
+        // toggle while leaving caret placement (a mousedown default) and character
+        // insertion (a beforeinput default) alone. Deliberately not a keydown
+        // preventDefault: that would stop Space typing a space, which is the very
+        // behaviour this is here to preserve. Switching the anchor to an inner
+        // `<span>` is not an option — the published markup must stay byte-identical
+        // (layout/__tests__/inline-prop-anchors.test.tsx).
+        const suppressActivation = host.tagName === 'SUMMARY' ? (event) => event.preventDefault() : null;
+        if (suppressActivation)
+            host.addEventListener('click', suppressActivation);
+        return () => {
+            // Undo exactly what this run did to `host`, and nothing else. On a
+            // re-attach that means the OLD element goes back to being ordinary markup
+            // (suppressor and all, so a re-bind away from a `<summary>` stops
+            // swallowing its clicks) while the binding itself — which by then may be
+            // the new one a gesture resolved — is left alone; the session's binding is
+            // cleared by the `!isEditing` branch above instead.
+            if (suppressActivation)
+                host.removeEventListener('click', suppressActivation);
+            host.removeAttribute('contenteditable');
+            host.removeAttribute('spellcheck');
+        };
+    }, [isEditing, attachNonce]);
+    // The other half of the orphan recovery: no deps, so it runs after EVERY
+    // render (and after the attach effect above, which is declared first). A
+    // re-render that replaced the module's inner DOM lands here with a bound
+    // element that is no longer in the document — re-run the attach against what
+    // is there now (kywi-cms#145 review).
+    React.useEffect(() => {
+        if (!isEditing || abandonedRef.current)
+            return;
+        // …but only while this module is still IN the document. When the whole
+        // wrapper has been detached — the React tree is still mounted, its DOM is
+        // not: a host that removed the editor's container node, a test root whose
+        // container was taken out of `document.body` — then every element
+        // re-resolution could find lives inside that same detached wrapper, so it
+        // comes back disconnected too, this effect fires again on the render
+        // `reattach()` just caused, and the two effects ping-pong forever: an
+        // unbounded render loop that pins a core and exhausts the heap. Latent
+        // since kywi-cms#145 (it needs one render AFTER the detach to start, and
+        // nothing used to produce one); the component library loading in the shell
+        // is such a render, which is how kywi-cms#147 found it. There is nothing on
+        // screen to recover onto in that state anyway, and if the wrapper is
+        // re-attached the next render reaches the recovery again.
+        if (!hostRef.current?.isConnected)
+            return;
+        if (!isOrphanedEdit())
+            return;
+        reattach();
+    });
     const style = {
         transform: CSS.Transform.toString(transform),
         transition,
@@ -53,26 +219,48 @@ export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelecte
         // instead of following the link (kywi-cms#94).
         if (inPlace)
             e.preventDefault();
-        if (isEditing)
+        // A live edit swallows clicks — but only a LIVE one. An orphaned session
+        // (see `isOrphanedEdit`) must let the gesture re-bind, or the module stays
+        // inert (kywi-cms#145 review).
+        if (isEditing) {
+            if (!isOrphanedEdit())
+                return;
+            if (recoverOrphanedEdit(e.target))
+                return;
+            onSelect();
             return;
+        }
         // A click on an already-selected, text-bearing module starts typing —
-        // the second click of the "select, then edit" pattern (kywi-cms#94).
+        // the second click of the "select, then edit" pattern (kywi-cms#94). Which
+        // prop that is depends on where the click landed (kywi-cms#145); a click
+        // with nothing safe to bind just leaves the module selected, and the
+        // double-click that follows routes to the rail.
         if (inlineText && isSelected) {
-            inlineText.onActivate();
+            if (bind(e.target))
+                inlineText.onActivate();
             return;
         }
         onSelect();
     }
     function handleDoubleClick(e) {
-        if (isEditing)
-            return;
-        if (inlineText) {
+        if (isEditing) {
+            if (!isOrphanedEdit())
+                return;
+            if (recoverOrphanedEdit(e.target)) {
+                e.stopPropagation();
+                return;
+            }
+            // Nothing left to re-bind: the session has just ended, so fall through to
+            // the rail fallback below rather than eating the double-click.
+        }
+        if (inlineText && bind(e.target)) {
             e.stopPropagation();
             inlineText.onActivate();
             return;
         }
-        // No primary text prop to bind (kywi-cms#118) — route the gesture to the
-        // props rail instead of leaving it a silent no-op.
+        // Nothing safe to bind (kywi-cms#118, kywi-cms#145) — route the gesture to
+        // the props rail instead of leaving it a silent no-op, and never to the
+        // wrapper, which renders more than any one prop.
         if (onInlineFallback) {
             e.stopPropagation();
             onInlineFallback();
@@ -84,44 +272,57 @@ export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelecte
         if (e.key === 'Escape') {
             // Handled here rather than at the window: stopping propagation keeps the
             // shell's Escape handler (deselect) from also firing for the same press.
+            // Deliberately not gated on a resolved binding — Escape is the way out of
+            // an edit session however it got into trouble.
             e.preventDefault();
             e.stopPropagation();
             cancellingRef.current = true;
             inlineText.onCancel();
             return;
         }
-        if (e.key === 'Enter' && !e.shiftKey && !inlineText.html) {
+        const bound = boundRef.current;
+        if (!bound)
+            return;
+        if (e.key === 'Enter' && !e.shiftKey && !bound.prop.html) {
             // A plain-text prop is a single line — Enter means "done", not a newline.
             e.preventDefault();
             e.stopPropagation();
-            inlineText.onCommit(e.currentTarget);
+            inlineText.onCommit(bound.element, bound.prop);
         }
     }
     function handleBlur(e) {
-        if (!isEditing || !inlineText)
+        const bound = boundRef.current;
+        if (!isEditing || !inlineText || !bound)
             return;
         // Focus moving to a child (an action button) is not leaving the edit.
+        // `currentTarget` is the wrapper: React's onBlur is focusout, which bubbles,
+        // so the edit's own element reports through here whatever it is bound to.
         if (e.relatedTarget && e.currentTarget.contains(e.relatedTarget))
             return;
         if (cancellingRef.current) {
             cancellingRef.current = false;
             return;
         }
-        inlineText.onCommit(e.currentTarget);
+        inlineText.onCommit(bound.element, bound.prop);
     }
+    // No rendered `contentEditable` here: the edit is turned on imperatively, on
+    // the resolved element, by the effect above (kywi-cms#145).
     const editingProps = inlineText
         ? {
             onDoubleClick: handleDoubleClick,
             onKeyDown: handleKeyDown,
             onBlur: handleBlur,
-            ...(isEditing
-                ? { contentEditable: true, suppressContentEditableWarning: true, spellCheck: true }
-                : {}),
         }
         : onInlineFallback
             ? { onDoubleClick: handleDoubleClick }
             : {};
-    const chrome = (_jsxs(_Fragment, { children: [typeLabel && (_jsx("span", { className: inPlace ? 'kywi-ip-chip' : 'kywi-editor-module-type-chip', "data-kywi-editor-chrome": "", contentEditable: false, children: typeLabel })), _jsxs("div", { className: inPlace ? 'kywi-ip-chrome kywi-ip-module-actions' : 'kywi-editor-module-actions', "data-kywi-editor-chrome": "", contentEditable: false, children: [_jsx("button", { type: "button", className: "kywi-editor-module-action-btn kywi-editor-module-drag-handle", "aria-label": "Drag to reorder", title: "Drag to reorder", ...listeners, children: _jsx(EditorIcon, { name: "grip", size: 14 }) }), actions?.map((action, i) => (_jsx("button", { type: "button", className: "kywi-editor-module-action-btn", onClick: (e) => {
+    const chrome = (_jsxs(_Fragment, { children: [typeLabel && (_jsx("span", { className: inPlace ? 'kywi-ip-chip' : 'kywi-editor-module-type-chip', "data-kywi-editor-chrome": "", contentEditable: false, children: typeLabel })), componentId && (
+            // Deliberately NOT `.kywi-ip-chrome`: that class is invisible and
+            // click-through until its owner is hovered or selected, and a linked
+            // instance must announce itself BEFORE anyone reaches for it. It takes
+            // the same z-tier through its own rule, exactly as `.kywi-ip-insert-btn`
+            // does (see the stacking contract in editor.css).
+            _jsx("span", { className: inPlace ? 'kywi-ip-module-linked-tag' : 'kywi-editor-module-linked-tag', "data-kywi-editor-chrome": "", contentEditable: false, children: _jsx(LinkedComponentPill, { name: componentName }) })), _jsxs("div", { className: inPlace ? 'kywi-ip-chrome kywi-ip-module-actions' : 'kywi-editor-module-actions', "data-kywi-editor-chrome": "", contentEditable: false, children: [_jsx("button", { type: "button", className: "kywi-editor-module-action-btn kywi-editor-module-drag-handle", "aria-label": "Drag to reorder", title: "Drag to reorder", ...listeners, children: _jsx(EditorIcon, { name: "grip", size: 14 }) }), actions?.map((action, i) => (_jsx("button", { type: "button", className: "kywi-editor-module-action-btn", onClick: (e) => {
                             e.stopPropagation();
                             action.onClick();
                         }, title: action.label, "aria-label": action.label, children: _jsx(EditorIcon, { name: action.icon, size: 14 }) }, i)))] })] }));
@@ -132,10 +333,17 @@ export function ModuleOverlay({ moduleId, instanceId, columnId, index, isSelecte
             'kywi-ip-module',
             isSelected ? 'kywi-ip-module--selected' : null,
             isEditing ? 'kywi-ip-module--editing' : null,
+            componentId ? 'kywi-ip-module--linked' : null,
         ]
             .filter(Boolean)
             .join(' ')
-        : `kywi-editor-module${isSelected ? ' kywi-editor-module--selected' : ''}`;
-    return (_jsxs("div", { ref: setRefs, className: className, style: style, onClick: handleClick, "data-module-id": moduleId, "data-kywi-module-slot": "", ...(inPlace ? { 'data-instance-id': instanceId } : {}), ...(inPlace && moduleType ? { 'data-kywi-module': moduleType } : {}), ...attributes, ...editingProps, children: [chrome, children] }));
+        : [
+            'kywi-editor-module',
+            isSelected ? 'kywi-editor-module--selected' : null,
+            componentId ? 'kywi-editor-module--linked' : null,
+        ]
+            .filter(Boolean)
+            .join(' ');
+    return (_jsxs("div", { ref: setRefs, className: className, style: style, onClick: handleClick, "data-module-id": moduleId, "data-kywi-module-slot": "", ...(componentId ? { 'data-component-id': componentId } : {}), ...(inPlace ? { 'data-instance-id': instanceId } : {}), ...(inPlace && moduleType ? { 'data-kywi-module': moduleType } : {}), ...attributes, ...editingProps, children: [chrome, children] }));
 }
 //# sourceMappingURL=module-overlay.js.map

package/dist/admin/layout-editor/module-overlay.js.map

@@ -1 +1 @@
-{"version":3,"file":"module-overlay.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/module-overlay.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"module-overlay.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/module-overlay.tsx"],"names":[],"mappings":"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"}

package/dist/admin/layout-editor/node-lookup.d.ts

@@ -88,6 +88,41 @@ export declare function findColumnIn(regions: Record<string, RegionNode[]>, colu
 export declare function findModuleIn(regions: Record<string, RegionNode[]>, moduleId: string): ModuleLocation | null;
 /** Find a variant container by id. Containers only ever live at region level. */
 export declare function findVariantContainerIn(regions: Record<string, RegionNode[]>, containerId: string): VariantContainerLocation | null;
+/**
+ * The `componentId` of the nearest ANCESTOR of `nodeId` that is itself a linked
+ * component instance, or null when every ancestor is ordinary content.
+ *
+ * WHY THIS EXISTS (kywi-cms#147 T3 review, I1). Connecting a node that lives
+ * inside an already-linked ancestor silently destroys data:
+ *
+ *  - the connect writes the node as a CLEAN instance (`props: { componentId }`),
+ *    replacing the content stored for it in the page's document — but that
+ *    document is the ancestor's inline FALLBACK copy, so what was overwritten is
+ *    the only thing the page can render when the ancestor's component cannot be
+ *    resolved;
+ *  - `collectComponentRefs` deliberately stops at a connected node, so the new
+ *    link is invisible to the instance index, the usage counts and the delete
+ *    gate, and the render-side placement pass strips it structurally;
+ *  - so the moment the outer component becomes unresolvable, the inner node
+ *    renders EMPTY, with nothing left to recover it from.
+ *
+ * A node's OWN `componentId` is deliberately not considered: this answers "is
+ * this node inside somebody ELSE's component?", which is the question both the
+ * chrome gating and the hard refusal in `useComponentConnect` ask. A linked
+ * SIBLING is not an ancestor and must not block anything.
+ */
+export declare function findLinkedAncestor(regions: Record<string, RegionNode[]>, nodeId: string): string | null;
+/**
+ * {@link findLinkedAncestor} as a yes/no, over a document's own regions.
+ *
+ * Regions only, exactly like the document readers below and for the same reason:
+ * the shells resolve their selection from `layout.regions` too, so a node living
+ * in a `pageVariants` / `abExperiments` region cannot be saved or linked through
+ * them at all (the lookup fails first). The canvas's own gating does not depend on
+ * this function — it threads `linkedAncestor` structurally, from where it is
+ * rendering — so variant regions are gated in the UI regardless.
+ */
+export declare function hasLinkedAncestor(layout: LayoutDocument, nodeId: string): boolean;
 export declare function findModuleInDocument(layout: LayoutDocument, moduleId: string): ModuleNode | null;
 export declare function findSectionInDocument(layout: LayoutDocument, sectionId: string): LayoutSection | null;
 export declare function findVariantContainerInDocument(layout: LayoutDocument, containerId: string): VariantContainer | null;

package/dist/admin/layout-editor/node-lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-lookup.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/node-lookup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-lookup.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/node-lookup.ts"],"names":[],"mappings":"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"}

package/dist/admin/layout-editor/node-lookup.js

@@ -125,6 +125,97 @@ export function findVariantContainerIn(regions, containerId) {
     }
     return null;
 }
+// ── Linked ancestry (kywi-cms#147) ───────────────────────────────────────────
+/**
+ * Search one array of sections for `nodeId`, carrying the link inherited from
+ * whatever holds those sections. Returns a WRAPPER so "found, no linked
+ * ancestor" (`{ value: null }`) stays distinguishable from "not here" (`null`).
+ */
+function linkedAncestorInSections(sections, nodeId, inherited) {
+    for (const section of sections) {
+        if (!isLayoutSection(section))
+            continue;
+        // The section itself: its own componentId is not an ANCESTOR's.
+        if (section.id === nodeId)
+            return { value: inherited };
+        // Nearest first — a module inside a linked section reports that section,
+        // not the linked container two levels up.
+        const nearest = section.componentId ?? inherited ?? null;
+        for (const column of section.columns) {
+            if (column.id === nodeId)
+                return { value: nearest };
+            for (const module of column.nodes) {
+                if (module.id === nodeId)
+                    return { value: nearest };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * The `componentId` of the nearest ANCESTOR of `nodeId` that is itself a linked
+ * component instance, or null when every ancestor is ordinary content.
+ *
+ * WHY THIS EXISTS (kywi-cms#147 T3 review, I1). Connecting a node that lives
+ * inside an already-linked ancestor silently destroys data:
+ *
+ *  - the connect writes the node as a CLEAN instance (`props: { componentId }`),
+ *    replacing the content stored for it in the page's document — but that
+ *    document is the ancestor's inline FALLBACK copy, so what was overwritten is
+ *    the only thing the page can render when the ancestor's component cannot be
+ *    resolved;
+ *  - `collectComponentRefs` deliberately stops at a connected node, so the new
+ *    link is invisible to the instance index, the usage counts and the delete
+ *    gate, and the render-side placement pass strips it structurally;
+ *  - so the moment the outer component becomes unresolvable, the inner node
+ *    renders EMPTY, with nothing left to recover it from.
+ *
+ * A node's OWN `componentId` is deliberately not considered: this answers "is
+ * this node inside somebody ELSE's component?", which is the question both the
+ * chrome gating and the hard refusal in `useComponentConnect` ask. A linked
+ * SIBLING is not an ancestor and must not block anything.
+ */
+export function findLinkedAncestor(regions, nodeId) {
+    for (const nodes of Object.values(regions)) {
+        for (const node of nodes) {
+            // Region level: a section or container sitting here has no ancestor at all.
+            if (node.id === nodeId)
+                return null;
+            if (isVariantContainer(node)) {
+                const containerLink = node.componentId ?? null;
+                const arms = [
+                    node.defaultSections,
+                    ...node.variants.map(variant => variant.sections),
+                ];
+                for (const arm of arms) {
+                    const hit = linkedAncestorInSections(arm, nodeId, containerLink);
+                    if (hit)
+                        return hit.value;
+                }
+                continue;
+            }
+            if (isLayoutSection(node)) {
+                const hit = linkedAncestorInSections([node], nodeId, null);
+                if (hit)
+                    return hit.value;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * {@link findLinkedAncestor} as a yes/no, over a document's own regions.
+ *
+ * Regions only, exactly like the document readers below and for the same reason:
+ * the shells resolve their selection from `layout.regions` too, so a node living
+ * in a `pageVariants` / `abExperiments` region cannot be saved or linked through
+ * them at all (the lookup fails first). The canvas's own gating does not depend on
+ * this function — it threads `linkedAncestor` structurally, from where it is
+ * rendering — so variant regions are gated in the UI regardless.
+ */
+export function hasLinkedAncestor(layout, nodeId) {
+    return findLinkedAncestor(layout.regions, nodeId) !== null;
+}
 // ── Document-level readers ───────────────────────────────────────────────────
 //
 // Read-only convenience for the editor shells, which resolve the current