@richardmcquiston01/dashboard-widgets-toolkit 0.14.0 → 0.16.0

package/dist/core.cjs

@@ -1,88 +1,5 @@
 'use strict';
 
-// src/core/payload.ts
-var WIDGET_KINDS = [
-  "TEXT",
-  "KPI",
-  "GAUGE",
-  "TABLE",
-  "BAR_LIST",
-  "ALERT_LIST",
-  "GRAPH"
-];
-function isWidgetKind(value) {
-  return typeof value === "string" && WIDGET_KINDS.includes(value);
-}
-var VALUE_FORMATS = ["number", "currency", "percent"];
-var MAX_GRAPH_SERIES = 8;
-var DEFAULT_EMPTY_TEXT = "Nothing to show yet.";
-function emptyWidget(text = DEFAULT_EMPTY_TEXT) {
-  return { empty: true, text };
-}
-function isWidgetEmptyState(payload) {
-  return "empty" in payload && payload.empty === true;
-}
-function emptyTextFor(payload) {
-  if (isWidgetEmptyState(payload)) {
-    return payload.text;
-  }
-  switch (payload.kind) {
-    case "TABLE":
-      return payload.rows.length === 0 ? DEFAULT_EMPTY_TEXT : null;
-    case "BAR_LIST":
-      return payload.items.length === 0 ? DEFAULT_EMPTY_TEXT : null;
-    case "ALERT_LIST":
-      return payload.items.length === 0 ? payload.emptyText : null;
-    case "GRAPH":
-      return payload.series.every((series) => series.points.length === 0) ? DEFAULT_EMPTY_TEXT : null;
-    case "TEXT":
-    case "KPI":
-    case "GAUGE":
-      return null;
-  }
-}
-
-// src/core/compat.ts
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((v) => typeof v === "string");
-}
-function upgradeLegacyWidgetData(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return value;
-  }
-  const record = value;
-  if (record["kind"] === "TABLE" && isStringArray(record["columns"]) && Array.isArray(record["rows"]) && record["rows"].every(isStringArray)) {
-    const rows = record["rows"];
-    return {
-      ...record,
-      columns: record["columns"].map((label) => ({ label })),
-      rows: rows.map((row) => row.map((text) => ({ text })))
-    };
-  }
-  if (record["kind"] === "GRAPH" && Array.isArray(record["points"]) && record["series"] === void 0) {
-    const { points, ...rest } = record;
-    return {
-      ...rest,
-      series: [{ name: "Value", points }],
-      chartType: "bar",
-      valueFormat: "number"
-    };
-  }
-  return value;
-}
-function fromLegacyDefinition(legacy) {
-  if (!isWidgetKind(legacy.viewType)) {
-    return null;
-  }
-  return {
-    key: legacy.widgetKey,
-    title: legacy.title,
-    ...legacy.description === null ? {} : { description: legacy.description },
-    kind: legacy.viewType,
-    sortOrder: legacy.sortOrder
-  };
-}
-
 // src/core/definition.ts
 var WIDGET_SIZES = ["small", "medium", "large", "full"];
 var WIDGET_FILLS = ["height", "width", "both"];
