@kywi-software/core 0.11.0 → 0.12.1

package/dist/admin/layout-editor/editor.css

@@ -83,6 +83,19 @@
   --kywi-editor-ease: 140ms cubic-bezier(0.2, 0.7, 0.2, 1);
   --kywi-editor-focus: 0 0 0 2px var(--kywi-editor-panel-bg), 0 0 0 4px var(--kywi-editor-accent-ring);
 
+  /* Linked components (kywi-cms#147).
+     Deliberately NOT derived from --kywi-editor-accent: "selected" is the accent
+     in both shells (indigo on the front end, green under admin.css's bridge —
+     kywi-cms#144), so a linked instance keyed off the accent would read as
+     selected in one theme and as nothing in particular in the other. A fixed
+     fuchsia is distinct from BOTH accents, which is the whole job of this
+     affordance, and it therefore needs no bridge entry in the (locked) admin.css
+     — the same colour means the same thing in both editors. */
+  --kywi-editor-linked: #c026d3;
+  --kywi-editor-linked-soft: rgba(192, 38, 211, 0.16);
+  --kywi-editor-linked-ring: rgba(192, 38, 211, 0.45);
+  --kywi-editor-on-linked: #ffffff;
+
   --kywi-editor-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
   --kywi-editor-panel-width-left: 232px;
   --kywi-editor-panel-width-right: 288px;
