@agent-native/core 0.90.5 → 0.90.8

package/corpus/templates/design/app/components/design/multi-screen/handle-hit-zones.ts

@@ -0,0 +1,124 @@
+// Resize-handle hit-zone geometry for the host-side selection chrome
+// (SelectionBox / screen-frame / draft-primitive handles in
+// MultiScreenCanvas.tsx).
+//
+// The chrome is drawn inside the pan/zoom-scaled world container, so every
+// screen-space size is multiplied by chromeScale (= 1 / zoomScale) to stay a
+// constant size on screen. That compensation is correct for the VISUAL chrome,
+// but it makes handle HIT zones grow without bound in local (board) units as
+// you zoom out: at 19% zoom a nominal 14px edge bar is ~74 local px thick,
+// reaching ~37 local px into the frame from each edge. For any frame shorter
+// than twice that reach, the opposing N/S (or W/E) hit bars overlap and
+// jointly cover the ENTIRE frame body — every press resolves to a resize and
+// the frame can never be grabbed for a move drag (dnd finding: "scale-
+// compensated resize-handle hit-zones can completely cover a selected
+// element's body at low zoom").
+//
+// Figma bar: handles keep their constant on-screen size, but their hit slop
+// must never eat the element's own body — a press near the element's center
+// engages a MOVE at any zoom. These helpers implement that by clamping only
+// the INWARD reach of each hit zone to a fraction of the frame's own
+// dimension, leaving the outward reach (which can never occlude the body)
+// untouched. With HANDLE_MAX_INWARD_FRACTION = 0.25, two opposing handles
+// consume at most half of the frame's dimension, so the central 50% band of
+// each axis is always body-grabbable.
+//
+// Keep in sync with the in-iframe selection chrome's mirror of this clamp in
+// bridge/editor-chrome.bridge.ts (applySelectionHandleHitGeometry /
+// clampHandleInwardReach — bridge files are self-contained, so it ports these
+// pure functions locally with its own nominal handle sizes).
+
+/** Nominal hit slop of an invisible edge-resize bar beyond the frame edge,
+ *  in screen px. Never clamped: space outside the frame can't occlude it. */
+export const EDGE_HANDLE_HIT_OUTWARD_PX = 7;
+
+/** Nominal hit slop of an invisible edge-resize bar into the frame body, in
+ *  screen px. Clamped by clampHandleInwardReach on small/zoomed-out frames. */
+export const EDGE_HANDLE_HIT_INWARD_PX = 7;
+
+/** Visible corner-handle square size, in screen px. The square is also its
+ *  own hit target, so its inward quadrant is subject to the same clamp. */
+export const CORNER_HANDLE_SIZE_PX = 10;
+
+/** Maximum fraction of the frame's own dimension a single handle's hit zone
+ *  may reach inward past the frame edge. 0.25 guarantees the central 50% of
+ *  each axis stays free of handle hit zones (opposing handles reach 25% each),
+ *  so a center press always engages a body move, matching Figma. */
+export const HANDLE_MAX_INWARD_FRACTION = 0.25;
+
+/**
+ * Clamps a handle hit zone's inward reach (local px past the frame edge,
+ * toward the frame center) so it never exceeds HANDLE_MAX_INWARD_FRACTION of
+ * the frame's own dimension on that axis.
+ *
+ * Non-finite or non-positive dimensions (unknown frame size, degenerate
+ * zero-size frames mid-creation) return the nominal reach unchanged — that is
+ * exactly the pre-clamp behavior, and a zero-size frame has no body to
+ * protect.
+ */
+export function clampHandleInwardReach(
+  nominalInward: number,
+  frameDimension: number,
+): number {
+  if (!Number.isFinite(frameDimension) || frameDimension <= 0) {
+    return nominalInward;
+  }
+  return Math.min(nominalInward, frameDimension * HANDLE_MAX_INWARD_FRACTION);
+}
+
+export interface EdgeHandleHitGeometry {
+  /** Total bar thickness along its resize axis, in local px. */
+  thickness: number;
+  /** Offset of the bar's outward side from the frame edge, in local px
+   *  (negative: starts outside the frame). Apply as `top` for the N bar,
+   *  `bottom` for S, `left` for W, `right` for E. */
+  outwardOffset: number;
+}
+
+/**
+ * Hit geometry for an invisible edge-resize bar. `frameDimension` is the
+ * frame's size in local px along the bar's resize axis (height for N/S bars,
+ * width for W/E bars). On large frames this returns the historical geometry
+ * exactly: 14 * chromeScale thick, centered on the edge.
+ */
+export function getEdgeHandleHitGeometry(
+  chromeScale: number,
+  frameDimension: number,
+): EdgeHandleHitGeometry {
+  const outward = EDGE_HANDLE_HIT_OUTWARD_PX * chromeScale;
+  const inward = clampHandleInwardReach(
+    EDGE_HANDLE_HIT_INWARD_PX * chromeScale,
+    frameDimension,
+  );
+  return { thickness: outward + inward, outwardOffset: -outward };
+}
+
+export interface CornerHandleGeometry {
+  /** Square side length in local px (constant CORNER_HANDLE_SIZE_PX on
+   *  screen — the visual size is never clamped, only its placement). */
+  size: number;
+  /** Offset from the frame's vertical edge, in local px (negative: outside).
+   *  Apply as `left` for W-side corners, `right` for E-side corners. */
+  offsetX: number;
+  /** Offset from the frame's horizontal edge, in local px (negative:
+   *  outside). Apply as `top` for N-side corners, `bottom` for S-side. */
+  offsetY: number;
+}
+
+/**
+ * Geometry for a visible corner-handle square. The square keeps its constant
+ * on-screen size, but when its nominal half-inward overlap would exceed the
+ * per-axis clamp (tiny frame and/or low zoom), the square shifts outward so
+ * only the clamped reach overlaps the body. On large frames this returns the
+ * historical geometry exactly: centered on the corner (offset -size / 2).
+ */
+export function getCornerHandleGeometry(
+  chromeScale: number,
+  frameWidth: number,
+  frameHeight: number,
+): CornerHandleGeometry {
+  const size = CORNER_HANDLE_SIZE_PX * chromeScale;
+  const inwardX = clampHandleInwardReach(size / 2, frameWidth);
+  const inwardY = clampHandleInwardReach(size / 2, frameHeight);
+  return { size, offsetX: inwardX - size, offsetY: inwardY - size };
+}