@@ -90,13 +7,15 @@ var NOT_LOCKED = Object.freeze({
   move: false,
   hide: false,
   minimize: false,
-  options: false
+  options: false,
+  clone: false
 });
 var FULLY_LOCKED = Object.freeze({
   move: true,
   hide: true,
   minimize: true,
-  options: true
+  options: true,
+  clone: true
 });
 function resolveWidgetLock(definition) {
   const setting = definition.locked;
@@ -106,7 +25,8 @@ function resolveWidgetLock(definition) {
     move: setting.move === true,
     hide: setting.hide === true,
     minimize: setting.minimize === true,
-    options: setting.options === true
+    options: setting.options === true,
+    clone: setting.clone === true
   };
 }
 function defineWidget(definition) {
@@ -130,6 +50,103 @@ function isWidgetVisibleTo(definition, roles) {
   return definition.roles.some((role) => roles.includes(role));
 }
 
+// src/core/grid.ts
+var WIDTH_COLUMNS = 12;
+var MIN_WIDGET_WIDTH = 2;
+var MAX_WIDGET_WIDTH = 12;
+function isWidgetWidth(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= MIN_WIDGET_WIDTH && value <= MAX_WIDGET_WIDTH;
+}
+function widthForSize(size) {
+  switch (size) {
+    case "small":
+      return 3;
+    case "large":
+      return 6;
+    case "full":
+      return 12;
+    default:
+      return 4;
+  }
+}
+function itemWidth(item) {
+  return isWidgetWidth(item.width) ? item.width : widthForSize(item.defaultSize);
+}
+function usesWidthColumns(items) {
+  return items.some((item) => item.width !== void 0);
+}
+function fillsWidth(fill) {
+  return fill === "width" || fill === "both";
+}
+function fillsHeight(fill) {
+  return fill === "height" || fill === "both";
+}
+function baseColumnSpan(size, columns, largeSpan = 2) {
+  if (size === "full") return columns;
+  if (size === "large") return Math.min(largeSpan, columns);
+  return 1;
+}
+function fillColumnSpans(items, columns, largeSpan = 2) {
+  return placeAndFill(
+    items,
+    columns,
+    (item, trackCount) => baseColumnSpan(item.defaultSize, trackCount, largeSpan)
+  );
+}
+function fillWidthSpans(items) {
+  return placeAndFill(items, WIDTH_COLUMNS, itemWidth);
+}
+function placeRows(items) {
+  return placeAndFillRows(items, WIDTH_COLUMNS, itemWidth).rows;
+}
+function fitCount(items, maxRows) {
+  const rows = placeRows(items);
+  let count = 0;
+  for (const row of rows.slice(0, Math.max(0, Math.floor(maxRows)))) {
+    count += row.keys.length;
+  }
+  return count;
+}
+function placeAndFill(items, columns, spanOf) {
+  return placeAndFillRows(items, columns, spanOf).spans;
+}
+function placeAndFillRows(items, columns, spanOf) {
+  const trackCount = Math.max(1, Math.floor(columns));
+  const spans = /* @__PURE__ */ new Map();
+  const rows = [];
+  let row = [];
+  let used = 0;
+  function closeRow() {
+    if (row.length === 0) return;
+    const fillers = row.filter(({ item }) => fillsWidth(item.fill));
+    const leftover = trackCount - used;
+    const finalSpans = /* @__PURE__ */ new Map();
+    if (fillers.length > 0) {
+      const share = Math.floor(leftover / fillers.length);
+      const remainder = leftover % fillers.length;
+      fillers.forEach(({ item, span }, index) => {
+        const grown = span + share + (index < remainder ? 1 : 0);
+        spans.set(item.key, grown);
+        finalSpans.set(item.key, grown);
+      });
+    }
+    rows.push({
+      keys: row.map(({ item }) => item.key),
+      spans: row.map(({ item, span }) => finalSpans.get(item.key) ?? span)
+    });
+    row = [];
+    used = 0;
+  }
+  for (const item of items) {
+    const span = Math.min(spanOf(item, trackCount), trackCount);
+    if (used + span > trackCount && row.length > 0) closeRow();
+    row.push({ item, span });
+    used += span;
+  }
+  closeRow();
+  return { spans, rows };
+}
+
 // src/core/format.ts
 var DEFAULT_CURRENCY = "USD";
 function localeArgument(locale) {
@@ -215,6 +232,48 @@ function kpiDelta(current, previous, options = {}) {
   };
 }
 
+// src/core/payload.ts
+var WIDGET_KINDS = [
+  "TEXT",
+  "KPI",
+  "GAUGE",
+  "TABLE",
+  "BAR_LIST",
+  "ALERT_LIST",
+  "GRAPH"
+];
+function isWidgetKind(value) {
+  return typeof value === "string" && WIDGET_KINDS.includes(value);
+}
+var VALUE_FORMATS = ["number", "currency", "percent"];
+var MAX_GRAPH_SERIES = 8;
+var DEFAULT_EMPTY_TEXT = "Nothing to show yet.";
+function emptyWidget(text = DEFAULT_EMPTY_TEXT) {
+  return { empty: true, text };
+}
+function isWidgetEmptyState(payload) {
+  return "empty" in payload && payload.empty === true;
+}
+function emptyTextFor(payload) {
+  if (isWidgetEmptyState(payload)) {
+    return payload.text;
+  }
+  switch (payload.kind) {
+    case "TABLE":
+      return payload.rows.length === 0 ? DEFAULT_EMPTY_TEXT : null;
+    case "BAR_LIST":
+      return payload.items.length === 0 ? DEFAULT_EMPTY_TEXT : null;
+    case "ALERT_LIST":
+      return payload.items.length === 0 ? payload.emptyText : null;
+    case "GRAPH":
+      return payload.series.every((series) => series.points.length === 0) ? DEFAULT_EMPTY_TEXT : null;
+    case "TEXT":
+    case "KPI":
+    case "GAUGE":
+      return null;
+  }
+}
+
 // src/core/result.ts
 function ok(value) {
   return { ok: true, value };
@@ -237,41 +296,298 @@ function describeUnknownError(cause) {
   }
 }
 
-// src/core/url.ts
-var SCHEME_PATTERN = /^([a-z][a-z0-9+.-]*):/i;
-var IGNORED_IN_SCHEME = /[\u0000- \u007f]/g;
-function schemeOf(url) {
-  const match = SCHEME_PATTERN.exec(
-    url.replace(IGNORED_IN_SCHEME, "")
-  );
-  return match === null ? null : (match[1] ?? "").toLowerCase();
+// src/core/views.ts
+var BASE_VIEW_KEY = "base";
+var MAX_WIDGET_VIEWS = 8;
+var VIEW_CONVERSIONS = {
+  tableToBarList: { from: "TABLE", to: "BAR_LIST" },
+  tableToGraph: { from: "TABLE", to: "GRAPH" },
+  barListToTable: { from: "BAR_LIST", to: "TABLE" },
+  graphToTable: { from: "GRAPH", to: "TABLE" },
+  barListToGraph: { from: "BAR_LIST", to: "GRAPH" }
+};
+var KIND_LABELS = {
+  TEXT: "Text",
+  KPI: "Number",
+  GAUGE: "Gauge",
+  TABLE: "Table",
+  BAR_LIST: "Bars",
+  ALERT_LIST: "List",
+  GRAPH: "Chart"
+};
+function kindLabel(kind) {
+  return KIND_LABELS[kind];
 }
-function isSafeHref(url) {
-  if (url.trim() === "") {
-    return false;
-  }
-  const scheme = schemeOf(url);
-  return scheme === null || scheme === "http" || scheme === "https" || scheme === "mailto";
+function hasViews(item) {
+  return item.views !== void 0 && item.views.length > 0;
 }
-function isSafeImageUrl(url) {
-  if (url.trim() === "") {
-    return false;
-  }
-  const scheme = schemeOf(url);
-  return scheme === null || scheme === "http" || scheme === "https";
+function findView(item, key) {
+  return item.views?.find((view) => view.key === key);
 }
-
-// src/core/detail.ts
-var DETAIL_MODES = ["client", "server"];
-var DEFAULT_DETAIL_PAGE_SIZE = 25;
-var MAX_DETAIL_PAGE_SIZE = 200;
-function resolveDetailOptions(definition) {
-  const detail = definition.detail;
-  if (detail === void 0 || detail === false) return void 0;
-  const options = detail === true ? {} : detail;
-  return {
-    title: options.title ?? definition.title,
-    pageSize: options.pageSize ?? DEFAULT_DETAIL_PAGE_SIZE,
+function viewChoices(item) {
+  if (!hasViews(item)) return [];
+  return [
+    {
+      key: BASE_VIEW_KEY,
+      label: item.baseViewLabel ?? kindLabel(item.kind),
+      kind: item.kind
+    },
+    ...(item.views ?? []).map(({ key, label, kind }) => ({
+      key,
+      label,
+      kind
+    }))
+  ];
+}
+function isKnownView(item, key) {
+  return key !== void 0 && (key === BASE_VIEW_KEY || findView(item, key) !== void 0);
+}
+function effectiveViewKey(item, chosen) {
+  if (!hasViews(item)) return BASE_VIEW_KEY;
+  if (isKnownView(item, chosen)) return chosen;
+  if (isKnownView(item, item.defaultView)) return item.defaultView;
+  return BASE_VIEW_KEY;
+}
+function viewKind(item, chosen) {
+  return findView(item, effectiveViewKey(item, chosen))?.kind ?? item.kind;
+}
+function cellValue(cell) {
+  const value = cell?.value;
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function columnName(table, index) {
+  return table.columns[index]?.label ?? `#${index + 1}`;
+}
+function checkColumn(table, index, field, context) {
+  if (!Number.isInteger(index) || index < 0 || index >= table.columns.length) {
+    return `${context.where}: ${field} column ${index} does not exist (the table has ${table.columns.length} columns, numbered from 0).`;
+  }
+  return void 0;
+}
+function numericColumn(table, index, context) {
+  const numbers = [];
+  for (const [rowIndex, row] of table.rows.entries()) {
+    const value = cellValue(row[index]);
+    if (value === void 0) {
+      return err(
+        `${context.where}: row ${rowIndex + 1}, column ${index + 1} ("${columnName(table, index)}") has no numeric value. Add value to the cells.`
+      );
+    }
+    numbers.push(value);
+  }
+  return ok(numbers);
+}
+function tableToBarList(table, conversion, context) {
+  const bad = checkColumn(table, conversion.label, "label", context) ?? checkColumn(table, conversion.value, "value", context);
+  if (bad !== void 0) return err(bad);
+  const numbers = numericColumn(table, conversion.value, context);
+  if (!numbers.ok) return numbers;
+  const items = table.rows.map((row, index) => ({
+    label: row[conversion.label]?.text ?? "",
+    value: numbers.value[index],
+    display: row[conversion.value]?.text ?? String(numbers.value[index])
+  }));
+  return ok({ kind: "BAR_LIST", items });
+}
+function tableToGraph(table, conversion, context) {
+  if (conversion.values.length === 0 || conversion.values.length > MAX_GRAPH_SERIES) {
+    return err(
+      `${context.where}: a chart needs 1 to ${MAX_GRAPH_SERIES} series columns, got ${conversion.values.length}.`
+    );
+  }
+  let bad = checkColumn(
+    table,
+    conversion.label,
+    "label",
+    context
+  );
+  for (const index of conversion.values) {
+    bad ??= checkColumn(table, index, "series", context);
+  }
+  if (bad !== void 0) return err(bad);
+  const series = [];
+  for (const index of conversion.values) {
+    const numbers = numericColumn(table, index, context);
+    if (!numbers.ok) return numbers;
+    series.push({
+      name: columnName(table, index),
+      points: table.rows.map((row, rowIndex) => ({
+        label: row[conversion.label]?.text ?? "",
+        value: numbers.value[rowIndex]
+      }))
+    });
+  }
+  return ok({
+    kind: "GRAPH",
+    series,
+    chartType: conversion.chartType,
+    valueFormat: conversion.valueFormat ?? "number",
+    ...conversion.currency === void 0 ? {} : { currency: conversion.currency },
+    xLabel: columnName(table, conversion.label)
+  });
+}
+function barListToTable(list, conversion) {
+  return ok({
+    kind: "TABLE",
+    columns: [
+      { label: conversion.labelHeading ?? "Name" },
+      { label: conversion.valueHeading ?? "Value", numeric: true }
+    ],
+    rows: list.items.map((item) => [
+      { text: item.label },
+      { text: item.display ?? String(item.value), value: item.value }
+    ])
+  });
+}
+function graphToTable(graph, context) {
+  const first = graph.series[0];
+  if (first === void 0)
+    return err(`${context.where}: the chart has no series.`);
+  const format = {
+    ...graph.currency === void 0 ? {} : { currency: graph.currency },
+    ...context.locale === void 0 ? {} : { locale: context.locale }
+  };
+  return ok({
+    kind: "TABLE",
+    columns: [
+      { label: graph.xLabel ?? "Label" },
+      ...graph.series.map((series) => ({ label: series.name, numeric: true }))
+    ],
+    rows: first.points.map((point, index) => [
+      { text: point.label },
+      ...graph.series.map((series) => {
+        const value = series.points[index]?.value;
+        return value === void 0 ? { text: "\u2014" } : { text: formatValue(value, graph.valueFormat, format), value };
+      })
+    ])
+  });
+}
+function barListToGraph(list, conversion) {
+  return ok({
+    kind: "GRAPH",
+    series: [
+      {
+        name: conversion.seriesName ?? "Value",
+        points: list.items.map((item) => ({
+          label: item.label,
+          value: item.value
+        }))
+      }
+    ],
+    chartType: conversion.chartType,
+    valueFormat: conversion.valueFormat ?? "number",
+    ...conversion.currency === void 0 ? {} : { currency: conversion.currency }
+  });
+}
+function convertView(widgetKey, view, data, options = {}) {
+  const conversion = view.convert;
+  const context = {
+    where: `Widget ${JSON.stringify(widgetKey)} view ${JSON.stringify(view.key)}`,
+    ...options.locale === void 0 ? {} : { locale: options.locale }
+  };
+  const expected = VIEW_CONVERSIONS[conversion.type]?.from;
+  if (expected === void 0) {
+    return err(
+      `${context.where}: unknown conversion type ${JSON.stringify(conversion.type)}.`
+    );
+  }
+  if (data.kind !== expected) {
+    return err(
+      `${context.where}: ${conversion.type} reads a ${expected} payload, but the widget returned ${data.kind}.`
+    );
+  }
+  switch (conversion.type) {
+    case "tableToBarList":
+      return tableToBarList(data, conversion, context);
+    case "tableToGraph":
+      return tableToGraph(data, conversion, context);
+    case "barListToTable":
+      return barListToTable(data, conversion);
+    case "graphToTable":
+      return graphToTable(data, context);
+    case "barListToGraph":
+      return barListToGraph(data, conversion);
+  }
+}
+function viewNote(view, data) {
+  if (data?.kind !== "TABLE") return "";
+  const conversion = view.convert;
+  let indexes;
+  if (conversion.type === "tableToBarList") {
+    indexes = [conversion.label, conversion.value];
+  } else if (conversion.type === "tableToGraph") {
+    indexes = [conversion.label, ...conversion.values];
+  } else {
+    return "";
+  }
+  const names = indexes.map(
+    (index) => data.columns[index]?.label ?? `#${index + 1}`
+  );
+  return `Shows ${names.join(", ")} only.`;
+}
+function applyView(widget, chosen, options = {}) {
+  const key = effectiveViewKey(widget.definition, chosen);
+  const view = findView(widget.definition, key);
+  if (view === void 0) return widget;
+  const definition = {
+    ...widget.definition,
+    kind: view.kind
+  };
+  if (widget.status === "loading") return { ...widget, definition };
+  if (widget.status === "empty") return { ...widget, definition };
+  if (widget.status === "error") return { ...widget, definition };
+  const converted = convertView(
+    widget.definition.key,
+    view,
+    widget.data,
+    options
+  );
+  if (!converted.ok) {
+    return {
+      definition,
+      status: "error",
+      error: converted.error,
+      ...widget.options === void 0 ? {} : { options: widget.options }
+    };
+  }
+  return { ...widget, definition, data: converted.value };
+}
+
+// src/core/url.ts
+var SCHEME_PATTERN = /^([a-z][a-z0-9+.-]*):/i;
+var IGNORED_IN_SCHEME = /[\u0000- \u007f]/g;
+function schemeOf(url) {
+  const match = SCHEME_PATTERN.exec(
+    url.replace(IGNORED_IN_SCHEME, "")
+  );
+  return match === null ? null : (match[1] ?? "").toLowerCase();
+}
+function isSafeHref(url) {
+  if (url.trim() === "") {
+    return false;
+  }
+  const scheme = schemeOf(url);
+  return scheme === null || scheme === "http" || scheme === "https" || scheme === "mailto";
+}
+function isSafeImageUrl(url) {
+  if (url.trim() === "") {
+    return false;
+  }
+  const scheme = schemeOf(url);
+  return scheme === null || scheme === "http" || scheme === "https";
+}
+
+// src/core/detail.ts
+var DETAIL_MODES = ["client", "server"];
+var DEFAULT_DETAIL_PAGE_SIZE = 25;
+var MAX_DETAIL_PAGE_SIZE = 200;
+function resolveDetailOptions(definition) {
+  const detail = definition.detail;
+  if (detail === void 0 || detail === false) return void 0;
+  const options = detail === true ? {} : detail;
+  return {
+    title: options.title ?? definition.title,
+    pageSize: options.pageSize ?? DEFAULT_DETAIL_PAGE_SIZE,
     mode: options.mode ?? "client"
   };
 }
@@ -291,15 +607,15 @@ function defaultDetailQuery(pageSize = DEFAULT_DETAIL_PAGE_SIZE) {
 function fold(text) {
   return text.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase();
 }
-function cellValue(cell) {
+function cellValue2(cell) {
   return cell.value ?? cell.text;
 }
 function cellMatches(cell, needle) {
-  return fold(String(cellValue(cell))).includes(needle);
+  return fold(String(cellValue2(cell))).includes(needle);
 }
 function compareCells(a, b, collator) {
-  const left = cellValue(a);
-  const right = cellValue(b);
+  const left = cellValue2(a);
+  const right = cellValue2(b);
   if (typeof left === "number" && typeof right === "number") {
     return left - right;
   }
@@ -591,103 +907,6 @@ function deriveDetailData(data, locale) {
   return void 0;
 }
 
-// src/core/grid.ts
-var WIDTH_COLUMNS = 12;
-var MIN_WIDGET_WIDTH = 2;
-var MAX_WIDGET_WIDTH = 12;
-function isWidgetWidth(value) {
-  return typeof value === "number" && Number.isInteger(value) && value >= MIN_WIDGET_WIDTH && value <= MAX_WIDGET_WIDTH;
-}
-function widthForSize(size) {
-  switch (size) {
-    case "small":
-      return 3;
-    case "large":
-      return 6;
-    case "full":
-      return 12;
-    default:
-      return 4;
-  }
-}
-function itemWidth(item) {
-  return isWidgetWidth(item.width) ? item.width : widthForSize(item.defaultSize);
-}
-function usesWidthColumns(items) {
-  return items.some((item) => item.width !== void 0);
-}
-function fillsWidth(fill) {
-  return fill === "width" || fill === "both";
-}
-function fillsHeight(fill) {
-  return fill === "height" || fill === "both";
-}
-function baseColumnSpan(size, columns, largeSpan = 2) {
-  if (size === "full") return columns;
-  if (size === "large") return Math.min(largeSpan, columns);
-  return 1;
-}
-function fillColumnSpans(items, columns, largeSpan = 2) {
-  return placeAndFill(
-    items,
-    columns,
-    (item, trackCount) => baseColumnSpan(item.defaultSize, trackCount, largeSpan)
-  );
-}
-function fillWidthSpans(items) {
-  return placeAndFill(items, WIDTH_COLUMNS, itemWidth);
-}
-function placeRows(items) {
-  return placeAndFillRows(items, WIDTH_COLUMNS, itemWidth).rows;
-}
-function fitCount(items, maxRows) {
-  const rows = placeRows(items);
-  let count = 0;
-  for (const row of rows.slice(0, Math.max(0, Math.floor(maxRows)))) {
-    count += row.keys.length;
-  }
-  return count;
-}
-function placeAndFill(items, columns, spanOf) {
-  return placeAndFillRows(items, columns, spanOf).spans;
-}
-function placeAndFillRows(items, columns, spanOf) {
-  const trackCount = Math.max(1, Math.floor(columns));
-  const spans = /* @__PURE__ */ new Map();
-  const rows = [];
-  let row = [];
-  let used = 0;
-  function closeRow() {
-    if (row.length === 0) return;
-    const fillers = row.filter(({ item }) => fillsWidth(item.fill));
-    const leftover = trackCount - used;
-    const finalSpans = /* @__PURE__ */ new Map();
-    if (fillers.length > 0) {
-      const share = Math.floor(leftover / fillers.length);
-      const remainder = leftover % fillers.length;
-      fillers.forEach(({ item, span }, index) => {
-        const grown = span + share + (index < remainder ? 1 : 0);
-        spans.set(item.key, grown);
-        finalSpans.set(item.key, grown);
-      });
-    }
-    rows.push({
-      keys: row.map(({ item }) => item.key),
-      spans: row.map(({ item, span }) => finalSpans.get(item.key) ?? span)
-    });
-    row = [];
-    used = 0;
-  }
-  for (const item of items) {
-    const span = Math.min(spanOf(item, trackCount), trackCount);
-    if (used + span > trackCount && row.length > 0) closeRow();
-    row.push({ item, span });
-    used += span;
-  }
-  closeRow();
-  return { spans, rows };
-}
-
 // src/core/options.ts
 var DATE_RANGE_PRESETS = [
   "today",
@@ -993,6 +1212,7 @@ function parseOne(raw) {
   const width = raw["width"];
   const flexible = raw["flexible"];
   const options = raw["options"];
+  const view = raw["view"];
   const cleanTitle = typeof title === "string" ? title.trim().slice(0, MAX_WIDGET_TITLE_LENGTH) : "";
   const chosen = {};
   if (isRecord(options)) {
@@ -1005,7 +1225,8 @@ function parseOne(raw) {
     ...cleanTitle === "" ? {} : { title: cleanTitle },
     ...isWidgetWidth(width) ? { width } : {},
     ...typeof flexible === "boolean" ? { flexible } : {},
-    ...Object.keys(chosen).length === 0 ? {} : { options: chosen }
+    ...Object.keys(chosen).length === 0 ? {} : { options: chosen },
+    ...typeof view === "string" && view !== "" && view.length <= 80 ? { view } : {}
   };
   return Object.keys(settings).length === 0 ? void 0 : settings;
 }
@@ -1032,7 +1253,8 @@ function serializeSettings(settings) {
       ...one.title === void 0 ? {} : { title: one.title },
       ...one.width === void 0 ? {} : { width: one.width },
       ...one.flexible === void 0 ? {} : { flexible: one.flexible },
-      ...one.options === void 0 || Object.keys(one.options).length === 0 ? {} : { options: { ...one.options } }
+      ...one.options === void 0 || Object.keys(one.options).length === 0 ? {} : { options: { ...one.options } },
+      ...one.view === void 0 ? {} : { view: one.view }
     };
     if (Object.keys(piece).length > 0) out[key] = piece;
   }
@@ -1124,12 +1346,18 @@ function optionValuesFromLayout(definitions, layout, options = {}) {
 }
 function sameSettings(a, b) {
   if (a === b) return true;
-  return a?.title === b?.title && a?.width === b?.width && a?.flexible === b?.flexible && sameOptionValues(a?.options ?? {}, b?.options ?? {});
+  return a?.title === b?.title && a?.width === b?.width && a?.flexible === b?.flexible && a?.view === b?.view && sameOptionValues(a?.options ?? {}, b?.options ?? {});
 }
 function setWidgetSettings(layout, key, patch) {
   const before = layout.settings?.[key];
   const draft = { ...before };
-  for (const field of ["title", "width", "flexible", "options"]) {
+  for (const field of [
+    "title",
+    "width",
+    "flexible",
+    "options",
+    "view"
+  ]) {
     if (!(field in patch)) continue;
     const value = patch[field];
     if (value === void 0) {
@@ -1155,7 +1383,8 @@ function clearWidgetSettings(layout, key) {
     title: void 0,
     width: void 0,
     flexible: void 0,
-    options: void 0
+    options: void 0,
+    view: void 0
   });
 }
 function normalizeTitle(title) {
@@ -1215,7 +1444,8 @@ function normalizeSettings(definitions, layout, options = {}) {
       ...title === void 0 ? {} : { title },
       ...one.width === void 0 ? {} : { width: Math.min(range.max, Math.max(range.min, one.width)) },
       ...one.flexible === void 0 ? {} : { flexible: one.flexible },
-      ...Object.keys(chosen).length === 0 ? {} : { options: chosen }
+      ...Object.keys(chosen).length === 0 ? {} : { options: chosen },
+      ...one.view !== void 0 && (one.view === BASE_VIEW_KEY || findView(definition, one.view) !== void 0) ? { view: one.view } : {}
     };
     if (Object.keys(next).length > 0) {
       cleaned[definition.key] = sameSettings(one, next) ? one : next;
@@ -1228,57 +1458,184 @@ function normalizeSettings(definitions, layout, options = {}) {
   return keys.length === 0 ? others : { ...others, settings: cleaned };
 }
 
-// src/core/layout.ts
-var MAX_PAGE_TITLE_LENGTH = 30;
-var MAX_PARSED_PAGES = 50;
-var MAX_PAGE_ROWS = 20;
-var EMPTY_LAYOUT = Object.freeze({
-  order: Object.freeze([]),
-  hidden: Object.freeze([]),
-  minimized: Object.freeze([])
-});
-function uniqueStrings(value) {
-  if (!Array.isArray(value)) return [];
+// src/core/clones.ts
+var MAX_PARSED_CLONES = 500;
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseClones(raw) {
+  if (!Array.isArray(raw)) return void 0;
   const seen = /* @__PURE__ */ new Set();
-  for (const entry of value) {
-    if (typeof entry === "string" && entry !== "") seen.add(entry);
+  const clones = [];
+  for (const entry of raw.slice(0, MAX_PARSED_CLONES)) {
+    if (!isRecord2(entry)) continue;
+    const key = entry["key"];
+    const from = entry["from"];
+    if (typeof key !== "string" || typeof from !== "string" || key === "" || from === "" || key === from || seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    clones.push({ key, from });
   }
-  return [...seen];
+  return clones.length === 0 ? void 0 : clones;
 }
-function parseLayout(raw) {
-  let value = raw;
-  if (typeof raw === "string") {
-    try {
-      value = JSON.parse(raw);
-    } catch {
-      return EMPTY_LAYOUT;
+function serializeClones(clones) {
+  if (clones === void 0 || clones.length === 0) return void 0;
+  return clones.map(({ key, from }) => ({ key, from }));
+}
+function cloneNumber(key) {
+  const match = /#(\d+)$/.exec(key);
+  return match === null ? void 0 : Number(match[1]);
+}
+function cleanClones(definitions, clones, options = {}) {
+  if (clones === void 0) return void 0;
+  const byKey = new Map(definitions.map((d) => [d.key, d]));
+  const seen = /* @__PURE__ */ new Set();
+  const kept = [];
+  for (const clone of clones) {
+    if (seen.has(clone.key)) continue;
+    const original = byKey.get(clone.from);
+    if (original === void 0 || original.sourceKey !== void 0) continue;
+    const existing = byKey.get(clone.key);
+    if (existing !== void 0 && existing.sourceKey !== clone.from) continue;
+    if (options.overrideLocks !== true && resolveWidgetLock(original).clone) {
+      continue;
     }
+    seen.add(clone.key);
+    kept.push(clone);
+  }
+  if (kept.length === 0) return void 0;
+  return kept.length === clones.length && kept.every((c, i) => c === clones[i]) ? clones : kept;
+}
+function defaultCloneTitle(original, clone, index) {
+  const base = original.title ?? original.key;
+  const suffix = ` (#${cloneNumber(clone.key) ?? index + 1})`;
+  return `${base.slice(0, MAX_WIDGET_TITLE_LENGTH - suffix.length)}${suffix}`;
+}
+function withClones(definitions, layout, options = {}) {
+  const valid = cleanClones(
+    definitions,
+    layout.clones,
+    options
+  );
+  if (valid === void 0) return definitions;
+  const present = new Set(definitions.map((d) => d.key));
+  const toAdd = valid.filter((c) => !present.has(c.key));
+  if (toAdd.length === 0) return definitions;
+  const out = [];
+  for (const definition of definitions) {
+    out.push(definition);
+    toAdd.forEach((clone, index) => {
+      if (clone.from !== definition.key) return;
+      const copy = { ...definition };
+      copy.key = clone.key;
+      copy.sourceKey = definition.key;
+      copy.title = defaultCloneTitle(definition, clone, index);
+      delete copy.locked;
+      out.push(copy);
+    });
   }
+  return out;
+}
+
+// src/core/compat.ts
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((v) => typeof v === "string");
+}
+function upgradeLegacyWidgetData(value) {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return EMPTY_LAYOUT;
+    return value;
   }
   const record = value;
-  const order = uniqueStrings(record["order"]);
-  const hidden = uniqueStrings(record["hidden"]);
-  const minimized = uniqueStrings(record["minimized"]);
-  const pages = parsePages(record["pages"]);
-  const settings = parseSettings(
-    record["settings"]
-  );
-  const withSettings = settings === void 0 ? {} : { settings };
-  if (pages.length > 0) {
+  if (record["kind"] === "TABLE" && isStringArray(record["columns"]) && Array.isArray(record["rows"]) && record["rows"].every(isStringArray)) {
+    const rows = record["rows"];
+    return {
+      ...record,
+      columns: record["columns"].map((label) => ({ label })),
+      rows: rows.map((row) => row.map((text) => ({ text })))
+    };
+  }
+  if (record["kind"] === "GRAPH" && Array.isArray(record["points"]) && record["series"] === void 0) {
+    const { points, ...rest } = record;
+    return {
+      ...rest,
+      series: [{ name: "Value", points }],
+      chartType: "bar",
+      valueFormat: "number"
+    };
+  }
+  return value;
+}
+function fromLegacyDefinition(legacy) {
+  if (!isWidgetKind(legacy.viewType)) {
+    return null;
+  }
+  return {
+    key: legacy.widgetKey,
+    title: legacy.title,
+    ...legacy.description === null ? {} : { description: legacy.description },
+    kind: legacy.viewType,
+    sortOrder: legacy.sortOrder
+  };
+}
+
+// src/core/layout.ts
+var MAX_PAGE_TITLE_LENGTH = 30;
+var MAX_PARSED_PAGES = 50;
+var MAX_PAGE_ROWS = 20;
+var EMPTY_LAYOUT = Object.freeze({
+  order: Object.freeze([]),
+  hidden: Object.freeze([]),
+  minimized: Object.freeze([])
+});
+function uniqueStrings(value) {
+  if (!Array.isArray(value)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of value) {
+    if (typeof entry === "string" && entry !== "") seen.add(entry);
+  }
+  return [...seen];
+}
+function parseLayout(raw) {
+  let value = raw;
+  if (typeof raw === "string") {
+    try {
+      value = JSON.parse(raw);
+    } catch {
+      return EMPTY_LAYOUT;
+    }
+  }
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return EMPTY_LAYOUT;
+  }
+  const record = value;
+  const order = uniqueStrings(record["order"]);
+  const hidden = uniqueStrings(record["hidden"]);
+  const minimized = uniqueStrings(record["minimized"]);
+  const pages = parsePages(record["pages"]);
+  const settings = parseSettings(
+    record["settings"]
+  );
+  const clones = parseClones(
+    record["clones"]
+  );
+  const extras = {
+    ...settings === void 0 ? {} : { settings },
+    ...clones === void 0 ? {} : { clones }
+  };
+  if (pages.length > 0) {
     return {
       order: EMPTY_LAYOUT.order,
       hidden: EMPTY_LAYOUT.hidden,
       minimized: EMPTY_LAYOUT.minimized,
       pages,
-      ...withSettings
+      ...extras
     };
   }
   if (order.length === 0 && hidden.length === 0 && minimized.length === 0) {
-    return settings === void 0 ? EMPTY_LAYOUT : { ...EMPTY_LAYOUT, settings };
+    return Object.keys(extras).length === 0 ? EMPTY_LAYOUT : { ...EMPTY_LAYOUT, ...extras };
   }
-  return { order, hidden, minimized, ...withSettings };
+  return { order, hidden, minimized, ...extras };
 }
 function parsePages(value) {
   if (!Array.isArray(value)) return [];
@@ -1326,7 +1683,8 @@ function serializeLayout(layout) {
         ...page.maxRows === void 0 ? {} : { maxRows: page.maxRows }
       }))
     },
-    ...serializeSettings(layout.settings) === void 0 ? {} : { settings: serializeSettings(layout.settings) }
+    ...serializeSettings(layout.settings) === void 0 ? {} : { settings: serializeSettings(layout.settings) },
+    ...serializeClones(layout.clones) === void 0 ? {} : { clones: serializeClones(layout.clones) }
   });
 }
 function bySortOrder(items) {
@@ -1491,1482 +1849,1746 @@ function enforceLocks(definitions, layout, options = {}) {
   }));
 }
 
-// src/core/validate.ts
-var MAX_REPORTED_PROBLEMS = 10;
-function describeType2(value) {
-  if (value === null) return "null";
-  if (Array.isArray(value)) return "array";
-  if (typeof value === "number" && !Number.isFinite(value)) {
-    return String(value);
-  }
-  return typeof value;
-}
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+// src/core/pages.ts
+var DEFAULT_PAGE_KEY = "default";
+var DEFAULT_PAGE_ROWS = 4;
+function rowsAllowed(page, options) {
+  const rows = page.maxRows ?? options.maxRows ?? DEFAULT_PAGE_ROWS;
+  return Math.max(1, Math.min(MAX_PAGE_ROWS, Math.floor(rows)));
 }
-function join(path, field) {
-  return path === "" ? field : `${path}.${field}`;
+function hasPages(layout) {
+  return layout.pages !== void 0 && layout.pages.length > 0;
 }
-function requireString(record, field, path, problems) {
-  const value = record[field];
-  if (typeof value !== "string") {
-    problems.push(
-      `${join(path, field)} must be a string, got ${describeType2(value)}.`
-    );
+function pageList(layout) {
+  if (layout.pages !== void 0 && layout.pages.length > 0) {
+    return layout.pages;
   }
+  return [
+    {
+      key: DEFAULT_PAGE_KEY,
+      title: "Page 1",
+      order: layout.order,
+      hidden: layout.hidden,
+      minimized: layout.minimized
+    }
+  ];
 }
-function optionalString(record, field, path, problems) {
-  if (record[field] !== void 0) {
-    requireString(record, field, path, problems);
-  }
+function withExplicitPages(layout) {
+  if (hasPages(layout)) return layout;
+  return {
+    ...layout,
+    order: [],
+    hidden: [],
+    minimized: [],
+    pages: pageList(layout)
+  };
 }
-function requireNumber(record, field, path, problems) {
-  const value = record[field];
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    problems.push(
-      `${join(path, field)} must be a finite number, got ${describeType2(value)}.`
-    );
-  }
+function sameKeys(a, b) {
+  return a === b || a.length === b.length && a.every((k, i) => k === b[i]);
 }
-function optionalNumber(record, field, path, problems) {
-  if (record[field] !== void 0) {
-    requireNumber(record, field, path, problems);
-  }
+function pageLayout(layout, pageKey) {
+  if (!hasPages(layout))
+    return pageKey === DEFAULT_PAGE_KEY ? layout : void 0;
+  const page = layout.pages?.find(
+    (p) => p.key === pageKey
+  );
+  if (page === void 0) return void 0;
+  const { pages, ...rest } = layout;
+  return {
+    ...rest,
+    order: page.order,
+    hidden: page.hidden,
+    minimized: page.minimized
+  };
 }
-function optionalSortValue(record, path, problems) {
-  const value = record["value"];
-  if (value !== void 0 && typeof value !== "string" && !(typeof value === "number" && Number.isFinite(value))) {
-    problems.push(
-      `${path}.value must be a string or a finite number, got ${describeType2(value)}.`
-    );
+function withPageLayout(layout, pageKey, next) {
+  const current = pageLayout(layout, pageKey);
+  if (current === void 0 || sameKeys(current.order, next.order) && sameKeys(current.hidden, next.hidden) && sameKeys(current.minimized, next.minimized)) {
+    return layout;
   }
-}
-function optionalBoolean(record, field, path, problems) {
-  const value = record[field];
-  if (value !== void 0 && typeof value !== "boolean") {
-    problems.push(
-      `${join(path, field)} must be a boolean, got ${describeType2(value)}.`
-    );
+  if (!hasPages(layout)) {
+    return {
+      ...layout,
+      order: next.order,
+      hidden: next.hidden,
+      minimized: next.minimized
+    };
   }
+  return {
+    ...layout,
+    pages: (layout.pages ?? []).map(
+      (page) => page.key === pageKey ? {
+        ...page,
+        order: next.order,
+        hidden: next.hidden,
+        minimized: next.minimized
+      } : page
+    )
+  };
 }
-function optionalUrl(record, field, path, problems, isSafe, allowed) {
-  const value = record[field];
-  if (value === void 0) return;
-  if (typeof value !== "string") {
-    problems.push(
-      `${join(path, field)} must be a string, got ${describeType2(value)}.`
-    );
-  } else if (!isSafe(value)) {
-    problems.push(
-      `${join(path, field)} must be ${allowed}, got ${JSON.stringify(value.slice(0, 80))}.`
-    );
-  }
+function normalizedTitle(title) {
+  return title.trim().normalize("NFKC").toLowerCase();
 }
-function requireArray(record, field, path, problems) {
-  const value = record[field];
-  if (!Array.isArray(value)) {
-    problems.push(
-      `${join(path, field)} must be an array, got ${describeType2(value)}.`
-    );
-    return null;
+function resolvePageKey(layout, reference) {
+  if (reference === void 0 || reference === "") return void 0;
+  const pages = pageList(layout);
+  const byKey = pages.find((p) => p.key === reference);
+  if (byKey !== void 0) return byKey.key;
+  const wanted = normalizedTitle(reference);
+  return pages.find((p) => normalizedTitle(p.title) === wanted)?.key;
+}
+function homePageKey(layout, item) {
+  return resolvePageKey(layout, item.page) ?? pageList(layout)[0].key;
+}
+function assignPages(definitions, layout) {
+  const pages = pageList(layout);
+  const assigned = new Map(pages.map((p) => [p.key, []]));
+  for (const definition of definitions) {
+    let pageKey;
+    if (!resolveWidgetLock(definition).move) {
+      pageKey = pages.find(
+        (p) => p.order.includes(definition.key) || p.hidden.includes(definition.key)
+      )?.key;
+    }
+    assigned.get(pageKey ?? homePageKey(layout, definition))?.push(definition);
   }
-  return value;
+  return assigned;
 }
-function requireOneOf(record, field, options, path, problems) {
-  const value = record[field];
-  if (typeof value !== "string" || !options.includes(value)) {
-    problems.push(
-      `${join(path, field)} must be one of ${options.map((o) => `"${o}"`).join(", ")}, got ${typeof value === "string" ? JSON.stringify(value) : describeType2(value)}.`
-    );
+function pageOf(definitions, layout, key) {
+  for (const [pageKey, widgets] of assignPages(definitions, layout)) {
+    if (widgets.some((w) => w.key === key)) return pageKey;
   }
+  return void 0;
 }
-function eachRecord(items, path, problems, check) {
-  items.forEach((item, index) => {
-    const itemPath = `${path}[${index}]`;
-    if (isRecord2(item)) {
-      check(item, itemPath);
-    } else {
-      problems.push(
-        `${itemPath} must be an object, got ${describeType2(item)}.`
-      );
-    }
-  });
+function pageWidgets(definitions, layout, pageKey) {
+  const onPage = assignPages(definitions, layout).get(pageKey) ?? [];
+  const view = pageLayout(layout, pageKey);
+  return view === void 0 ? [] : visibleWidgets(onPage, view);
 }
-var HREF_RULE = "an http(s), mailto or relative URL";
-var IMAGE_RULE = "an http(s) or relative URL";
-function checkPayloadFields(kind, data, problems) {
-  switch (kind) {
-    case "TEXT":
-      requireString(data, "value", "", problems);
-      requireString(data, "label", "", problems);
-      return;
-    case "KPI":
-      requireNumber(data, "value", "", problems);
-      if (data["previous"] !== null) {
-        optionalNumber(data, "previous", "", problems);
-      }
-      requireOneOf(data, "format", VALUE_FORMATS, "", problems);
-      optionalString(data, "currency", "", problems);
-      requireString(data, "label", "", problems);
-      optionalString(data, "hint", "", problems);
-      optionalBoolean(data, "higherIsBetter", "", problems);
-      return;
-    case "GAUGE":
-      requireNumber(data, "value", "", problems);
-      requireNumber(data, "max", "", problems);
-      requireString(data, "label", "", problems);
-      if (typeof data["max"] === "number" && data["max"] <= 0) {
-        problems.push(`max must be greater than 0, got ${data["max"]}.`);
-      }
-      return;
-    case "TABLE": {
-      const columns = requireArray(data, "columns", "", problems);
-      if (columns !== null) {
-        eachRecord(columns, "columns", problems, (column, path) => {
-          requireString(column, "label", path, problems);
-          optionalBoolean(column, "numeric", path, problems);
-        });
-      }
-      const rows = requireArray(data, "rows", "", problems);
-      if (rows !== null) {
-        rows.forEach((row, rowIndex) => {
-          const rowPath = `rows[${rowIndex}]`;
-          if (!Array.isArray(row)) {
-            problems.push(
-              `${rowPath} must be an array of cells, got ${describeType2(row)}.`
-            );
-            return;
-          }
-          if (columns !== null && row.length !== columns.length) {
-            problems.push(
-              `${rowPath} has ${row.length} cell(s) but there are ${columns.length} column(s).`
-            );
-          }
-          eachRecord(row, rowPath, problems, (cell, cellPath) => {
-            requireString(cell, "text", cellPath, problems);
-            optionalSortValue(cell, cellPath, problems);
-            optionalUrl(
-              cell,
-              "href",
-              cellPath,
-              problems,
-              isSafeHref,
-              HREF_RULE
-            );
-          });
-        });
-      }
-      optionalString(data, "footer", "", problems);
-      return;
-    }
-    case "BAR_LIST": {
-      const items = requireArray(data, "items", "", problems);
-      if (items !== null) {
-        eachRecord(items, "items", problems, (item, path) => {
-          requireString(item, "label", path, problems);
-          requireNumber(item, "value", path, problems);
-          optionalString(item, "display", path, problems);
-        });
-      }
-      optionalNumber(data, "total", "", problems);
-      return;
-    }
-    case "ALERT_LIST": {
-      const items = requireArray(data, "items", "", problems);
-      if (items !== null) {
-        eachRecord(items, "items", problems, (item, path) => {
-          requireString(item, "title", path, problems);
-          optionalUrl(item, "href", path, problems, isSafeHref, HREF_RULE);
-          optionalUrl(
-            item,
-            "thumbnailUrl",
-            path,
-            problems,
-            isSafeImageUrl,
-            IMAGE_RULE
-          );
-          requireString(item, "valueLabel", path, problems);
-          optionalString(item, "detail", path, problems);
-        });
-      }
-      requireNumber(data, "total", "", problems);
-      requireString(data, "emptyText", "", problems);
-      if (items !== null && typeof data["total"] === "number" && data["total"] < items.length) {
-        problems.push(
-          `total (${data["total"]}) must be at least the number of items (${items.length}).`
-        );
-      }
-      return;
-    }
-    case "GRAPH": {
-      const series = requireArray(data, "series", "", problems);
-      if (series !== null) {
-        if (series.length > MAX_GRAPH_SERIES) {
-          problems.push(
-            `series has ${series.length} entries; at most ${MAX_GRAPH_SERIES} are allowed (fold the rest into "Other").`
-          );
-        }
-        eachRecord(series, "series", problems, (entry, path) => {
-          requireString(entry, "name", path, problems);
-          const points = requireArray(entry, "points", path, problems);
-          if (points !== null) {
-            eachRecord(
-              points,
-              `${path}.points`,
-              problems,
-              (point, pointPath) => {
-                requireString(point, "label", pointPath, problems);
-                requireNumber(point, "value", pointPath, problems);
-              }
-            );
-          }
-        });
-      }
-      requireOneOf(data, "chartType", ["bar", "line"], "", problems);
-      requireOneOf(data, "valueFormat", VALUE_FORMATS, "", problems);
-      optionalString(data, "currency", "", problems);
-      optionalString(data, "xLabel", "", problems);
-      return;
-    }
-  }
+function pageRoom(definitions, layout, pageKey, options = {}) {
+  const page = pageList(layout).find(
+    (p) => p.key === pageKey
+  );
+  if (page === void 0) return void 0;
+  const maxRows = rowsAllowed(page, options);
+  const rowsUsed = placeRows(
+    pageWidgets(definitions, layout, pageKey)
+  ).length;
+  return { maxRows, rowsUsed, rowsFree: Math.max(0, maxRows - rowsUsed) };
 }
-function checkDetailOption(detail, problems) {
-  if (detail === void 0 || typeof detail === "boolean") return;
-  if (!isRecord2(detail)) {
-    problems.push(
-      `detail must be true, false or an options object, got ${describeType2(detail)}.`
-    );
-    return;
-  }
-  optionalString(detail, "title", "detail", problems);
-  const pageSize = detail["pageSize"];
-  if (pageSize !== void 0 && !(typeof pageSize === "number" && Number.isInteger(pageSize) && pageSize >= 1 && pageSize <= MAX_DETAIL_PAGE_SIZE)) {
-    problems.push(
-      `detail.pageSize must be a whole number from 1 to ${MAX_DETAIL_PAGE_SIZE}, got ${typeof pageSize === "number" ? String(pageSize) : describeType2(pageSize)}.`
-    );
-  }
-  if (detail["mode"] !== void 0) {
-    requireOneOf(detail, "mode", DETAIL_MODES, "detail", problems);
-  }
+function describePage(page) {
+  return `Page "${page.title}"`;
 }
-function checkTableControlsOption(controls, kind, problems) {
-  if (controls === void 0 || controls === false) return;
-  if (typeof controls !== "boolean" && !isRecord2(controls)) {
-    problems.push(
-      `tableControls must be true, false or an options object, got ${describeType2(controls)}.`
-    );
-    return;
-  }
-  if (isRecord2(controls)) {
-    optionalBoolean(controls, "search", "tableControls", problems);
-    optionalBoolean(controls, "sort", "tableControls", problems);
-  }
-  if (typeof kind === "string" && kind !== "TABLE") {
-    problems.push(
-      `tableControls only applies to TABLE widgets, but kind is "${kind}".`
-    );
-  }
+function titleOf(item) {
+  return item.title ?? item.key;
 }
-function checkWidthLimits(value, problems) {
-  for (const field of ["minWidth", "maxWidth"]) {
-    const limit = value[field];
-    if (limit !== void 0 && !isWidgetWidth(limit)) {
-      problems.push(
-        `${field} must be an integer from ${MIN_WIDGET_WIDTH} to ${MAX_WIDGET_WIDTH} (twelfths of the row), got ${typeof limit === "number" ? String(limit) : describeType2(limit)}.`
-      );
-      return;
-    }
-  }
-  const { minWidth, maxWidth, width } = value;
-  if (isWidgetWidth(minWidth) && isWidgetWidth(maxWidth) && minWidth > maxWidth) {
-    problems.push(
-      `minWidth (${minWidth}) must not be more than maxWidth (${maxWidth}).`
+function checkTitle(layout, title, exceptKey) {
+  const trimmed = title.trim();
+  if (trimmed === "") return err("A page title must not be empty.");
+  if (trimmed.length > MAX_PAGE_TITLE_LENGTH) {
+    return err(
+      `Page title "${trimmed}" is ${trimmed.length} characters; the most is ${MAX_PAGE_TITLE_LENGTH}.`
     );
-    return;
   }
-  if (isWidgetWidth(width)) {
-    if (isWidgetWidth(minWidth) && width < minWidth) {
-      problems.push(
-        `width (${width}) must not be less than minWidth (${minWidth}).`
-      );
-    }
-    if (isWidgetWidth(maxWidth) && width > maxWidth) {
-      problems.push(
-        `width (${width}) must not be more than maxWidth (${maxWidth}).`
-      );
-    }
+  const wanted = normalizedTitle(trimmed);
+  const clash = pageList(layout).find(
+    (p) => p.key !== exceptKey && normalizedTitle(p.title) === wanted
+  );
+  if (clash !== void 0) {
+    return err(`Another page is already called "${clash.title}".`);
   }
+  return ok(trimmed);
 }
-function checkLockedOption(locked, problems) {
-  if (locked === void 0 || typeof locked === "boolean") return;
-  if (!isRecord2(locked)) {
-    problems.push(
-      `locked must be true, false or an object, got ${describeType2(locked)}.`
-    );
-    return;
-  }
-  optionalBoolean(locked, "move", "locked", problems);
-  optionalBoolean(locked, "hide", "locked", problems);
-  optionalBoolean(locked, "minimize", "locked", problems);
-  optionalBoolean(locked, "options", "locked", problems);
+function nextPageKey(layout) {
+  const keys = new Set(pageList(layout).map((p) => p.key));
+  let n = 1;
+  while (keys.has(`page-${n}`)) n += 1;
+  return `page-${n}`;
 }
-function checkOptionColumns(option, path, kind, problems) {
-  const columns = option["columns"];
-  if (!Array.isArray(columns) || columns.length === 0) {
-    problems.push(
-      `${join(path, "columns")} must be a non-empty array of { key, label }, got ${describeType2(columns)}.`
+function nextPageTitle(layout) {
+  const used = new Set(
+    pageList(layout).map((p) => normalizedTitle(p.title))
+  );
+  let n = pageList(layout).length + 1;
+  while (used.has(normalizedTitle(`Page ${n}`))) n += 1;
+  return `Page ${n}`;
+}
+function addPage(layout, options = {}) {
+  if (pageList(layout).length >= MAX_PARSED_PAGES) {
+    return err(
+      `The layout already has ${MAX_PARSED_PAGES} pages, the most it can keep.`
     );
-    return [];
   }
-  const keys = [];
-  columns.forEach((entry, index) => {
-    const entryPath = `${path}.columns[${index}]`;
-    if (!isRecord2(entry)) {
-      problems.push(
-        `${entryPath} must be an object, got ${describeType2(entry)}.`
-      );
-      return;
-    }
-    requireString(entry, "label", entryPath, problems);
-    const key = entry["key"];
-    if (typeof key !== "string") {
-      problems.push(
-        `${entryPath}.key must be a string, got ${describeType2(key)}.`
-      );
-    } else if (typeof kind === "string" && !isColumnKeyFor(kind, key)) {
-      problems.push(
-        `${entryPath}.key "${key}" is not a column of a ${kind} widget (${kind === "TABLE" ? '"c0", "c1", ...' : '"label" or "value"'}).`
-      );
-    } else if (keys.includes(key)) {
-      problems.push(`${entryPath}.key "${key}" is used twice.`);
-    } else {
-      keys.push(key);
-    }
+  const key = options.key ?? nextPageKey(layout);
+  if (pageList(layout).some((p) => p.key === key)) {
+    return err(`A page with the key "${key}" already exists.`);
+  }
+  const title = checkTitle(
+    layout,
+    options.title ?? nextPageTitle(layout)
+  );
+  if (!title.ok) return title;
+  const base = withExplicitPages(layout);
+  const page = {
+    key,
+    title: title.value,
+    order: [],
+    hidden: [],
+    minimized: []
+  };
+  return ok({ ...base, pages: [...base.pages ?? [], page] });
+}
+function renamePage(layout, pageKey, title) {
+  const page = pageList(layout).find(
+    (p) => p.key === pageKey
+  );
+  if (page === void 0) return err(`Page "${pageKey}" doesn't exist.`);
+  const checked = checkTitle(layout, title, pageKey);
+  if (!checked.ok) return checked;
+  if (checked.value === page.title) return ok(layout);
+  const base = withExplicitPages(layout);
+  return ok({
+    ...base,
+    pages: (base.pages ?? []).map(
+      (p) => p.key === pageKey ? { ...p, title: checked.value } : p
+    )
   });
-  return keys;
 }
-function checkOption(option, path, kind, seenKeys, seenTypes, problems) {
-  if (!isRecord2(option)) {
-    problems.push(`${path} must be an object, got ${describeType2(option)}.`);
-    return;
+function movePage(layout, pageKey, offset) {
+  const pages = layout.pages ?? [];
+  const from = pages.findIndex((p) => p.key === pageKey);
+  if (from === -1) return layout;
+  const to = Math.max(
+    0,
+    Math.min(pages.length - 1, from + Math.trunc(offset))
+  );
+  if (to === from) return layout;
+  const next = [...pages];
+  const [moved] = next.splice(from, 1);
+  next.splice(to, 0, moved);
+  return { ...layout, pages: next };
+}
+function overflowing(definitions, layout, options) {
+  return pageList(layout).find(
+    (page) => placeRows(pageWidgets(definitions, layout, page.key)).length > rowsAllowed(page, options)
+  );
+}
+function removePage(definitions, layout, pageKey, options = {}) {
+  const pages = pageList(layout);
+  const index = pages.findIndex((p) => p.key === pageKey);
+  const page = pages[index];
+  if (page === void 0) return err(`Page "${pageKey}" doesn't exist.`);
+  if (pages.length === 1) {
+    return err(
+      `${describePage(page)} is the only page, so it can't be removed.`
+    );
   }
-  const type = option["type"];
-  if (typeof type !== "string" || !WIDGET_OPTION_TYPES.includes(type)) {
-    requireOneOf(option, "type", WIDGET_OPTION_TYPES, path, problems);
-    return;
+  const target = pages[index > 0 ? index - 1 : 1];
+  const merged = {
+    ...layout,
+    pages: pages.filter((p) => p.key !== pageKey).map(
+      (p) => p.key === target.key ? {
+        ...p,
+        order: index > 0 ? [...p.order, ...page.order] : [...page.order, ...p.order],
+        hidden: [...p.hidden, ...page.hidden],
+        minimized: [...p.minimized, ...page.minimized]
+      } : p
+    )
+  };
+  const full = overflowing(
+    definitions,
+    merged,
+    options
+  );
+  if (full !== void 0) {
+    return err(
+      `${describePage(page)} has widgets that don't fit on the other pages (${describePage(full)} would need more than ${rowsAllowed(full, options)} rows). Move or hide some first.`
+    );
   }
-  const key = option["key"];
-  if (typeof key !== "string" || !OPTION_KEY_PATTERN.test(key)) {
-    problems.push(
-      `${path}.key must be letters, digits, "_" or "-", starting with a letter (40 characters at most), got ${typeof key === "string" ? JSON.stringify(key) : describeType2(key)}.`
+  return ok(merged);
+}
+function without(keys, key) {
+  return keys.includes(key) ? keys.filter((k) => k !== key) : keys;
+}
+function moveWidgetToPage(definitions, layout, widgetKey, targetKey, options = {}) {
+  const widget = definitions.find((d) => d.key === widgetKey);
+  if (widget === void 0) {
+    return err(
+      `Widget "${widgetKey}" isn't one of the widgets, so it can't be moved to a page.`
     );
-  } else if (seenKeys.has(key)) {
-    problems.push(`${path}.key "${key}" is used by another option.`);
-  } else {
-    seenKeys.add(key);
   }
-  requireString(option, "label", path, problems);
-  const fallback = option["default"];
-  switch (type) {
-    case "choice": {
-      const choices = option["choices"];
-      const values = [];
-      if (!Array.isArray(choices) || choices.length === 0) {
-        problems.push(
-          `${path}.choices must be a non-empty array of { value, label }, got ${describeType2(choices)}.`
-        );
-      } else {
-        choices.forEach((choice, index) => {
-          const choicePath = `${path}.choices[${index}]`;
-          if (!isRecord2(choice)) {
-            problems.push(
-              `${choicePath} must be an object, got ${describeType2(choice)}.`
-            );
-            return;
-          }
-          requireString(choice, "label", choicePath, problems);
-          const value = choice["value"];
-          if (typeof value !== "string" || value === "") {
-            problems.push(
-              `${choicePath}.value must be a non-empty string, got ${describeType2(value)}.`
-            );
-          } else if (values.includes(value)) {
-            problems.push(`${choicePath}.value "${value}" is used twice.`);
-          } else {
-            values.push(value);
-          }
-        });
-      }
-      if (values.length > 0)
-        requireOneOf(option, "default", values, path, problems);
-      break;
-    }
-    case "number": {
-      const { min, max, step } = option;
-      requireNumber(option, "min", path, problems);
-      requireNumber(option, "max", path, problems);
-      if (typeof min === "number" && typeof max === "number" && min > max) {
-        problems.push(
-          `${path}.min (${min}) must not be more than max (${max}).`
-        );
-      }
-      if (step !== void 0 && !(typeof step === "number" && Number.isFinite(step) && step > 0)) {
-        problems.push(
-          `${path}.step must be a number above 0, got ${describeType2(step)}.`
-        );
+  const pages = pageList(layout);
+  const target = pages.find((p) => p.key === targetKey);
+  if (target === void 0) return err(`Page "${targetKey}" doesn't exist.`);
+  const sourceKey = pageOf(definitions, layout, widgetKey);
+  if (sourceKey === targetKey) return ok(layout);
+  if (resolveWidgetLock(widget).move) {
+    return err(
+      `Widget "${titleOf(widget)}" is locked against moving, so it can't be moved to ${describePage(target)}.`
+    );
+  }
+  const base = withExplicitPages(layout);
+  const source = (base.pages ?? []).find(
+    (p) => p.key === sourceKey
+  );
+  const hidden = source.hidden.includes(widgetKey);
+  const minimized = source.minimized.includes(widgetKey);
+  const targetOrder = pageWidgets(
+    definitions,
+    base,
+    targetKey
+  ).map((d) => d.key);
+  const moved = {
+    ...base,
+    pages: (base.pages ?? []).map((p) => {
+      if (p.key === sourceKey) {
+        return {
+          ...p,
+          order: without(p.order, widgetKey),
+          hidden: without(p.hidden, widgetKey),
+          minimized: without(p.minimized, widgetKey)
+        };
       }
-      if (typeof fallback !== "number" || !Number.isFinite(fallback)) {
-        problems.push(
-          `${path}.default must be a finite number, got ${describeType2(fallback)}.`
-        );
-      } else if (typeof min === "number" && typeof max === "number" && (fallback < min || fallback > max)) {
-        problems.push(
-          `${path}.default (${fallback}) must be between min (${min}) and max (${max}).`
-        );
-      } else if (typeof min === "number" && typeof step === "number" && step > 0 && Math.abs(
-        (fallback - min) / step - Math.round((fallback - min) / step)
-      ) > 1e-9) {
-        problems.push(
-          `${path}.default (${fallback}) must be ${min} plus a whole number of steps of ${step}.`
-        );
+      if (p.key === targetKey) {
+        return {
+          ...p,
+          order: hidden ? p.order : [...targetOrder, widgetKey],
+          hidden: hidden ? [...p.hidden, widgetKey] : p.hidden,
+          minimized: minimized ? [...p.minimized, widgetKey] : p.minimized
+        };
       }
-      break;
-    }
-    case "boolean":
-      if (typeof fallback !== "boolean") {
-        problems.push(
-          `${path}.default must be a boolean, got ${describeType2(fallback)}.`
-        );
-      }
-      break;
-    case "text": {
-      const maxLength = option["maxLength"];
-      if (typeof maxLength !== "number" || !Number.isInteger(maxLength) || maxLength < 1 || maxLength > MAX_TEXT_OPTION_LENGTH) {
-        problems.push(
-          `${path}.maxLength must be a whole number from 1 to ${MAX_TEXT_OPTION_LENGTH}, got ${typeof maxLength === "number" ? maxLength : describeType2(maxLength)}.`
-        );
-      }
-      if (typeof fallback !== "string") {
-        problems.push(
-          `${path}.default must be a string, got ${describeType2(fallback)}.`
-        );
-      } else if (typeof maxLength === "number" && fallback.length > maxLength) {
-        problems.push(
-          `${path}.default is ${fallback.length} characters; maxLength is ${maxLength}.`
-        );
-      }
-      break;
-    }
-    case "dateRange": {
-      const presets = option["presets"];
-      const offered = [];
-      if (presets !== void 0) {
-        if (!Array.isArray(presets) || presets.length === 0) {
-          problems.push(
-            `${path}.presets must be a non-empty array of { value, label }, got ${describeType2(presets)}.`
-          );
-        } else {
-          presets.forEach((preset, index) => {
-            const presetPath = `${path}.presets[${index}]`;
-            if (!isRecord2(preset)) {
-              problems.push(
-                `${presetPath} must be an object, got ${describeType2(preset)}.`
-              );
-              return;
-            }
-            requireString(preset, "label", presetPath, problems);
-            requireOneOf(
-              preset,
-              "value",
-              DATE_RANGE_PRESETS,
-              presetPath,
-              problems
-            );
-            if (typeof preset["value"] === "string")
-              offered.push(preset["value"]);
-          });
-        }
-      }
-      const allowed = offered.length > 0 ? offered : DATE_RANGE_PRESETS;
-      if (typeof fallback !== "string" || !(allowed.includes(fallback) || isIsoInterval(fallback))) {
-        problems.push(
-          `${path}.default must be one of ${allowed.map((p) => `"${p}"`).join(", ")} or an interval like "2026-01-01/2026-01-31", got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
-        );
-      }
-      break;
-    }
-    case "color":
-      if (typeof fallback !== "string" || !/^#[0-9a-fA-F]{6}$/.test(fallback)) {
-        problems.push(
-          `${path}.default must be a color like "#1c5cab", got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
-        );
-      }
-      break;
-    case "sort":
-    case "columns": {
-      const supported = type === "sort" ? kind === "TABLE" || kind === "BAR_LIST" : kind === "TABLE";
-      if (!supported && typeof kind === "string") {
-        problems.push(
-          `${path} is a ${type} option, which only applies to ${type === "sort" ? "TABLE and BAR_LIST" : "TABLE"} widgets, but kind is "${kind}".`
-        );
-      }
-      if (seenTypes.has(type)) {
-        problems.push(
-          `${path} is a second ${type} option; a widget has at most one.`
-        );
-      }
-      seenTypes.add(type);
-      const columnKeys = checkOptionColumns(
-        option,
-        path,
-        supported ? kind : void 0,
-        problems
-      );
-      if (option["apply"] !== void 0) {
-        requireOneOf(option, "apply", ["provider", "client"], path, problems);
-      }
-      if (type === "sort") {
-        if (fallback !== void 0) {
-          const sort = typeof fallback === "string" ? parseSortValue(fallback) : void 0;
-          if (sort === void 0) {
-            problems.push(
-              `${path}.default must look like "c1:desc" ("column:asc" or "column:desc"), got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
-            );
-          } else if (columnKeys.length > 0 && !columnKeys.includes(sort.column)) {
-            requireOneOf(
-              { default: sort.column },
-              "default",
-              columnKeys,
-              path,
-              problems
-            );
-          }
-        }
-      } else if (!Array.isArray(fallback) || fallback.length === 0 || fallback.some((k) => typeof k !== "string")) {
-        problems.push(
-          `${path}.default must be a non-empty array of column keys, got ${describeType2(fallback)}.`
-        );
-      } else {
-        const shown = /* @__PURE__ */ new Set();
-        for (const columnKey of fallback) {
-          if (columnKeys.length > 0 && !columnKeys.includes(columnKey)) {
-            problems.push(
-              `${path}.default has "${columnKey}", which is not one of the columns (${columnKeys.map((c) => `"${c}"`).join(", ")}).`
-            );
-          } else if (shown.has(columnKey)) {
-            problems.push(`${path}.default lists "${columnKey}" twice.`);
-          }
-          shown.add(columnKey);
-        }
-      }
-      break;
+      return p;
+    })
+  };
+  if (!hidden) {
+    const allowed = rowsAllowed(target, options);
+    const needed = placeRows(
+      pageWidgets(definitions, moved, targetKey)
+    ).length;
+    if (needed > allowed) {
+      return err(
+        `${describePage(target)} has no room for "${titleOf(widget)}": it would need row ${needed}, and the page allows ${allowed}.`
+      );
     }
   }
+  return ok(moved);
 }
-function checkOptions(options, kind, problems) {
-  if (options === void 0) return;
-  if (!Array.isArray(options)) {
-    problems.push(`options must be an array, got ${describeType2(options)}.`);
-    return;
-  }
-  if (options.length > MAX_WIDGET_OPTIONS) {
-    problems.push(
-      `options lists ${options.length} options; the most a widget may declare is ${MAX_WIDGET_OPTIONS}.`
-    );
-    return;
+function withoutLockField(definition) {
+  if (definition.locked === void 0) return definition;
+  const copy = { ...definition };
+  delete copy.locked;
+  return copy;
+}
+function uniqueTitle2(taken, title, index) {
+  let base = title.trim().slice(0, MAX_PAGE_TITLE_LENGTH);
+  if (base === "") base = `Page ${index + 1}`;
+  let candidate = base;
+  let n = 1;
+  while (taken.has(normalizedTitle(candidate))) {
+    const suffix = ` (#${n})`;
+    candidate = `${base.slice(0, MAX_PAGE_TITLE_LENGTH - suffix.length)}${suffix}`;
+    n += 1;
   }
-  const seenKeys = /* @__PURE__ */ new Set();
-  const seenTypes = /* @__PURE__ */ new Set();
-  options.forEach((option, index) => {
-    checkOption(
-      option,
-      `options[${index}]`,
-      kind,
-      seenKeys,
-      seenTypes,
-      problems
-    );
+  taken.add(normalizedTitle(candidate));
+  return candidate;
+}
+function samePages(a, b) {
+  return a.length === b.length && a.every((p, i) => {
+    const q = b[i];
+    return p.key === q.key && p.title === q.title && p.maxRows === q.maxRows && sameKeys(p.order, q.order) && sameKeys(p.hidden, q.hidden) && sameKeys(p.minimized, q.minimized);
   });
 }
-function formatProblems(prefix, problems) {
-  const shown = problems.slice(0, MAX_REPORTED_PROBLEMS);
-  const more = problems.length - shown.length;
-  return `${prefix}: ${shown.join(" ")}${more > 0 ? ` (and ${more} more problem(s))` : ""}`;
+function normalizeLayout(definitions, layout, options = {}) {
+  const clones = cleanClones(definitions, layout.clones, options);
+  let base = layout;
+  if (clones !== layout.clones) {
+    const { clones: _dropped, ...others } = layout;
+    base = clones === void 0 ? others : { ...others, clones };
+  }
+  return normalizeWidgets(
+    withClones(definitions, base, options),
+    base,
+    options
+  );
 }
-function validateWidgetData(value, options = {}) {
-  const subject = options.widgetKey === void 0 ? "Widget data" : `Widget ${JSON.stringify(options.widgetKey)}`;
-  if (!isRecord2(value)) {
-    return err(`${subject}: must be an object, got ${describeType2(value)}.`);
-  }
-  if (value["empty"] === true) {
-    if (typeof value["text"] !== "string") {
-      return err(
-        `${subject} (empty): text must be a string, got ${describeType2(value["text"])}.`
-      );
-    }
-    return ok(value);
+function normalizeWidgets(definitions, layout, options) {
+  const known = pruneLayout(definitions, layout);
+  const enforced = enforceLocks(definitions, known, options);
+  const locked = normalizeSettings(
+    definitions,
+    enforced,
+    options
+  );
+  if (!hasPages(locked)) return locked === layout ? layout : locked;
+  const defs = effectiveDefinitions(
+    options.overrideLocks === true ? definitions.map(withoutLockField) : definitions,
+    locked,
+    options
+  );
+  const taken = /* @__PURE__ */ new Set();
+  const seenKeys = /* @__PURE__ */ new Set();
+  const held = /* @__PURE__ */ new Set();
+  let pages = [];
+  (locked.pages ?? []).forEach((page, index) => {
+    if (seenKeys.has(page.key)) return;
+    seenKeys.add(page.key);
+    const keep = (list) => [
+      ...new Set(list.filter((k) => !held.has(k)))
+    ];
+    const next = {
+      ...page,
+      title: uniqueTitle2(taken, page.title, index),
+      order: keep(page.order),
+      hidden: keep(page.hidden),
+      minimized: keep(page.minimized)
+    };
+    for (const k of [...next.order, ...next.hidden]) held.add(k);
+    pages.push(next);
+  });
+  const work = () => ({ ...locked, pages });
+  const pinned = defs.filter((d) => resolveWidgetLock(d).move);
+  for (const widget of pinned) {
+    const home = homePageKey(work(), widget);
+    const keysHere = (p, list) => p.key !== home && p[list].includes(widget.key);
+    const wasHidden = pages.some((p) => keysHere(p, "hidden"));
+    const wasMinimized = pages.some((p) => keysHere(p, "minimized"));
+    if (!wasHidden && !wasMinimized) continue;
+    pages = pages.map((p) => {
+      let next = p;
+      if (keysHere(p, "hidden")) {
+        next = { ...next, hidden: without(next.hidden, widget.key) };
+      }
+      if (keysHere(p, "minimized")) {
+        next = { ...next, minimized: without(next.minimized, widget.key) };
+      }
+      if (p.key === home) {
+        next = {
+          ...next,
+          hidden: wasHidden && !next.hidden.includes(widget.key) ? [...next.hidden, widget.key] : next.hidden,
+          minimized: wasMinimized && !next.minimized.includes(widget.key) ? [...next.minimized, widget.key] : next.minimized
+        };
+      }
+      return next;
+    });
   }
-  const kind = value["kind"];
-  if (!isWidgetKind(kind)) {
-    return err(
-      `${subject}: kind must be one of ${WIDGET_KINDS.join(", ")} (or the payload must be {"empty": true, "text": ...}), got ${typeof kind === "string" ? JSON.stringify(kind) : describeType2(kind)}.`
-    );
+  const placedKeys = /* @__PURE__ */ new Set();
+  for (const p of pages) {
+    for (const k of [...p.order, ...p.hidden]) placedKeys.add(k);
   }
-  if (options.expectedKind !== void 0 && kind !== options.expectedKind) {
-    return err(
-      `${subject}: expected kind ${options.expectedKind} from its definition, got ${kind}.`
+  const pinnedKeys = new Set(pinned.map((d) => d.key));
+  const unplaced = defs.filter((d) => !placedKeys.has(d.key) && !pinnedKeys.has(d.key)).map((definition, index) => ({ definition, index })).sort(
+    (a, b) => (a.definition.sortOrder ?? 0) - (b.definition.sortOrder ?? 0) || a.index - b.index
+  ).map(({ definition }) => definition);
+  for (const widget of unplaced) {
+    const home = homePageKey(work(), widget);
+    pages = pages.map(
+      (p) => p.key === home ? { ...p, order: [...p.order, widget.key] } : p
     );
   }
-  const problems = [];
-  checkPayloadFields(kind, value, problems);
-  if (problems.length > 0) {
-    return err(formatProblems(`${subject} (${kind})`, problems));
-  }
-  return ok(value);
-}
-function validateWidgetDefinition(value) {
-  if (!isRecord2(value)) {
-    return err(
-      `Widget definition: must be an object, got ${describeType2(value)}.`
+  for (let i = 0; i < pages.length; i += 1) {
+    const page = pages[i];
+    const shown = pageWidgets(defs, work(), page.key);
+    const fits = fitCount(shown, rowsAllowed(page, options));
+    if (fits >= shown.length) continue;
+    const moving = shown.slice(fits).filter((d) => !pinnedKeys.has(d.key)).map((d) => d.key);
+    if (moving.length === 0) continue;
+    const moveSet = new Set(moving);
+    const movedMinimized = page.minimized.filter(
+      (k) => moveSet.has(k)
     );
-  }
-  const subject = typeof value["key"] === "string" ? `Widget definition ${JSON.stringify(value["key"])}` : "Widget definition";
-  const problems = [];
-  requireString(value, "key", "", problems);
-  if (value["key"] === "") {
-    problems.push("key must not be empty.");
-  }
-  requireString(value, "title", "", problems);
-  optionalString(value, "description", "", problems);
-  requireOneOf(value, "kind", WIDGET_KINDS, "", problems);
-  optionalNumber(value, "sortOrder", "", problems);
-  if (value["roles"] !== void 0) {
-    const roles = requireArray(value, "roles", "", problems);
-    roles?.forEach((role, index) => {
-      if (typeof role !== "string") {
-        problems.push(
-          `roles[${index}] must be a string, got ${describeType2(role)}.`
-        );
+    pages = pages.map(
+      (p) => p.key === page.key ? {
+        ...p,
+        order: p.order.filter((k) => !moveSet.has(k)),
+        minimized: p.minimized.filter((k) => !moveSet.has(k))
+      } : p
+    );
+    let placed = false;
+    for (let j = i + 1; j < pages.length && !placed; j += 1) {
+      const candidate = pages[j];
+      const trial = pages.map(
+        (p) => p.key === candidate.key ? {
+          ...p,
+          order: [...moving, ...p.order],
+          minimized: [...p.minimized, ...movedMinimized]
+        } : p
+      );
+      const items = pageWidgets(
+        defs,
+        { ...locked, pages: trial },
+        candidate.key
+      );
+      if (placeRows(items).length <= rowsAllowed(candidate, options)) {
+        pages = trial;
+        placed = true;
       }
-    });
+    }
+    if (!placed) {
+      const key = nextPageKey(work());
+      const title = uniqueTitle2(
+        new Set(pages.map((p) => normalizedTitle(p.title))),
+        `Page ${pages.length + 1}`,
+        pages.length
+      );
+      pages = [
+        ...pages,
+        { key, title, order: moving, hidden: [], minimized: movedMinimized }
+      ];
+    }
   }
-  optionalBoolean(value, "active", "", problems);
-  if (value["defaultSize"] !== void 0) {
-    requireOneOf(value, "defaultSize", WIDGET_SIZES, "", problems);
+  const result = work();
+  return samePages(layout.pages ?? [], pages) && sameKeys(layout.order, result.order) && locked.settings === layout.settings ? layout : result;
+}
+
+// src/core/duplicate.ts
+function canDuplicate(definitions, key, options = {}) {
+  const definition = definitions.find(
+    (d) => d.key === key
+  );
+  if (definition === void 0) return false;
+  if (options.overrideLocks === true) return true;
+  const sourceKey = definition.sourceKey ?? definition.key;
+  const original = definitions.find(
+    (d) => d.key === sourceKey
+  );
+  return original !== void 0 && !resolveWidgetLock(original).clone;
+}
+function nextCloneKey(definitions, layout, fromKey) {
+  const taken = /* @__PURE__ */ new Set([
+    ...definitions.map((d) => d.key),
+    ...(layout.clones ?? []).map((c) => c.key)
+  ]);
+  let highest = 0;
+  for (const clone of layout.clones ?? []) {
+    if (clone.from === fromKey) {
+      highest = Math.max(highest, cloneNumber(clone.key) ?? 0);
+    }
   }
-  if (value["width"] !== void 0 && !isWidgetWidth(value["width"])) {
-    problems.push(
-      `width must be an integer from ${MIN_WIDGET_WIDTH} to ${MAX_WIDGET_WIDTH} (twelfths of the row), got ${typeof value["width"] === "number" ? String(value["width"]) : describeType2(value["width"])}.`
+  let n = highest + 1;
+  while (taken.has(`${fromKey}#${n}`)) n += 1;
+  return `${fromKey}#${n}`;
+}
+function suggestedViewTitle(title, viewLabel) {
+  return `${title} ${viewLabel}`.trim().slice(0, MAX_WIDGET_TITLE_LENGTH);
+}
+function duplicateWidget(definitions, layout, key, options = {}) {
+  const widget = definitions.find((d) => d.key === key);
+  if (widget === void 0) {
+    return err(`Widget ${JSON.stringify(key)} isn't on this dashboard.`);
+  }
+  const originalKey = widget.sourceKey ?? widget.key;
+  if (!canDuplicate(definitions, key, options)) {
+    return err(
+      `Widget ${JSON.stringify(originalKey)} is locked against duplicating.`
     );
   }
-  checkWidthLimits(value, problems);
-  checkDetailOption(value["detail"], problems);
-  checkTableControlsOption(value["tableControls"], value["kind"], problems);
-  checkLockedOption(value["locked"], problems);
-  checkOptions(value["options"], value["kind"], problems);
-  if (value["page"] !== void 0) {
-    if (typeof value["page"] !== "string" || value["page"].trim() === "") {
-      problems.push(
-        `page must be a non-empty page key or title, got ${describeType2(value["page"])}.`
-      );
+  const cloneKey = nextCloneKey(definitions, layout, originalKey);
+  const copiedSettings = (() => {
+    const mine = layout.settings?.[key];
+    if (mine === void 0) return void 0;
+    const { title: _title, ...rest } = mine;
+    return Object.keys(rest).length === 0 ? void 0 : rest;
+  })();
+  const settings = copiedSettings === void 0 ? layout.settings : { ...layout.settings, [cloneKey]: copiedSettings };
+  let next = {
+    ...layout,
+    clones: [...layout.clones ?? [], { key: cloneKey, from: originalKey }],
+    ...settings === void 0 ? {} : { settings }
+  };
+  const all = withClones(definitions, next, options);
+  const assigned = assignPages(all, next);
+  const pageKey = [...assigned].find(
+    ([, widgets]) => widgets.some((w) => w.key === key)
+  )?.[0];
+  if (pageKey !== void 0) {
+    const view = pageLayout(next, pageKey);
+    const onPage = assigned.get(pageKey) ?? [];
+    if (view !== void 0) {
+      const shown = visibleWidgets(onPage, view).filter((d) => !resolveWidgetLock(d).move && d.key !== cloneKey).map((d) => d.key);
+      const at = shown.indexOf(key);
+      const order = at === -1 ? [...shown, cloneKey] : [...shown.slice(0, at + 1), cloneKey, ...shown.slice(at + 1)];
+      next = withPageLayout(next, pageKey, { ...view, order });
     }
   }
-  if (value["fill"] !== void 0) {
-    requireOneOf(value, "fill", WIDGET_FILLS, "", problems);
-  }
-  if (problems.length > 0) {
-    return err(formatProblems(subject, problems));
+  if (hasPages(next) && pageKey !== void 0) {
+    const effective = effectiveDefinitions(all, next, options);
+    const room = pageRoom(effective, next, pageKey, options);
+    if (room !== void 0 && room.rowsUsed > room.maxRows) {
+      const page = next.pages?.find(
+        (p) => p.key === pageKey
+      );
+      const width = effective.find(
+        (d) => d.key === cloneKey
+      )?.width;
+      return err(
+        `Page "${page?.title ?? pageKey}" has no room for a widget${width === void 0 ? "" : ` ${width} wide`} (it holds ${room.maxRows} rows).`
+      );
+    }
   }
-  return ok(value);
+  return ok({ layout: next, key: cloneKey });
+}
+function deleteClone(layout, key) {
+  if (layout.clones?.some((clone) => clone.key === key) !== true) return layout;
+  const without2 = (keys) => keys.includes(key) ? keys.filter((k) => k !== key) : keys;
+  const { clones, settings, ...rest } = layout;
+  const remaining = (clones ?? []).filter((c) => c.key !== key);
+  const { [key]: _gone, ...otherSettings } = settings ?? {};
+  return {
+    ...rest,
+    order: without2(layout.order),
+    hidden: without2(layout.hidden),
+    minimized: without2(layout.minimized),
+    ...layout.pages === void 0 ? {} : {
+      pages: layout.pages.map((page) => ({
+        ...page,
+        order: without2(page.order),
+        hidden: without2(page.hidden),
+        minimized: without2(page.minimized)
+      }))
+    },
+    ...Object.keys(otherSettings).length === 0 ? {} : { settings: otherSettings },
+    ...remaining.length === 0 ? {} : { clones: remaining }
+  };
 }
 
-// src/core/resolve.ts
-function resolvePayload(definition, payload, options = {}) {
-  let checked;
-  if (options.validate === false) {
-    checked = payload;
-  } else {
-    const result = validateWidgetData(payload, {
-      widgetKey: definition.key,
-      expectedKind: definition.kind
-    });
-    if (!result.ok) {
-      return { definition, status: "error", error: result.error };
-    }
-    checked = result.value;
-  }
-  const emptyText = emptyTextFor(checked);
-  if (emptyText !== null) {
-    return { definition, status: "empty", emptyText };
+// src/core/validate.ts
+var MAX_REPORTED_PROBLEMS = 10;
+function describeType2(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  if (typeof value === "number" && !Number.isFinite(value)) {
+    return String(value);
   }
-  return { definition, status: "ok", data: checked };
+  return typeof value;
 }
-function failedWidget(definition, error) {
-  return { definition, status: "error", error };
+function isRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function loadingWidgets(definitions) {
-  return definitions.map((definition) => ({ definition, status: "loading" }));
+function join(path, field) {
+  return path === "" ? field : `${path}.${field}`;
 }
-function cacheKeyFor(definition, options, values) {
-  const base = options.cacheKey === void 0 ? definition.key : options.cacheKey(definition);
-  return values === void 0 ? base : `${base}${optionsCacheSuffix(definition, values, options)}`;
+function requireString(record, field, path, problems) {
+  const value = record[field];
+  if (typeof value !== "string") {
+    problems.push(
+      `${join(path, field)} must be a string, got ${describeType2(value)}.`
+    );
+  }
 }
-function optionValuesFor(definition, options) {
-  return resolveOptionValues(
-    definition,
-    options.optionValues?.[definition.key],
-    options
-  );
+function optionalString(record, field, path, problems) {
+  if (record[field] !== void 0) {
+    requireString(record, field, path, problems);
+  }
 }
-function finalizeWidget(widget, values) {
-  if (Object.keys(values).length === 0) return widget;
-  if (widget.status === "ok") {
-    const data = applyClientOptions(
-      widget.definition,
-      widget.data,
-      values
+function requireNumber(record, field, path, problems) {
+  const value = record[field];
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    problems.push(
+      `${join(path, field)} must be a finite number, got ${describeType2(value)}.`
     );
-    return { ...widget, data, options: values };
   }
-  return { ...widget, options: values };
 }
-var LoadInterruption = class extends Error {
-};
-async function resolveWidget(definition, provider, context, options = {}) {
-  const values = optionValuesFor(definition, options);
-  return finalizeWidget(
-    await resolveWidgetUnapplied(definition, provider, context, options),
-    values
-  );
+function optionalNumber(record, field, path, problems) {
+  if (record[field] !== void 0) {
+    requireNumber(record, field, path, problems);
+  }
 }
-async function resolveWidgetUnapplied(definition, provider, context, options = {}) {
-  const values = optionValuesFor(definition, options);
-  const quotedKey = JSON.stringify(definition.key);
-  if (provider === void 0) {
-    return failedWidget(
-      definition,
-      `Widget ${quotedKey}: no provider is registered for this key.`
+function optionalSortValue(record, path, problems) {
+  const value = record["value"];
+  if (value !== void 0 && typeof value !== "string" && !(typeof value === "number" && Number.isFinite(value))) {
+    problems.push(
+      `${path}.value must be a string or a finite number, got ${describeType2(value)}.`
     );
   }
-  if (options.signal?.aborted === true) {
-    return failedWidget(
-      definition,
-      `Widget ${quotedKey}: loading was canceled before it started.`
+}
+function optionalBoolean(record, field, path, problems) {
+  const value = record[field];
+  if (value !== void 0 && typeof value !== "boolean") {
+    problems.push(
+      `${join(path, field)} must be a boolean, got ${describeType2(value)}.`
     );
   }
-  const controller = new AbortController();
-  const onExternalAbort = () => controller.abort(options.signal?.reason);
-  options.signal?.addEventListener("abort", onExternalAbort, { once: true });
-  let timedOut = false;
-  const timeoutMs = options.timeoutMs !== void 0 && options.timeoutMs > 0 ? options.timeoutMs : void 0;
-  const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
-    timedOut = true;
-    controller.abort(new Error(`Timed out after ${timeoutMs} ms.`));
-  }, timeoutMs);
-  const interrupted = new Promise((_resolve, reject) => {
-    controller.signal.addEventListener(
-      "abort",
-      () => reject(new LoadInterruption()),
-      { once: true }
+}
+function optionalUrl(record, field, path, problems, isSafe, allowed) {
+  const value = record[field];
+  if (value === void 0) return;
+  if (typeof value !== "string") {
+    problems.push(
+      `${join(path, field)} must be a string, got ${describeType2(value)}.`
     );
-  });
-  let payload;
-  try {
-    payload = await Promise.race([
-      Promise.resolve().then(() => {
-        if (controller.signal.aborted) throw new LoadInterruption();
-        return provider(context, definition, {
-          signal: controller.signal,
-          options: values
-        });
-      }),
-      interrupted
-    ]);
-  } catch (cause) {
-    if (cause instanceof LoadInterruption) {
-      return failedWidget(
-        definition,
-        timedOut ? `Widget ${quotedKey}: provider timed out after ${timeoutMs} ms.` : `Widget ${quotedKey}: loading was canceled.`
-      );
-    }
-    return failedWidget(
-      definition,
-      `Widget ${quotedKey}: provider failed: ${describeUnknownError(cause)}`
+  } else if (!isSafe(value)) {
+    problems.push(
+      `${join(path, field)} must be ${allowed}, got ${JSON.stringify(value.slice(0, 80))}.`
     );
-  } finally {
-    if (timer !== void 0) clearTimeout(timer);
-    options.signal?.removeEventListener("abort", onExternalAbort);
   }
-  const resolved = resolvePayload(definition, payload, options);
-  if (resolved.status !== "ok") return resolved;
-  const storedAt = Date.now();
-  if (options.cache !== void 0) {
-    try {
-      await options.cache.set(cacheKeyFor(definition, options, values), {
-        payload: resolved.data,
-        storedAt
-      });
-    } catch {
-    }
+}
+function requireArray(record, field, path, problems) {
+  const value = record[field];
+  if (!Array.isArray(value)) {
+    problems.push(
+      `${join(path, field)} must be an array, got ${describeType2(value)}.`
+    );
+    return null;
   }
-  return { ...resolved, updatedAt: storedAt };
+  return value;
 }
-function widgetsFor(definitions, roles) {
-  return sortDefinitions(
-    definitions.filter((definition) => isWidgetVisibleTo(definition, roles))
-  );
+function requireOneOf(record, field, options, path, problems) {
+  const value = record[field];
+  if (typeof value !== "string" || !options.includes(value)) {
+    problems.push(
+      `${join(path, field)} must be one of ${options.map((o) => `"${o}"`).join(", ")}, got ${typeof value === "string" ? JSON.stringify(value) : describeType2(value)}.`
+    );
+  }
 }
-async function resolveWidgets(definitions, providers, context, options = {}) {
-  const visible = widgetsFor(definitions, context.roles);
-  return Promise.all(
-    visible.map(
-      (definition) => resolveWidget(
-        definition,
-        Object.prototype.hasOwnProperty.call(providers, definition.key) ? providers[definition.key] : void 0,
-        context,
-        options
-      )
-    )
-  );
+function eachRecord(items, path, problems, check) {
+  items.forEach((item, index) => {
+    const itemPath = `${path}[${index}]`;
+    if (isRecord3(item)) {
+      check(item, itemPath);
+    } else {
+      problems.push(
+        `${itemPath} must be an object, got ${describeType2(item)}.`
+      );
+    }
+  });
 }
-
-// src/core/loader.ts
-function createWidgetLoader(options) {
-  const { definitions, providers, context, ...baseOptions } = options;
-  const chosen = new Map(
-    Object.entries(baseOptions.optionValues ?? {}).flatMap(
-      ([key, values]) => values === void 0 ? [] : [[key, values]]
-    )
-  );
-  const resolveOptions = baseOptions;
-  function currentOptions() {
-    return { ...resolveOptions, optionValues: Object.fromEntries(chosen) };
-  }
-  const unapplied = /* @__PURE__ */ new Map();
-  const visible = widgetsFor(definitions, context.roles);
-  let snapshot = loadingWidgets(visible);
-  const listeners = /* @__PURE__ */ new Set();
-  const started = /* @__PURE__ */ new Set();
-  const generations = /* @__PURE__ */ new Map();
-  const inFlight = /* @__PURE__ */ new Map();
-  let disposed = false;
-  function publish(next) {
-    snapshot = next;
-    for (const listener of [...listeners]) {
-      try {
-        listener();
-      } catch {
+var HREF_RULE = "an http(s), mailto or relative URL";
+var IMAGE_RULE = "an http(s) or relative URL";
+function checkPayloadFields(kind, data, problems) {
+  switch (kind) {
+    case "TEXT":
+      requireString(data, "value", "", problems);
+      requireString(data, "label", "", problems);
+      return;
+    case "KPI":
+      requireNumber(data, "value", "", problems);
+      if (data["previous"] !== null) {
+        optionalNumber(data, "previous", "", problems);
       }
-    }
-  }
-  function replace(key, widget) {
-    publish(
-      snapshot.map(
-        (current) => current.definition.key === key ? widget : current
-      )
-    );
-  }
-  function abortAll(reason) {
-    for (const controller of inFlight.values()) controller.abort(reason);
-    inFlight.clear();
-  }
-  resolveOptions.signal?.addEventListener(
-    "abort",
-    () => abortAll(resolveOptions.signal?.reason),
-    { once: true }
-  );
-  async function run(definition, readCache) {
-    const key = definition.key;
-    const generation = (generations.get(key) ?? 0) + 1;
-    generations.set(key, generation);
-    inFlight.get(key)?.abort(new Error("Superseded by a newer load."));
-    const controller = new AbortController();
-    inFlight.set(key, controller);
-    const isCurrent = () => !disposed && generations.get(key) === generation;
-    const runOptions = currentOptions();
-    const values = optionValuesFor(definition, runOptions);
-    if (readCache && runOptions.cache !== void 0) {
-      try {
-        const entry = await runOptions.cache.get(
-          cacheKeyFor(definition, runOptions, values)
-        );
-        if (entry !== void 0 && isCurrent()) {
-          const cached = resolvePayload(definition, entry.payload, runOptions);
-          if (cached.status === "ok") {
-            const stale = { ...cached, updatedAt: entry.storedAt, stale: true };
-            unapplied.set(key, stale);
-            replace(key, finalizeWidget(stale, values));
+      requireOneOf(data, "format", VALUE_FORMATS, "", problems);
+      optionalString(data, "currency", "", problems);
+      requireString(data, "label", "", problems);
+      optionalString(data, "hint", "", problems);
+      optionalBoolean(data, "higherIsBetter", "", problems);
+      return;
+    case "GAUGE":
+      requireNumber(data, "value", "", problems);
+      requireNumber(data, "max", "", problems);
+      requireString(data, "label", "", problems);
+      if (typeof data["max"] === "number" && data["max"] <= 0) {
+        problems.push(`max must be greater than 0, got ${data["max"]}.`);
+      }
+      return;
+    case "TABLE": {
+      const columns = requireArray(data, "columns", "", problems);
+      if (columns !== null) {
+        eachRecord(columns, "columns", problems, (column, path) => {
+          requireString(column, "label", path, problems);
+          optionalBoolean(column, "numeric", path, problems);
+        });
+      }
+      const rows = requireArray(data, "rows", "", problems);
+      if (rows !== null) {
+        rows.forEach((row, rowIndex) => {
+          const rowPath = `rows[${rowIndex}]`;
+          if (!Array.isArray(row)) {
+            problems.push(
+              `${rowPath} must be an array of cells, got ${describeType2(row)}.`
+            );
+            return;
           }
-        }
-      } catch {
+          if (columns !== null && row.length !== columns.length) {
+            problems.push(
+              `${rowPath} has ${row.length} cell(s) but there are ${columns.length} column(s).`
+            );
+          }
+          eachRecord(row, rowPath, problems, (cell, cellPath) => {
+            requireString(cell, "text", cellPath, problems);
+            optionalSortValue(cell, cellPath, problems);
+            optionalUrl(
+              cell,
+              "href",
+              cellPath,
+              problems,
+              isSafeHref,
+              HREF_RULE
+            );
+          });
+        });
       }
+      optionalString(data, "footer", "", problems);
+      return;
     }
-    if (!isCurrent()) return;
-    const provider = Object.prototype.hasOwnProperty.call(providers, key) ? providers[key] : void 0;
-    const result = await resolveWidgetUnapplied(definition, provider, context, {
-      ...runOptions,
-      signal: controller.signal
-    });
-    if (!isCurrent()) return;
-    inFlight.delete(key);
-    if (result.status === "ok") unapplied.set(key, result);
-    else unapplied.delete(key);
-    replace(key, finalizeWidget(result, values));
-  }
-  function start(definition, readCache) {
-    started.add(definition.key);
-    void run(definition, readCache);
-  }
-  function definitionFor(key) {
-    return visible.find((definition) => definition.key === key);
-  }
-  function load(key) {
-    if (disposed || started.has(key)) return;
-    const definition = definitionFor(key);
-    if (definition !== void 0) start(definition, true);
-  }
-  function loadAll() {
-    for (const definition of visible) load(definition.key);
-  }
-  function refresh(key, refreshOptions) {
-    if (disposed) return;
-    const keys = key === void 0 ? [...started] : [key];
-    for (const target of keys) {
-      const definition = definitionFor(target);
-      if (definition === void 0) continue;
-      if (refreshOptions?.skipInFlight === true && inFlight.has(target)) {
-        continue;
-      }
-      const current = snapshot.find(
-        (widget) => widget.definition.key === target
-      );
-      if (current?.status === "error") {
-        replace(target, { definition, status: "loading" });
+    case "BAR_LIST": {
+      const items = requireArray(data, "items", "", problems);
+      if (items !== null) {
+        eachRecord(items, "items", problems, (item, path) => {
+          requireString(item, "label", path, problems);
+          requireNumber(item, "value", path, problems);
+          optionalString(item, "display", path, problems);
+        });
       }
-      start(definition, false);
+      optionalNumber(data, "total", "", problems);
+      return;
     }
-  }
-  function setOptions(key, values) {
-    if (disposed) return;
-    const definition = definitionFor(key);
-    if (definition === void 0) return;
-    const before = optionValuesFor(definition, currentOptions());
-    chosen.set(key, { ...values });
-    const runOptions = currentOptions();
-    const after = optionValuesFor(definition, runOptions);
-    if (sameOptionValues(before, after) || !started.has(key)) return;
-    const kept = unapplied.get(key);
-    if (kept !== void 0 && optionsCacheSuffix(definition, before, runOptions) === optionsCacheSuffix(definition, after, runOptions)) {
-      replace(key, finalizeWidget(kept, after));
+    case "ALERT_LIST": {
+      const items = requireArray(data, "items", "", problems);
+      if (items !== null) {
+        eachRecord(items, "items", problems, (item, path) => {
+          requireString(item, "title", path, problems);
+          optionalUrl(item, "href", path, problems, isSafeHref, HREF_RULE);
+          optionalUrl(
+            item,
+            "thumbnailUrl",
+            path,
+            problems,
+            isSafeImageUrl,
+            IMAGE_RULE
+          );
+          requireString(item, "valueLabel", path, problems);
+          optionalString(item, "detail", path, problems);
+        });
+      }
+      requireNumber(data, "total", "", problems);
+      requireString(data, "emptyText", "", problems);
+      if (items !== null && typeof data["total"] === "number" && data["total"] < items.length) {
+        problems.push(
+          `total (${data["total"]}) must be at least the number of items (${items.length}).`
+        );
+      }
       return;
     }
-    const current = snapshot.find(
-      (widget) => widget.definition.key === key
-    );
-    if (current?.status === "ok") replace(key, { ...current, stale: true });
-    else if (current?.status === "error") {
-      replace(key, { definition, status: "loading" });
+    case "GRAPH": {
+      const series = requireArray(data, "series", "", problems);
+      if (series !== null) {
+        if (series.length > MAX_GRAPH_SERIES) {
+          problems.push(
+            `series has ${series.length} entries; at most ${MAX_GRAPH_SERIES} are allowed (fold the rest into "Other").`
+          );
+        }
+        eachRecord(series, "series", problems, (entry, path) => {
+          requireString(entry, "name", path, problems);
+          const points = requireArray(entry, "points", path, problems);
+          if (points !== null) {
+            eachRecord(
+              points,
+              `${path}.points`,
+              problems,
+              (point, pointPath) => {
+                requireString(point, "label", pointPath, problems);
+                requireNumber(point, "value", pointPath, problems);
+              }
+            );
+          }
+        });
+      }
+      requireOneOf(data, "chartType", ["bar", "line"], "", problems);
+      requireOneOf(data, "valueFormat", VALUE_FORMATS, "", problems);
+      optionalString(data, "currency", "", problems);
+      optionalString(data, "xLabel", "", problems);
+      return;
     }
-    start(definition, true);
   }
-  function dispose() {
-    disposed = true;
-    abortAll(new Error("The widget loader was disposed."));
-    listeners.clear();
+}
+function checkDetailOption(detail, problems) {
+  if (detail === void 0 || typeof detail === "boolean") return;
+  if (!isRecord3(detail)) {
+    problems.push(
+      `detail must be true, false or an options object, got ${describeType2(detail)}.`
+    );
+    return;
   }
-  function subscribe(listener) {
-    listeners.add(listener);
-    return () => {
-      listeners.delete(listener);
-    };
+  optionalString(detail, "title", "detail", problems);
+  const pageSize = detail["pageSize"];
+  if (pageSize !== void 0 && !(typeof pageSize === "number" && Number.isInteger(pageSize) && pageSize >= 1 && pageSize <= MAX_DETAIL_PAGE_SIZE)) {
+    problems.push(
+      `detail.pageSize must be a whole number from 1 to ${MAX_DETAIL_PAGE_SIZE}, got ${typeof pageSize === "number" ? String(pageSize) : describeType2(pageSize)}.`
+    );
+  }
+  if (detail["mode"] !== void 0) {
+    requireOneOf(detail, "mode", DETAIL_MODES, "detail", problems);
   }
-  return {
-    getSnapshot: () => snapshot,
-    subscribe,
-    load,
-    loadAll,
-    refresh,
-    setOptions,
-    dispose
-  };
-}
-
-// src/core/pages.ts
-var DEFAULT_PAGE_KEY = "default";
-var DEFAULT_PAGE_ROWS = 4;
-function rowsAllowed(page, options) {
-  const rows = page.maxRows ?? options.maxRows ?? DEFAULT_PAGE_ROWS;
-  return Math.max(1, Math.min(MAX_PAGE_ROWS, Math.floor(rows)));
 }
-function hasPages(layout) {
-  return layout.pages !== void 0 && layout.pages.length > 0;
+function checkTableControlsOption(controls, kind, problems) {
+  if (controls === void 0 || controls === false) return;
+  if (typeof controls !== "boolean" && !isRecord3(controls)) {
+    problems.push(
+      `tableControls must be true, false or an options object, got ${describeType2(controls)}.`
+    );
+    return;
+  }
+  if (isRecord3(controls)) {
+    optionalBoolean(controls, "search", "tableControls", problems);
+    optionalBoolean(controls, "sort", "tableControls", problems);
+  }
+  if (typeof kind === "string" && kind !== "TABLE") {
+    problems.push(
+      `tableControls only applies to TABLE widgets, but kind is "${kind}".`
+    );
+  }
 }
-function pageList(layout) {
-  if (layout.pages !== void 0 && layout.pages.length > 0) {
-    return layout.pages;
+function checkWidthLimits(value, problems) {
+  for (const field of ["minWidth", "maxWidth"]) {
+    const limit = value[field];
+    if (limit !== void 0 && !isWidgetWidth(limit)) {
+      problems.push(
+        `${field} must be an integer from ${MIN_WIDGET_WIDTH} to ${MAX_WIDGET_WIDTH} (twelfths of the row), got ${typeof limit === "number" ? String(limit) : describeType2(limit)}.`
+      );
+      return;
+    }
   }
-  return [
-    {
-      key: DEFAULT_PAGE_KEY,
-      title: "Page 1",
-      order: layout.order,
-      hidden: layout.hidden,
-      minimized: layout.minimized
+  const { minWidth, maxWidth, width } = value;
+  if (isWidgetWidth(minWidth) && isWidgetWidth(maxWidth) && minWidth > maxWidth) {
+    problems.push(
+      `minWidth (${minWidth}) must not be more than maxWidth (${maxWidth}).`
+    );
+    return;
+  }
+  if (isWidgetWidth(width)) {
+    if (isWidgetWidth(minWidth) && width < minWidth) {
+      problems.push(
+        `width (${width}) must not be less than minWidth (${minWidth}).`
+      );
     }
-  ];
-}
-function withExplicitPages(layout) {
-  if (hasPages(layout)) return layout;
-  return {
-    ...layout,
-    order: [],
-    hidden: [],
-    minimized: [],
-    pages: pageList(layout)
-  };
+    if (isWidgetWidth(maxWidth) && width > maxWidth) {
+      problems.push(
+        `width (${width}) must not be more than maxWidth (${maxWidth}).`
+      );
+    }
+  }
 }
-function sameKeys(a, b) {
-  return a === b || a.length === b.length && a.every((k, i) => k === b[i]);
+function checkLockedOption(locked, problems) {
+  if (locked === void 0 || typeof locked === "boolean") return;
+  if (!isRecord3(locked)) {
+    problems.push(
+      `locked must be true, false or an object, got ${describeType2(locked)}.`
+    );
+    return;
+  }
+  optionalBoolean(locked, "move", "locked", problems);
+  optionalBoolean(locked, "hide", "locked", problems);
+  optionalBoolean(locked, "minimize", "locked", problems);
+  optionalBoolean(locked, "options", "locked", problems);
+  optionalBoolean(locked, "clone", "locked", problems);
 }
-function pageLayout(layout, pageKey) {
-  if (!hasPages(layout))
-    return pageKey === DEFAULT_PAGE_KEY ? layout : void 0;
-  const page = layout.pages?.find(
-    (p) => p.key === pageKey
-  );
-  if (page === void 0) return void 0;
-  const { pages, ...rest } = layout;
-  return {
-    ...rest,
-    order: page.order,
-    hidden: page.hidden,
-    minimized: page.minimized
-  };
+function checkOptionColumns(option, path, kind, problems) {
+  const columns = option["columns"];
+  if (!Array.isArray(columns) || columns.length === 0) {
+    problems.push(
+      `${join(path, "columns")} must be a non-empty array of { key, label }, got ${describeType2(columns)}.`
+    );
+    return [];
+  }
+  const keys = [];
+  columns.forEach((entry, index) => {
+    const entryPath = `${path}.columns[${index}]`;
+    if (!isRecord3(entry)) {
+      problems.push(
+        `${entryPath} must be an object, got ${describeType2(entry)}.`
+      );
+      return;
+    }
+    requireString(entry, "label", entryPath, problems);
+    const key = entry["key"];
+    if (typeof key !== "string") {
+      problems.push(
+        `${entryPath}.key must be a string, got ${describeType2(key)}.`
+      );
+    } else if (typeof kind === "string" && !isColumnKeyFor(kind, key)) {
+      problems.push(
+        `${entryPath}.key "${key}" is not a column of a ${kind} widget (${kind === "TABLE" ? '"c0", "c1", ...' : '"label" or "value"'}).`
+      );
+    } else if (keys.includes(key)) {
+      problems.push(`${entryPath}.key "${key}" is used twice.`);
+    } else {
+      keys.push(key);
+    }
+  });
+  return keys;
 }
-function withPageLayout(layout, pageKey, next) {
-  const current = pageLayout(layout, pageKey);
-  if (current === void 0 || sameKeys(current.order, next.order) && sameKeys(current.hidden, next.hidden) && sameKeys(current.minimized, next.minimized)) {
-    return layout;
+function checkOption(option, path, kind, seenKeys, seenTypes, problems) {
+  if (!isRecord3(option)) {
+    problems.push(`${path} must be an object, got ${describeType2(option)}.`);
+    return;
   }
-  if (!hasPages(layout)) {
-    return {
-      ...layout,
-      order: next.order,
-      hidden: next.hidden,
-      minimized: next.minimized
-    };
+  const type = option["type"];
+  if (typeof type !== "string" || !WIDGET_OPTION_TYPES.includes(type)) {
+    requireOneOf(option, "type", WIDGET_OPTION_TYPES, path, problems);
+    return;
   }
-  return {
-    ...layout,
-    pages: (layout.pages ?? []).map(
-      (page) => page.key === pageKey ? {
-        ...page,
-        order: next.order,
-        hidden: next.hidden,
-        minimized: next.minimized
-      } : page
-    )
-  };
-}
-function normalizedTitle(title) {
-  return title.trim().normalize("NFKC").toLowerCase();
-}
-function resolvePageKey(layout, reference) {
-  if (reference === void 0 || reference === "") return void 0;
-  const pages = pageList(layout);
-  const byKey = pages.find((p) => p.key === reference);
-  if (byKey !== void 0) return byKey.key;
-  const wanted = normalizedTitle(reference);
-  return pages.find((p) => normalizedTitle(p.title) === wanted)?.key;
-}
-function homePageKey(layout, item) {
-  return resolvePageKey(layout, item.page) ?? pageList(layout)[0].key;
-}
-function assignPages(definitions, layout) {
-  const pages = pageList(layout);
-  const assigned = new Map(pages.map((p) => [p.key, []]));
-  for (const definition of definitions) {
-    let pageKey;
-    if (!resolveWidgetLock(definition).move) {
-      pageKey = pages.find(
-        (p) => p.order.includes(definition.key) || p.hidden.includes(definition.key)
-      )?.key;
+  const key = option["key"];
+  if (typeof key !== "string" || !OPTION_KEY_PATTERN.test(key)) {
+    problems.push(
+      `${path}.key must be letters, digits, "_" or "-", starting with a letter (40 characters at most), got ${typeof key === "string" ? JSON.stringify(key) : describeType2(key)}.`
+    );
+  } else if (seenKeys.has(key)) {
+    problems.push(`${path}.key "${key}" is used by another option.`);
+  } else {
+    seenKeys.add(key);
+  }
+  requireString(option, "label", path, problems);
+  const fallback = option["default"];
+  switch (type) {
+    case "choice": {
+      const choices = option["choices"];
+      const values = [];
+      if (!Array.isArray(choices) || choices.length === 0) {
+        problems.push(
+          `${path}.choices must be a non-empty array of { value, label }, got ${describeType2(choices)}.`
+        );
+      } else {
+        choices.forEach((choice, index) => {
+          const choicePath = `${path}.choices[${index}]`;
+          if (!isRecord3(choice)) {
+            problems.push(
+              `${choicePath} must be an object, got ${describeType2(choice)}.`
+            );
+            return;
+          }
+          requireString(choice, "label", choicePath, problems);
+          const value = choice["value"];
+          if (typeof value !== "string" || value === "") {
+            problems.push(
+              `${choicePath}.value must be a non-empty string, got ${describeType2(value)}.`
+            );
+          } else if (values.includes(value)) {
+            problems.push(`${choicePath}.value "${value}" is used twice.`);
+          } else {
+            values.push(value);
+          }
+        });
+      }
+      if (values.length > 0)
+        requireOneOf(option, "default", values, path, problems);
+      break;
+    }
+    case "number": {
+      const { min, max, step } = option;
+      requireNumber(option, "min", path, problems);
+      requireNumber(option, "max", path, problems);
+      if (typeof min === "number" && typeof max === "number" && min > max) {
+        problems.push(
+          `${path}.min (${min}) must not be more than max (${max}).`
+        );
+      }
+      if (step !== void 0 && !(typeof step === "number" && Number.isFinite(step) && step > 0)) {
+        problems.push(
+          `${path}.step must be a number above 0, got ${describeType2(step)}.`
+        );
+      }
+      if (typeof fallback !== "number" || !Number.isFinite(fallback)) {
+        problems.push(
+          `${path}.default must be a finite number, got ${describeType2(fallback)}.`
+        );
+      } else if (typeof min === "number" && typeof max === "number" && (fallback < min || fallback > max)) {
+        problems.push(
+          `${path}.default (${fallback}) must be between min (${min}) and max (${max}).`
+        );
+      } else if (typeof min === "number" && typeof step === "number" && step > 0 && Math.abs(
+        (fallback - min) / step - Math.round((fallback - min) / step)
+      ) > 1e-9) {
+        problems.push(
+          `${path}.default (${fallback}) must be ${min} plus a whole number of steps of ${step}.`
+        );
+      }
+      break;
+    }
+    case "boolean":
+      if (typeof fallback !== "boolean") {
+        problems.push(
+          `${path}.default must be a boolean, got ${describeType2(fallback)}.`
+        );
+      }
+      break;
+    case "text": {
+      const maxLength = option["maxLength"];
+      if (typeof maxLength !== "number" || !Number.isInteger(maxLength) || maxLength < 1 || maxLength > MAX_TEXT_OPTION_LENGTH) {
+        problems.push(
+          `${path}.maxLength must be a whole number from 1 to ${MAX_TEXT_OPTION_LENGTH}, got ${typeof maxLength === "number" ? maxLength : describeType2(maxLength)}.`
+        );
+      }
+      if (typeof fallback !== "string") {
+        problems.push(
+          `${path}.default must be a string, got ${describeType2(fallback)}.`
+        );
+      } else if (typeof maxLength === "number" && fallback.length > maxLength) {
+        problems.push(
+          `${path}.default is ${fallback.length} characters; maxLength is ${maxLength}.`
+        );
+      }
+      break;
+    }
+    case "dateRange": {
+      const presets = option["presets"];
+      const offered = [];
+      if (presets !== void 0) {
+        if (!Array.isArray(presets) || presets.length === 0) {
+          problems.push(
+            `${path}.presets must be a non-empty array of { value, label }, got ${describeType2(presets)}.`
+          );
+        } else {
+          presets.forEach((preset, index) => {
+            const presetPath = `${path}.presets[${index}]`;
+            if (!isRecord3(preset)) {
+              problems.push(
+                `${presetPath} must be an object, got ${describeType2(preset)}.`
+              );
+              return;
+            }
+            requireString(preset, "label", presetPath, problems);
+            requireOneOf(
+              preset,
+              "value",
+              DATE_RANGE_PRESETS,
+              presetPath,
+              problems
+            );
+            if (typeof preset["value"] === "string")
+              offered.push(preset["value"]);
+          });
+        }
+      }
+      const allowed = offered.length > 0 ? offered : DATE_RANGE_PRESETS;
+      if (typeof fallback !== "string" || !(allowed.includes(fallback) || isIsoInterval(fallback))) {
+        problems.push(
+          `${path}.default must be one of ${allowed.map((p) => `"${p}"`).join(", ")} or an interval like "2026-01-01/2026-01-31", got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
+        );
+      }
+      break;
+    }
+    case "color":
+      if (typeof fallback !== "string" || !/^#[0-9a-fA-F]{6}$/.test(fallback)) {
+        problems.push(
+          `${path}.default must be a color like "#1c5cab", got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
+        );
+      }
+      break;
+    case "sort":
+    case "columns": {
+      const supported = type === "sort" ? kind === "TABLE" || kind === "BAR_LIST" : kind === "TABLE";
+      if (!supported && typeof kind === "string") {
+        problems.push(
+          `${path} is a ${type} option, which only applies to ${type === "sort" ? "TABLE and BAR_LIST" : "TABLE"} widgets, but kind is "${kind}".`
+        );
+      }
+      if (seenTypes.has(type)) {
+        problems.push(
+          `${path} is a second ${type} option; a widget has at most one.`
+        );
+      }
+      seenTypes.add(type);
+      const columnKeys = checkOptionColumns(
+        option,
+        path,
+        supported ? kind : void 0,
+        problems
+      );
+      if (option["apply"] !== void 0) {
+        requireOneOf(option, "apply", ["provider", "client"], path, problems);
+      }
+      if (type === "sort") {
+        if (fallback !== void 0) {
+          const sort = typeof fallback === "string" ? parseSortValue(fallback) : void 0;
+          if (sort === void 0) {
+            problems.push(
+              `${path}.default must look like "c1:desc" ("column:asc" or "column:desc"), got ${typeof fallback === "string" ? JSON.stringify(fallback) : describeType2(fallback)}.`
+            );
+          } else if (columnKeys.length > 0 && !columnKeys.includes(sort.column)) {
+            requireOneOf(
+              { default: sort.column },
+              "default",
+              columnKeys,
+              path,
+              problems
+            );
+          }
+        }
+      } else if (!Array.isArray(fallback) || fallback.length === 0 || fallback.some((k) => typeof k !== "string")) {
+        problems.push(
+          `${path}.default must be a non-empty array of column keys, got ${describeType2(fallback)}.`
+        );
+      } else {
+        const shown = /* @__PURE__ */ new Set();
+        for (const columnKey of fallback) {
+          if (columnKeys.length > 0 && !columnKeys.includes(columnKey)) {
+            problems.push(
+              `${path}.default has "${columnKey}", which is not one of the columns (${columnKeys.map((c) => `"${c}"`).join(", ")}).`
+            );
+          } else if (shown.has(columnKey)) {
+            problems.push(`${path}.default lists "${columnKey}" twice.`);
+          }
+          shown.add(columnKey);
+        }
+      }
+      break;
     }
-    assigned.get(pageKey ?? homePageKey(layout, definition))?.push(definition);
   }
-  return assigned;
 }
-function pageOf(definitions, layout, key) {
-  for (const [pageKey, widgets] of assignPages(definitions, layout)) {
-    if (widgets.some((w) => w.key === key)) return pageKey;
+function checkOptions(options, kind, problems) {
+  if (options === void 0) return;
+  if (!Array.isArray(options)) {
+    problems.push(`options must be an array, got ${describeType2(options)}.`);
+    return;
   }
-  return void 0;
+  if (options.length > MAX_WIDGET_OPTIONS) {
+    problems.push(
+      `options lists ${options.length} options; the most a widget may declare is ${MAX_WIDGET_OPTIONS}.`
+    );
+    return;
+  }
+  const seenKeys = /* @__PURE__ */ new Set();
+  const seenTypes = /* @__PURE__ */ new Set();
+  options.forEach((option, index) => {
+    checkOption(
+      option,
+      `options[${index}]`,
+      kind,
+      seenKeys,
+      seenTypes,
+      problems
+    );
+  });
 }
-function pageWidgets(definitions, layout, pageKey) {
-  const onPage = assignPages(definitions, layout).get(pageKey) ?? [];
-  const view = pageLayout(layout, pageKey);
-  return view === void 0 ? [] : visibleWidgets(onPage, view);
+var MAX_VIEW_COLUMN = 1e3;
+function checkColumnIndex(value, path, problems) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 0 || value > MAX_VIEW_COLUMN) {
+    problems.push(
+      `${path} must be a column index (a whole number from 0), got ${typeof value === "number" ? String(value) : describeType2(value)}.`
+    );
+  }
 }
-function pageRoom(definitions, layout, pageKey, options = {}) {
-  const page = pageList(layout).find(
-    (p) => p.key === pageKey
-  );
-  if (page === void 0) return void 0;
-  const maxRows = rowsAllowed(page, options);
-  const rowsUsed = placeRows(
-    pageWidgets(definitions, layout, pageKey)
-  ).length;
-  return { maxRows, rowsUsed, rowsFree: Math.max(0, maxRows - rowsUsed) };
+function checkConversion(conversion, path, baseKind, viewKind2, problems) {
+  if (!isRecord3(conversion)) {
+    problems.push(
+      `${path} must be an object with a type, got ${describeType2(conversion)}.`
+    );
+    return;
+  }
+  const type = conversion["type"];
+  const known = typeof type === "string" && Object.hasOwn(VIEW_CONVERSIONS, type) ? VIEW_CONVERSIONS[type] : void 0;
+  if (known === void 0) {
+    problems.push(
+      `${path}.type must be one of ${Object.keys(VIEW_CONVERSIONS).map((name) => `"${name}"`).join(", ")}, got ${describeType2(type)}.`
+    );
+    return;
+  }
+  if (baseKind !== known.from) {
+    problems.push(
+      `${path}.type "${String(type)}" reads a ${known.from} widget, but this one is ${String(baseKind)}.`
+    );
+  }
+  if (viewKind2 !== known.to) {
+    problems.push(
+      `${path}.type "${String(type)}" produces ${known.to}, but the view's kind is ${String(viewKind2)}.`
+    );
+  }
+  switch (type) {
+    case "tableToBarList":
+      checkColumnIndex(conversion["label"], `${path}.label`, problems);
+      checkColumnIndex(conversion["value"], `${path}.value`, problems);
+      break;
+    case "tableToGraph": {
+      checkColumnIndex(conversion["label"], `${path}.label`, problems);
+      const values = conversion["values"];
+      if (!Array.isArray(values) || values.length === 0) {
+        problems.push(`${path}.values must list 1 or more column indexes.`);
+      } else if (values.length > MAX_GRAPH_SERIES) {
+        problems.push(
+          `${path}.values lists ${values.length} series; a chart carries at most ${MAX_GRAPH_SERIES}.`
+        );
+      } else {
+        values.forEach(
+          (index, at) => checkColumnIndex(index, `${path}.values[${at}]`, problems)
+        );
+      }
+      if (conversion["chartType"] !== "bar" && conversion["chartType"] !== "line") {
+        problems.push(`${path}.chartType must be "bar" or "line".`);
+      }
+      break;
+    }
+    case "barListToGraph":
+      if (conversion["chartType"] !== "bar" && conversion["chartType"] !== "line") {
+        problems.push(`${path}.chartType must be "bar" or "line".`);
+      }
+      break;
+  }
+  if (conversion["valueFormat"] !== void 0 && !VALUE_FORMATS.includes(conversion["valueFormat"])) {
+    problems.push(
+      `${path}.valueFormat must be one of ${VALUE_FORMATS.map((f) => `"${f}"`).join(", ")}.`
+    );
+  }
 }
-function describePage(page) {
-  return `Page "${page.title}"`;
+function checkViews(value, problems) {
+  const views = value["views"];
+  const defaultView = value["defaultView"];
+  optionalString(value, "baseViewLabel", "", problems);
+  if (value["baseViewLabel"] === "") {
+    problems.push("baseViewLabel must not be empty.");
+  }
+  const declared = /* @__PURE__ */ new Set([BASE_VIEW_KEY]);
+  if (views !== void 0) {
+    if (!Array.isArray(views)) {
+      problems.push(`views must be an array, got ${describeType2(views)}.`);
+    } else if (views.length > MAX_WIDGET_VIEWS) {
+      problems.push(
+        `views lists ${views.length} views; the most a widget may declare is ${MAX_WIDGET_VIEWS}.`
+      );
+    } else {
+      views.forEach((view, index) => {
+        const path = `views[${index}]`;
+        if (!isRecord3(view)) {
+          problems.push(
+            `${path} must be an object, got ${describeType2(view)}.`
+          );
+          return;
+        }
+        const key = view["key"];
+        if (typeof key !== "string" || key.trim() === "") {
+          problems.push(`${path}.key must be a non-empty string.`);
+        } else if (declared.has(key)) {
+          problems.push(
+            key === BASE_VIEW_KEY ? `${path}.key "${BASE_VIEW_KEY}" is reserved for the widget's own kind.` : `${path}.key "${key}" is used twice.`
+          );
+        } else {
+          declared.add(key);
+        }
+        if (typeof view["label"] !== "string" || view["label"].trim() === "") {
+          problems.push(`${path}.label must be a non-empty string.`);
+        }
+        requireOneOf(view, "kind", WIDGET_KINDS, path, problems);
+        if (view["convert"] === void 0) {
+          problems.push(
+            `${path}.convert is required: views supplied by a provider are not supported yet.`
+          );
+        } else {
+          checkConversion(
+            view["convert"],
+            `${path}.convert`,
+            value["kind"],
+            view["kind"],
+            problems
+          );
+        }
+      });
+    }
+  }
+  if (defaultView !== void 0) {
+    if (typeof defaultView !== "string" || !declared.has(defaultView)) {
+      problems.push(
+        `defaultView must be "${BASE_VIEW_KEY}" or the key of a declared view, got ${typeof defaultView === "string" ? JSON.stringify(defaultView) : describeType2(defaultView)}.`
+      );
+    }
+  }
 }
-function titleOf(item) {
-  return item.title ?? item.key;
+function formatProblems(prefix, problems) {
+  const shown = problems.slice(0, MAX_REPORTED_PROBLEMS);
+  const more = problems.length - shown.length;
+  return `${prefix}: ${shown.join(" ")}${more > 0 ? ` (and ${more} more problem(s))` : ""}`;
 }
-function checkTitle(layout, title, exceptKey) {
-  const trimmed = title.trim();
-  if (trimmed === "") return err("A page title must not be empty.");
-  if (trimmed.length > MAX_PAGE_TITLE_LENGTH) {
+function validateWidgetData(value, options = {}) {
+  const subject = options.widgetKey === void 0 ? "Widget data" : `Widget ${JSON.stringify(options.widgetKey)}`;
+  if (!isRecord3(value)) {
+    return err(`${subject}: must be an object, got ${describeType2(value)}.`);
+  }
+  if (value["empty"] === true) {
+    if (typeof value["text"] !== "string") {
+      return err(
+        `${subject} (empty): text must be a string, got ${describeType2(value["text"])}.`
+      );
+    }
+    return ok(value);
+  }
+  const kind = value["kind"];
+  if (!isWidgetKind(kind)) {
     return err(
-      `Page title "${trimmed}" is ${trimmed.length} characters; the most is ${MAX_PAGE_TITLE_LENGTH}.`
+      `${subject}: kind must be one of ${WIDGET_KINDS.join(", ")} (or the payload must be {"empty": true, "text": ...}), got ${typeof kind === "string" ? JSON.stringify(kind) : describeType2(kind)}.`
     );
   }
-  const wanted = normalizedTitle(trimmed);
-  const clash = pageList(layout).find(
-    (p) => p.key !== exceptKey && normalizedTitle(p.title) === wanted
-  );
-  if (clash !== void 0) {
-    return err(`Another page is already called "${clash.title}".`);
+  if (options.expectedKind !== void 0 && kind !== options.expectedKind) {
+    return err(
+      `${subject}: expected kind ${options.expectedKind} from its definition, got ${kind}.`
+    );
   }
-  return ok(trimmed);
-}
-function nextPageKey(layout) {
-  const keys = new Set(pageList(layout).map((p) => p.key));
-  let n = 1;
-  while (keys.has(`page-${n}`)) n += 1;
-  return `page-${n}`;
-}
-function nextPageTitle(layout) {
-  const used = new Set(
-    pageList(layout).map((p) => normalizedTitle(p.title))
-  );
-  let n = pageList(layout).length + 1;
-  while (used.has(normalizedTitle(`Page ${n}`))) n += 1;
-  return `Page ${n}`;
+  const problems = [];
+  checkPayloadFields(kind, value, problems);
+  if (problems.length > 0) {
+    return err(formatProblems(`${subject} (${kind})`, problems));
+  }
+  return ok(value);
 }
-function addPage(layout, options = {}) {
-  if (pageList(layout).length >= MAX_PARSED_PAGES) {
+function validateWidgetDefinition(value) {
+  if (!isRecord3(value)) {
     return err(
-      `The layout already has ${MAX_PARSED_PAGES} pages, the most it can keep.`
+      `Widget definition: must be an object, got ${describeType2(value)}.`
     );
   }
-  const key = options.key ?? nextPageKey(layout);
-  if (pageList(layout).some((p) => p.key === key)) {
-    return err(`A page with the key "${key}" already exists.`);
+  const subject = typeof value["key"] === "string" ? `Widget definition ${JSON.stringify(value["key"])}` : "Widget definition";
+  const problems = [];
+  requireString(value, "key", "", problems);
+  if (value["key"] === "") {
+    problems.push("key must not be empty.");
   }
-  const title = checkTitle(
-    layout,
-    options.title ?? nextPageTitle(layout)
-  );
-  if (!title.ok) return title;
-  const base = withExplicitPages(layout);
-  const page = {
-    key,
-    title: title.value,
-    order: [],
-    hidden: [],
-    minimized: []
-  };
-  return ok({ ...base, pages: [...base.pages ?? [], page] });
+  requireString(value, "title", "", problems);
+  optionalString(value, "description", "", problems);
+  requireOneOf(value, "kind", WIDGET_KINDS, "", problems);
+  optionalNumber(value, "sortOrder", "", problems);
+  if (value["roles"] !== void 0) {
+    const roles = requireArray(value, "roles", "", problems);
+    roles?.forEach((role, index) => {
+      if (typeof role !== "string") {
+        problems.push(
+          `roles[${index}] must be a string, got ${describeType2(role)}.`
+        );
+      }
+    });
+  }
+  optionalBoolean(value, "active", "", problems);
+  if (value["defaultSize"] !== void 0) {
+    requireOneOf(value, "defaultSize", WIDGET_SIZES, "", problems);
+  }
+  if (value["width"] !== void 0 && !isWidgetWidth(value["width"])) {
+    problems.push(
+      `width must be an integer from ${MIN_WIDGET_WIDTH} to ${MAX_WIDGET_WIDTH} (twelfths of the row), got ${typeof value["width"] === "number" ? String(value["width"]) : describeType2(value["width"])}.`
+    );
+  }
+  checkWidthLimits(value, problems);
+  checkDetailOption(value["detail"], problems);
+  checkTableControlsOption(value["tableControls"], value["kind"], problems);
+  checkLockedOption(value["locked"], problems);
+  checkOptions(value["options"], value["kind"], problems);
+  checkViews(value, problems);
+  if (value["page"] !== void 0) {
+    if (typeof value["page"] !== "string" || value["page"].trim() === "") {
+      problems.push(
+        `page must be a non-empty page key or title, got ${describeType2(value["page"])}.`
+      );
+    }
+  }
+  if (value["fill"] !== void 0) {
+    requireOneOf(value, "fill", WIDGET_FILLS, "", problems);
+  }
+  if (problems.length > 0) {
+    return err(formatProblems(subject, problems));
+  }
+  return ok(value);
+}
+
+// src/core/resolve.ts
+function resolvePayload(definition, payload, options = {}) {
+  let checked;
+  if (options.validate === false) {
+    checked = payload;
+  } else {
+    const result = validateWidgetData(payload, {
+      widgetKey: definition.key,
+      expectedKind: definition.kind
+    });
+    if (!result.ok) {
+      return { definition, status: "error", error: result.error };
+    }
+    checked = result.value;
+  }
+  const emptyText = emptyTextFor(checked);
+  if (emptyText !== null) {
+    return { definition, status: "empty", emptyText };
+  }
+  return { definition, status: "ok", data: checked };
 }
-function renamePage(layout, pageKey, title) {
-  const page = pageList(layout).find(
-    (p) => p.key === pageKey
-  );
-  if (page === void 0) return err(`Page "${pageKey}" doesn't exist.`);
-  const checked = checkTitle(layout, title, pageKey);
-  if (!checked.ok) return checked;
-  if (checked.value === page.title) return ok(layout);
-  const base = withExplicitPages(layout);
-  return ok({
-    ...base,
-    pages: (base.pages ?? []).map(
-      (p) => p.key === pageKey ? { ...p, title: checked.value } : p
-    )
-  });
+function failedWidget(definition, error) {
+  return { definition, status: "error", error };
 }
-function movePage(layout, pageKey, offset) {
-  const pages = layout.pages ?? [];
-  const from = pages.findIndex((p) => p.key === pageKey);
-  if (from === -1) return layout;
-  const to = Math.max(
-    0,
-    Math.min(pages.length - 1, from + Math.trunc(offset))
-  );
-  if (to === from) return layout;
-  const next = [...pages];
-  const [moved] = next.splice(from, 1);
-  next.splice(to, 0, moved);
-  return { ...layout, pages: next };
+function loadingWidgets(definitions) {
+  return definitions.map((definition) => ({ definition, status: "loading" }));
 }
-function overflowing(definitions, layout, options) {
-  return pageList(layout).find(
-    (page) => placeRows(pageWidgets(definitions, layout, page.key)).length > rowsAllowed(page, options)
-  );
+function cacheKeyFor(definition, options, values) {
+  const base = options.cacheKey === void 0 ? definition.sourceKey ?? definition.key : options.cacheKey(definition);
+  return values === void 0 ? base : `${base}${optionsCacheSuffix(definition, values, options)}`;
 }
-function removePage(definitions, layout, pageKey, options = {}) {
-  const pages = pageList(layout);
-  const index = pages.findIndex((p) => p.key === pageKey);
-  const page = pages[index];
-  if (page === void 0) return err(`Page "${pageKey}" doesn't exist.`);
-  if (pages.length === 1) {
-    return err(
-      `${describePage(page)} is the only page, so it can't be removed.`
-    );
-  }
-  const target = pages[index > 0 ? index - 1 : 1];
-  const merged = {
-    ...layout,
-    pages: pages.filter((p) => p.key !== pageKey).map(
-      (p) => p.key === target.key ? {
-        ...p,
-        order: index > 0 ? [...p.order, ...page.order] : [...page.order, ...p.order],
-        hidden: [...p.hidden, ...page.hidden],
-        minimized: [...p.minimized, ...page.minimized]
-      } : p
-    )
-  };
-  const full = overflowing(
-    definitions,
-    merged,
+function optionValuesFor(definition, options) {
+  return resolveOptionValues(
+    definition,
+    options.optionValues?.[definition.key],
     options
   );
-  if (full !== void 0) {
-    return err(
-      `${describePage(page)} has widgets that don't fit on the other pages (${describePage(full)} would need more than ${rowsAllowed(full, options)} rows). Move or hide some first.`
+}
+function finalizeWidget(widget, values) {
+  if (Object.keys(values).length === 0) return widget;
+  if (widget.status === "ok") {
+    const data = applyClientOptions(
+      widget.definition,
+      widget.data,
+      values
     );
+    return { ...widget, data, options: values };
   }
-  return ok(merged);
+  return { ...widget, options: values };
 }
-function without(keys, key) {
-  return keys.includes(key) ? keys.filter((k) => k !== key) : keys;
+var LoadInterruption = class extends Error {
+};
+async function resolveWidget(definition, provider, context, options = {}) {
+  const values = optionValuesFor(definition, options);
+  return finalizeWidget(
+    await resolveWidgetUnapplied(definition, provider, context, options),
+    values
+  );
 }
-function moveWidgetToPage(definitions, layout, widgetKey, targetKey, options = {}) {
-  const widget = definitions.find((d) => d.key === widgetKey);
-  if (widget === void 0) {
-    return err(
-      `Widget "${widgetKey}" isn't one of the widgets, so it can't be moved to a page.`
+async function resolveWidgetUnapplied(definition, provider, context, options = {}) {
+  const values = optionValuesFor(definition, options);
+  const quotedKey = JSON.stringify(definition.key);
+  if (provider === void 0) {
+    return failedWidget(
+      definition,
+      `Widget ${quotedKey}: no provider is registered for this key.`
     );
   }
-  const pages = pageList(layout);
-  const target = pages.find((p) => p.key === targetKey);
-  if (target === void 0) return err(`Page "${targetKey}" doesn't exist.`);
-  const sourceKey = pageOf(definitions, layout, widgetKey);
-  if (sourceKey === targetKey) return ok(layout);
-  if (resolveWidgetLock(widget).move) {
-    return err(
-      `Widget "${titleOf(widget)}" is locked against moving, so it can't be moved to ${describePage(target)}.`
+  if (options.signal?.aborted === true) {
+    return failedWidget(
+      definition,
+      `Widget ${quotedKey}: loading was canceled before it started.`
     );
   }
-  const base = withExplicitPages(layout);
-  const source = (base.pages ?? []).find(
-    (p) => p.key === sourceKey
-  );
-  const hidden = source.hidden.includes(widgetKey);
-  const minimized = source.minimized.includes(widgetKey);
-  const targetOrder = pageWidgets(
-    definitions,
-    base,
-    targetKey
-  ).map((d) => d.key);
-  const moved = {
-    ...base,
-    pages: (base.pages ?? []).map((p) => {
-      if (p.key === sourceKey) {
-        return {
-          ...p,
-          order: without(p.order, widgetKey),
-          hidden: without(p.hidden, widgetKey),
-          minimized: without(p.minimized, widgetKey)
-        };
-      }
-      if (p.key === targetKey) {
-        return {
-          ...p,
-          order: hidden ? p.order : [...targetOrder, widgetKey],
-          hidden: hidden ? [...p.hidden, widgetKey] : p.hidden,
-          minimized: minimized ? [...p.minimized, widgetKey] : p.minimized
-        };
-      }
-      return p;
-    })
-  };
-  if (!hidden) {
-    const allowed = rowsAllowed(target, options);
-    const needed = placeRows(
-      pageWidgets(definitions, moved, targetKey)
-    ).length;
-    if (needed > allowed) {
-      return err(
-        `${describePage(target)} has no room for "${titleOf(widget)}": it would need row ${needed}, and the page allows ${allowed}.`
+  const controller = new AbortController();
+  const onExternalAbort = () => controller.abort(options.signal?.reason);
+  options.signal?.addEventListener("abort", onExternalAbort, { once: true });
+  let timedOut = false;
+  const timeoutMs = options.timeoutMs !== void 0 && options.timeoutMs > 0 ? options.timeoutMs : void 0;
+  const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
+    timedOut = true;
+    controller.abort(new Error(`Timed out after ${timeoutMs} ms.`));
+  }, timeoutMs);
+  const interrupted = new Promise((_resolve, reject) => {
+    controller.signal.addEventListener(
+      "abort",
+      () => reject(new LoadInterruption()),
+      { once: true }
+    );
+  });
+  let payload;
+  try {
+    payload = await Promise.race([
+      Promise.resolve().then(() => {
+        if (controller.signal.aborted) throw new LoadInterruption();
+        return provider(context, definition, {
+          signal: controller.signal,
+          options: values
+        });
+      }),
+      interrupted
+    ]);
+  } catch (cause) {
+    if (cause instanceof LoadInterruption) {
+      return failedWidget(
+        definition,
+        timedOut ? `Widget ${quotedKey}: provider timed out after ${timeoutMs} ms.` : `Widget ${quotedKey}: loading was canceled.`
       );
     }
+    return failedWidget(
+      definition,
+      `Widget ${quotedKey}: provider failed: ${describeUnknownError(cause)}`
+    );
+  } finally {
+    if (timer !== void 0) clearTimeout(timer);
+    options.signal?.removeEventListener("abort", onExternalAbort);
   }
-  return ok(moved);
-}
-function withoutLockField(definition) {
-  if (definition.locked === void 0) return definition;
-  const copy = { ...definition };
-  delete copy.locked;
-  return copy;
-}
-function uniqueTitle2(taken, title, index) {
-  let base = title.trim().slice(0, MAX_PAGE_TITLE_LENGTH);
-  if (base === "") base = `Page ${index + 1}`;
-  let candidate = base;
-  let n = 1;
-  while (taken.has(normalizedTitle(candidate))) {
-    const suffix = ` (#${n})`;
-    candidate = `${base.slice(0, MAX_PAGE_TITLE_LENGTH - suffix.length)}${suffix}`;
-    n += 1;
+  const resolved = resolvePayload(definition, payload, options);
+  if (resolved.status !== "ok") return resolved;
+  const storedAt = Date.now();
+  if (options.cache !== void 0) {
+    try {
+      await options.cache.set(cacheKeyFor(definition, options, values), {
+        payload: resolved.data,
+        storedAt
+      });
+    } catch {
+    }
   }
-  taken.add(normalizedTitle(candidate));
-  return candidate;
+  return { ...resolved, updatedAt: storedAt };
 }
-function samePages(a, b) {
-  return a.length === b.length && a.every((p, i) => {
-    const q = b[i];
-    return p.key === q.key && p.title === q.title && p.maxRows === q.maxRows && sameKeys(p.order, q.order) && sameKeys(p.hidden, q.hidden) && sameKeys(p.minimized, q.minimized);
-  });
+function widgetsFor(definitions, roles) {
+  return sortDefinitions(
+    definitions.filter((definition) => isWidgetVisibleTo(definition, roles))
+  );
 }
-function normalizeLayout(definitions, layout, options = {}) {
-  const known = pruneLayout(definitions, layout);
-  const enforced = enforceLocks(definitions, known, options);
-  const locked = normalizeSettings(
-    definitions,
-    enforced,
-    options
+async function resolveWidgets(definitions, providers, context, options = {}) {
+  const visible = widgetsFor(definitions, context.roles);
+  return Promise.all(
+    visible.map(
+      (definition) => resolveWidget(
+        definition,
+        Object.prototype.hasOwnProperty.call(
+          providers,
+          definition.sourceKey ?? definition.key
+        ) ? providers[definition.sourceKey ?? definition.key] : void 0,
+        context,
+        options
+      )
+    )
   );
-  if (!hasPages(locked)) return locked === layout ? layout : locked;
-  const defs = effectiveDefinitions(
-    options.overrideLocks === true ? definitions.map(withoutLockField) : definitions,
-    locked,
-    options
+}
+
+// src/core/loader.ts
+function createWidgetLoader(options) {
+  const { definitions, providers, context, ...baseOptions } = options;
+  const chosen = new Map(
+    Object.entries(baseOptions.optionValues ?? {}).flatMap(
+      ([key, values]) => values === void 0 ? [] : [[key, values]]
+    )
   );
-  const taken = /* @__PURE__ */ new Set();
-  const seenKeys = /* @__PURE__ */ new Set();
-  const held = /* @__PURE__ */ new Set();
-  let pages = [];
-  (locked.pages ?? []).forEach((page, index) => {
-    if (seenKeys.has(page.key)) return;
-    seenKeys.add(page.key);
-    const keep = (list) => [
-      ...new Set(list.filter((k) => !held.has(k)))
-    ];
-    const next = {
-      ...page,
-      title: uniqueTitle2(taken, page.title, index),
-      order: keep(page.order),
-      hidden: keep(page.hidden),
-      minimized: keep(page.minimized)
-    };
-    for (const k of [...next.order, ...next.hidden]) held.add(k);
-    pages.push(next);
-  });
-  const work = () => ({ ...locked, pages });
-  const pinned = defs.filter((d) => resolveWidgetLock(d).move);
-  for (const widget of pinned) {
-    const home = homePageKey(work(), widget);
-    const keysHere = (p, list) => p.key !== home && p[list].includes(widget.key);
-    const wasHidden = pages.some((p) => keysHere(p, "hidden"));
-    const wasMinimized = pages.some((p) => keysHere(p, "minimized"));
-    if (!wasHidden && !wasMinimized) continue;
-    pages = pages.map((p) => {
-      let next = p;
-      if (keysHere(p, "hidden")) {
-        next = { ...next, hidden: without(next.hidden, widget.key) };
-      }
-      if (keysHere(p, "minimized")) {
-        next = { ...next, minimized: without(next.minimized, widget.key) };
+  const resolveOptions = baseOptions;
+  function currentOptions() {
+    return { ...resolveOptions, optionValues: Object.fromEntries(chosen) };
+  }
+  const unapplied = /* @__PURE__ */ new Map();
+  const visible = widgetsFor(definitions, context.roles);
+  let snapshot = loadingWidgets(visible);
+  const listeners = /* @__PURE__ */ new Set();
+  const started = /* @__PURE__ */ new Set();
+  const generations = /* @__PURE__ */ new Map();
+  const inFlight = /* @__PURE__ */ new Map();
+  let disposed = false;
+  function publish(next) {
+    snapshot = next;
+    for (const listener of [...listeners]) {
+      try {
+        listener();
+      } catch {
       }
-      if (p.key === home) {
-        next = {
-          ...next,
-          hidden: wasHidden && !next.hidden.includes(widget.key) ? [...next.hidden, widget.key] : next.hidden,
-          minimized: wasMinimized && !next.minimized.includes(widget.key) ? [...next.minimized, widget.key] : next.minimized
-        };
+    }
+  }
+  function replace(key, widget) {
+    publish(
+      snapshot.map(
+        (current) => current.definition.key === key ? widget : current
+      )
+    );
+  }
+  function abortAll(reason) {
+    for (const controller of inFlight.values()) controller.abort(reason);
+    inFlight.clear();
+  }
+  resolveOptions.signal?.addEventListener(
+    "abort",
+    () => abortAll(resolveOptions.signal?.reason),
+    { once: true }
+  );
+  async function run(definition, readCache) {
+    const key = definition.key;
+    const generation = (generations.get(key) ?? 0) + 1;
+    generations.set(key, generation);
+    inFlight.get(key)?.abort(new Error("Superseded by a newer load."));
+    const controller = new AbortController();
+    inFlight.set(key, controller);
+    const isCurrent = () => !disposed && generations.get(key) === generation;
+    const runOptions = currentOptions();
+    const values = optionValuesFor(definition, runOptions);
+    if (readCache && runOptions.cache !== void 0) {
+      try {
+        const entry = await runOptions.cache.get(
+          cacheKeyFor(definition, runOptions, values)
+        );
+        if (entry !== void 0 && isCurrent()) {
+          const cached = resolvePayload(definition, entry.payload, runOptions);
+          if (cached.status === "ok") {
+            const stale = { ...cached, updatedAt: entry.storedAt, stale: true };
+            unapplied.set(key, stale);
+            replace(key, finalizeWidget(stale, values));
+          }
+        }
+      } catch {
       }
-      return next;
+    }
+    if (!isCurrent()) return;
+    const providerKey = definition.sourceKey ?? key;
+    const provider = Object.prototype.hasOwnProperty.call(
+      providers,
+      providerKey
+    ) ? providers[providerKey] : void 0;
+    const result = await resolveWidgetUnapplied(definition, provider, context, {
+      ...runOptions,
+      signal: controller.signal
     });
+    if (!isCurrent()) return;
+    inFlight.delete(key);
+    if (result.status === "ok") unapplied.set(key, result);
+    else unapplied.delete(key);
+    replace(key, finalizeWidget(result, values));
   }
-  const placedKeys = /* @__PURE__ */ new Set();
-  for (const p of pages) {
-    for (const k of [...p.order, ...p.hidden]) placedKeys.add(k);
+  function start(definition, readCache) {
+    started.add(definition.key);
+    void run(definition, readCache);
   }
-  const pinnedKeys = new Set(pinned.map((d) => d.key));
-  const unplaced = defs.filter((d) => !placedKeys.has(d.key) && !pinnedKeys.has(d.key)).map((definition, index) => ({ definition, index })).sort(
-    (a, b) => (a.definition.sortOrder ?? 0) - (b.definition.sortOrder ?? 0) || a.index - b.index
-  ).map(({ definition }) => definition);
-  for (const widget of unplaced) {
-    const home = homePageKey(work(), widget);
-    pages = pages.map(
-      (p) => p.key === home ? { ...p, order: [...p.order, widget.key] } : p
-    );
+  function definitionFor(key) {
+    return visible.find((definition) => definition.key === key);
   }
-  for (let i = 0; i < pages.length; i += 1) {
-    const page = pages[i];
-    const shown = pageWidgets(defs, work(), page.key);
-    const fits = fitCount(shown, rowsAllowed(page, options));
-    if (fits >= shown.length) continue;
-    const moving = shown.slice(fits).filter((d) => !pinnedKeys.has(d.key)).map((d) => d.key);
-    if (moving.length === 0) continue;
-    const moveSet = new Set(moving);
-    const movedMinimized = page.minimized.filter(
-      (k) => moveSet.has(k)
-    );
-    pages = pages.map(
-      (p) => p.key === page.key ? {
-        ...p,
-        order: p.order.filter((k) => !moveSet.has(k)),
-        minimized: p.minimized.filter((k) => !moveSet.has(k))
-      } : p
-    );
-    let placed = false;
-    for (let j = i + 1; j < pages.length && !placed; j += 1) {
-      const candidate = pages[j];
-      const trial = pages.map(
-        (p) => p.key === candidate.key ? {
-          ...p,
-          order: [...moving, ...p.order],
-          minimized: [...p.minimized, ...movedMinimized]
-        } : p
-      );
-      const items = pageWidgets(
-        defs,
-        { ...locked, pages: trial },
-        candidate.key
+  function load(key) {
+    if (disposed || started.has(key)) return;
+    const definition = definitionFor(key);
+    if (definition !== void 0) start(definition, true);
+  }
+  function loadAll() {
+    for (const definition of visible) load(definition.key);
+  }
+  function refresh(key, refreshOptions) {
+    if (disposed) return;
+    const keys = key === void 0 ? [...started] : [key];
+    for (const target of keys) {
+      const definition = definitionFor(target);
+      if (definition === void 0) continue;
+      if (refreshOptions?.skipInFlight === true && inFlight.has(target)) {
+        continue;
+      }
+      const current = snapshot.find(
+        (widget) => widget.definition.key === target
       );
-      if (placeRows(items).length <= rowsAllowed(candidate, options)) {
-        pages = trial;
-        placed = true;
+      if (current?.status === "error") {
+        replace(target, { definition, status: "loading" });
       }
+      start(definition, false);
     }
-    if (!placed) {
-      const key = nextPageKey(work());
-      const title = uniqueTitle2(
-        new Set(pages.map((p) => normalizedTitle(p.title))),
-        `Page ${pages.length + 1}`,
-        pages.length
-      );
-      pages = [
-        ...pages,
-        { key, title, order: moving, hidden: [], minimized: movedMinimized }
-      ];
+  }
+  function setOptions(key, values) {
+    if (disposed) return;
+    const definition = definitionFor(key);
+    if (definition === void 0) return;
+    const before = optionValuesFor(definition, currentOptions());
+    chosen.set(key, { ...values });
+    const runOptions = currentOptions();
+    const after = optionValuesFor(definition, runOptions);
+    if (sameOptionValues(before, after) || !started.has(key)) return;
+    const kept = unapplied.get(key);
+    if (kept !== void 0 && optionsCacheSuffix(definition, before, runOptions) === optionsCacheSuffix(definition, after, runOptions)) {
+      replace(key, finalizeWidget(kept, after));
+      return;
+    }
+    const current = snapshot.find(
+      (widget) => widget.definition.key === key
+    );
+    if (current?.status === "ok") replace(key, { ...current, stale: true });
+    else if (current?.status === "error") {
+      replace(key, { definition, status: "loading" });
     }
+    start(definition, true);
   }
-  const result = work();
-  return samePages(layout.pages ?? [], pages) && sameKeys(layout.order, result.order) && locked.settings === layout.settings ? layout : result;
+  function dispose() {
+    disposed = true;
+    abortAll(new Error("The widget loader was disposed."));
+    listeners.clear();
+  }
+  function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  }
+  return {
+    getSnapshot: () => snapshot,
+    subscribe,
+    load,
+    loadAll,
+    refresh,
+    setOptions,
+    dispose
+  };
 }
 
 // src/core/scale.ts
@@ -3798,6 +4420,7 @@ function indent(block) {
   return block.split("\n").map((line) => `  ${line}`).join("\n");
 }
 
+exports.BASE_VIEW_KEY = BASE_VIEW_KEY;
 exports.DATE_RANGE_PRESETS = DATE_RANGE_PRESETS;
 exports.DEFAULT_COMPARISON_LABEL = DEFAULT_COMPARISON_LABEL;
 exports.DEFAULT_CURRENCY = DEFAULT_CURRENCY;
@@ -3813,17 +4436,20 @@ exports.MAX_DETAIL_PAGE_SIZE = MAX_DETAIL_PAGE_SIZE;
 exports.MAX_GRAPH_SERIES = MAX_GRAPH_SERIES;
 exports.MAX_PAGE_ROWS = MAX_PAGE_ROWS;
 exports.MAX_PAGE_TITLE_LENGTH = MAX_PAGE_TITLE_LENGTH;
+exports.MAX_PARSED_CLONES = MAX_PARSED_CLONES;
 exports.MAX_PARSED_PAGES = MAX_PARSED_PAGES;
 exports.MAX_PARSED_SETTINGS = MAX_PARSED_SETTINGS;
 exports.MAX_REPORTED_PROBLEMS = MAX_REPORTED_PROBLEMS;
 exports.MAX_TEXT_OPTION_LENGTH = MAX_TEXT_OPTION_LENGTH;
 exports.MAX_WIDGET_OPTIONS = MAX_WIDGET_OPTIONS;
 exports.MAX_WIDGET_TITLE_LENGTH = MAX_WIDGET_TITLE_LENGTH;
+exports.MAX_WIDGET_VIEWS = MAX_WIDGET_VIEWS;
 exports.MAX_WIDGET_WIDTH = MAX_WIDGET_WIDTH;
 exports.MIN_WIDGET_WIDTH = MIN_WIDGET_WIDTH;
 exports.OPTION_KEY_PATTERN = OPTION_KEY_PATTERN;
 exports.THEME_TOKEN_VARIABLES = THEME_TOKEN_VARIABLES;
 exports.VALUE_FORMATS = VALUE_FORMATS;
+exports.VIEW_CONVERSIONS = VIEW_CONVERSIONS;
 exports.WIDGET_FILLS = WIDGET_FILLS;
 exports.WIDGET_KINDS = WIDGET_KINDS;
 exports.WIDGET_OPTION_TYPES = WIDGET_OPTION_TYPES;
@@ -3832,20 +4458,28 @@ exports.WIDTH_COLUMNS = WIDTH_COLUMNS;
 exports.addPage = addPage;
 exports.applyClientOptions = applyClientOptions;
 exports.applySettings = applySettings;
+exports.applyView = applyView;
 exports.assignPages = assignPages;
 exports.baseColumnSpan = baseColumnSpan;
 exports.cacheKeyFor = cacheKeyFor;
+exports.canDuplicate = canDuplicate;
+exports.cleanClones = cleanClones;
 exports.clearWidgetSettings = clearWidgetSettings;
+exports.cloneNumber = cloneNumber;
 exports.coerceOptionValue = coerceOptionValue;
+exports.convertView = convertView;
 exports.createLayoutPersistence = createLayoutPersistence;
 exports.createTheme = createTheme;
 exports.createWidgetLoader = createWidgetLoader;
 exports.defaultDetailQuery = defaultDetailQuery;
 exports.defaultOptionValue = defaultOptionValue;
 exports.defineWidget = defineWidget;
+exports.deleteClone = deleteClone;
 exports.deriveDetailData = deriveDetailData;
 exports.describeUnknownError = describeUnknownError;
+exports.duplicateWidget = duplicateWidget;
 exports.effectiveDefinitions = effectiveDefinitions;
+exports.effectiveViewKey = effectiveViewKey;
 exports.emptyTextFor = emptyTextFor;
 exports.emptyWidget = emptyWidget;
 exports.enforceLocks = enforceLocks;
@@ -3856,12 +4490,14 @@ exports.fillWidthSpans = fillWidthSpans;
 exports.fillsHeight = fillsHeight;
 exports.fillsWidth = fillsWidth;
 exports.finalizeWidget = finalizeWidget;
+exports.findView = findView;
 exports.fitCount = fitCount;
 exports.formatCount = formatCount;
 exports.formatPercentChange = formatPercentChange;
 exports.formatValue = formatValue;
 exports.fromLegacyDefinition = fromLegacyDefinition;
 exports.hasPages = hasPages;
+exports.hasViews = hasViews;
 exports.hiddenWidgets = hiddenWidgets;
 exports.hideWidget = hideWidget;
 exports.isClientApplied = isClientApplied;
@@ -3879,6 +4515,7 @@ exports.isWidgetKind = isWidgetKind;
 exports.isWidgetVisibleTo = isWidgetVisibleTo;
 exports.isWidgetWidth = isWidgetWidth;
 exports.itemWidth = itemWidth;
+exports.kindLabel = kindLabel;
 exports.kpiDelta = kpiDelta;
 exports.labelStride = labelStride;
 exports.loadingWidgets = loadingWidgets;
@@ -3890,6 +4527,7 @@ exports.moveWidgetBy = moveWidgetBy;
 exports.moveWidgetDown = moveWidgetDown;
 exports.moveWidgetToPage = moveWidgetToPage;
 exports.moveWidgetUp = moveWidgetUp;
+exports.nextCloneKey = nextCloneKey;
 exports.nextPageKey = nextPageKey;
 exports.niceDomain = niceDomain;
 exports.niceStep = niceStep;
@@ -3905,6 +4543,7 @@ exports.pageList = pageList;
 exports.pageOf = pageOf;
 exports.pageRoom = pageRoom;
 exports.pageWidgets = pageWidgets;
+exports.parseClones = parseClones;
 exports.parseDetailQuery = parseDetailQuery;
 exports.parseLayout = parseLayout;
 exports.parseSettings = parseSettings;
@@ -3928,6 +4567,7 @@ exports.resolveWidgetUnapplied = resolveWidgetUnapplied;
 exports.resolveWidgets = resolveWidgets;
 exports.restoreWidget = restoreWidget;
 exports.sameOptionValues = sameOptionValues;
+exports.serializeClones = serializeClones;
 exports.serializeDetailQuery = serializeDetailQuery;
 exports.serializeLayout = serializeLayout;
 exports.serializeSettings = serializeSettings;
@@ -3936,6 +4576,7 @@ exports.shareOf = shareOf;
 exports.showWidget = showWidget;
 exports.sortDefinitions = sortDefinitions;
 exports.sortFromOptions = sortFromOptions;
+exports.suggestedViewTitle = suggestedViewTitle;
 exports.tableDetailData = tableDetailData;
 exports.toggleHidden = toggleHidden;
 exports.toggleMinimized = toggleMinimized;
@@ -3945,12 +4586,16 @@ exports.utf8Length = utf8Length;
 exports.validateDetailData = validateDetailData;
 exports.validateWidgetData = validateWidgetData;
 exports.validateWidgetDefinition = validateWidgetDefinition;
+exports.viewChoices = viewChoices;
+exports.viewKind = viewKind;
+exports.viewNote = viewNote;
 exports.visibleWidgets = visibleWidgets;
 exports.widgetOptionValues = widgetOptionValues;
 exports.widgetsFor = widgetsFor;
 exports.widthForSize = widthForSize;
 exports.widthRange = widthRange;
 exports.widthShareLabel = widthShareLabel;
+exports.withClones = withClones;
 exports.withEncoding = withEncoding;
 exports.withFallback = withFallback;
 exports.withLogging = withLogging;