@@ -2029,8 +2042,12 @@ input[type="color"].kywi-token-raw-input { height: 34px; padding: 3px; cursor: p
    Invisible AND click-through until its owner is hovered or selected, so the
    page never collects stray editor hit-targets.
 
-   Five-tier stacking contract, all keyed off one variable so the tiers can
-   never drift apart (kywi-cms#118, extended by #124):
+   Stacking contract, all keyed off one variable so the tiers can never drift
+   apart (kywi-cms#118, extended by #124 and #147):
+     .kywi-editor-dialog-overlay (the editor's = var(--kywi-z-overlay, 1000) + 2  = 1002
+       own modal — save-as-component, the save
+       fork — which can be opened from inside
+       any of the surfaces below it, #147)
      .kywi-editor-template-overlay (section-  = var(--kywi-z-overlay, 1000) + 1  = 1001
        template picker modal)
      .kywi-overlay-toolbar (fixed edit bar)  = var(--kywi-z-overlay, 1000)         = 1000
@@ -2305,6 +2322,266 @@ input[type="color"].kywi-token-raw-input { height: 34px; padding: 3px; cursor: p
 .kywi-ip-vc:hover .kywi-ip-add-arm-section,
 .kywi-ip-vc--selected .kywi-ip-add-arm-section { opacity: 1; }
 
+/* ============================================================================
+   Linked component instances (kywi-cms#147)
+   A linked instance is ordinary-looking content that is shared with every other
+   instance of the same component, so editing it is never a local act. Both
+   editors therefore mark it two ways: a distinct OUTLINE (never a border — an
+   affordance must not move the page by a pixel, see the in-place selection rules
+   above) and a NAMED pill in whatever chrome already floats above the node.
+
+   The pill is always visible, unlike hover chrome: "which of these bands is
+   shared?" has to be answerable before the owner reaches for one. It is also
+   `pointer-events: none` — it is a label, not a control, and it must never take a
+   click meant for the content underneath.
+
+   Selection still wins visually where the two meet: a selected linked node shows
+   the accent outline (it is what the owner just clicked) with the pill still
+   naming the component.
+   ========================================================================== */
+
+.kywi-editor-linked-pill {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  height: 18px;
+  padding: 0 8px;
+  border-radius: var(--kywi-editor-radius-pill);
+  background: var(--kywi-editor-linked);
+  color: var(--kywi-editor-on-linked);
+  font-family: var(--kywi-editor-font);
+  font-size: 9.5px;
+  font-weight: 700;
+  letter-spacing: 0.04em;
+  white-space: nowrap;
+  max-width: 190px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.kywi-editor-linked-pill svg { flex-shrink: 0; }
+
+/* Artboard (admin Layout tab) */
+.kywi-editor-section--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: -1.5px;
+}
+.kywi-editor-vc--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: -1.5px;
+}
+.kywi-editor-module--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: 1px;
+}
+.kywi-editor-module-linked-tag {
+  position: absolute;
+  top: -10px;
+  right: 10px;
+  z-index: 3;
+  pointer-events: none;
+}
+
+/* In place (front-of-site overlay) */
+.kywi-ip-section--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: -1.5px;
+}
+.kywi-ip-section--linked.kywi-ip-section--selected,
+.kywi-ip-section--linked.kywi-ip-section--selected:hover {
+  outline: 2px solid var(--kywi-editor-accent);
+  outline-offset: -2px;
+}
+.kywi-ip-vc--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: 2px;
+}
+.kywi-ip-vc--linked.kywi-ip-vc--selected,
+.kywi-ip-vc--linked.kywi-ip-vc--selected:hover {
+  outline: 2px solid var(--kywi-editor-accent);
+  outline-offset: 2px;
+}
+.kywi-ip-module--linked {
+  outline: 1.5px solid var(--kywi-editor-linked);
+  outline-offset: 2px;
+}
+.kywi-ip-module--linked.kywi-ip-module--selected,
+.kywi-ip-module--linked.kywi-ip-module--selected:hover {
+  outline: 2px solid var(--kywi-editor-accent);
+  outline-offset: 2px;
+}
+/* Above the module, right-aligned: the type chip sits above-left and the action
+   cluster inside top-right, so this collides with neither. Takes the page-flow
+   chrome z-tier through its own rule rather than by joining
+   `.kywi-ip-chrome, .kywi-ip-chip` — that shared rule also resets opacity and
+   pointer-events, which is exactly what this must not inherit. */
+.kywi-ip-module-linked-tag {
+  position: absolute;
+  top: 0;
+  right: 0;
+  transform: translateY(-100%);
+  z-index: calc(var(--kywi-z-overlay, 1000) - 2);
+  pointer-events: none;
+}
+
+/* ============================================================================
+   Editor dialog (kywi-cms#147)
+   The editor's own modal, used by "Save as component" and by the save fork. It
+   renders in BOTH shells through a portal to `document.body`, wrapped in
+   `.kywi-admin-shell.kywi-overlay-dialog-host` — so it is styled entirely from
+   `--kywi-editor-*` tokens and comes out indigo on the front end and green in the
+   admin Layout tab with no second rule set (kywi-cms#144).
+   ========================================================================== */
+
+.kywi-editor-dialog-overlay {
+  position: fixed;
+  inset: 0;
+  /* One tier above the section-template modal's tier so a dialog opened from
+     inside another surface is never painted under it. */
+  z-index: calc(var(--kywi-z-overlay, 1000) + 2);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--kywi-editor-sp-4);
+  background: rgba(8, 8, 20, 0.55);
+}
+.kywi-editor-dialog {
+  width: 100%;
+  max-width: 420px;
+  box-sizing: border-box;
+  background: var(--kywi-editor-panel-bg);
+  border: 1px solid var(--kywi-editor-border-strong);
+  border-radius: var(--kywi-editor-radius-lg);
+  box-shadow: var(--kywi-editor-shadow-pop);
+  color: var(--kywi-editor-panel-text);
+  font-family: var(--kywi-editor-font);
+  font-size: 13px;
+  line-height: 1.45;
+  overflow: hidden;
+}
+.kywi-editor-dialog-header {
+  padding: var(--kywi-editor-sp-4) var(--kywi-editor-sp-5) 0;
+}
+.kywi-editor-dialog-title {
+  font-size: 14.5px;
+  font-weight: 700;
+  color: var(--kywi-editor-text-strong);
+}
+.kywi-editor-dialog-body {
+  padding: var(--kywi-editor-sp-3) var(--kywi-editor-sp-5) var(--kywi-editor-sp-2);
+}
+.kywi-editor-dialog-intro {
+  margin: 0 0 var(--kywi-editor-sp-3);
+  font-size: 12.5px;
+  color: var(--kywi-editor-panel-muted);
+}
+/* "Component 1 of 2" — the save fork asks per component, so the owner needs to
+   know a second question is coming (kywi-cms#147 T4). */
+.kywi-editor-dialog-step {
+  margin: 0 0 var(--kywi-editor-sp-2);
+  font-size: 10.5px;
+  font-weight: 650;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--kywi-editor-panel-faint);
+}
+.kywi-editor-dialog-field { margin-bottom: var(--kywi-editor-sp-3); }
+.kywi-editor-dialog-label {
+  display: block;
+  margin-bottom: 5px;
+  font-size: 10.5px;
+  font-weight: 650;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--kywi-editor-panel-muted);
+}
+.kywi-editor-dialog-optional {
+  margin-left: 6px;
+  color: var(--kywi-editor-panel-faint);
+  text-transform: none;
+  letter-spacing: 0;
+  font-weight: 500;
+}
+.kywi-editor-dialog-input {
+  width: 100%;
+  box-sizing: border-box;
+  min-height: 32px;
+  padding: 6px 9px;
+  font-family: inherit;
+  font-size: 12.5px;
+  line-height: 1.4;
+  color: var(--kywi-editor-panel-text);
+  background: var(--kywi-editor-panel-raised-2);
+  border: 1px solid var(--kywi-editor-border-strong);
+  border-radius: var(--kywi-editor-radius-sm);
+}
+.kywi-editor-dialog-input:focus {
+  outline: none;
+  border-color: var(--kywi-editor-accent);
+  box-shadow: 0 0 0 3px var(--kywi-editor-accent-ring);
+}
+.kywi-editor-dialog-textarea { resize: vertical; }
+/* A consequence of the save the owner has to know about before committing (a
+   nested link that is about to be copied in) — informational, not an error. */
+.kywi-editor-dialog-notice {
+  margin: 0 var(--kywi-editor-sp-5) var(--kywi-editor-sp-3);
+  padding: var(--kywi-editor-sp-2) var(--kywi-editor-sp-3);
+  border-left: 2px solid var(--kywi-editor-linked);
+  border-radius: 0 var(--kywi-editor-radius-sm) var(--kywi-editor-radius-sm) 0;
+  background: var(--kywi-editor-linked-soft);
+  color: var(--kywi-editor-panel-text);
+  font-size: 12px;
+}
+.kywi-editor-dialog-error {
+  margin: 0 var(--kywi-editor-sp-5) var(--kywi-editor-sp-2);
+  padding: var(--kywi-editor-sp-2) var(--kywi-editor-sp-3);
+  border-radius: var(--kywi-editor-radius-sm);
+  background: var(--kywi-editor-danger-soft);
+  color: var(--kywi-editor-danger);
+  font-size: 12px;
+}
+.kywi-editor-dialog-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: var(--kywi-editor-sp-2);
+  padding: var(--kywi-editor-sp-3) var(--kywi-editor-sp-5) var(--kywi-editor-sp-4);
+  border-top: 1px solid var(--kywi-editor-hairline);
+}
+.kywi-editor-dialog-btn {
+  min-height: 30px;
+  padding: 0 14px;
+  border-radius: var(--kywi-editor-radius-sm);
+  border: 1px solid transparent;
+  font-family: inherit;
+  font-size: 12.5px;
+  font-weight: 650;
+  cursor: pointer;
+  transition: background var(--kywi-editor-ease), border-color var(--kywi-editor-ease);
+}
+.kywi-editor-dialog-btn:disabled { opacity: 0.55; cursor: default; }
+.kywi-editor-dialog-btn--primary {
+  background: var(--kywi-editor-accent);
+  color: var(--kywi-editor-on-accent);
+}
+.kywi-editor-dialog-btn--primary:hover:not(:disabled) { background: var(--kywi-editor-accent-hover); }
+.kywi-editor-dialog-btn--secondary {
+  background: var(--kywi-editor-panel-raised-solid);
+  border-color: var(--kywi-editor-border-strong);
+  color: var(--kywi-editor-panel-text);
+}
+.kywi-editor-dialog-btn--secondary:hover:not(:disabled) { background: var(--kywi-editor-panel-raised-2); }
+.kywi-editor-dialog-btn--danger {
+  background: var(--kywi-editor-danger-strong);
+  color: #fff;
+}
+
+/* The linked note's second paragraph — the "what the canvas is showing you"
+   aside — is subordinate to the first, not a second headline. */
+.kywi-editor-props-linked-aside {
+  margin-top: var(--kywi-editor-sp-2);
+  color: var(--kywi-editor-panel-muted);
+  font-size: 12px;
+}
+
 /* ============================================================================
    Admin-shell override guard.
    The admin design system (admin.css) sweeps `.kywi-editor-prop-input`,

package/dist/admin/layout-editor/index.d.ts

@@ -2,7 +2,16 @@ export { LayoutEditor } from './layout-editor.js';
 export type { EditorState, EditorAction, VariantArmPatch, VariantContainerPatch, } from './editor-state.js';
 export { ModeToggle } from './mode-toggle.js';
 export { PagePropertiesPanel } from './page-properties.js';
-export { buildConnectedModuleNode, buildConnectedSectionNode, detachModuleFromComponent, detachSectionFromComponent, resolveSectionComponentDefinition, saveAsComponent, saveAsTemplate, cloneSection, cloneModule, copyToClipboard, pasteFromClipboard, type ComponentDefinitionInput, type SectionTemplateInput, type ClipboardPayload, } from './component-actions.js';
+export { buildConnectedModuleNode, buildConnectedSectionNode, buildConnectedVariantContainerNode, flattenComponentLinks, countComponentLinksToFlatten, detachModuleFromComponent, detachSectionFromComponent, detachVariantContainerFromComponent, resolveSectionComponentDefinition, resolveVariantContainerComponentDefinition, saveAsComponent, saveAsTemplate, cloneSection, cloneModule, cloneVariantContainer, copyToClipboard, pasteFromClipboard, type ComponentDefinitionInput, type SaveAsComponentOptions, type SectionTemplateInput, type ClipboardPayload, } from './component-actions.js';
+export { useComponentLibrary } from './use-component-library.js';
+export type { ComponentLibrary, EditorComponent } from './use-component-library.js';
+export { useComponentConnect } from './use-component-connect.js';
+export type { ComponentConnect } from './use-component-connect.js';
+export { findLinkedAncestor, hasLinkedAncestor } from './node-lookup.js';
+export { LinkedComponentPill, linkedComponentName } from './linked-component.js';
+export type { ComponentAffordances } from './linked-component.js';
+export { EditorDialog, ComponentSaveDialog } from './editor-dialog.js';
+export type { EditorDialogAction, ComponentSaveKind } from './editor-dialog.js';
 export { OverlayShell } from './overlay-shell.js';
 export type { OverlayShellProps, SaveAction, ResponsivePreview } from './overlay-shell.js';
 export { TokenColorInput, TokenSpacingInput, TokenTypographyInput, TokenPropField } from './token-inputs.js';

package/dist/admin/layout-editor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,mCAAmC,EACnC,iCAAiC,EACjC,0CAA0C,EAC1C,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAGlE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChF,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACtE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC1F,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/admin/layout-editor/index.js

@@ -1,7 +1,17 @@
 export { LayoutEditor } from './layout-editor.js';
 export { ModeToggle } from './mode-toggle.js';
 export { PagePropertiesPanel } from './page-properties.js';
-export { buildConnectedModuleNode, buildConnectedSectionNode, detachModuleFromComponent, detachSectionFromComponent, resolveSectionComponentDefinition, saveAsComponent, saveAsTemplate, cloneSection, cloneModule, copyToClipboard, pasteFromClipboard, } from './component-actions.js';
+export { buildConnectedModuleNode, buildConnectedSectionNode, buildConnectedVariantContainerNode, flattenComponentLinks, countComponentLinksToFlatten, detachModuleFromComponent, detachSectionFromComponent, detachVariantContainerFromComponent, resolveSectionComponentDefinition, resolveVariantContainerComponentDefinition, saveAsComponent, saveAsTemplate, cloneSection, cloneModule, cloneVariantContainer, copyToClipboard, pasteFromClipboard, } from './component-actions.js';
+// Linked components in the editor (kywi-cms#147): the shared library/connect
+// hooks both shells use, the canvas affordance contract, and the reusable dialog
+// (which the save fork also renders).
+export { useComponentLibrary } from './use-component-library.js';
+export { useComponentConnect } from './use-component-connect.js';
+// "Is this node inside somebody else's component?" — the question every component
+// action is refused on (kywi-cms#147 T3 review, I1).
+export { findLinkedAncestor, hasLinkedAncestor } from './node-lookup.js';
+export { LinkedComponentPill, linkedComponentName } from './linked-component.js';
+export { EditorDialog, ComponentSaveDialog } from './editor-dialog.js';
 export { OverlayShell } from './overlay-shell.js';
 export { TokenColorInput, TokenSpacingInput, TokenTypographyInput, TokenPropField } from './token-inputs.js';
 //# sourceMappingURL=index.js.map

package/dist/admin/layout-editor/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,EACjC,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,kBAAkB,GAInB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin/layout-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,EACrB,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,mCAAmC,EACnC,iCAAiC,EACjC,0CAA0C,EAC1C,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GAKnB,MAAM,wBAAwB,CAAA;AAC/B,6EAA6E;AAC7E,iFAAiF;AACjF,sCAAsC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,kFAAkF;AAClF,qDAAqD;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

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

@@ -35,7 +35,64 @@ interface LayoutEditorProps {
     onChange?: (layout: LayoutDocument) => void;
     /** Current user's role — gates admin-only modules in the palette. */
     userRole?: string;
