Free drag & drop with fixed positions, empty cells and kept pages (0.2.31)

Tiles get an absolute grid slot instead of a packed order: a tile lands exactly
where it is dropped, dropping on another tile swaps the two, everything else
stays put, and empty cells and empty pages persist. The mockup previews the
result while dragging, a new page waits below the last one, "Pagina toevoegen"
keeps an empty page, empty cells accept the next tile from the picker, and the
mouse no longer selects text while dragging.

Storage and protocol stay version 1: `tiles[].slot` (0-47) and `pages` (1-8)
are additive, the layout message carries `slots` and `pages`. Firmware 0.2.26
places tiles on those slots (`place()` next to `pack()`); older firmware packs
in order as before and the editor says so.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

screen_manager/CHANGELOG.md

@@ -1,3 +1,12 @@
+## 0.2.31 (firmware 0.2.26)
+
+- **Vrij slepen, met lege plekken**: de editor werkt met vaste plekken in plaats van een volgorde die steeds wordt aangeschoven. Elke tegel heeft zijn eigen plek (kolom, rij, pagina) en die verandert alleen als jij hem versleept. Lege plekken zijn gewoon lege plekken: naast een enkele tegel, midden op een pagina, waar je wilt; ze blijven staan zodat je kunt ordenen. Sleep een tegel op een lege plek en hij staat daar. Sleep hem op een andere tegel en die twee wisselen: de ander neemt de plek die vrijkwam, of anders de dichtstbijzijnde vrije plek. Alle overige tegels blijven waar ze staan. Tijdens het slepen laat het voorbeeld al zien waar alles terechtkomt; loslaten bevestigt precies dat, loslaten buiten het voorbeeld verandert niets.
+- **Naar een volgende pagina slepen**, ook als de vorige nog niet vol is: onder de laatste pagina staat tijdens het slepen een lege pagina klaar. Met **Pagina toevoegen** maak je zelf een lege pagina, die ook bewaard blijft; een lege pagina heeft **Pagina weghalen** (de pagina's erna schuiven op). Maximaal acht pagina's.
+- **Lege plek aanklikken**: klik op een lege plek en de volgende tegel uit de kiezer komt daar ("Volgende tegel komt hier"); zonder keuze vult toevoegen de eerste vrije plek. Een tegel die dubbelbreed wordt houdt zijn rij als de plek ernaast vrij is en gaat anders naar de dichtstbijzijnde vrije rij; de buurtegel blijft staan. Dubbelbreed terug naar normaal laat de rechterplek leeg.
+- **Geen tekstselectie meer tijdens het slepen**, en een sleep die snel begint start toch (de muis blijft aan de kaart gekoppeld tot de sleep loopt). Pijltjestoetsen verplaatsen een gefocuste tegel per plek; Enter opent de instellingen.
+- Firmware 0.2.26 tekent de tegels op precies die plekken: lege plekken blijven leeg en een lege pagina blijft een pagina. Oudere firmware negeert de nieuwe velden en schuift de tegels aan tot de eerste vrije plek, zoals voorheen; de editor meldt dat onder het voorbeeld zolang zo'n scherm een indeling met gaten heeft. Bestaande indelingen krijgen bij het laden de plekken die ze al hadden, er verandert niets op het scherm.
+- Opslag en protocol (voor ontwikkelaars): `tiles[].slot` (0–47, absolute plek: pagina × 6 + rij × 2 + kolom; dubbelbreed altijd op een even plek) en `pages` (1–8) zijn additief in opslagversie 1; het layoutbericht krijgt `slots` en `pages`. Firmware 0.2.26 voor beide borden; de app biedt de update aan.
+
 ## 0.2.30 (firmware 0.2.25)
 
 - **Groen bolletje voor online schermen**: in de lijst met schermen is het bolletje voor **Online** nu groen, zodat je in één oogopslag ziet welke schermen bereikbaar zijn. **Offline** blijft een grijs open rondje.

screen_manager/app/core.py

@@ -16,7 +16,7 @@ WEEKDAYS = ['ma', 'di', 'wo', 'do', 'vr', 'za', 'zo']
 REPO = 'https://github.com/MaxGramser/homeassistant_espscreen'
 REFS = {'cyd': 'main', 'guition': 'main'}
 # Firmware shipped with this app release; screens below it get an update offer.
-FIRMWARE_VERSION = '0.2.25'
+FIRMWARE_VERSION = '0.2.26'
 ATTRS = frozenset('brightness percentage current_position current_temperature temperature current_humidity min_temp max_temp target_temp_step supported_color_modes hvac_modes hvac_action hs_color color_temp_kelvin min_color_temp_kelvin max_color_temp_kelvin fan_speed_list unit_of_measurement battery_level fan_speed volume_level is_volume_muted media_title options min max step temperature_unit supported_features device_class next_rising next_setting finishes_at duration remaining humidity wind_speed wind_speed_unit apparent_temperature fan_modes swing_modes fan_mode swing_mode'.split())
 # Attributes whose boolean value the screen needs; every other bool stays behind.
 BOOL_ATTRS = frozenset(['is_volume_muted'])
@@ -42,6 +42,36 @@ DISPLAYS = {'weather': ('standard', 'watch', 'forecast'), 'sensor': ('standard',
 # Displays that only work on a double-width card.
 WIDE_ONLY = ('forecast', 'sunpath')
 
+# Grid positions: two columns, three rows per page, at most eight pages. A tile's
+# `slot` is its absolute cell (page * 6 + row * 2 + column); a wide tile starts in
+# the left column and also covers the cell to its right. Empty cells are allowed.
+SLOTS_PER_PAGE = 6
+MAX_PAGES = 8
+MAX_SLOTS = MAX_PAGES * SLOTS_PER_PAGE
+
+def is_wide(tile):
+    return tile.get('options', {}).get('size') == 'wide'
+
+def footprint(slot, wide):
+    return (slot, slot + 1) if wide else (slot,)
+
+def pack_slots(tiles):
+    """In-order packing, the rule before explicit positions and what firmware without
+    `slots` still does: fill left to right, a wide card starts a new row."""
+    position, slots = 0, []
+    for tile in tiles:
+        wide = is_wide(tile)
+        if wide and position % 2:
+            position += 1
+        slots.append(position)
+        position += 2 if wide else 1
+    return slots
+
+def has_gaps(tiles):
+    """True when the stored positions differ from the in-order packing, so firmware
+    before 0.2.26 (which ignores `slots`) would show another arrangement."""
+    return [t.get('slot') for t in tiles] != pack_slots(tiles)
+
 # Direct controls on the right half of a double-width card (firmware 0.2.19+), like
 # Home Assistant's own entity rows. The first choice is what a wide card shows
 # when the tile has no explicit choice; 'none' keeps the plain card.
@@ -182,7 +212,30 @@ def validate_layout(data):
                     raise ValueError('Deze entiteit ondersteunt die directe bediening niet.')
             item['options'] = dict(options)
         clean.append(item)
+    # Positions: every tile or none (an older editor sends none and keeps its order).
+    given = [tile.get('slot') for tile in tiles]
+    if any(slot is not None for slot in given):
+        occupied = set()
+        for item, slot in zip(clean, given):
+            if type(slot) is not int or not 0 <= slot < MAX_SLOTS:
+                raise ValueError('Ongeldige tegelpositie; vernieuw de beheerpagina.')
+            if is_wide(item) and slot % 2:
+                raise ValueError('Een dubbelbrede tegel begint in de linkerkolom.')
+            for cell in footprint(slot, is_wide(item)):
+                if cell in occupied:
+                    raise ValueError('Twee tegels staan op dezelfde plek.')
+                occupied.add(cell)
+            item['slot'] = slot
+        clean.sort(key=lambda item: item['slot'])
+    else:
+        for item, slot in zip(clean, pack_slots(clean)):
+            item['slot'] = slot
     result = {'title': title.strip(), 'tiles': clean}
+    # Pages kept on purpose, empty ones included; the screen shows at least what the tiles need.
+    if 'pages' in data:
+        if type(data['pages']) is not int or not 1 <= data['pages'] <= MAX_PAGES:
+            raise ValueError(f'Een scherm heeft 1 tot {MAX_PAGES} pagina\'s.')
+        result['pages'] = data['pages']
     if 'settings' in data:
         result['settings'] = validate_settings(data['settings'])
     return result

screen_manager/app/server.py

@@ -14,7 +14,7 @@ import tile_icons
 from updates import Updater
 
 from aiohttp import ClientSession, ClientTimeout, WSMsgType, web
-from core import BUILTIN, TILE_BACKGROUNDS, controls_catalogue, discover, extras, min_firmware, packets, state_message, validate_layout, validate_settings
+from core import BUILTIN, TILE_BACKGROUNDS, controls_catalogue, discover, extras, min_firmware, pack_slots, packets, state_message, validate_layout, validate_settings
 from zoneinfo import ZoneInfo
 
 LOG = logging.getLogger('screen_manager')
@@ -269,6 +269,12 @@ class Manager:
                     tile['options'][key]=old_options[key]
             if 'options' not in tile and 'options' in old_tiles.get(tile['entity'],{}):
                 tile['options'] = old_tiles[tile['entity']]['options'].copy()
+        # Restored options can widen a tile: an editor without positions packs again with
+        # the real widths, and explicit positions are checked once more for overlap.
+        if not any(isinstance(t, dict) and 'slot' in t for t in data.get('tiles', [])):
+            for tile, slot in zip(layout['tiles'], pack_slots(layout['tiles'])):
+                tile['slot'] = slot
+        layout = validate_layout(layout)
         known = {e['id'] for e in entities} | set(BUILTIN)
         if any(t['entity'] not in known for t in layout['tiles']):
             raise ValueError('Een gekozen entiteit bestaat niet meer. Zoek de nieuwe entiteit op.')
@@ -327,8 +333,12 @@ class Manager:
         if needed:
             self.status[inbox]=f"Indeling bewaard; firmware {needed}+ nodig voor deze tegels"
             return
-        messages = [{'v': 1, 'op': 'layout', 'inbox': inbox, 'title': layout['title'], 'entities': [t['entity'] for t in layout['tiles']],
-                     'keepalive': KEEPALIVE_SECONDS}]
+        tiles = layout['tiles']
+        # Grid positions (firmware 0.2.26+; older firmware ignores them and packs the entities in order).
+        messages = [{'v': 1, 'op': 'layout', 'inbox': inbox, 'title': layout['title'], 'entities': [t['entity'] for t in tiles],
+                     'slots': [t['slot'] for t in tiles], 'keepalive': KEEPALIVE_SECONDS}]
+        if 'pages' in layout:
+            messages[0]['pages'] = layout['pages']
         if 'settings' in layout:
             messages[0]['settings'] = {k:v for k,v in layout['settings'].items() if k not in ('swipe_pages','rotation')}
             messages[0]['swipe_pages'] = layout['settings'].get('swipe_pages',False)

screen_manager/app/static/app.js

@@ -64,6 +64,8 @@ function select(id) {
   const screen = inventory.screens.find((s) => s.id === id);
   if (!screen) return;
   layout = structuredClone(screen.layout);
+  normalize();
+  insertAt = -1;
   dirty = false;
   $("#title").value = layout.title;
   $("#screen-name").textContent = screen.name;
@@ -391,13 +393,6 @@ $("#auto-update").onchange = async () => {
     toast(e.message);
   }
 };
-function move(from, to) {
-  if (to < 0 || to >= layout.tiles.length) return;
-  const [tile] = layout.tiles.splice(from, 1);
-  layout.tiles.splice(to, 0, tile);
-  markDirty();
-  renderTiles();
-}
 const domains = {
   light: ["Licht", "☀", "#ad7600", "#fff3d3"],
   climate: ["Klimaat", "❄", "#c86620", "#ffebdc"],
@@ -465,17 +460,111 @@ function defaultOptions(id) {
   if (domain === "screen") return { options: { display: "digital", size: "wide" } };
   return {};
 }
-// Same packing as the firmware: wide tiles start in the left column and take a whole row.
-function packTiles(tiles) {
+// ---- Grid positions ----
+// Two columns, three rows per page, at most eight pages. A tile's `slot` is its absolute
+// cell (page * 6 + row * 2 + column); a wide tile starts in the left column and also covers
+// the cell to its right. Empty cells are allowed and stay exactly where they are.
+const SLOTS_PER_PAGE = 6, MAX_PAGES = 8, MAX_SLOTS = MAX_PAGES * SLOTS_PER_PAGE;
+const isWide = (tile) => tile.options?.size === "wide";
+const cellsOf = (slot, wide) => (wide ? [slot, slot + 1] : [slot]);
+const rowStart = (slot) => slot - (slot % 2);
+const pageOf = (slot) => Math.floor(slot / SLOTS_PER_PAGE);
+const liveEntries = () => layout.tiles.map((tile) => ({ tile, slot: tile.slot }));
+// In-order packing: the rule before positions existed, and what firmware below 0.2.26 still draws.
+function packSlots(tiles) {
   let position = 0;
-  const placement = tiles.map((tile) => {
-    const wide = tile.options?.size === "wide";
+  return tiles.map((tile) => {
+    const wide = isWide(tile);
     if (wide && position % 2 === 1) position++;
-    const slot = { page: Math.floor(position / 6), slot: position % 6, wide };
+    const slot = position;
     position += wide ? 2 : 1;
     return slot;
   });
-  return { placement, pages: Math.max(1, Math.ceil(position / 6)) };
+}
+function hasGaps(tiles) {
+  const packed = packSlots(tiles);
+  return tiles.some((tile, i) => tile.slot !== packed[i]);
+}
+// Every tile gets a position (older layouts pack in order), the list stays in reading
+// order and the open settings sheet keeps following its tile.
+function normalize() {
+  if (layout.tiles.some((t) => !Number.isInteger(t.slot))) { const packed = packSlots(layout.tiles); layout.tiles.forEach((t, i) => (t.slot = packed[i])); }
+  layout.tiles.sort((a, b) => a.slot - b.slot);
+  if (sheetIndex >= 0) sheetIndex = layout.tiles.findIndex((t) => t.entity === selectedTile);
+}
+function occupied(entries) {
+  const taken = new Set();
+  for (const { tile, slot } of entries) for (const cell of cellsOf(slot, isWide(tile))) taken.add(cell);
+  return taken;
+}
+const fits = (taken, slot, wide) => Number.isInteger(slot) && slot >= 0 && slot + (wide ? 1 : 0) < MAX_SLOTS && !(wide && slot % 2) && cellsOf(slot, wide).every((c) => !taken.has(c));
+function firstFree(taken, wide) {
+  for (let slot = 0; slot < MAX_SLOTS; slot++) if (fits(taken, slot, wide)) return slot;
+  return -1;
+}
+// The free position closest to `origin`; on a tie the later one, so a nudged tile moves down, not up.
+function nearestFree(taken, wide, origin) {
+  let best = -1;
+  for (let slot = 0; slot < MAX_SLOTS; slot++) if (fits(taken, slot, wide) && (best < 0 || Math.abs(slot - origin) <= Math.abs(best - origin))) best = slot;
+  return best;
+}
+// The arrangement after putting `moving` (a tile on the grid, or a new one) at `target`:
+// it lands exactly there; tiles in its way take the cells it left (a swap) or else the
+// nearest free cell; everything else stays put. Null when the target is off the grid.
+function arrange(tiles, moving, target) {
+  const wide = isWide(moving);
+  if (wide) target = rowStart(target);
+  if (!fits(new Set(), target, wide)) return null;
+  const footprint = cellsOf(target, wide);
+  const vacated = tiles.includes(moving) ? cellsOf(moving.slot, wide) : [];
+  const result = [{ tile: moving, slot: target }], displaced = [];
+  for (const tile of tiles) {
+    if (tile === moving) continue;
+    if (cellsOf(tile.slot, isWide(tile)).some((c) => footprint.includes(c))) displaced.push(tile);
+    else result.push({ tile, slot: tile.slot });
+  }
+  for (const tile of displaced) {
+    const w = isWide(tile), taken = occupied(result);
+    let slot = vacated.map((c) => (w ? rowStart(c) : c)).find((c) => fits(taken, c, w));
+    if (slot === undefined) slot = nearestFree(taken, w, tile.slot);
+    if (slot < 0) return null;
+    result.push({ tile, slot });
+  }
+  return result.sort((a, b) => a.slot - b.slot);
+}
+// Apply an arrangement; a new tile joins the layout. True when anything changed.
+function commit(result) {
+  const before = layout.tiles.map((t) => `${t.entity}@${t.slot}`).join();
+  for (const { tile, slot } of result) { tile.slot = slot; if (!layout.tiles.includes(tile)) layout.tiles.push(tile); }
+  normalize();
+  const changed = layout.tiles.map((t) => `${t.entity}@${t.slot}`).join() !== before;
+  if (changed) { markDirty(); renderTiles(); renderResults(); }
+  return changed;
+}
+function placeTile(tile, target) {
+  const result = arrange(layout.tiles, tile, target);
+  return result ? commit(result) : false;
+}
+// Pages the tiles need, or more when the user keeps empty pages on purpose (`layout.pages`).
+function pageCount(entries) {
+  const last = Math.max(0, ...entries.map(({ tile, slot }) => slot + (isWide(tile) ? 2 : 1)));
+  return Math.min(MAX_PAGES, Math.max(1, Math.ceil(last / SLOTS_PER_PAGE), layout.pages || 1));
+}
+function addPage() {
+  layout.pages = Math.min(MAX_PAGES, pageCount(liveEntries()) + 1);
+  markDirty();
+  renderTiles();
+  document.querySelector("#layout-preview .screen-preview:last-child")?.scrollIntoView({ behavior: "smooth", block: "nearest" });
+}
+// An empty page goes; the pages after it move up.
+function removePage(page) {
+  for (const tile of layout.tiles) if (pageOf(tile.slot) > page) tile.slot -= SLOTS_PER_PAGE;
+  layout.pages = Math.max(1, pageCount(liveEntries()) - 1);
+  markDirty();
+  renderTiles();
+}
+function focusSlot(slot) {
+  document.querySelector(`#layout-preview [data-slot="${slot}"]`)?.focus();
 }
 function supportsFirmware(major, minor, patch) {
   const version = inventory.screens.find((s) => s.id === selected)?.firmware || "";
@@ -525,65 +614,114 @@ function tileLimit() {
 function entityName(id) {
   return inventory.entities.find((e) => e.id === id)?.name || inventory.builtin?.find((e) => e.id === id)?.name || id;
 }
-function renderPreview() {
+let insertAt = -1;  // empty cell chosen as the place for the next tile from the picker
+function renderPreview(preview) {
   const root = $("#layout-preview");
   root.replaceChildren();
-  const { placement, pages } = packTiles(layout.tiles);
-  for (let page = 0; page < pages; page++) {
+  // While dragging, the mockup already shows the arrangement after the drop.
+  const entries = preview?.result || liveEntries();
+  const moving = preview?.moving || null;
+  const bySlot = new Map(entries.map((e) => [e.slot, e]));
+  const covered = new Set(entries.filter((e) => isWide(e.tile)).map((e) => e.slot + 1));
+  const pages = pageCount(entries), title = $("#title").value || "Thuis";
+  // While dragging, one more page waits below the last one.
+  const shown = drag.active && pages < MAX_PAGES ? pages + 1 : pages;
+  for (let page = 0; page < shown; page++) {
     const frame = node("section", undefined, "screen-preview");
-    frame.append(node("small", `Pagina ${page + 1} · ${$("#title").value || "Thuis"}`, "preview-heading"));
+    const heading = node("div", undefined, "preview-heading");
+    heading.append(node("small", `Pagina ${page + 1} · ${title}`));
+    if (page >= pages) {
+      frame.classList.add("new-page");
+      heading.replaceChildren(node("small", `Pagina ${page + 1} · sleep hierheen voor een nieuwe pagina`));
+    } else if (pages > 1 && !entries.some((e) => pageOf(e.slot) === page)) {
+      heading.append(node("small", "leeg", "page-note"));
+      const drop = node("button", "Pagina weghalen", "mini");
+      drop.type = "button";
+      drop.title = "De pagina's erna schuiven een plek op";
+      drop.onclick = () => removePage(page);
+      heading.append(drop);
+    }
+    frame.append(heading);
     const grid = node("div", undefined, "preview-grid");
-    let filled = 0;
-    layout.tiles.forEach((tile, index) => {
-      const place = placement[index];
-      if (place.page !== page) return;
-      // Keep the grid honest: an empty right column before a wide tile is a real gap on the screen.
-      for (; filled < place.slot; filled++) grid.append(node("span", "", "preview-gap"));
-      const card = node("div", undefined, "preview-tile");
-      card.tabIndex = 0;
-      card.setAttribute("role", "button");
-      const name = tile.name || entityName(tile.entity);
-      const background=inventory.backgrounds?.[tile.options?.background]?.color;
-      if(background)card.style.backgroundColor=background;
-      // "Geen": no card on the screen; the mockup keeps a dashed outline as drop target.
-      if (tile.options?.background === "none") card.classList.add("bare");
-      if (place.wide) card.classList.add("wide");
-      card.append(tileBadge(tile), node("strong", name));
-      card.dataset.index = index;
-      enableDrag(card, { kind: "tile", index });
-      card.classList.toggle("chosen", selectedTile === tile.entity);
-      card.setAttribute("aria-label", `Tegel ${index + 1}: ${name}, instellen`);
-      card.onclick = () => openTileSheet(index);
-      card.onkeydown = (e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); openTileSheet(index); } };
-      const remove = node("button", "✕", "preview-remove");
-      remove.type = "button";
-      remove.title = "Tegel verwijderen";
-      remove.setAttribute("aria-label", `${name} verwijderen`);
-      remove.onclick = (e) => { e.stopPropagation(); removeTile(index); };
-      card.append(remove);
-      if (tile.options?.inline === "slider") card.append(node("span", "", "preview-slider"));
-      const controls = controlsPreview(tile);
-      if (controls) card.append(controls);
-      const display = tile.options?.display;
-      if (display && display !== "standard") card.append(node("small", displayNames[display] || display));
-      grid.append(card);
-      filled += place.wide ? 2 : 1;
-    });
-    if (layout.tiles.length < tileLimit())
-      for (; filled < 6; filled++) {
-        const card = node("button", undefined, "preview-tile vacant");
-        card.append(node("span", "+"), node("small", "Tegel toevoegen"));
-        card.onclick = () => { $("#search").focus(); $("#search").scrollIntoView({behavior:"smooth", block:"center"}); };
-        grid.append(card);
-      }
+    for (let cell = 0; cell < SLOTS_PER_PAGE; cell++) {
+      const slot = page * SLOTS_PER_PAGE + cell;
+      if (covered.has(slot)) continue;
+      const entry = bySlot.get(slot);
+      grid.append(entry ? tileCard(entry.tile, slot, entry.tile === moving) : emptyCell(slot));
+    }
     frame.append(grid);
     root.append(frame);
   }
 }
+// A card on the mockup. A placeholder is the tile being dragged, drawn where it will land.
+function tileCard(tile, slot, placeholder) {
+  const index = layout.tiles.indexOf(tile);
+  const card = node("div", undefined, "preview-tile");
+  card.dataset.slot = slot;
+  const name = tile.name || entityName(tile.entity);
+  const background = inventory.backgrounds?.[tile.options?.background]?.color;
+  if (background) card.style.backgroundColor = background;
+  // "Geen": no card on the screen; the mockup keeps a dashed outline.
+  if (tile.options?.background === "none") card.classList.add("bare");
+  if (isWide(tile)) card.classList.add("wide");
+  card.append(tileBadge(tile), node("strong", name));
+  if (tile.options?.inline === "slider") card.append(node("span", "", "preview-slider"));
+  const controls = controlsPreview(tile);
+  if (controls) card.append(controls);
+  const display = tile.options?.display;
+  if (display && display !== "standard") card.append(node("small", displayNames[display] || display));
+  if (placeholder || index < 0) { card.classList.add("placeholder"); return card; }
+  card.tabIndex = 0;
+  card.setAttribute("role", "button");
+  card.setAttribute("aria-label", `${name}, plek ${(slot % SLOTS_PER_PAGE) + 1} op pagina ${pageOf(slot) + 1}. Enter: instellen, pijltjestoetsen: verplaatsen`);
+  card.classList.toggle("chosen", selectedTile === tile.entity);
+  enableDrag(card, { kind: "tile", tile });
+  card.onclick = () => openTileSheet(index);
+  card.onkeydown = (e) => {
+    if (e.key === "Enter" || e.key === " ") { e.preventDefault(); openTileSheet(index); return; }
+    const step = { ArrowLeft: -1, ArrowRight: 1, ArrowUp: -2, ArrowDown: 2 }[e.key];
+    if (!step) return;
+    e.preventDefault();
+    // A wide card owns its row: left and right mean the row above and below.
+    if (placeTile(tile, tile.slot + (isWide(tile) ? Math.sign(step) * 2 : step))) focusSlot(tile.slot);
+  };
+  const remove = node("button", "✕", "preview-remove");
+  remove.type = "button";
+  remove.title = "Tegel verwijderen";
+  remove.setAttribute("aria-label", `${name} verwijderen`);
+  remove.onclick = (e) => { e.stopPropagation(); removeTile(index); };
+  card.append(remove);
+  return card;
+}
+// An empty cell: a drop target, and a click marks it as the place for the next tile.
+function emptyCell(slot) {
+  const cell = node("button", undefined, "preview-cell");
+  cell.type = "button";
+  cell.dataset.slot = slot;
+  const marked = insertAt === slot;
+  cell.classList.toggle("insert-here", marked);
+  cell.append(node("span", "+"), node("small", marked ? "Volgende tegel komt hier" : "Leeg"));
+  cell.title = "Lege plek. Klik om hier een tegel toe te voegen, of sleep er een naartoe.";
+  cell.setAttribute("aria-label", `Lege plek ${(slot % SLOTS_PER_PAGE) + 1} op pagina ${pageOf(slot) + 1}: hier de volgende tegel toevoegen`);
+  cell.onclick = () => {
+    insertAt = marked ? -1 : slot;
+    renderPreview();
+    if (insertAt >= 0) { $("#search").focus(); $("#search").scrollIntoView({ behavior: "smooth", block: "center" }); }
+  };
+  return cell;
+}
 function renderTiles() {
+  normalize();
+  // Pages follow the tiles; only a page the user added on purpose can stay empty.
+  layout.pages = pageCount(liveEntries());
   renderPreview();
+  $("#add-page").disabled = layout.pages >= MAX_PAGES;
   $("#count").textContent = `${layout.tiles.length} / ${tileLimit()}${tileLimit()===10?" · update firmware voor 20":""}`;
   $("#no-tiles").hidden = layout.tiles.length > 0;
+  // Firmware below 0.2.26 ignores positions and packs the tiles in order, without gaps.
+  const hint = $("#positions-hint");
+  hint.hidden = !hasGaps(layout.tiles) || supportsFirmware(0, 2, 26);
+  hint.textContent = `Lege plekken en vaste posities werken vanaf firmware 0.2.26. Dit scherm (firmware ${inventory.screens.find((s) => s.id === selected)?.firmware || "onbekend"}) schuift de tegels tot die update aan tot de eerste vrije plek.`;
   if (sheetIndex >= 0) renderTileSheet();
 }
 function removeTile(index) {
@@ -595,7 +733,7 @@ function removeTile(index) {
   renderResults();
   toast(`${tile.name || entityName(tile.entity)} verwijderd`, {
     label: "Ongedaan maken",
-    run: () => { layout.tiles.splice(Math.min(index, layout.tiles.length), 0, tile); markDirty(); renderTiles(); renderResults(); },
+    run: () => placeTile(tile, tile.slot),
   });
 }
 // Tile settings open in a sheet above the mockup; every change applies live,
@@ -748,6 +886,7 @@ function renderTileSheet() {
   if (domain === "sun") displays.push(["sunpath", "Zonnebaan"]);
   const current = (key, fallback) => tile.options?.[key] ?? fallback;
   const set = (key, value) => {
+    const wasWide = isWide(tile);
     tile.options = { ...tile.options, [key]: value };
     // Direct controls need the standard layout without a mini slider, and vice versa.
     if (key === "display" && value === "watch") { tile.options.inline = "none"; if (inventory.controls?.[domain]) tile.options.controls = "none"; }
@@ -755,6 +894,13 @@ function renderTileSheet() {
     if (key === "inline" && value === "slider") { tile.options.display = "standard"; if (inventory.controls?.[domain]) tile.options.controls = "none"; }
     if (key === "controls" && value !== "none") { tile.options.display = "standard"; tile.options.inline = "none"; }
     markDirty();
+    // A card that becomes double-wide keeps its row when the cell beside it is free, else it
+    // takes the nearest free row (below first); every other tile stays where it is.
+    if (isWide(tile) && !wasWide) {
+      const taken = occupied(liveEntries().filter((e) => e.tile !== tile)), own = rowStart(tile.slot);
+      const slot = fits(taken, own, true) ? own : nearestFree(taken, true, own);
+      if (slot >= 0) tile.slot = slot;
+    }
     renderTiles();
   };
   body.append(field("Weergave", segmented(displays, current("display", domain === "screen" ? "digital" : "standard"), (v) => set("display", v))));
@@ -815,48 +961,48 @@ function renderTileSheet() {
   foot.append(done);
   sheet.append(head, body, foot);
 }
-function addTile(id, at) {
+// A click in the picker: the marked empty cell, else the first free cell.
+function addTile(id) {
   if (layout.tiles.some((t) => t.entity === id) || layout.tiles.length >= tileLimit()) return;
-  layout.tiles.splice(Math.min(at, layout.tiles.length), 0, { entity: id, name: "", ...defaultOptions(id) });
+  const tile = { entity: id, name: "", ...defaultOptions(id) };
+  const slot = insertAt >= 0 ? insertAt : firstFree(occupied(liveEntries()), isWide(tile));
+  insertAt = -1;
   selectedTile = id;
-  markDirty();
-  renderTiles();
-  renderResults();
+  if (slot >= 0) placeTile(tile, slot);
 }
-// Pointer-based drag & drop: works with mouse and touch, from the picker into
-// the mockup and between tiles. Touch starts after a short hold so the page
-// still scrolls; a finished drag never doubles as a click.
-const drag = { active: false, source: null, element: null, ghost: null, target: null, timer: 0, start: null, offset: null, pointerId: null, suppressUntil: 0, last: null, scroller: 0 };
+// Pointer-based drag & drop, mouse and touch, from the picker into the mockup and between
+// cells. Touch starts after a short hold so the page still scrolls. While dragging, the
+// mockup already shows where everything ends up; the drop confirms exactly that, and a
+// drop off the grid changes nothing. A finished drag never doubles as a click.
+const drag = { active: false, source: null, element: null, ghost: null, timer: 0, start: null, offset: null, pointerId: null, suppressUntil: 0, last: null, scroller: 0, moving: null, target: null, preview: null };
 function enableDrag(element, source) {
   element.addEventListener("pointerdown", (e) => {
     if (e.button !== 0 || element.disabled || e.target.closest(".preview-remove")) return;
+    // No text selection while the mouse drags; touch keeps its default so the page can scroll.
+    if (e.pointerType !== "touch") e.preventDefault();
     Object.assign(drag, { source, element, start: { x: e.clientX, y: e.clientY }, pointerId: e.pointerId, active: false });
+    // A fast flick may leave the card before its first move event: keep the pointer until the drag begins.
+    try { element.setPointerCapture(e.pointerId); } catch {}
     clearTimeout(drag.timer);
     if (e.pointerType === "touch") drag.timer = setTimeout(() => beginDrag(e), 260);
   });
   element.addEventListener("pointermove", (e) => {
-    if (!drag.start || drag.element !== element) return;
+    if (drag.active || !drag.start || drag.element !== element) return;
     const distance = Math.hypot(e.clientX - drag.start.x, e.clientY - drag.start.y);
-    if (!drag.active) {
-      if (e.pointerType === "touch") { if (distance > 10) { clearTimeout(drag.timer); drag.start = null; } return; }
-      if (distance < 6) return;
-      beginDrag(e);
-    }
-    moveDrag(e);
+    if (e.pointerType === "touch") { if (distance > 10) { clearTimeout(drag.timer); drag.start = null; } return; }
+    if (distance >= 6) beginDrag(e);
   });
-  const finish = (e) => {
-    if (drag.element !== element) return;
-    clearTimeout(drag.timer);
-    if (drag.active) endDrag(e.type === "pointerup");
-    drag.start = null;
-  };
-  element.addEventListener("pointerup", finish);
-  element.addEventListener("pointercancel", finish);
+  const cancel = () => { if (drag.element === element && !drag.active) { clearTimeout(drag.timer); drag.start = null; } };
+  element.addEventListener("pointerup", cancel);
+  element.addEventListener("pointercancel", cancel);
 }
 function beginDrag(e) {
   if (drag.active || !drag.start) return;
   drag.active = true;
-  try { drag.element.setPointerCapture(drag.pointerId); } catch {}
+  drag.moving = drag.source.kind === "tile" ? drag.source.tile : { entity: drag.source.id, name: "", ...defaultOptions(drag.source.id) };
+  drag.target = null;
+  drag.preview = null;
+  getSelection()?.removeAllRanges();
   const rect = drag.element.getBoundingClientRect();
   const ghost = drag.element.cloneNode(true);
   ghost.classList.add("drag-ghost");
@@ -865,45 +1011,64 @@ function beginDrag(e) {
   document.body.append(ghost);
   drag.ghost = ghost;
   document.body.classList.add("dragging");
+  // The mockup re-renders while hovering, so the pointer is followed on the document, not the card.
+  document.addEventListener("pointermove", moveDrag);
+  document.addEventListener("pointerup", finishDrag);
+  document.addEventListener("pointercancel", finishDrag);
+  try { drag.element.releasePointerCapture(drag.pointerId); } catch {}
+  try { document.documentElement.setPointerCapture(drag.pointerId); } catch {}
   document.addEventListener("touchmove", blockScroll, { passive: false });
   // Near the viewport edges the page scrolls along, so the mockup can be reached on small screens.
   drag.scroller = setInterval(() => {
     if (!drag.last) return;
     const step = drag.last.y < 70 ? -12 : drag.last.y > innerHeight - 70 ? 12 : 0;
-    if (step) { window.scrollBy(0, step); setTarget(document.elementFromPoint(drag.last.x, drag.last.y)?.closest(".preview-tile, .preview-gap, .preview-grid") || null); }
+    if (step) { window.scrollBy(0, step); setTarget(slotAt(drag.last.x, drag.last.y)); }
   }, 16);
+  setTarget(-1);
   moveDrag(e);
 }
 function blockScroll(e) { if (drag.active) e.preventDefault(); }
+function finishDrag(e) { if (e.pointerId === drag.pointerId) endDrag(e.type === "pointerup"); }
 function moveDrag(e) {
-  if (!drag.ghost) return;
+  if (!drag.ghost || e.pointerId !== drag.pointerId) return;
   drag.last = { x: e.clientX, y: e.clientY };
   drag.ghost.style.transform = `translate(${e.clientX - drag.offset.x}px, ${e.clientY - drag.offset.y}px)`;
-  const under = document.elementFromPoint(e.clientX, e.clientY);
-  setTarget(under?.closest(".preview-tile, .preview-gap, .preview-grid") || null);
+  setTarget(slotAt(e.clientX, e.clientY));
 }
-function setTarget(target) {
-  if (drag.target === target) return;
-  drag.target?.classList.remove("drop-target");
-  drag.target = target;
-  drag.target?.classList.add("drop-target");
+// The cell under the pointer: the nearest card or empty cell (the gaps between them count
+// too); on a wide card the left or right half decides. -1 away from the mockup.
+function slotAt(x, y) {
+  let best = null, nearest = Infinity;
+  for (const cell of document.querySelectorAll("#layout-preview [data-slot]")) {
+    const r = cell.getBoundingClientRect();
+    const distance = Math.hypot(Math.max(r.left - x, 0, x - r.right), Math.max(r.top - y, 0, y - r.bottom));
+    if (distance < nearest) { nearest = distance; best = { cell, r }; }
+  }
+  if (!best || nearest > 16) return -1;
+  let slot = Number(best.cell.dataset.slot);
+  if (best.cell.classList.contains("wide") && x > (best.r.left + best.r.right) / 2) slot += 1;
+  return slot;
+}
+function setTarget(slot) {
+  if (drag.target === slot) return;
+  drag.target = slot;
+  const result = slot >= 0 ? arrange(layout.tiles, drag.moving, slot) : null;
+  drag.preview = result;
+  // Off the grid: a tile from the grid shows where it came from; a new one shows nowhere yet.
+  renderPreview({ result: result || liveEntries(), moving: drag.moving });
 }
 function endDrag(drop) {
-  const { target, source } = drag;
-  setTarget(null);
-  drag.ghost?.remove();
-  drag.ghost = null;
-  drag.active = false;
-  drag.suppressUntil = Date.now() + 400;
-  clearInterval(drag.scroller);
-  drag.last = null;
-  document.body.classList.remove("dragging");
+  const { preview } = drag;
+  document.removeEventListener("pointermove", moveDrag);
+  document.removeEventListener("pointerup", finishDrag);
+  document.removeEventListener("pointercancel", finishDrag);
   document.removeEventListener("touchmove", blockScroll);
-  try { drag.element.releasePointerCapture(drag.pointerId); } catch {}
-  if (!drop || !target) return;
-  const to = target.dataset.index !== undefined ? Number(target.dataset.index) : layout.tiles.length;
-  if (source.kind === "tile") { if (to !== source.index) move(source.index, to); }
-  else addTile(source.id, to);
+  try { document.documentElement.releasePointerCapture(drag.pointerId); } catch {}
+  drag.ghost?.remove();
+  Object.assign(drag, { ghost: null, active: false, suppressUntil: Date.now() + 400, last: null, start: null, moving: null, target: null, preview: null });
+  clearInterval(drag.scroller);
+  document.body.classList.remove("dragging");
+  if (!(drop && preview && commit(preview))) renderPreview();
 }
 window.addEventListener("click", (e) => { if (Date.now() < drag.suppressUntil) { e.stopPropagation(); e.preventDefault(); } }, true);
 function renderResults() {
@@ -934,7 +1099,7 @@ function renderResults() {
       node("span", chosen.has(entity.id) ? "✓" : "+", "plus"),
     );
     b.disabled = chosen.has(entity.id) || layout.tiles.length >= tileLimit();
-    b.onclick = () => addTile(entity.id, layout.tiles.length);
+    b.onclick = () => addTile(entity.id);
     if (!b.disabled) enableDrag(b, { kind: "entity", id: entity.id });
     $("#results").append(b);
   }
@@ -995,6 +1160,7 @@ $("#save").onclick = async () => {
   }
 };
 $("#title").oninput = () => { markDirty(); renderPreview(); };
+$("#add-page").onclick = addPage;
 $("#search").oninput = renderResults;
 $("#refresh").onclick = refresh;
 for (const [value, label] of [

screen_manager/app/static/index.html

@@ -98,9 +98,13 @@
                 <span id="count">0 / 10</span>
               </div>
               <div id="layout-preview" aria-label="Schermindeling"></div>
+              <button id="add-page" class="quiet add-page" type="button">
+                ＋ Pagina toevoegen
+              </button>
               <p id="no-tiles" class="hint">
                 Voeg je eerste lamp, scène of apparaat toe via de kiezer.
               </p>
+              <p id="positions-hint" class="hint" hidden></p>
             </div>
             <div class="picker">
               <label for="search">Voeg een entiteit toe</label

screen_manager/app/static/style.css

@@ -331,14 +331,16 @@ aside h2 {
   background: white;
   margin: 0;
 }
-.drop-target {
-  outline: 2px solid var(--accent);
-  outline-offset: 2px;
-  background: var(--soft) !important;
-}
 body.dragging {
   cursor: grabbing;
   user-select: none;
+  -webkit-user-select: none;
+}
+/* Dragging a card must never start a text selection; the search box stays editable. */
+.tile-editor,
+.picker #results {
+  user-select: none;
+  -webkit-user-select: none;
 }
 #editor,
 .empty {
@@ -839,15 +841,28 @@ pre {
 .filters button { display: inline-flex; align-items: center; gap: 5px; }
 .filters .domain-icon { width: 20px; height: 20px; flex-basis: 20px; font-size: 15px; }
 .screen-preview { background: #e7e7e7; border: 1px solid #d9dde2; border-radius: 22px; padding: 14px; margin-top: 14px; }
-.preview-heading { display: block; color: #49515a; margin: 0 2px 12px; }
+.preview-heading { display: flex; align-items: center; gap: 8px; color: #49515a; margin: 0 2px 12px; }
+.preview-heading .page-note { color: var(--muted); }
+.preview-heading .mini { margin-left: auto; padding: 3px 10px; border-radius: 8px; font-size: 12px; font-weight: 600; background: white; color: var(--ink); border: 1px solid var(--line); }
 .preview-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 9px; }
 .preview-tile { background: white; color: #25282c; border: 1px solid #ddd; border-radius: 15px; padding: 12px; min-height: 90px; text-align: left; display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
 .preview-tile strong { flex: 1; min-width: 0; font-size: 13px; overflow-wrap: anywhere; }
 .preview-tile .domain-icon { width: 30px; height: 30px; flex-basis: 30px; font-size: 20px; }
 .preview-tile.chosen { outline: 2px solid var(--accent); outline-offset: 1px; }
 .preview-tile.wide { grid-column: span 2; }
-.preview-gap { min-height: 90px; border: 1px dashed #d0d4d9; border-radius: 15px; }
-.preview-tile.vacant { background: #f4f4f4; border-style: dashed; color: #727982; justify-content: center; }
+/* Empty cells are real places on the screen: a drop target, and a click marks where the next tile goes. */
+.preview-cell { min-height: 90px; padding: 8px; border: 1px dashed #cfd4da; border-radius: 15px; background: transparent; color: #a3abb5; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 2px; font-weight: 500; cursor: pointer; }
+.preview-cell span { font-size: 20px; line-height: 1; }
+.preview-cell small { font-size: 11px; }
+.preview-cell:hover, .preview-cell:focus-visible { border-color: #9eb6cf; color: #4b5563; background: #fbfcfd; }
+.preview-cell.insert-here { border: 2px dashed var(--accent); color: var(--accent); background: var(--soft); }
+/* The dragged tile, drawn where it will land; the drop confirms exactly this. */
+.preview-tile.placeholder { opacity: 0.6; border: 2px dashed var(--accent); background: var(--soft); box-shadow: none; cursor: default; }
+.preview-tile.placeholder .preview-remove { display: none; }
+.screen-preview.new-page { background: transparent; border: 2px dashed #cfd4da; }
+.add-page { margin-top: 12px; width: 100%; border: 1px dashed #cfd4da; background: transparent; color: var(--muted); }
+.add-page:hover:not(:disabled) { border-color: #9eb6cf; color: var(--ink); background: #fbfcfd; }
+.screen-preview.new-page .preview-cell { border-color: #e3e7ec; }
 .preview-slider { height: 13px; flex-basis: 100%; border-radius: 10px; background: linear-gradient(to right, #ffbf38 60%, #fff1d3 60%); }
 /* Miniature direct controls on a wide mockup card, in the shapes the screen draws. */
 .preview-controls { display: flex; align-items: center; gap: 4px; flex: none; margin-right: 18px; color: #1b1b1b; }

screen_manager/config.yaml

@@ -1,5 +1,5 @@
 name: ESP Screen Manager
-version: "0.2.30"
+version: "0.2.31"
 slug: esp_screen_manager
 description: Kies tegels voor je CYD en Guition touchscreen, zonder opnieuw flashen.
 url: https://github.com/MaxGramser/homeassistant_espscreen