@kywi-software/core 0.10.0 → 0.12.0

package/dist/admin/layout-editor/use-chrome-flip.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-chrome-flip.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/use-chrome-flip.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB,4EAA4E;AAC5E,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,CAAA;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA6C,EAC7C,OAAO,GAAG,IAAI;IAEd,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAgB,IAAI,CAAC,CAAA;IAE7E,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAC9C,gBAAgB,CAAC,IAAI,CAAC,CAAA;YACtB,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAA;YAC9B,IAAI,CAAC,KAAK;gBAAE,OAAM;YAClB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,qBAAqB,EAAE,CAAA;YACrD,IAAI,GAAG,IAAI,YAAY,EAAE,CAAC;gBACxB,gBAAgB,CAAC,IAAI,CAAC,CAAA;gBACtB,OAAM;YACR,CAAC;YACD,yEAAyE;YACzE,sEAAsE;YACtE,0EAA0E;YAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC,CAAA;YAC/C,yEAAyE;YACzE,0EAA0E;YAC1E,wEAAwE;YACxE,sEAAsE;YACtE,sEAAsE;YACtE,+CAA+C;YAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAA;YAC1D,sEAAsE;YACtE,wEAAwE;YACxE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;QAChE,CAAC,CAAA;QAED,OAAO,EAAE,CAAA;QACT,wEAAwE;QACxE,yEAAyE;QACzE,0DAA0D;QAC1D,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAW,CAAA;QACjE,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAA;QAC3D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAA;QAC3D,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAA;YAC9D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,CAAA;QAChE,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAEvB,OAAO,aAAa,CAAA;AACtB,CAAC"}
+{"version":3,"file":"use-chrome-flip.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/use-chrome-flip.ts"],"names":[],"mappings":"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"}

package/dist/admin/layout-editor/use-component-connect.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { LayoutDocument } from '../../layout/types.js';
+import type { EditorAction } from './editor-state.js';
+import type { ComponentAffordances } from './linked-component.js';
+import type { ComponentLibrary } from './use-component-library.js';
+/**
+ * use-component-connect.tsx
+ * The save-as-component → POST → connect-in-place flow, and detach, for BOTH
+ * editor shells (kywi-cms#147).
+ *
+ * This is one implementation on purpose. The admin Layout tab already had two
+ * near-copies of the flow (one for modules, one for sections), each with its own
+ * `window.prompt`, its own fetch and its own error swallowing, and the overlay
+ * shell had none — so adding containers would have made six. The shells now
+ * differ only in where they render the dialog and which selection they hand in.
+ */
+interface ComponentConnectArgs {
+    layout: LayoutDocument;
+    dispatch: React.Dispatch<EditorAction>;
+    library: ComponentLibrary;
+}
+export interface ComponentConnect {
+    /** Chrome affordances for `EditorCanvas` (stable reference — it is memoized). */
+    affordances: ComponentAffordances;
+    /** The open save dialog, or null. Render anywhere: it portals to the body. */
+    dialog: React.ReactNode;
+    saveModule: (moduleId: string) => void;
+    saveSection: (sectionId: string) => void;
+    saveVariantContainer: (containerId: string) => void;
+    detachModule: (moduleId: string) => void;
+    detachSection: (sectionId: string) => void;
+    detachVariantContainer: (containerId: string) => void;
+    /** Point an unlinked `component` placeholder node at a saved component. */
+    linkModule: (moduleId: string, componentId: string) => void;
+    /**
+     * Does this node live inside ANOTHER node's linked component instance?
+     *
+     * Every component action is refused there (the reasoning is at
+     * `isInsideLinkedComponent` below, and at `findLinkedAncestor`), and a refusal
+     * the owner can click is worse than one they never see — so the
+     * surfaces that offer those actions ask this and simply do not offer them. The
+     * canvas threads the same fact down its own tree (`linkedAncestor`); the props
+     * rail, which addresses whatever is selected, asks here.
+     */
+    isInsideLinkedComponent: (nodeId: string) => boolean;
+}
+/**
+ * The server's own words for a refused component write, details included.
+ *
+ * `readError` (host-client) reports only `error.message`, which for a rejected
+ * definition is the generic "Validation failed" — the useful half is in
+ * `details[]` ("A component definition may not link to another component…").
+ * The owner is looking at a dialog they cannot get past, so they get the reason.
+ *
+ * Shared with the save fork (`use-component-fork.tsx`), which puts a refused
+ * definition PUT in front of the owner for the same reason.
+ */
+export declare function componentErrorMessage(res: Response): Promise<string>;
+export declare function useComponentConnect({ layout, dispatch, library, }: ComponentConnectArgs): ComponentConnect;
+export {};
+//# sourceMappingURL=use-component-connect.d.ts.map