+    /**
+     * WHAT THE DOCUMENT ON THIS CANVAS ACTUALLY IS. Defaults to `'page'` — a real
+     * piece of content, where every component affordance means what it says.
+     *
+     * The other two values are canvases where the document is NOT a page, and the
+     * component affordances are withheld for the same underlying reason: everything
+     * component-shaped this editor offers is about a PLACEMENT — "save this bit of
+     * the page as a component", "point this placeholder at a component", "drop a
+     * linked copy in here" — and neither of these canvases has placements.
+     *
+     *  - `'definition'` — the document IS a component definition (kywi-cms#147 T5
+     *    review, I1). Set by the admin `components.edit` surface, which seeds a
+     *    one-node document out of a stored definition and PUTs it back.
+     *  - `'blueprint'` — the document is a saved layout / section blueprint
+     *    (kywi-cms#147 final review, M2). Set by the standalone Layouts editor,
+     *    which writes `kywi_section_templates` rows.
+     *
+     * WHY THE DEFINITION CANVAS HAD TO KNOW. Left unsaid, the seeded definition node
+     * looked like an ordinary unlinked section to the rail and to the insert picker,
+     * which offered all three affordances; and the save fork, which exists to ask
+     * "does this edit belong to the component or to this page?", would ask a question
+     * with no second answer. The worst of it was reachable in three clicks: link a
+     * module inside the definition to some OTHER component Z, edit it, press Save.
+     * The fork saw an edited instance of Z, PUT Z's definition site-wide — published
+     * pages included — and only then did the definition extract refuse the nested
+     * link, so the save the owner actually asked for never happened. A write nobody
+     * requested landed; the requested one did not.
+     *
+     * WHY THE BLUEPRINT CANVAS DOES TOO. A blueprint is deliberately not indexed
+     * (the reasoning is at the decision site in `api/section-template-routes.ts`):
+     * `kywi_component_instances` tracks placements in CONTENT, and a blueprint is a
+     * stencil, not a page. So a component minted here, and linked from the blueprint
+     * it was minted out of, is a link nothing can see — its usage count reads "0
+     * instances across 0 pages", and the delete confirmation says so to the owner's
+     * face while a blueprint still renders it. Every claim the feature makes about
+     * blast radius is a claim about content. Saving a component out of a blueprint is
+     * a coherent thing to want, and it needs the index to reach blueprints first; it
+     * is not something to leave half-working with honest-looking copy on top.
+     *
+     * In both non-page modes:
+     *  - "Save as component" (module, section and container), the props rail's
+     *    component picker and the insert picker's component rows are all WITHHELD —
+     *    the same shape as the linked-ancestor withdrawal (T3 review I1), for the
+     *    same reason: an action that cannot cohere is not offered;
+     *  - the save fork is INERT ({@link useComponentFork}'s `inert`) — a definition
+     *    save IS the propagation, and a blueprint save writes a stencil, so in
+     *    neither case is there a "this page" to fork against;
+     *  - everything else — palette, DnD, props and style editing, undo/redo — works
+     *    exactly as it does on a page. The one palette entry that goes is the
+     *    `component` placeholder itself, which here could only ever be a node
+     *    pointing at nothing (see the filter below).
+     *
+     * Detach is deliberately KEPT in both: a definition stored before the nested-link
+     * refusal, or a blueprint saved from a linked section, can still hold a link, and
+     * detaching it is how the owner resolves it.
+     */
+    canvasKind?: 'page' | 'definition' | 'blueprint';
 }
