@camstack/types 1.2.447 → 1.2.449

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-UXDHn-oJ.js");
+const require_sleep = require("./sleep-BSPhInRm.js");
 const require_event_category = require("./event-category-E17zaHjN.js");
 const require_composition = require("./composition-CO6Sak-s.js");
 const require_node_color = require("./node-color.js");
@@ -66607,6 +66607,39 @@ var EMPTY_REMOTE_ASSUMED_STATE = {
 	muted: null
 };
 var MAX_LAYOUT_SPAN = 24;
+var MAX_LAYOUT_GROUPS = 50;
+/**
+* Closed vocabularies the UI knows how to DRAW (D973). A layout names a shape,
+* a tone or a frame; it never carries a style. An addon that contributes a
+* component picks from these lists — it ships no UI code.
+*/
+var REMOTE_BUTTON_SHAPES = [
+	"rect",
+	"rounded",
+	"round",
+	"pill"
+];
+var RemoteButtonShapeSchema = zod.z.enum(REMOTE_BUTTON_SHAPES);
+var REMOTE_BUTTON_TONES = [
+	"neutral",
+	"accent",
+	"danger",
+	"red",
+	"green",
+	"yellow",
+	"blue"
+];
+var RemoteButtonToneSchema = zod.z.enum(REMOTE_BUTTON_TONES);
+var REMOTE_GROUP_FRAMES = [
+	"none",
+	"panel",
+	"divider",
+	"dpad",
+	"rocker-v",
+	"rocker-h",
+	"keypad"
+];
+var RemoteGroupFrameSchema = zod.z.enum(REMOTE_GROUP_FRAMES);
 var RemoteLayoutButtonSchema = zod.z.object({
 	id: zod.z.string().min(1).max(40),
 	/** 0-based grid position. */
@@ -66616,12 +66649,94 @@ var RemoteLayoutButtonSchema = zod.z.object({
 	colSpan: zod.z.number().int().min(1).max(24),
 	icon: zod.z.string().min(1).max(60).optional(),
 	label: zod.z.string().min(1).max(40).optional(),
-	role: RemoteRoleSchema
+	role: RemoteRoleSchema,
+	/** Absent = the plain rendering every layout had before shapes existed. */
+	shape: RemoteButtonShapeSchema.optional(),
+	tone: RemoteButtonToneSchema.optional(),
+	/** The group this button belongs to; it must lie inside that group's rectangle. */
+	groupId: zod.z.string().min(1).max(40).optional()
+});
+/**
+* A rectangle of the grid that moves as ONE thing and is drawn with a frame: a
+* titled panel, a section divider, a D-pad ring. `componentId` names the palette
+* entry it came from (informational: the layout is self-contained).
+*/
+var RemoteLayoutGroupSchema = zod.z.object({
+	id: zod.z.string().min(1).max(40),
+	componentId: zod.z.string().min(1).max(80),
+	frame: RemoteGroupFrameSchema,
+	row: zod.z.number().int().min(0).max(24),
+	col: zod.z.number().int().min(0).max(24),
+	rowSpan: zod.z.number().int().min(1).max(24),
+	colSpan: zod.z.number().int().min(1).max(24),
+	title: zod.z.string().min(1).max(40).optional()
 });
+function rectsOverlap(a, b) {
+	return a.row < b.row + b.rowSpan && b.row < a.row + a.rowSpan && a.col < b.col + b.colSpan && b.col < a.col + a.colSpan;
+}
+function rectContains(outer, inner) {
+	return inner.row >= outer.row && inner.col >= outer.col && inner.row + inner.rowSpan <= outer.row + outer.rowSpan && inner.col + inner.colSpan <= outer.col + outer.colSpan;
+}
+/**
+* The group rules of a layout: inside the grid, no two groups overlap, a
+* member lies inside its group, a divider holds nothing, and a button that is
+* not a member never sits inside someone else's rectangle (a group moves as
+* one thing, so a stray key under it would be left behind).
+*/
+function refineGroups(grid, ctx) {
+	const groups = grid.groups ?? [];
+	const byId = /* @__PURE__ */ new Map();
+	const fail = (message, path) => {
+		ctx.addIssue({
+			code: "custom",
+			message,
+			path
+		});
+	};
+	groups.forEach((group, index) => {
+		if (byId.has(group.id)) fail(`group id "${group.id}" is used twice`, [
+			"groups",
+			index,
+			"id"
+		]);
+		byId.set(group.id, group);
+		if (group.row + group.rowSpan > grid.rows || group.col + group.colSpan > grid.columns) fail(`group "${group.id}" leaves the grid`, ["groups", index]);
+		for (let other = 0; other < index; other += 1) {
+			const earlier = groups[other];
+			if (earlier !== void 0 && rectsOverlap(earlier, group)) {
+				fail(`groups "${earlier.id}" and "${group.id}" overlap`, ["groups", index]);
+				return;
+			}
+		}
+	});
+	grid.buttons.forEach((button, index) => {
+		if (button.groupId !== void 0) {
+			const group = byId.get(button.groupId);
+			if (group === void 0) {
+				fail(`button "${button.id}" names the unknown group "${button.groupId}"`, [
+					"buttons",
+					index,
+					"groupId"
+				]);
+				return;
+			}
+			if (group.frame === "divider") fail(`a divider group ("${group.id}") holds no buttons`, [
+				"buttons",
+				index,
+				"groupId"
+			]);
+			if (!rectContains(group, button)) fail(`button "${button.id}" lies outside its group "${group.id}"`, ["buttons", index]);
+			return;
+		}
+		const foreign = groups.find((group) => rectsOverlap(group, button));
+		if (foreign !== void 0) fail(`button "${button.id}" lies inside group "${foreign.id}" but is not a member`, ["buttons", index]);
+	});
+}
 var RemoteLayoutPayloadSchema = zod.z.object({
 	columns: zod.z.number().int().min(1).max(24),
 	rows: zod.z.number().int().min(1).max(24),
-	buttons: zod.z.array(RemoteLayoutButtonSchema).max(200)
+	buttons: zod.z.array(RemoteLayoutButtonSchema).max(200),
+	groups: zod.z.array(RemoteLayoutGroupSchema).max(50).optional()
 }).superRefine((grid, ctx) => {
 	const ids = /* @__PURE__ */ new Set();
 	const taken = /* @__PURE__ */ new Map();
@@ -66658,6 +66773,7 @@ var RemoteLayoutPayloadSchema = zod.z.object({
 			taken.set(cell, button.id);
 		}
 	});
+	refineGroups(grid, ctx);
 });
 //#endregion
 //#region src/capabilities/remote.cap.ts
@@ -66887,6 +67003,121 @@ var templateCapability = {
 	}
 };
 //#endregion