package/dist/admin/layout-editor/use-component-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-component-connect.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/use-component-connect.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAA+C,MAAM,uBAAuB,CAAA;AAExG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAgBrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,4BAA4B,CAAA;AAEnF;;;;;;;;;;GAUG;AAEH,UAAU,oBAAoB;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IACtC,OAAO,EAAE,gBAAgB,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,WAAW,EAAE,oBAAoB,CAAA;IACjC,8EAA8E;IAC9E,MAAM,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,oBAAoB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,sBAAsB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,2EAA2E;IAC3E,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3D;;;;;;;;;OASG;IACH,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CACrD;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1E;AAED,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,QAAQ,EACR,OAAO,GACR,EAAE,oBAAoB,GAAG,gBAAgB,CAyTzC"}

package/dist/admin/layout-editor/use-component-connect.js

@@ -0,0 +1,292 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { adminFetch } from '../../host-client/index.js';
+import { countComponentLinksToFlatten, detachModuleFromComponent, detachSectionFromComponent, detachVariantContainerFromComponent, flattenComponentLinks, saveAsComponent, } from './component-actions.js';
+import { findModuleInDocument, findSectionInDocument, findVariantContainerInDocument, hasLinkedAncestor, } from './node-lookup.js';
+import { ComponentSaveDialog } from './editor-dialog.js';
+/**
+ * The server's own words for a refused component write, details included.
+ *
+ * `readError` (host-client) reports only `error.message`, which for a rejected
+ * definition is the generic "Validation failed" — the useful half is in
+ * `details[]` ("A component definition may not link to another component…").
+ * The owner is looking at a dialog they cannot get past, so they get the reason.
+ *
+ * Shared with the save fork (`use-component-fork.tsx`), which puts a refused
+ * definition PUT in front of the owner for the same reason.
+ */
+export async function componentErrorMessage(res) {
+    try {
+        const body = (await res.json());
+        const detail = body.error?.details?.map(d => d.message).filter(Boolean).join('; ');
+        if (detail)
+            return detail;
+        if (body.error?.message)
+            return body.error.message;
+    }
+    catch {
+        /* non-JSON body — fall through to the status line */
+    }
+    return `Could not save the component (${res.status}).`;
+}
+export function useComponentConnect({ layout, dispatch, library, }) {
+    const [pending, setPending] = React.useState(null);
+    const [busy, setBusy] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    /**
+     * Is `nodeId` inside another node's component instance? (kywi-cms#147 T3
+     * review, I1.)
+     *
+     * THE HOLE THIS CLOSES. Connecting a node that sits inside an already-linked
+     * ancestor writes a bare link into what is really the ancestor's inline
+     * FALLBACK copy: the content that node used to hold is gone from the stored
+     * document, and the new link is invisible to `collectComponentRefs` (it stops
+     * at the connected ancestor), so it never reaches the instance index, the usage
+     * counts or the delete gate, and the render-side placement pass strips it. The
+     * page looks fine right up to the moment the outer component stops resolving —
+     * and then that node renders EMPTY with nothing to recover it from.
+     *
+     * The gate lives HERE, not only in the canvas chrome, because the canvas is
+     * not the only caller: the props rail addresses the current selection and would
+     * otherwise reach `saveModule` / `saveSection` / `linkModule` directly. The
+     * canvas threading (`linkedAncestor`) and the rail's `isInsideLinkedComponent`
+     * make the actions invisible; this makes them impossible.
+     */
+    const isInsideLinkedComponent = React.useCallback((nodeId) => hasLinkedAncestor(layout, nodeId), [layout]);
+    const openSave = React.useCallback((kind, nodeId) => {
+        if (hasLinkedAncestor(layout, nodeId))
+            return;
+        setError(null);
+        setBusy(false);
+        setPending({ kind, nodeId });
+    }, [layout]);
+    const closeSave = React.useCallback(() => {
+        setPending(null);
+        setBusy(false);
+        setError(null);
+    }, []);
+    const saveModule = React.useCallback((moduleId) => openSave('module', moduleId), [openSave]);
+    const saveSection = React.useCallback((sectionId) => openSave('section', sectionId), [openSave]);
+    const saveVariantContainer = React.useCallback((containerId) => openSave('variantContainer', containerId), [openSave]);
+    // ── Connect in place ───────────────────────────────────────────────────────
+    //
+    // Each of these swaps the source node for a CLEAN linked instance, keeping its
+    // id and its position (that is what REPLACE_* exist for). "Clean" means the
+    // node carries no local content of its own, which is what makes the link
+    // STRICT: `isCleanComponentInstance` reads exactly this shape, and the renderer
+    // then draws the definition alone rather than merging the node's props over it.
+    //
+    // The node handed in is the FLATTENED one — the same tree that was just stored
+    // as the definition — so a freshly connected instance's fallback copy holds the
+    // same CONTENT the link resolves to. (Not byte-identical: rendering a resolved
+    // definition re-keys its ids per placement — `${nodeId}:${storedId}`, see
+    // `rekeyResolvedSection` — so the ids differ by construction. What matters is
+    // that the props, style and structure agree, which is what makes an
+    // unresolvable link degrade to the same page rather than a different one.)
+    // Keeping the pre-flatten copy would instead leave a nested link sitting in the
+    // page's fallback data: unindexed (`collectComponentRefs` stops at a connected
+    // node), unrendered, and able to reappear if the outer component ever became
+    // unresolvable.
+    const connectModule = React.useCallback((node, componentId) => {
+        dispatch({
+            type: 'REPLACE_MODULE',
+            moduleId: node.id,
+            node: { ...node, componentId, props: { componentId }, style: {} },
+        });
+    }, [dispatch]);
+    const connectSection = React.useCallback((section, componentId) => {
+        dispatch({
+            type: 'REPLACE_SECTION',
+            sectionId: section.id,
+            section: { ...section, componentId },
+        });
+    }, [dispatch]);
+    const connectVariantContainer = React.useCallback((container, componentId) => {
+        // `experimentId` / `winnerId` stay exactly as the page has them: they bind
+        // THIS page's container to THIS page's experiment run, and
+        // `applyVariantContainerPlacement` gives the placement's binding priority
+        // over the definition's for precisely that reason. Connecting must not
+        // silently re-point a live experiment at the saved component's.
+        dispatch({
+            type: 'REPLACE_VARIANT_CONTAINER',
+            containerId: container.id,
+            container: { ...container, componentId },
+        });
+    }, [dispatch]);
+    const linkModule = React.useCallback((moduleId, componentId) => {
+        const node = findModuleInDocument(layout, moduleId);
+        if (!node)
+            return;
+        // Same refusal as saving, for the same reason: this link would live in
+        // another component's fallback copy, where nothing can see it.
+        if (hasLinkedAncestor(layout, moduleId))
+            return;
+        connectModule(node, componentId);
+    }, [layout, connectModule]);
+    // ── The save itself ────────────────────────────────────────────────────────
+    const submitSave = React.useCallback(async (name, description) => {
+        if (!pending)
+            return;
+        const { kind, nodeId } = pending;
+        const source = kind === 'module'
+            ? findModuleInDocument(layout, nodeId)
+            : kind === 'section'
+                ? findSectionInDocument(layout, nodeId)
+                : findVariantContainerInDocument(layout, nodeId);
+        if (!source) {
+            setError('That element is no longer on the page.');
+            return;
+        }
+        // Materialise any component link INSIDE the selection before storing it:
+        // the API refuses a definition that links to another component, so without
+        // this a section holding a connected module would simply 400 (kywi-cms#147,
+        // ledger C2b). Flattening is idempotent, so passing the flattened node to
+        // `saveAsComponent` below re-walks it and finds nothing left to do.
+        const flattened = flattenComponentLinks(source, library.lookup);
+        const input = saveAsComponent(flattened, name, {
+            ...(description ? { description } : {}),
+            resolveLink: library.lookup,
+        });
+        setBusy(true);
+        setError(null);
+        try {
+            const res = await adminFetch('/api/v1/components', {
+                method: 'POST',
+                body: JSON.stringify(input),
+            });
+            if (!res.ok) {
+                setError(await componentErrorMessage(res));
+                setBusy(false);
+                return;
+            }
+            const body = (await res.json());
+            const created = body.data;
+            if (!created?.id) {
+                setError('The server did not return the saved component.');
+                setBusy(false);
+                return;
+            }
+            library.add(created);
+            if (kind === 'module')
+                connectModule(flattened, created.id);
+            else if (kind === 'section')
+                connectSection(flattened, created.id);
+            else
+                connectVariantContainer(flattened, created.id);
+            closeSave();
+        }
+        catch {
+            // Network-level failure: the node stays exactly as it was, unlinked.
+            setError('Could not reach the server. Nothing was changed.');
+            setBusy(false);
+        }
+    }, [pending, layout, library, connectModule, connectSection, connectVariantContainer, closeSave]);
+    // ── Detach ────────────────────────────────────────────────────────────────
+    //
+    // Materialise the component's CURRENT definition into the node and drop the
+    // link, through the helpers the server-side detach-all shares — so detaching
+    // one instance here and detaching every instance from the API produce
+    // byte-identical nodes for the same placement.
+    const detachModule = React.useCallback((moduleId) => {
+        const node = findModuleInDocument(layout, moduleId);
+        if (!node?.componentId)
+            return;
+        dispatch({
+            type: 'REPLACE_MODULE',
+            moduleId,
+            node: detachModuleFromComponent(node, library.byId(node.componentId)),
+        });
+        dispatch({ type: 'DESELECT' });
+    }, [layout, library, dispatch]);
+    const detachSection = React.useCallback((sectionId) => {
+        const section = findSectionInDocument(layout, sectionId);
+        if (!section?.componentId)
+            return;
+        dispatch({
+            type: 'REPLACE_SECTION',
+            sectionId,
+            section: detachSectionFromComponent(section, library.byId(section.componentId)),
+        });
+        dispatch({ type: 'DESELECT' });
+    }, [layout, library, dispatch]);
+    const detachVariantContainer = React.useCallback((containerId) => {
+        const container = findVariantContainerInDocument(layout, containerId);
+        if (!container?.componentId)
+            return;
+        dispatch({
+            type: 'REPLACE_VARIANT_CONTAINER',
+            containerId,
+            container: detachVariantContainerFromComponent(container, library.byId(container.componentId)),
+        });
+        dispatch({ type: 'DESELECT' });
+    }, [layout, library, dispatch]);
+    // ── Canvas chrome ─────────────────────────────────────────────────────────
+    const affordances = React.useMemo(() => ({
+        nameOf: library.nameOf,
+        onSaveModule: saveModule,
+        onSaveSection: saveSection,
+        onSaveVariantContainer: saveVariantContainer,
+    }), [library.nameOf, saveModule, saveSection, saveVariantContainer]);
+    // A container is a "personalized section" or an "A/B tested section" — the
+    // dialog cannot know which from the granularity, and the canvas names it that
+    // way in its own badge, so tell it.
+    const pendingSubject = () => {
+        if (!pending || pending.kind !== 'variantContainer')
+            return undefined;
+        const container = findVariantContainerInDocument(layout, pending.nodeId);
+        if (!container)
+            return undefined;
+        return container.mode === 'ab_test' ? 'A/B tested section' : 'personalized section';
+    };
+    /**
+     * How many component links sit INSIDE the pending selection.
+     *
+     * Saving materialises them (the API refuses a definition that links out), which
+     * means those inner instances stop following their own source — a real change
+     * to the page, not a formality, so it is said out loud before the owner commits
+     * rather than discovered later when editing the inner component changes nothing
+     * here.
+     *
+     * Counted by RUNNING the flattening (`countComponentLinksToFlatten`), not by
+     * asking `collectComponentRefs` (kywi-cms#147 T3 review, M2): that walker stops
+     * at a connected node, so a link hidden inside a connected node's inline
+     * fallback copy — the case an unresolvable inner link produces — is invisible to
+     * it while the flattening rewrites it on the next pass regardless. The disclosure
+     * has to match what the save actually does.
+     *
+     * The selection's own link is subtracted, though it is never present: saving an
+     * already-linked node as a new component is not offered anywhere.
+     */
+    const pendingNestedLinks = () => {
+        if (!pending || pending.kind === 'module')
+            return 0;
+        const node = pending.kind === 'section'
+            ? findSectionInDocument(layout, pending.nodeId)
+            : findVariantContainerInDocument(layout, pending.nodeId);
+        if (!node)
+            return 0;
+        const total = countComponentLinksToFlatten(node, library.lookup);
+        return Math.max(0, total - (node.componentId ? 1 : 0));
+    };
+    const subject = pendingSubject();
+    const nested = pendingNestedLinks();
+    const notice = nested > 0
+        ? `${nested} linked component${nested === 1 ? '' : 's'} inside will be copied into this one, ` +
+            `and ${nested === 1 ? 'that instance' : 'those instances'} will stop following ${nested === 1 ? 'its' : 'their'} source.`
+        : null;
+    const dialog = pending ? (_jsx(ComponentSaveDialog, { kind: pending.kind, ...(subject ? { subject } : {}), ...(notice ? { notice } : {}), busy: busy, error: error, onCancel: closeSave, onSubmit: (name, description) => { void submitSave(name, description); } })) : null;
+    return {
+        affordances,
+        dialog,
+        saveModule,
+        saveSection,
+        saveVariantContainer,
+        detachModule,
+        detachSection,
+        detachVariantContainer,
+        linkModule,
+        isInsideLinkedComponent,
+    };
+}
+//# sourceMappingURL=use-component-connect.js.map