-export declare function LayoutEditor({ initialLayout, moduleRegistry, moduleComponents, onSave, onCancel, audiences, onChange, userRole, }: LayoutEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function LayoutEditor({ initialLayout, moduleRegistry, moduleComponents, onSave, onCancel, audiences, onChange, userRole, canvasKind, }: LayoutEditorProps): import("react/jsx-runtime").JSX.Element;
 export {};
 //# sourceMappingURL=layout-editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"layout-editor.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/layout-editor.tsx"],"names":[],"mappings":"AACA,OAAO,KAA+D,MAAM,OAAO,CAAA;AAEnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAmB9D,OAAO,cAAc,CAAA;AAarB,UAAU,iBAAiB;IACzB,aAAa,EAAE,cAAc,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,cAAc,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC,CAAA;IACzH;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;0EACsE;IACtE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAYD,wBAAgB,YAAY,CAAC,EAC3B,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,EAAE,iBAAiB,2CA8ZnB"}
+{"version":3,"file":"layout-editor.d.ts","sourceRoot":"","sources":["../../../src/admin/layout-editor/layout-editor.tsx"],"names":[],"mappings":"AACA,OAAO,KAAwE,MAAM,OAAO,CAAA;AAE5F,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,uBAAuB,CAAA;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAmB9D,OAAO,cAAc,CAAA;AAIrB,UAAU,iBAAiB;IACzB,aAAa,EAAE,cAAc,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,cAAc,CAAA;IAC9B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC,CAAA;IACzH;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;0EACsE;IACtE,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAA;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,WAAW,CAAA;CACjD;AAYD,wBAAgB,YAAY,CAAC,EAC3B,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,UAAmB,GACpB,EAAE,iBAAiB,2CAsZnB"}