+//#region src/remote/remote-components.ts
+/**
+* A remote layout COMPONENT (D973): a reusable, named chunk of a remote — a
+* D-pad, a keypad, a section divider — offered in the template editor's
+* "Add component" palette. Pure data: the buttons are placed RELATIVE to the
+* component, and the frame, shape and tone are names from the closed
+* vocabularies the UI draws. An addon contributes components through the
+* `remote-layout-components` cap and ships no UI code.
+*/
+var REMOTE_COMPONENT_CATEGORIES = [
+	"power",
+	"navigation",
+	"volume",
+	"numbers",
+	"media",
+	"colour",
+	"apps",
+	"layout"
+];
+var RemoteComponentCategorySchema = zod.z.enum(REMOTE_COMPONENT_CATEGORIES);
+var MAX_COMPONENT_BUTTONS = 40;
+/** `<namespace>:<name>`, both lowercase slugs — `core:dpad`, `<addonId>:<name>`. */
+var COMPONENT_ID_RE = /^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_-]*$/;
+var RemoteComponentButtonSchema = zod.z.object({
+	/** Joined to the instance id when the component is inserted. */
+	idSuffix: zod.z.string().regex(/^[a-z0-9][a-z0-9_-]{0,19}$/, { message: "a short lowercase slug" }),
+	row: zod.z.number().int().min(0).max(24),
+	col: zod.z.number().int().min(0).max(24),
+	rowSpan: zod.z.number().int().min(1).max(24),
+	colSpan: zod.z.number().int().min(1).max(24),
+	role: RemoteRoleSchema,
+	icon: zod.z.string().min(1).max(60).optional(),
+	label: zod.z.string().min(1).max(40).optional(),
+	shape: RemoteButtonShapeSchema.optional(),
+	tone: RemoteButtonToneSchema.optional()
+});
+var RemoteLayoutComponentSchema = zod.z.object({
+	id: zod.z.string().max(80).regex(COMPONENT_ID_RE, { message: "<namespace>:<name>, lowercase" }),
+	name: zod.z.string().min(1).max(60),
+	nameI18n: zod.z.object({
+		en: zod.z.string().min(1).max(60),
+		it: zod.z.string().min(1).max(60)
+	}).optional(),
+	/** A display icon key, resolved by the UI like a button icon. */
+	icon: zod.z.string().min(1).max(60),
+	category: RemoteComponentCategorySchema,
+	size: zod.z.object({
+		rows: zod.z.number().int().min(1).max(24),
+		cols: zod.z.number().int().min(1).max(24)
+	}),
+	/** The frame drawn around the whole component, or null for loose buttons. */
+	group: zod.z.object({
+		frame: RemoteGroupFrameSchema,
+		title: zod.z.string().min(1).max(40).optional()
+	}).nullable(),
+	buttons: zod.z.array(RemoteComponentButtonSchema).max(40)
+}).superRefine((component, ctx) => {
+	const suffixes = /* @__PURE__ */ new Set();
+	component.buttons.forEach((button, index) => {
+		if (suffixes.has(button.idSuffix)) ctx.addIssue({
+			code: "custom",
+			message: `button "${button.idSuffix}" is listed twice`,
+			path: [
+				"buttons",
+				index,
+				"idSuffix"
+			]
+		});
+		suffixes.add(button.idSuffix);
+		if (button.row + button.rowSpan > component.size.rows || button.col + button.colSpan > component.size.cols) {
+			ctx.addIssue({
+				code: "custom",
+				message: `button "${button.idSuffix}" leaves the component`,
+				path: ["buttons", index]
+			});
+			return;
+		}
+		for (let other = 0; other < index; other += 1) {
+			const earlier = component.buttons[other];
+			if (earlier !== void 0 && rectsOverlap(earlier, button)) {
+				ctx.addIssue({
+					code: "custom",
+					message: `buttons "${earlier.idSuffix}" and "${button.idSuffix}" overlap`,
+					path: ["buttons", index]
+				});
+				return;
+			}
+		}
+	});
+	if (component.group?.frame === "divider" && component.buttons.length > 0) ctx.addIssue({
+		code: "custom",
+		message: "a divider component holds no buttons",
+		path: ["buttons"]
+	});
+});
+//#endregion
+//#region src/capabilities/remote-layout-components.cap.ts
+/**
+* remote-layout-components — the palette of the remote template editor's "Add
+* component" (D973). A provider DECLARES components as data (buttons placed
+* relative to the component, a frame, shapes and tones from closed
+* vocabularies the UI draws); it ships no UI code.
+*
+* Collection: `listComponents` returns an array, so the generated mount
+* concat-fans it across every enabled provider. The core-blocks builtin
+* provides the built-in set (`core:*`); an addon adds its own under
+* `<addonId>:<name>`. The caller dedupes by id, built-ins first.
+*/
+var remoteLayoutComponentsCapability = {
+	name: "remote-layout-components",
+	scope: "system",
+	mode: "collection",
+	methods: { listComponents: require_sleep.method(zod.z.object({}), zod.z.array(RemoteLayoutComponentSchema), { auth: "protected" }) }
+};
+//#endregion
 //#region src/capabilities/button.cap.ts
 /**
 * button — device-scoped capability for HA `button.*` / `input_button.*`
@@ -82956,6 +83187,467 @@ var PIPELINE_OWNER_CAPABILITY_NAMES = [
 	"pipeline-runner"
 ];
 //#endregion
+//#region src/remote/remote-layout-ops.ts
+var LAYOUT_EDIT_REFUSALS = [
+	"outside",
+	"overlap",
+	"unknown-group",
+	"too-many"
+];
+var refuse = (reason) => ({
+	ok: false,
+	reason
+});
+function withGroups(layout, groups) {
+	const { groups: _previous, ...rest } = layout;
+	return groups.length === 0 ? rest : {
+		...rest,
+		groups: [...groups]
+	};
+}
+function fitsGrid(layout, rect) {
+	return rect.row >= 0 && rect.col >= 0 && rect.row + rect.rowSpan <= layout.rows && rect.col + rect.colSpan <= layout.columns;
+}
+/** The columns a component must be scaled by to span the whole grid width, or null when it does not divide. */
+function fillWidthScale(layout, component) {
+	const factor = layout.columns / component.size.cols;
+	return Number.isInteger(factor) && factor >= 1 ? factor : null;
+}
+function titleOf(title) {
+	return title === void 0 ? {} : { title };
+}
+function slug$1(value) {
+	return (value.includes(":") ? value.slice(value.indexOf(":") + 1) : value).replace(/[^a-z0-9_-]/g, "-").slice(0, 16);
+}
+function uniqueId(base, taken) {
+	if (!taken.has(base)) return base;
+	for (let n = 2;; n += 1) {
+		const candidate = `${base}-${n}`;
+		if (!taken.has(candidate)) return candidate;
+	}
+}
+function freePrefix(base, placed, taken) {
+	for (let n = 1;; n += 1) {
+		const candidate = n === 1 ? base : `${base}-${n}`;
+		if (!placed.some((p) => taken.has(`${candidate}-${p.spec.idSuffix}`))) return candidate;
+	}
+}
+/**
+* Put `component` on the layout with its top-left cell at `at`. A component
+* with a group becomes one group whose rectangle is the whole component and
+* whose members are its buttons; one without is a set of loose buttons. The
+* grid does not grow: a component that does not fit is refused `outside`, one
+* that would sit on an existing key or group `overlap`.
+*/
+function insertComponent(layout, component, at, options = {}) {
+	const rowScale = options.scale?.rows ?? 1;
+	const colScale = options.scale?.cols ?? 1;
+	const bounds = {
+		row: at.row,
+		col: at.col,
+		rowSpan: component.size.rows * rowScale,
+		colSpan: component.size.cols * colScale
+	};
+	if (!fitsGrid(layout, bounds)) return refuse("outside");
+	const specs = [...component.buttons, ...options.extras ?? []];
+	const placed = specs.map((spec) => ({
+		spec,
+		rect: {
+			row: at.row + spec.row * rowScale,
+			col: at.col + spec.col * colScale,
+			rowSpan: spec.rowSpan * rowScale,
+			colSpan: spec.colSpan * colScale
+		}
+	}));
+	const groups = layout.groups ?? [];
+	if ((component.group === null ? placed.map((p) => p.rect) : [bounds]).some((rect) => layout.buttons.some((b) => rectsOverlap(b, rect)) || groups.some((g) => rectsOverlap(g, rect)))) return refuse("overlap");
+	if (layout.buttons.length + specs.length > 200 || groups.length + (component.group === null ? 0 : 1) > 50) return refuse("too-many");
+	const base = slug$1(component.id);
+	const takenButtons = new Set(layout.buttons.map((b) => b.id));
+	const takenGroups = new Set(groups.map((g) => g.id));
+	const groupId = component.group === null ? null : uniqueId(base, takenGroups);
+	const prefix = groupId ?? freePrefix(base, placed, takenButtons);
+	const buttons = placed.map(({ spec, rect }) => ({
+		id: `${prefix}-${spec.idSuffix}`,
+		...rect,
+		role: spec.role,
+		...spec.icon === void 0 ? {} : { icon: spec.icon },
+		...spec.label === void 0 ? {} : { label: spec.label },
+		...spec.shape === void 0 ? {} : { shape: spec.shape },
+		...spec.tone === void 0 ? {} : { tone: spec.tone },
+		...groupId === null ? {} : { groupId }
+	}));
+	const group = component.group === null || groupId === null ? [] : [{
+		id: groupId,
+		componentId: component.id,
+		frame: component.group.frame,
+		...bounds,
+		...titleOf(options.title ?? component.group.title)
+	}];
+	return {
+		ok: true,
+		layout: withGroups({
+			...layout,
+			buttons: [...layout.buttons, ...buttons]
+		}, [...groups, ...group]),
+		groupId,
+		buttonIds: buttons.map((b) => b.id)
+	};
+}
+/** Move a group and every member by the same offset, atomically. */
+function moveGroup(layout, groupId, to) {
+	const groups = layout.groups ?? [];
+	const group = groups.find((g) => g.id === groupId);
+	if (group === void 0) return refuse("unknown-group");
+	const moved = {
+		...group,
+		row: to.row,
+		col: to.col
+	};
+	if (!fitsGrid(layout, moved)) return refuse("outside");
+	const dRow = to.row - group.row;
+	const dCol = to.col - group.col;
+	const isMember = (b) => b.groupId === groupId;
+	if (groups.some((g) => g.id !== groupId && rectsOverlap(g, moved)) || layout.buttons.some((b) => !isMember(b) && rectsOverlap(b, moved))) return refuse("overlap");
+	return {
+		ok: true,
+		layout: {
+			...layout,
+			buttons: layout.buttons.map((b) => isMember(b) ? {
+				...b,
+				row: b.row + dRow,
+				col: b.col + dCol
+			} : b),
+			groups: groups.map((g) => g.id === groupId ? moved : g)
+		}
+	};
+}
+/**
+* Delete a group. With `keepButtons` its members stay where they are as loose
+* keys; without, they go with it.
+*/
+function removeGroup(layout, groupId, options) {
+	const groups = layout.groups ?? [];
+	if (!groups.some((g) => g.id === groupId)) return refuse("unknown-group");
+	const buttons = options.keepButtons ? layout.buttons.map((b) => {
+		if (b.groupId !== groupId) return b;
+		const { groupId: _gone, ...rest } = b;
+		return rest;
+	}) : layout.buttons.filter((b) => b.groupId !== groupId);
+	return {
+		ok: true,
+		layout: withGroups({
+			...layout,
+			buttons
+		}, groups.filter((g) => g.id !== groupId))
+	};
+}
+/** Dissolve a group, keeping its buttons in place. */
+function ungroup(layout, groupId) {
+	return removeGroup(layout, groupId, { keepButtons: true });
+}
+//#endregion
+//#region src/remote/remote-builtin-components.ts
+var btn = (idSuffix, row, col, init) => ({
+	idSuffix,
+	row,
+	col,
+	rowSpan: 1,
+	colSpan: 1,
+	...init
+});
+function rocker(id, name, it, frame, title, buttons, size) {
+	return {
+		id,
+		name,
+		nameI18n: {
+			en: name,
+			it
+		},
+		icon: frame === "rocker-v" ? "chevrons-up-down" : "chevrons-left-right",
+		category: id.includes("channel") || id.includes("volume") ? "volume" : "navigation",
+		size,
+		group: title === null ? { frame } : {
+			frame,
+			title
+		},
+		buttons
+	};
+}
+var BUILTIN_REMOTE_COMPONENTS = [
+	{
+		id: "core:power",
+		name: "Power",
+		nameI18n: {
+			en: "Power",
+			it: "Accensione"
+		},
+		icon: "power",
+		category: "power",
+		size: {
+			rows: 1,
+			cols: 1
+		},
+		group: null,
+		buttons: [btn("power", 0, 0, {
+			role: "power",
+			shape: "round",
+			tone: "danger"
+		})]
+	},
+	{
+		id: "core:dpad",
+		name: "D-pad with OK",
+		nameI18n: {
+			en: "D-pad with OK",
+			it: "Croce direzionale con OK"
+		},
+		icon: "gamepad-2",
+		category: "navigation",
+		size: {
+			rows: 3,
+			cols: 3
+		},
+		group: { frame: "dpad" },
+		buttons: [
+			btn("up", 0, 1, {
+				role: "up",
+				icon: "chevron-up"
+			}),
+			btn("left", 1, 0, {
+				role: "left",
+				icon: "chevron-left"
+			}),
+			btn("ok", 1, 1, {
+				role: "ok",
+				shape: "round",
+				tone: "accent"
+			}),
+			btn("right", 1, 2, {
+				role: "right",
+				icon: "chevron-right"
+			}),
+			btn("down", 2, 1, {
+				role: "down",
+				icon: "chevron-down"
+			})
+		]
+	},
+	rocker("core:rocker-volume-v", "Volume rocker", "Bilanciere volume", "rocker-v", "VOL", [btn("up", 0, 0, {
+		role: "volume_up",
+		icon: "plus",
+		shape: "pill"
+	}), btn("down", 1, 0, {
+		role: "volume_down",
+		icon: "minus",
+		shape: "pill"
+	})], {
+		rows: 2,
+		cols: 1
+	}),
+	rocker("core:rocker-channel-v", "Channel rocker", "Bilanciere canali", "rocker-v", "CH", [btn("up", 0, 0, {
+		role: "channel_up",
+		icon: "chevron-up",
+		shape: "pill"
+	}), btn("down", 1, 0, {
+		role: "channel_down",
+		icon: "chevron-down",
+		shape: "pill"
+	})], {
+		rows: 2,
+		cols: 1
+	}),
+	rocker("core:rocker-h", "Minus / plus rocker", "Bilanciere meno / più", "rocker-h", null, [btn("minus", 0, 0, {
+		role: "custom:minus",
+		label: "Minus",
+		icon: "minus",
+		shape: "pill"
+	}), btn("plus", 0, 1, {
+		role: "custom:plus",
+		label: "Plus",
+		icon: "plus",
+		shape: "pill"
+	})], {
+		rows: 1,
+		cols: 2
+	}),
+	{
+		id: "core:keypad",
+		name: "Numeric keypad",
+		nameI18n: {
+			en: "Numeric keypad",
+			it: "Tastierino numerico"
+		},
+		icon: "grid-3x3",
+		category: "numbers",
+		size: {
+			rows: 4,
+			cols: 3
+		},
+		group: { frame: "keypad" },
+		buttons: [...Array.from({ length: 9 }, (_, i) => btn(`d${i + 1}`, Math.floor(i / 3), i % 3, { role: `digit_${i + 1}` })), btn("d0", 3, 1, { role: "digit_0" })]
+	},
+	{
+		id: "core:colour-keys",
+		name: "Colour keys",
+		nameI18n: {
+			en: "Colour keys",
+			it: "Tasti colorati"
+		},
+		icon: "palette",
+		category: "colour",
+		size: {
+			rows: 1,
+			cols: 4
+		},
+		group: null,
+		buttons: [
+			btn("red", 0, 0, {
+				role: "custom:color_red",
+				label: "Red",
+				tone: "red"
+			}),
+			btn("green", 0, 1, {
+				role: "custom:color_green",
+				label: "Green",
+				tone: "green"
+			}),
+			btn("yellow", 0, 2, {
+				role: "custom:color_yellow",
+				label: "Yellow",
+				tone: "yellow"
+			}),
+			btn("blue", 0, 3, {
+				role: "custom:color_blue",
+				label: "Blue",
+				tone: "blue"
+			})
+		]
+	},
+	{
+		id: "core:media-transport",
+		name: "Media transport",
+		nameI18n: {
+			en: "Media transport",
+			it: "Controlli multimediali"
+		},
+		icon: "play",
+		category: "media",
+		size: {
+			rows: 1,
+			cols: 5
+		},
+		group: null,
+		buttons: [
+			btn("rewind", 0, 0, {
+				role: "rewind",
+				icon: "rewind"
+			}),
+			btn("play", 0, 1, {
+				role: "play",
+				icon: "play"
+			}),
+			btn("pause", 0, 2, {
+				role: "pause",
+				icon: "pause"
+			}),
+			btn("forward", 0, 3, {
+				role: "fast_forward",
+				icon: "fast-forward"
+			}),
+			btn("stop", 0, 4, {
+				role: "stop",
+				icon: "square"
+			})
+		]
+	},
+	{
+		id: "core:apps-row",
+		name: "App row",
+		nameI18n: {
+			en: "App row",
+			it: "Riga di app"
+		},
+		icon: "app-window",
+		category: "apps",
+		size: {
+			rows: 1,
+			cols: 4
+		},
+		group: null,
+		buttons: [
+			1,
+			2,
+			3,
+			4
+		].map((n) => btn(`app${n}`, 0, n - 1, { role: `custom:app_slot_${n}` }))
+	},
+	{
+		id: "core:back-home-menu",
+		name: "Back, Home, Menu",
+		nameI18n: {
+			en: "Back, Home, Menu",
+			it: "Indietro, Home, Menu"
+		},
+		icon: "house",
+		category: "navigation",
+		size: {
+			rows: 1,
+			cols: 3
+		},
+		group: null,
+		buttons: [
+			btn("back", 0, 0, { role: "back" }),
+			btn("home", 0, 1, { role: "home" }),
+			btn("menu", 0, 2, { role: "menu" })
+		]
+	},
+	{
+		id: "core:section-divider",
+		name: "Section divider",
+		nameI18n: {
+			en: "Section divider",
+			it: "Divisore di sezione"
+		},
+		icon: "separator-horizontal",
+		category: "layout",
+		size: {
+			rows: 1,
+			cols: 1
+		},
+		group: {
+			frame: "divider",
+			title: "Section"
+		},
+		buttons: []
+	},
+	{
+		id: "core:panel",
+		name: "Titled panel",
+		nameI18n: {
+			en: "Titled panel",
+			it: "Pannello con titolo"
+		},
+		icon: "panel-top",
+		category: "layout",
+		size: {
+			rows: 2,
+			cols: 3
+		},
+		group: {
+			frame: "panel",
+			title: "Panel"
+		},
+		buttons: []
+	}
+];
+/** A built-in component by id (the presets compose from these). */
+function builtinRemoteComponent(id) {
+	const found = BUILTIN_REMOTE_COMPONENTS.find((component) => component.id === id);
+	if (found === void 0) throw new Error(`no built-in remote component "${id}"`);
+	return found;
+}
+//#endregion
 //#region src/ir/ir-error.ts
 var IrCodecError = class extends Error {
 	code;
@@ -96959,6 +97651,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"remoteLayoutComponents.listComponents": {
+		capName: "remote-layout-components",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"runningState.getStatus": {
 		capName: "running-state",
 		capScope: "device",
@@ -99322,6 +100021,7 @@ var KNOWN_CAP_NAMES = [
 	"recording-signal",
 	"records",
 	"remote",
+	"remote-layout-components",
 	"running-state",
 	"scene-monitor",
 	"script-runner",
@@ -99542,6 +100242,7 @@ var SYSTEM_CAP_NAMES = [
 	"recording-export",
 	"records",
 	"remote",
+	"remote-layout-components",
 	"server-management",
 	"settings-store",
 	"smtp-provider",
@@ -103540,6 +104241,7 @@ var SYSTEM_CAP_VOCABULARY = {
 	"recording-export": system("recording exports — requested from the timeline, not an automation step"),
 	records: system(INTERNAL),
 	remote: system("the per-device remote setup — authored in the Customize remote editor, sent through the remote UI"),
+	"remote-layout-components": system("the palette of the remote template editor — read-only data, never actuated"),
 	"server-management": system(CLUSTER),
 	"settings-store": system(INTERNAL),
 	"smtp-provider": system(INTERNAL),
@@ -105527,6 +106229,7 @@ var CAPABILITY_NAMES = {
 	recordingSignal: "recording-signal",
 	records: "records",
 	remote: "remote",
+	remoteLayoutComponents: "remote-layout-components",
 	runningState: "running-state",
 	sceneMonitor: "scene-monitor",
 	scriptRunner: "script-runner",
@@ -106166,6 +106869,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "remote",
 		name: "remote"
 	},
+	{
+		key: "remoteLayoutComponents",
+		name: "remote-layout-components"
+	},
 	{
 		key: "runningState",
 		name: "running-state"
@@ -106501,6 +107208,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	recordingSignalCapability,
 	recordsCapability,
 	remoteCapability,
+	remoteLayoutComponentsCapability,
 	runningStateCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
@@ -111291,6 +111999,7 @@ function createSystemProxy(api) {
 			sendCommand: (input) => dispatch("remote", "sendCommand", "mutation", input),
 			sendMediaCommand: (input) => dispatch("remote", "sendMediaCommand", "mutation", input)
 		},
+		remoteLayoutComponents: { listComponents: (input) => dispatch("remoteLayoutComponents", "listComponents", "query", input) },
 		serverManagement: {
 			getServerPackageStatus: (input) => dispatch("serverManagement", "getServerPackageStatus", "query", input),
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
@@ -115526,8 +116235,6 @@ var NC_TEMPLATE_VARS = [
 * delete it from here then, and the served catalog names it again.
 */
 var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
-	"node-restarting",
-	"node-updating",
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
@@ -122371,6 +123078,7 @@ exports.BENCH_ROOT_STEP_ID = BENCH_ROOT_STEP_ID;
 exports.BINARY_AGGREGATES = require_composition.BINARY_AGGREGATES;
 exports.BIRTH_DECISION_DEFAULT_LIMIT = BIRTH_DECISION_DEFAULT_LIMIT;
 exports.BOOT_RECOVERY_BACKOFF_MS = require_sleep.BOOT_RECOVERY_BACKOFF_MS;
+exports.BUILTIN_REMOTE_COMPONENTS = BUILTIN_REMOTE_COMPONENTS;
 exports.BUILTIN_RESULT_KINDS = BUILTIN_RESULT_KINDS;
 exports.BackgroundRunRegistry = BackgroundRunRegistry;
 exports.BacklightModeSchema = BacklightModeSchema;
@@ -123099,6 +123807,7 @@ exports.KeychainWriteRefusedError = require_sleep.KeychainWriteRefusedError;
 exports.LABEL_SUPPLY_MACRO = LABEL_SUPPLY_MACRO;
 exports.LABEL_SUPPLY_STEP_IDS = LABEL_SUPPLY_STEP_IDS;
 exports.LABEL_SUPPLY_VOCABULARIES = LABEL_SUPPLY_VOCABULARIES;
+exports.LAYOUT_EDIT_REFUSALS = LAYOUT_EDIT_REFUSALS;
 exports.LEGACY_READ_ONLY_CONFIG_KEY = LEGACY_READ_ONLY_CONFIG_KEY;
 exports.LIGHT_SHARED_CAPS = LIGHT_SHARED_CAPS;
 exports.LINKED_DEVICES_SLOT = LINKED_DEVICES_SLOT;
@@ -123205,6 +123914,7 @@ exports.MAX_BIRTH_LATENCY_PROXY_MS = MAX_BIRTH_LATENCY_PROXY_MS;
 exports.MAX_CAMERA_SENSORS = MAX_CAMERA_SENSORS;
 exports.MAX_CLIP_EVENT_IDS = MAX_CLIP_EVENT_IDS;
 exports.MAX_CLIP_LABELS = MAX_CLIP_LABELS;
+exports.MAX_COMPONENT_BUTTONS = MAX_COMPONENT_BUTTONS;
 exports.MAX_COMPOSITION_CODE_LENGTH = require_composition.MAX_COMPOSITION_CODE_LENGTH;
 exports.MAX_COMPOSITION_FEATURES = require_composition.MAX_COMPOSITION_FEATURES;
 exports.MAX_COMPOSITION_FIELDS_PER_FEATURE = require_composition.MAX_COMPOSITION_FIELDS_PER_FEATURE;
@@ -123218,6 +123928,7 @@ exports.MAX_EXPRESSION_EVAL_STEPS = require_composition.MAX_EXPRESSION_EVAL_STEP
 exports.MAX_EXPRESSION_SOURCE_LENGTH = require_composition.MAX_EXPRESSION_SOURCE_LENGTH;
 exports.MAX_HELPER_MEMBERS = require_composition.MAX_HELPER_MEMBERS;
 exports.MAX_KEYS = MAX_KEYS;
+exports.MAX_LAYOUT_GROUPS = MAX_LAYOUT_GROUPS;
 exports.MAX_LAYOUT_SPAN = MAX_LAYOUT_SPAN;
 exports.MAX_REASONS_PER_KEY = MAX_REASONS_PER_KEY;
 exports.MAX_REMOTE_BINDINGS = MAX_REMOTE_BINDINGS;
@@ -123786,8 +124497,12 @@ exports.RECOVERY_VIEW_PX = RECOVERY_VIEW_PX;
 exports.REDACTED_SECRET = require_sleep.REDACTED_SECRET;
 exports.REFERENCE_COMPUTE = REFERENCE_COMPUTE;
 exports.REFERENCE_MATCH_FRACTION = REFERENCE_MATCH_FRACTION;
+exports.REMOTE_BUTTON_SHAPES = REMOTE_BUTTON_SHAPES;
+exports.REMOTE_BUTTON_TONES = REMOTE_BUTTON_TONES;
+exports.REMOTE_COMPONENT_CATEGORIES = REMOTE_COMPONENT_CATEGORIES;
 exports.REMOTE_CONFIG_REFUSALS = REMOTE_CONFIG_REFUSALS;
 exports.REMOTE_CUSTOM_ROLE_PREFIX = REMOTE_CUSTOM_ROLE_PREFIX;
+exports.REMOTE_GROUP_FRAMES = REMOTE_GROUP_FRAMES;
 exports.REMOTE_KNOWN_ROLES = REMOTE_KNOWN_ROLES;
 exports.REMOTE_MAX_REPEAT = REMOTE_MAX_REPEAT;
 exports.REMOTE_MEDIA_COMMANDS = REMOTE_MEDIA_COMMANDS;
@@ -123906,10 +124621,17 @@ exports.RemoteAssumedStateSchema = RemoteAssumedStateSchema;
 exports.RemoteBindingActionSchema = RemoteBindingActionSchema;
 exports.RemoteBindingSchema = RemoteBindingSchema;
 exports.RemoteBoundCommandSchema = RemoteBoundCommandSchema;
+exports.RemoteButtonShapeSchema = RemoteButtonShapeSchema;
+exports.RemoteButtonToneSchema = RemoteButtonToneSchema;
 exports.RemoteCommandListSchema = RemoteCommandListSchema;
+exports.RemoteComponentButtonSchema = RemoteComponentButtonSchema;
+exports.RemoteComponentCategorySchema = RemoteComponentCategorySchema;
 exports.RemoteConfigSchema = RemoteConfigSchema;
 exports.RemoteCustomButtonSchema = RemoteCustomButtonSchema;
+exports.RemoteGroupFrameSchema = RemoteGroupFrameSchema;
 exports.RemoteLayoutButtonSchema = RemoteLayoutButtonSchema;
+exports.RemoteLayoutComponentSchema = RemoteLayoutComponentSchema;
+exports.RemoteLayoutGroupSchema = RemoteLayoutGroupSchema;
 exports.RemoteLayoutPayloadSchema = RemoteLayoutPayloadSchema;
 exports.RemoteMediaCommandResultSchema = RemoteMediaCommandResultSchema;
 exports.RemoteMediaCommandSchema = RemoteMediaCommandSchema;
@@ -124481,6 +125203,7 @@ exports.buildTriggerTrace = buildTriggerTrace;
 exports.buildVideoArgs = require_composition.buildVideoArgs;
 exports.buildViewerLink = buildViewerLink;
 exports.builtCapabilityBlockers = builtCapabilityBlockers;
+exports.builtinRemoteComponent = builtinRemoteComponent;
 exports.bundledCamstack = bundledCamstack;
 exports.buttonCapability = buttonCapability;
 exports.calendarEventLocalSpan = calendarEventLocalSpan;
@@ -124770,6 +125493,7 @@ exports.fieldReads = require_composition.fieldReads;
 exports.fieldUnitKeys = fieldUnitKeys;
 exports.fieldsPinnedAtValueBelow = fieldsPinnedAtValueBelow;
 exports.filesystemBrowseCapability = filesystemBrowseCapability;
+exports.fillWidthScale = fillWidthScale;
 exports.findCandidateCycles = findCandidateCycles;
 exports.findCompositionCycles = findCompositionCycles;
 exports.findTimezone = findTimezone;
@@ -124834,6 +125558,7 @@ exports.inferExpressionKinds = inferExpressionKinds;
 exports.inferModelProvider = inferModelProvider;
 exports.ingestReading = ingestReading;
 exports.initialPoolMemoryState = initialPoolMemoryState;
+exports.insertComponent = insertComponent;
 exports.integralCadenceMs = require_composition.integralCadenceMs;
 exports.integralDraft = integralDraft;
 exports.integrateReading = require_composition.integrateReading;
@@ -125013,6 +125738,7 @@ exports.motionDetectionCapability = motionDetectionCapability;
 exports.motionSourceLabel = motionSourceLabel;
 exports.motionTriggerCapability = motionTriggerCapability;
 exports.motionZonesCapability = motionZonesCapability;
+exports.moveGroup = moveGroup;
 exports.mqttBrokerCapability = mqttBrokerCapability;
 exports.nativeObjectDetectionCapability = nativeObjectDetectionCapability;
 exports.navigationCapability = navigationCapability;
@@ -125191,12 +125917,16 @@ exports.recordingOnboardCapability = recordingOnboardCapability;
 exports.recordingSignalCapability = recordingSignalCapability;
 exports.recordsCapability = recordsCapability;
 exports.recordsErrorFromMessage = require_sleep.recordsErrorFromMessage;
+exports.rectContains = rectContains;
+exports.rectsOverlap = rectsOverlap;
 exports.rectsToCells = rectsToCells;
 exports.reducePoints = reducePoints;
 exports.reducerForActive = reducerForActive;
 exports.registerKnownSecret = require_sleep.registerKnownSecret;
 exports.remapCropDetections = remapCropDetections;
 exports.remoteCapability = remoteCapability;
+exports.remoteLayoutComponentsCapability = remoteLayoutComponentsCapability;
+exports.removeGroup = removeGroup;
 exports.removeScalarTarget = removeScalarTarget;
 exports.renameAlarmProfile = renameAlarmProfile;
 exports.renderVocabPhrase = renderVocabPhrase;
@@ -125452,6 +126182,7 @@ exports.transformSecretWrite = require_sleep.transformSecretWrite;
 exports.tryConvertDelta = tryConvertDelta;
 exports.tryConvertUnit = tryConvertUnit;
 exports.turnProviderCapability = turnProviderCapability;
+exports.ungroup = ungroup;
 exports.unitCompanionField = unitCompanionField;
 exports.unitDimension = unitDimension;
 exports.unitsForDimension = unitsForDimension;