package/dist/admin/layout-editor/use-component-connect.js.map

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

package/dist/admin/layout-editor/use-component-fork.d.ts

@@ -0,0 +1,123 @@
+import React from 'react';
+import type { LayoutDocument } from '../../layout/types.js';
+import type { EditorAction } from './editor-state.js';
+import { type ComponentForkSaveMode } from './editor-dialog.js';
+import type { ComponentLibrary } from './use-component-library.js';
+/**
+ * use-component-fork.tsx
+ * The save fork, driven (kywi-cms#147 T4). One implementation for both editor
+ * shells, as with the connect flow.
+ *
+ * WHAT IT DOES TO A SAVE. Every save path in both shells goes through
+ * {@link ComponentFork.guardSave} instead of handing `state.layout` straight to
+ * its callback. With no edited linked instances that is a pass-through — the
+ * document goes out unchanged, and nothing about saving has changed. With one or
+ * more, the save is INTERRUPTED: the owner answers per component, the answers are
+ * applied to the document, the definitions that need writing are written, and
+ * only then does the save proceed — with the resolved document, so the page that
+ * lands on the server is one whose linked instances are all coherent again.
+ *
+ * ORDERING, AND THE PARTIAL STATE IT ADMITS TO. Component definitions are PUT
+ * first, the page second. That is the safer order of the two: a definition write
+ * is idempotent and self-contained (it makes every instance render the edit, on
+ * this page too — resolution is live), whereas a page write that landed before a
+ * failed definition write would leave the page storing a CLEAN instance of a
+ * definition that never received the edit, i.e. the edit deleted. The remaining
+ * failure — definitions written, page save failed — is real and is SAID rather
+ * than hidden: the message names it, nothing is marked saved, the document stays
+ * dirty, and retrying re-runs the same idempotent PUT and saves again.
+ *
+ * THE SECOND DOOR, AND WHY IT IS NOW SHUT (kywi-cms#147 T4 review, I1). The fork
+ * sits on the EDITOR's own save paths. The admin Layout tab used to also stage
+ * every edit into the surrounding content form (`onChange` → `handleChange`), so a
+ * page-level form Submit persisted a layout the fork had never seen, and switching
+ * tabs remounted the editor with that staged document as its new baseline — which
+ * made the staged state permanent rather than provisional. For a SECTION or
+ * CONTAINER instance the consequence was worse than a stray override: those resolve
+ * WHOLESALE, so the edit sat in a fallback copy the renderer never reads. It was
+ * persisted and never rendered, and the following editor session took it as the
+ * baseline, so nothing normalised it either.
+ *
+ * `content-form.tsx` therefore no longer stages the layout, and no longer sends it
+ * with the page form — the Layout tab's own Save is the layout's save path, and the
+ * fork is on it. The one exception is a page being CREATED, where there is no
+ * content row to PUT a layout against and the create payload is the only door
+ * there is; a first-save page's linked instances were all connected in this same
+ * session, so their definitions were written by the connect flow moments earlier.
+ * The front-of-site overlay — the primary editing surface — never had a second door.
+ */
+/** What the shell hands over: persist this document, report whether it landed. */
+export type PerformSave = (layout: LayoutDocument) => boolean | void | Promise<boolean | void>;
+export interface ComponentFork {
+    /** The open fork dialog, or null. Render anywhere — it portals to the body. */
+    dialog: React.ReactNode;
+    /**
+     * Run a save, asking about edited linked instances first.
+     *
+     * `perform` must be the shell's own persist step and must REPORT the outcome
+     * the way `onSave` does (`false`/rejection = did not persist), or a failed page
+     * save after a successful definition write cannot be told apart from a clean
+     * one.
+     *
+     * `mode` is which button was pressed, and only changes what the dialog SAYS: a
+     * component write is immediate whichever one it was, which is exactly the thing
+     * "Save Draft" and "Schedule" imply is not happening.
+     */
+    guardSave: (perform: PerformSave, mode?: ComponentForkSaveMode) => void;
+}
+export declare function useComponentFork({ layout, originalLayout, dispatch, library, inlineEditActive, inert, }: {
+    layout: LayoutDocument;
+    /** The last-saved document — the baseline an instance is "edited" against. */
+    originalLayout: LayoutDocument;
+    dispatch: React.Dispatch<EditorAction>;
+    library: ComponentLibrary;
+    /**
+     * True while the front-of-site overlay has a LIVE inline text edit open —
+     * i.e. `OverlayShell`'s own `textEdit.id !== null` (kywi-cms#147 T4 review
+     * round 2). The admin canvas never has one (module-overlay.tsx: "admin canvas
+     * never carries `inlineEdit`"), so it simply never passes this.
+     *
+     * Why the fallback-copy refresh below needs to know: an inline edit's
+     * keystrokes live in the DOM only until commit (blur/Enter), so
+     * `state.isDirty` — which the reducer's REFRESH_COMPONENT_COPIES case already
+     * refuses to touch — never sees them. A library load landing mid-session finds
+     * a document the reducer calls pristine and refreshes it anyway. Worse than an
+     * ordinary stale-copy overwrite: `rekeyResolvedSection` gives the refreshed
+     * copy the exact ids the placement already had, so React updates the bound
+     * element's text IN PLACE instead of remounting it — the #145 orphan recovery
+     * (`isOrphanedEdit` in module-overlay.tsx) exists for a bound element that
+     * DISCONNECTS, and this element never does, so recovery never fires. The
+     * result (pinned in `overlay-refresh-mid-inline-edit.test.tsx`) is a session
+     * that looks perfectly healthy — still `contenteditable`, no cancel, no error
+     * — while the refresh has silently overwritten whatever was typed with the
+     * definition's current value.
+     */
+    inlineEditActive?: boolean;
+    /**
+     * THE DOCUMENT IS NOT A PAGE, so there is no fork (kywi-cms#147 T5 review I1,
+     * final review M2). Set only by `LayoutEditor`'s `canvasKind` — the admin
+     * `components.edit` definition canvas, and the standalone Layouts editor's
+     * blueprint canvas.
+     *
+     * WHY INERT AND NOT "CAREFUL". The fork's question is "does this edit belong to
+     * the component, or to this page only?" — and on neither canvas is there a "this
+     * page". On a definition canvas the answer is fixed before the question (a
+     * definition save IS the propagation) and every branch behind it is wrong:
+     * "update all" would PUT some OTHER component's definition (whatever the edited
+     * node happened to link to) and only then let the definition save be refused by
+     * the extract's nested-link check — a site-wide write nobody asked for, in place
+     * of the one they did — while "this page only" would detach a node inside a
+     * definition. On a blueprint canvas the blast radius the dialog would name is not
+     * even readable: blueprints are outside the instance index, so a linked node in
+     * one reports "0 instances across 0 pages" and every number in the fork's copy
+     * would be a lie.
+     *
+     * `guardSave` therefore passes straight through, no dialog is ever built, and the
+     * fallback-copy refresh is skipped too: refreshing rewrites a linked node's
+     * inline copy from the library, which inside a definition would be silently
+     * editing stored content the owner never touched, and inside a blueprint would
+     * rewrite a stencil nobody opened for that.
+     */
+    inert?: boolean;
+}): ComponentFork;
+//# sourceMappingURL=use-component-fork.d.ts.map

package/dist/admin/layout-editor/use-component-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-component-fork.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/use-component-fork.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAA+C,MAAM,uBAAuB,CAAA;AAUxG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAUrD,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAIH,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,cAAc,KACnB,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;AAE7C,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,MAAM,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB;;;;;;;;;;;OAWG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAA;CACxE;AA6BD,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,cAAc,EACd,QAAQ,EACR,OAAO,EACP,gBAAwB,EACxB,KAAa,GACd,EAAE;IACD,MAAM,EAAE,cAAc,CAAA;IACtB,8EAA8E;IAC9E,cAAc,EAAE,cAAc,CAAA;IAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IACtC,OAAO,EAAE,gBAAgB,CAAA;IACzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,aAAa,CA+RhB"}