package/corpus/templates/design/app/components/design/multi-screen/types.ts

@@ -222,6 +222,12 @@ export interface MultiScreenCanvasProps {
     /** data-agent-native-node-id of the deepest container at the drop point
      *  inside the target screen iframe (undefined when hit-test timed out). */
     targetAnchorNodeId?: string;
+    /** Pending node id minted by the hit-test bridge for an id-less anchor —
+     *  see CrossScreenHitTestResult.pendingNodeId's doc for the handshake. */
+    targetAnchorPendingNodeId?: string;
+    /** Source-equivalent structural selector locating the pending anchor in
+     *  the persisted dest document (CrossScreenHitTestResult.anchorSelector). */
+    targetAnchorSelector?: string;
     /** DOM insertion placement relative to the anchor node. */
     targetAnchorPlacement?: "before" | "after" | "inside";
     /** Whether the target should receive an in-flow insert or an absolute child. */
@@ -793,6 +799,23 @@ export interface CrossScreenHitTestAnchorRect {
 
 export interface CrossScreenHitTestResult {
   anchorNodeId?: string;
+  /**
+   * Minted by the hit-test bridge when the resolved anchor has no stable id
+   * (AI-generated screens): the anchor's live DOM carries it as
+   * `data-an-pending-node-id`, and `anchorSelector` (below) locates the same
+   * element in the PERSISTED source so a host can stamp the pending id as
+   * the real `data-agent-native-node-id` before resolving the drop — the
+   * two-step id-on-demand handshake mirroring editor-chrome's selection
+   * contract. Without passing these through, drops into id-less screens
+   * silently degrade to absolute placement.
+   */
+  pendingNodeId?: string;
+  /**
+   * Body-rooted source-equivalent structural path for the pending anchor
+   * (skips Alpine-generated runtime nodes + editor overlays). Absent when
+   * the anchor is itself an Alpine-generated instance with no source node.
+   */
+  anchorSelector?: string;
   placement?: CrossScreenDropPlacement;
   axis?: CrossScreenDropAxis;
   dropMode?: CrossScreenDropMode;

package/corpus/templates/design/app/i18n/zh-TW.ts

@@ -648,6 +648,7 @@ const messages = {
       propsPasted: "屬性已貼上",
       primitiveInsertFailed: "無法將該圖層新增到畫面",
       layerMoveFailed: "無法移動該圖層",
+      layerMoveRedirected: "已移至原位置附近——精確的放置目標無法編輯",
       duplicateElementFailed: "無法複製該元素",
       eyedropperUnsupported: "此瀏覽器不支援取色器",
       saveCopyError: "無法儲存這個設計的副本",

package/corpus/templates/design/app/i18n-data.ts

@@ -665,6 +665,8 @@ const enUS = {
       propsPasted: "Properties pasted",
       primitiveInsertFailed: "Could not add that layer to the screen",
       layerMoveFailed: "Could not move that layer",
+      layerMoveRedirected:
+        "Moved next to its original spot — the exact drop target isn't editable",
       duplicateElementFailed: "Could not duplicate that element",
       eyedropperUnsupported: "Eyedropper isn't supported in this browser",
       saveCopyError: "Could not save a copy of this design",
@@ -8447,6 +8449,7 @@ const designCanvasFeatureOverrides = {
         propsPasted: "属性已粘贴",
         primitiveInsertFailed: "无法将该图层添加到画面",
         layerMoveFailed: "无法移动该图层",
+        layerMoveRedirected: "已移动到原位置附近——精确的放置目标不可编辑",
         duplicateElementFailed: "无法复制该元素",
         eyedropperUnsupported: "此浏览器不支持取色器",
       },
@@ -8522,6 +8525,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "Propiedades pegadas",
         primitiveInsertFailed: "No se pudo añadir esa capa a la pantalla",
         layerMoveFailed: "No se pudo mover esa capa",
+        layerMoveRedirected:
+          "Se movió cerca de su lugar original — el destino exacto no es editable",
         duplicateElementFailed: "No se pudo duplicar ese elemento",
         eyedropperUnsupported:
           "El cuentagotas no es compatible con este navegador",
@@ -8598,6 +8603,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "Propriétés collées",
         primitiveInsertFailed: "Impossible d’ajouter ce calque à l’écran",
         layerMoveFailed: "Impossible de déplacer ce calque",
+        layerMoveRedirected:
+          "Déplacé à proximité de son emplacement d’origine — la cible exacte n’est pas modifiable",
         duplicateElementFailed: "Impossible de dupliquer cet élément",
         eyedropperUnsupported:
           "La pipette n'est pas prise en charge par ce navigateur",
@@ -8675,6 +8682,8 @@ const designCanvasFeatureOverrides = {
         primitiveInsertFailed:
           "Diese Ebene konnte nicht zur Ansicht hinzugefügt werden",
         layerMoveFailed: "Diese Ebene konnte nicht verschoben werden",
+        layerMoveRedirected:
+          "In die Nähe der ursprünglichen Stelle verschoben — das genaue Ziel ist nicht bearbeitbar",
         duplicateElementFailed: "Dieses Element konnte nicht dupliziert werden",
         eyedropperUnsupported:
           "Die Pipette wird von diesem Browser nicht unterstützt",
@@ -8751,6 +8760,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "プロパティを貼り付けました",
         primitiveInsertFailed: "そのレイヤーを画面に追加できませんでした",
         layerMoveFailed: "そのレイヤーを移動できませんでした",
+        layerMoveRedirected:
+          "元の位置の近くに移動しました — 正確なドロップ先は編集できません",
         duplicateElementFailed: "その要素を複製できませんでした",
         eyedropperUnsupported: "このブラウザではスポイトツールを使用できません",
       },
@@ -8826,6 +8837,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "속성이 붙여넣어짐",
         primitiveInsertFailed: "해당 레이어를 화면에 추가할 수 없습니다",
         layerMoveFailed: "해당 레이어를 이동할 수 없습니다",
+        layerMoveRedirected:
+          "원래 위치 근처로 이동되었습니다 — 정확한 놓기 대상은 편집할 수 없습니다",
         duplicateElementFailed: "해당 요소를 복제할 수 없습니다",
         eyedropperUnsupported: "이 브라우저에서는 스포이드를 지원하지 않습니다",
       },
@@ -8901,6 +8914,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "Propriedades coladas",
         primitiveInsertFailed: "Não foi possível adicionar essa camada à tela",
         layerMoveFailed: "Não foi possível mover essa camada",
+        layerMoveRedirected:
+          "Movido para perto do local original — o destino exato não é editável",
         duplicateElementFailed: "Não foi possível duplicar esse elemento",
         eyedropperUnsupported:
           "O conta-gotas não é compatível com este navegador",
@@ -8977,6 +8992,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "गुण चिपकाए गए",
         primitiveInsertFailed: "उस परत को स्क्रीन में नहीं जोड़ा जा सका",
         layerMoveFailed: "उस परत को स्थानांतरित नहीं किया जा सका",
+        layerMoveRedirected:
+          "मूल स्थान के पास ले जाया गया — सटीक ड्रॉप लक्ष्य संपादन योग्य नहीं है",
         duplicateElementFailed: "उस तत्व की प्रतिलिपि नहीं बनाई जा सकी",
         eyedropperUnsupported: "इस ब्राउज़र में आई-ड्रॉपर समर्थित नहीं है",
       },
@@ -9052,6 +9069,8 @@ const designCanvasFeatureOverrides = {
         propsPasted: "تم لصق الخصائص",
         primitiveInsertFailed: "تعذرت إضافة تلك الطبقة إلى الشاشة",
         layerMoveFailed: "تعذر نقل تلك الطبقة",
+        layerMoveRedirected:
+          "تم النقل بالقرب من الموضع الأصلي — الهدف الدقيق للإفلات غير قابل للتحرير",
         duplicateElementFailed: "تعذّر تكرار هذا العنصر",
         eyedropperUnsupported: "أداة القطارة غير مدعومة في هذا المتصفح",
       },

package/corpus/templates/design/changelog/2026-07-07-dragging-a-free-floating-element-into-a-layout-column-or-row.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Dragging a free-floating element into a layout column or row no longer leaves it stranded far from the drop point; it now lands cleanly in the indicated slot.

package/corpus/templates/design/changelog/2026-07-07-dragging-a-repeated-list-item-like-a-to-do-card-generated-fr.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Dragging a repeated list item (like a to-do card generated from data) now shows a clear "Can't reorder repeated items" message instead of silently snapping back after the drop.

package/corpus/templates/design/changelog/2026-07-07-dragging-an-element-onto-a-button-or-chip-s-middle-no-longer.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Dragging an element onto a button or chip's middle no longer merges it inside the button's label; it now reorders as a sibling like other layout containers.

package/corpus/templates/design/changelog/2026-07-07-elements-dropped-into-another-board-shape-now-stay-exactly-w.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Elements dropped into another board shape now stay exactly where you dropped them, render inside their parent, and previously misplaced nested elements are repaired automatically

package/corpus/templates/design/changelog/2026-07-07-fixed-drag-reordering-elements-within-a-screen-no-longer-sil.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed drag-reordering elements within a screen no longer silently loses edits after the first one when a reload happens shortly after

package/corpus/templates/design/changelog/2026-07-07-fixed-dragging-an-element-from-a-screen-onto-the-canvas-now-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed dragging an element from a screen onto the canvas now drops it exactly under the cursor instead of drifting away

package/corpus/templates/design/changelog/2026-07-07-fixed-dragging-elements-between-screens-into-ai-generated-co.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed dragging elements between screens into AI-generated content no longer corrupts the layout by landing inside hidden template markup

package/corpus/templates/design/changelog/2026-07-07-fixed-moving-elements-between-screens-no-longer-bakes-intern.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed moving elements between screens no longer bakes internal editor styling into the design's HTML

package/corpus/templates/design/changelog/2026-07-07-fixed-the-cross-screen-drop-indicator-now-points-at-the-corr.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed the cross-screen drop indicator now points at the correct spot for duplicated or newly created screens

package/corpus/templates/design/changelog/2026-07-07-fixed-the-zoom-menu-no-longer-leaves-the-canvas-unresponsive.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Fixed the zoom menu no longer leaves the canvas unresponsive to clicks and scrolling after choosing a zoom preset

package/corpus/templates/design/changelog/2026-07-07-text-drawn-on-the-canvas-is-now-readable-white-instead-of-in.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Text drawn on the canvas is now readable white instead of invisible black when the app is in light theme

package/corpus/templates/design/server/source-workspace.ts

@@ -94,6 +94,16 @@ export interface SourceWorkspaceContext {
   sourceType: DesignSourceType;
   canEdit: boolean;
   files: SourceWorkspaceFile[];
+  /**
+   * The design's reserved board overlay file id (designs.data.boardFileId),
+   * when one has been created. The board file is deliberately excluded from
+   * `files` above (see isBoardFile filter below) since it isn't a source
+   * file the code workbench edits — callers that need to recognize "this id
+   * is the board, not a missing file" (e.g. read-source-file's graceful
+   * no-op) should check against this instead of treating an unresolved id
+   * as an error.
+   */
+  boardFileId: string | null;
 }
 
 function parseDesignDataSourceType(value: unknown): DesignSourceType {
@@ -110,6 +120,20 @@ function parseDesignDataSourceType(value: unknown): DesignSourceType {
   return "inline";
 }
 
+function parseDesignDataBoardFileId(value: unknown): string | null {
+  if (typeof value !== "string") return null;
+  try {
+    const parsed: unknown = JSON.parse(value);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const raw = (parsed as Record<string, unknown>).boardFileId;
+      return typeof raw === "string" && raw.length > 0 ? raw : null;
+    }
+  } catch {
+    // Invalid design data — no board file id available.
+  }
+  return null;
+}
+
 function roleCanEdit(role: unknown): boolean {
   return role === "owner" || role === "admin" || role === "editor";
 }
@@ -147,13 +171,13 @@ export async function resolveSourceWorkspace(
         .from(schema.designFiles)
         .where(eq(schema.designFiles.designId, designId));
 
+  const resourceData = (access.resource as { data?: unknown }).data;
   return {
     designId,
-    sourceType: parseDesignDataSourceType(
-      (access.resource as { data?: unknown }).data,
-    ),
+    sourceType: parseDesignDataSourceType(resourceData),
     canEdit: roleCanEdit(access.role),
     files: files.filter((file) => !isBoardFile(file.filename)),
+    boardFileId: parseDesignDataBoardFileId(resourceData),
   };
 }