@richardmcquiston01/dashboard-widgets-toolkit 0.13.0 → 0.15.0

package/dist/core.cjs

@@ -89,12 +89,14 @@ var WIDGET_FILLS = ["height", "width", "both"];
 var NOT_LOCKED = Object.freeze({
   move: false,
   hide: false,
-  minimize: false
+  minimize: false,
+  options: false
 });
 var FULLY_LOCKED = Object.freeze({
   move: true,
   hide: true,
-  minimize: true
+  minimize: true,
+  options: true
 });
 function resolveWidgetLock(definition) {
   const setting = definition.locked;
@@ -103,7 +105,8 @@ function resolveWidgetLock(definition) {
   return {
     move: setting.move === true,
     hide: setting.hide === true,
-    minimize: setting.minimize === true
+    minimize: setting.minimize === true,
+    options: setting.options === true
   };
 }
 function defineWidget(definition) {
@@ -685,261 +688,261 @@ function placeAndFillRows(items, columns, spanOf) {
   return { spans, rows };
 }
 
-// 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"]);
-  if (pages.length > 0) {
-    return {
-      order: EMPTY_LAYOUT.order,
-      hidden: EMPTY_LAYOUT.hidden,
-      minimized: EMPTY_LAYOUT.minimized,
-      pages
-    };
-  }
-  if (order.length === 0 && hidden.length === 0 && minimized.length === 0) {
-    return EMPTY_LAYOUT;
-  }
-  return { order, hidden, minimized };
+// 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 parsePages(value) {
-  if (!Array.isArray(value)) return [];
-  const pages = [];
-  const keys = /* @__PURE__ */ new Set();
-  for (const entry of value.slice(0, MAX_PARSED_PAGES)) {
-    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-      continue;
-    }
-    const record = entry;
-    const key = record["key"];
-    if (typeof key !== "string" || key === "" || keys.has(key)) continue;
-    keys.add(key);
-    const rawTitle = record["title"];
-    const title = typeof rawTitle === "string" && rawTitle.trim() !== "" ? rawTitle.trim().slice(0, MAX_PAGE_TITLE_LENGTH) : `Page ${pages.length + 1}`;
-    const maxRows = record["maxRows"];
-    const held = /* @__PURE__ */ new Set();
-    for (const earlier of pages) {
-      for (const k of [...earlier.order, ...earlier.hidden]) held.add(k);
-    }
-    const keep = (list) => uniqueStrings(list).filter((k) => !held.has(k));
-    pages.push({
-      key,
-      title,
-      order: keep(record["order"]),
-      hidden: keep(record["hidden"]),
-      minimized: keep(record["minimized"]),
-      ...typeof maxRows === "number" && Number.isInteger(maxRows) && maxRows >= 1 && maxRows <= MAX_PAGE_ROWS ? { maxRows } : {}
-    });
-  }
-  return pages;
+function hasViews(item) {
+  return item.views !== void 0 && item.views.length > 0;
 }
-function serializeLayout(layout) {
-  return JSON.stringify({
-    order: [...layout.order],
-    hidden: [...layout.hidden],
-    minimized: [...layout.minimized],
-    ...layout.pages === void 0 || layout.pages.length === 0 ? {} : {
-      pages: layout.pages.map((page) => ({
-        key: page.key,
-        title: page.title,
-        order: [...page.order],
-        hidden: [...page.hidden],
-        minimized: [...page.minimized],
-        ...page.maxRows === void 0 ? {} : { maxRows: page.maxRows }
-      }))
-    }
-  });
+function findView(item, key) {
+  return item.views?.find((view) => view.key === key);
 }
-function bySortOrder(items) {
-  return items.map((item, index) => ({ item, index })).sort(
-    (a, b) => (a.item.sortOrder ?? 0) - (b.item.sortOrder ?? 0) || a.index - b.index
-  ).map(({ item }) => item);
+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 isPinned(item) {
-  return resolveWidgetLock(item).move;
+function isKnownView(item, key) {
+  return key !== void 0 && (key === BASE_VIEW_KEY || findView(item, key) !== void 0);
 }
-function viewerOrder(visible, layout) {
-  const byKey = new Map(visible.map((d) => [d.key, d]));
-  const ordered = [];
-  for (const key of layout.order) {
-    const definition = byKey.get(key);
-    if (definition !== void 0) {
-      ordered.push(definition);
-      byKey.delete(key);
-    }
-  }
-  for (const definition of bySortOrder(visible)) {
-    if (byKey.has(definition.key)) ordered.push(definition);
-  }
-  return ordered;
+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 placeAroundPinned(visible, free) {
-  const slots = bySortOrder(visible).map(
-    (item) => isPinned(item) ? item : void 0
-  );
-  let next = 0;
-  return slots.map((pinned) => pinned ?? free[next++]);
+function viewKind(item, chosen) {
+  return findView(item, effectiveViewKey(item, chosen))?.kind ?? item.kind;
 }
-function visibleWidgets(definitions, layout) {
-  const hidden = new Set(layout.hidden);
-  const visible = definitions.filter((d) => !hidden.has(d.key));
-  const ordered = viewerOrder(visible, layout);
-  if (!visible.some(isPinned)) return ordered;
-  return placeAroundPinned(
-    visible,
-    ordered.filter((item) => !isPinned(item))
-  );
+function cellValue2(cell) {
+  const value = cell?.value;
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-function hiddenWidgets(definitions, layout) {
-  const hidden = new Set(layout.hidden);
-  return bySortOrder(definitions.filter((d) => hidden.has(d.key)));
+function columnName(table, index) {
+  return table.columns[index]?.label ?? `#${index + 1}`;
 }
-function moveWidget(definitions, layout, key, toIndex) {
-  const current = visibleWidgets(definitions, layout);
-  const fromIndex = current.findIndex((d) => d.key === key);
-  const mover = current[fromIndex];
-  if (mover === void 0 || !Number.isInteger(toIndex) || toIndex < 0 || toIndex >= current.length || toIndex === fromIndex || isPinned(mover) || isPinned(current[toIndex])) {
-    return layout;
+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).`;
   }
-  const freeSlots = freeSlotIndexes(current);
-  const free = current.filter((item) => !isPinned(item));
-  const fromFree = freeSlots.indexOf(fromIndex);
-  const toFree = freeSlots.indexOf(toIndex);
-  free.splice(fromFree, 1);
-  free.splice(toFree, 0, mover);
-  const next = placeAroundPinned(current, free);
-  return { ...layout, order: next.map((d) => d.key) };
+  return void 0;
 }
-function freeSlotIndexes(ordered) {
-  const slots = [];
-  ordered.forEach((item, index) => {
-    if (!isPinned(item)) slots.push(index);
-  });
-  return slots;
+function numericColumn(table, index, context) {
+  const numbers = [];
+  for (const [rowIndex, row] of table.rows.entries()) {
+    const value = cellValue2(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 moveWidgetBy(definitions, layout, key, offset) {
-  const current = visibleWidgets(definitions, layout);
-  const fromIndex = current.findIndex((d) => d.key === key);
-  if (fromIndex === -1) return layout;
-  const freeSlots = freeSlotIndexes(current);
-  const fromFree = freeSlots.indexOf(fromIndex);
-  if (fromFree === -1) return layout;
-  const toFree = Math.max(
-    0,
-    Math.min(freeSlots.length - 1, fromFree + Math.trunc(offset))
+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
   );
-  return moveWidget(definitions, layout, key, freeSlots[toFree]);
-}
-function moveWidgetUp(definitions, layout, key) {
-  return moveWidgetBy(definitions, layout, key, -1);
-}
-function moveWidgetDown(definitions, layout, key) {
-  return moveWidgetBy(definitions, layout, key, 1);
-}
-function isHidden(layout, key) {
-  return layout.hidden.includes(key);
-}
-function isMinimized(layout, key) {
-  return layout.minimized.includes(key);
+  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 hideWidget(layout, key) {
-  if (isHidden(layout, key)) return layout;
-  return { ...layout, hidden: [...layout.hidden, key] };
+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 showWidget(layout, key) {
-  if (!isHidden(layout, key)) return layout;
-  return {
-    ...layout,
-    hidden: layout.hidden.filter((k) => k !== key),
-    minimized: layout.minimized.filter((k) => k !== key)
+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 toggleHidden(layout, key) {
-  return isHidden(layout, key) ? showWidget(layout, key) : hideWidget(layout, key);
-}
-function minimizeWidget(layout, key) {
-  if (isMinimized(layout, key)) return layout;
-  return { ...layout, minimized: [...layout.minimized, key] };
-}
-function restoreWidget(layout, key) {
-  if (!isMinimized(layout, key)) return layout;
-  return { ...layout, minimized: layout.minimized.filter((k) => k !== key) };
-}
-function toggleMinimized(layout, key) {
-  return isMinimized(layout, key) ? restoreWidget(layout, key) : minimizeWidget(layout, key);
-}
-function pruneLayout(definitions, layout) {
-  const known = new Set(definitions.map((d) => d.key));
-  const keep = (keys) => keys.every((k) => known.has(k)) ? keys : keys.filter((k) => known.has(k));
-  return mapLayoutLists(layout, (lists) => ({
-    order: keep(lists.order),
-    hidden: keep(lists.hidden),
-    minimized: keep(lists.minimized)
-  }));
-}
-function mapLayoutLists(layout, change) {
-  const top = change(layout);
-  const pages = layout.pages?.map((page) => {
-    const next = change(page);
-    return next.order === page.order && next.hidden === page.hidden && next.minimized === page.minimized ? page : { ...page, ...next };
+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 }
   });
-  const pagesChanged = pages !== void 0 && pages.some((page, i) => page !== layout.pages?.[i]);
-  if (top.order === layout.order && top.hidden === layout.hidden && top.minimized === layout.minimized && !pagesChanged) {
-    return layout;
+}
+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)}.`
+    );
   }
-  return {
-    ...layout,
-    ...top,
-    ...pages === void 0 ? {} : { pages }
+  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
   };
-}
-function enforceLocks(definitions, layout, options = {}) {
-  if (options.overrideLocks === true) return layout;
-  const noMove = /* @__PURE__ */ new Set();
-  const noHide = /* @__PURE__ */ new Set();
-  const noMinimize = /* @__PURE__ */ new Set();
-  for (const definition of definitions) {
-    const lock = resolveWidgetLock(definition);
-    if (lock.move) noMove.add(definition.key);
-    if (lock.hide) noHide.add(definition.key);
-    if (lock.minimize) noMinimize.add(definition.key);
+  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 }
+    };
   }
-  const without2 = (keys, drop) => keys.some((key) => drop.has(key)) ? keys.filter((key) => !drop.has(key)) : keys;
-  return mapLayoutLists(layout, (lists) => ({
-    order: without2(lists.order, noMove),
-    hidden: without2(lists.hidden, noHide),
-    minimized: without2(lists.minimized, noMinimize)
-  }));
+  return { ...widget, definition, data: converted.value };
 }
 
 // src/core/options.ts
@@ -1116,107 +1119,644 @@ function coerceOptionValue(option, value, context = {}) {
     }
   }
 }
-function defaultOptionValue(option, context = {}) {
-  switch (option.type) {
-    case "dateRange":
-      return resolveDateRange(option.default, context);
-    case "sort":
-      return option.default;
-    case "columns":
-      return [...option.default];
-    default:
-      return option.default;
-  }
+function defaultOptionValue(option, context = {}) {
+  switch (option.type) {
+    case "dateRange":
+      return resolveDateRange(option.default, context);
+    case "sort":
+      return option.default;
+    case "columns":
+      return [...option.default];
+    default:
+      return option.default;
+  }
+}
+var NO_VALUES = Object.freeze({});
+function resolveOptionValues(definition, chosen, context = {}) {
+  const options = definition.options;
+  if (options === void 0 || options.length === 0) return NO_VALUES;
+  const values = {};
+  for (const option of options) {
+    const picked = chosen?.[option.key];
+    const value = (picked === void 0 ? void 0 : coerceOptionValue(option, picked, context)) ?? defaultOptionValue(option, context);
+    if (value !== void 0) values[option.key] = value;
+  }
+  return values;
+}
+function sameValue(a, b) {
+  if (Array.isArray(a) && Array.isArray(b)) {
+    return a.length === b.length && a.every((item, i) => item === b[i]);
+  }
+  return a === b;
+}
+function sameOptionValues(a, b) {
+  const keys = Object.keys({ ...a, ...b });
+  return keys.every((key) => sameValue(a[key], b[key]));
+}
+function optionsCacheSuffix(definition, values, context = {}) {
+  const parts = [];
+  for (const option of definition.options ?? []) {
+    if (isClientApplied(option)) continue;
+    const value = values[option.key];
+    if (sameValue(value, defaultOptionValue(option, context))) continue;
+    parts.push(
+      `${option.key}=${encodeURIComponent(JSON.stringify(value ?? null))}`
+    );
+  }
+  parts.sort();
+  return parts.length === 0 ? "" : `?${parts.join("&")}`;
+}
+function tableColumnIndex(key) {
+  const match = /^c(\d+)$/.exec(key);
+  return match === null ? void 0 : Number(match[1]);
+}
+function sortBarItems(items, sort) {
+  const sign = sort.direction === "desc" ? -1 : 1;
+  return items.map((item, index) => ({ item, index })).sort((a, b) => {
+    const order = sort.column === "value" ? a.item.value - b.item.value : a.item.label.localeCompare(b.item.label);
+    return order * sign || a.index - b.index;
+  }).map(({ item }) => item);
+}
+function applyClientOptions(definition, data, values) {
+  const options = definition.options ?? [];
+  const sortOption = options.find(
+    (o) => o.type === "sort" && o.apply === "client"
+  );
+  const columnsOption = options.find(
+    (o) => o.type === "columns" && o.apply === "client"
+  );
+  const sortValue = sortOption === void 0 ? void 0 : values[sortOption.key];
+  const columnsValue = columnsOption === void 0 ? void 0 : values[columnsOption.key];
+  let next = data;
+  if (typeof sortValue === "string") {
+    const sort = parseSortValue(sortValue);
+    if (sort !== void 0 && next.kind === "BAR_LIST") {
+      if (sort.column === "label" || sort.column === "value") {
+        next = { ...next, items: sortBarItems(next.items, sort) };
+      }
+    } else if (sort !== void 0 && next.kind === "TABLE") {
+      const index = tableColumnIndex(sort.column);
+      if (index !== void 0 && index < next.columns.length) {
+        const sorted = queryRows(tableDetailData(next), {
+          page: 1,
+          pageSize: Math.max(1, next.rows.length),
+          sort
+        });
+        if (sorted.ok) next = { ...next, rows: sorted.value.rows };
+      }
+    }
+  }
+  if (Array.isArray(columnsValue) && next.kind === "TABLE") {
+    const table = next;
+    const indexes = columnsValue.map(tableColumnIndex).filter(
+      (index) => index !== void 0 && index < table.columns.length
+    );
+    if (indexes.length > 0) {
+      next = {
+        ...table,
+        columns: indexes.map((i) => table.columns[i]),
+        rows: table.rows.map((row) => indexes.map((i) => row[i]))
+      };
+    }
+  }
+  return next;
+}
+
+// src/core/settings.ts
+var MAX_WIDGET_TITLE_LENGTH = 80;
+var MAX_PARSED_SETTINGS = 500;
+var MAX_COLUMN_LIST = 100;
+var MAX_VALUE_LENGTH = 500;
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseOptionValue(value) {
+  if (typeof value === "string") {
+    return value.length <= MAX_VALUE_LENGTH ? value : void 0;
+  }
+  if (typeof value === "number")
+    return Number.isFinite(value) ? value : void 0;
+  if (typeof value === "boolean") return value;
+  if (Array.isArray(value) && value.length <= MAX_COLUMN_LIST) {
+    return value.every(
+      (entry) => typeof entry === "string" && entry.length <= MAX_VALUE_LENGTH
+    ) ? value : void 0;
+  }
+  return void 0;
+}
+function parseOne(raw) {
+  if (!isRecord(raw)) return void 0;
+  const title = raw["title"];
+  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)) {
+    for (const [key, value] of Object.entries(options)) {
+      const parsed = parseOptionValue(value);
+      if (parsed !== void 0) chosen[key] = parsed;
+    }
+  }
+  const settings = {
+    ...cleanTitle === "" ? {} : { title: cleanTitle },
+    ...isWidgetWidth(width) ? { width } : {},
+    ...typeof flexible === "boolean" ? { flexible } : {},
+    ...Object.keys(chosen).length === 0 ? {} : { options: chosen },
+    ...typeof view === "string" && view !== "" && view.length <= 80 ? { view } : {}
+  };
+  return Object.keys(settings).length === 0 ? void 0 : settings;
+}
+function parseSettings(raw) {
+  if (!isRecord(raw)) return void 0;
+  const parsed = {};
+  for (const [key, value] of Object.entries(raw).slice(
+    0,
+    MAX_PARSED_SETTINGS
+  )) {
+    if (key === "") continue;
+    const one = parseOne(value);
+    if (one !== void 0) parsed[key] = one;
+  }
+  return Object.keys(parsed).length === 0 ? void 0 : parsed;
+}
+function serializeSettings(settings) {
+  if (settings === void 0) return void 0;
+  const out = {};
+  for (const key of Object.keys(settings)) {
+    const one = settings[key];
+    if (one === void 0) continue;
+    const piece = {
+      ...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.view === void 0 ? {} : { view: one.view }
+    };
+    if (Object.keys(piece).length > 0) out[key] = piece;
+  }
+  return Object.keys(out).length === 0 ? void 0 : out;
+}
+function widthRange(item) {
+  const min = isWidgetWidth(item.minWidth) ? item.minWidth : MIN_WIDGET_WIDTH;
+  const max = isWidgetWidth(item.maxWidth) ? item.maxWidth : MAX_WIDGET_WIDTH;
+  return { min, max: Math.max(min, max) };
+}
+var WIDTH_SHARES = {
+  2: "1/6",
+  3: "1/4",
+  4: "1/3",
+  5: "5/12",
+  6: "1/2",
+  7: "7/12",
+  8: "2/3",
+  9: "3/4",
+  10: "5/6",
+  11: "11/12",
+  12: "Full"
+};
+function widthShareLabel(width) {
+  return WIDTH_SHARES[width] ?? `${width}/12`;
+}
+function isOptionsLocked(item) {
+  return resolveWidgetLock(item).options;
+}
+function fillWith(fill, flexible) {
+  const heightToo = fill === "height" || fill === "both";
+  if (flexible) return heightToo ? "both" : "width";
+  return heightToo ? "height" : void 0;
+}
+function isFlexible(item, settings) {
+  if (settings?.flexible !== void 0) return settings.flexible;
+  return item.fill === "width" || item.fill === "both";
+}
+function applySettings(definition, settings) {
+  if (settings === void 0) return definition;
+  const range = widthRange(definition);
+  const width = settings.width === void 0 ? void 0 : Math.min(range.max, Math.max(range.min, settings.width));
+  const title = settings.title === void 0 || settings.title.trim() === "" ? void 0 : settings.title;
+  const flexibleChanged = settings.flexible !== void 0 && settings.flexible !== isFlexible(definition, void 0);
+  if (title === void 0 && width === void 0 && !flexibleChanged) {
+    return definition;
+  }
+  const next = { ...definition };
+  if (title !== void 0) next.title = title;
+  if (width !== void 0) next.width = width;
+  if (flexibleChanged) {
+    const fill = fillWith(
+      definition.fill,
+      settings.flexible === true
+    );
+    if (fill === void 0) {
+      delete next.fill;
+    } else {
+      next.fill = fill;
+    }
+  }
+  return next;
+}
+function effectiveDefinitions(definitions, layout, options = {}) {
+  return definitions.map(
+    (definition) => options.overrideLocks !== true && isOptionsLocked(definition) ? definition : applySettings(definition, layout.settings?.[definition.key])
+  );
+}
+function widgetOptionValues(definition, settings) {
+  const declared = definition.options ?? [];
+  const values = {};
+  for (const option of declared) {
+    const picked = settings?.options?.[option.key];
+    const value = (picked === void 0 ? void 0 : coerceOptionValue(option, picked)) ?? defaultOptionValue(option);
+    if (value !== void 0) values[option.key] = value;
+  }
+  return values;
+}
+function optionValuesFromLayout(definitions, layout, options = {}) {
+  const out = {};
+  for (const definition of definitions) {
+    if (definition.options === void 0 || definition.options.length === 0) {
+      continue;
+    }
+    const locked = options.overrideLocks !== true && isOptionsLocked(definition);
+    out[definition.key] = locked ? {} : layout.settings?.[definition.key]?.options ?? {};
+  }
+  return out;
+}
+function sameSettings(a, b) {
+  if (a === b) return true;
+  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",
+    "view"
+  ]) {
+    if (!(field in patch)) continue;
+    const value = patch[field];
+    if (value === void 0) {
+      delete draft[field];
+    } else {
+      draft[field] = value;
+    }
+  }
+  const merged = parseOne(draft);
+  if (sameSettings(before, merged)) return layout;
+  const rest = { ...layout.settings };
+  if (merged === void 0) {
+    delete rest[key];
+  } else {
+    rest[key] = merged;
+  }
+  const { settings: _previous, ...others } = layout;
+  return Object.keys(rest).length === 0 ? others : { ...others, settings: rest };
+}
+function clearWidgetSettings(layout, key) {
+  if (layout.settings?.[key] === void 0) return layout;
+  return setWidgetSettings(layout, key, {
+    title: void 0,
+    width: void 0,
+    flexible: void 0,
+    options: void 0,
+    view: void 0
+  });
+}
+function normalizeTitle(title) {
+  return title.normalize("NFKC").trim().toLowerCase();
+}
+function isTitleInUse(definitions, layout, key, title) {
+  const wanted = normalizeTitle(title);
+  if (wanted === "") return false;
+  return effectiveDefinitions(definitions, layout, {
+    overrideLocks: true
+  }).some(
+    (other) => other.key !== key && normalizeTitle(other.title ?? other.key) === wanted
+  );
+}
+function uniqueTitle(taken, title) {
+  if (!taken.has(normalizeTitle(title))) return title;
+  for (let n = 2; ; n += 1) {
+    const suffix = ` (#${n})`;
+    const candidate = `${title.slice(0, MAX_WIDGET_TITLE_LENGTH - suffix.length)}${suffix}`;
+    if (!taken.has(normalizeTitle(candidate))) return candidate;
+  }
+}
+function normalizeSettings(definitions, layout, options = {}) {
+  const settings = layout.settings;
+  if (settings === void 0) return layout;
+  const cleaned = {};
+  const taken = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
+    const renamed = settings[definition.key]?.title !== void 0 && (options.overrideLocks === true || !isOptionsLocked(definition));
+    if (!renamed) taken.add(normalizeTitle(definition.title ?? definition.key));
+  }
+  for (const definition of definitions) {
+    const one = settings[definition.key];
+    if (one === void 0) continue;
+    if (options.overrideLocks !== true && isOptionsLocked(definition)) continue;
+    const range = widthRange(definition);
+    const chosen = {};
+    for (const option of definition.options ?? []) {
+      const picked = one.options?.[option.key];
+      if (picked === void 0) continue;
+      const value = coerceOptionValue(option, picked);
+      if (value !== void 0) {
+        chosen[option.key] = option.type === "dateRange" ? picked : value;
+      }
+    }
+    let title = one.title;
+    if (title !== void 0) {
+      title = title.trim().slice(0, MAX_WIDGET_TITLE_LENGTH);
+      if (title === "") {
+        title = void 0;
+      } else {
+        title = uniqueTitle(taken, title);
+        taken.add(normalizeTitle(title));
+      }
+    }
+    const next = {
+      ...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 },
+      ...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;
+    }
+  }
+  const keys = Object.keys(cleaned);
+  const unchanged = keys.length === Object.keys(settings).length && keys.every((key) => cleaned[key] === settings[key]);
+  if (unchanged) return layout;
+  const { settings: _previous, ...others } = layout;
+  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 [];
+  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 withSettings = settings === void 0 ? {} : { settings };
+  if (pages.length > 0) {
+    return {
+      order: EMPTY_LAYOUT.order,
+      hidden: EMPTY_LAYOUT.hidden,
+      minimized: EMPTY_LAYOUT.minimized,
+      pages,
+      ...withSettings
+    };
+  }
+  if (order.length === 0 && hidden.length === 0 && minimized.length === 0) {
+    return settings === void 0 ? EMPTY_LAYOUT : { ...EMPTY_LAYOUT, settings };
+  }
+  return { order, hidden, minimized, ...withSettings };
+}
+function parsePages(value) {
+  if (!Array.isArray(value)) return [];
+  const pages = [];
+  const keys = /* @__PURE__ */ new Set();
+  for (const entry of value.slice(0, MAX_PARSED_PAGES)) {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+      continue;
+    }
+    const record = entry;
+    const key = record["key"];
+    if (typeof key !== "string" || key === "" || keys.has(key)) continue;
+    keys.add(key);
+    const rawTitle = record["title"];
+    const title = typeof rawTitle === "string" && rawTitle.trim() !== "" ? rawTitle.trim().slice(0, MAX_PAGE_TITLE_LENGTH) : `Page ${pages.length + 1}`;
+    const maxRows = record["maxRows"];
+    const held = /* @__PURE__ */ new Set();
+    for (const earlier of pages) {
+      for (const k of [...earlier.order, ...earlier.hidden]) held.add(k);
+    }
+    const keep = (list) => uniqueStrings(list).filter((k) => !held.has(k));
+    pages.push({
+      key,
+      title,
+      order: keep(record["order"]),
+      hidden: keep(record["hidden"]),
+      minimized: keep(record["minimized"]),
+      ...typeof maxRows === "number" && Number.isInteger(maxRows) && maxRows >= 1 && maxRows <= MAX_PAGE_ROWS ? { maxRows } : {}
+    });
+  }
+  return pages;
+}
+function serializeLayout(layout) {
+  return JSON.stringify({
+    order: [...layout.order],
+    hidden: [...layout.hidden],
+    minimized: [...layout.minimized],
+    ...layout.pages === void 0 || layout.pages.length === 0 ? {} : {
+      pages: layout.pages.map((page) => ({
+        key: page.key,
+        title: page.title,
+        order: [...page.order],
+        hidden: [...page.hidden],
+        minimized: [...page.minimized],
+        ...page.maxRows === void 0 ? {} : { maxRows: page.maxRows }
+      }))
+    },
+    ...serializeSettings(layout.settings) === void 0 ? {} : { settings: serializeSettings(layout.settings) }
+  });
+}
+function bySortOrder(items) {
+  return items.map((item, index) => ({ item, index })).sort(
+    (a, b) => (a.item.sortOrder ?? 0) - (b.item.sortOrder ?? 0) || a.index - b.index
+  ).map(({ item }) => item);
+}
+function isPinned(item) {
+  return resolveWidgetLock(item).move;
+}
+function viewerOrder(visible, layout) {
+  const byKey = new Map(visible.map((d) => [d.key, d]));
+  const ordered = [];
+  for (const key of layout.order) {
+    const definition = byKey.get(key);
+    if (definition !== void 0) {
+      ordered.push(definition);
+      byKey.delete(key);
+    }
+  }
+  for (const definition of bySortOrder(visible)) {
+    if (byKey.has(definition.key)) ordered.push(definition);
+  }
+  return ordered;
+}
+function placeAroundPinned(visible, free) {
+  const slots = bySortOrder(visible).map(
+    (item) => isPinned(item) ? item : void 0
+  );
+  let next = 0;
+  return slots.map((pinned) => pinned ?? free[next++]);
+}
+function visibleWidgets(definitions, layout) {
+  const hidden = new Set(layout.hidden);
+  const visible = definitions.filter((d) => !hidden.has(d.key));
+  const ordered = viewerOrder(visible, layout);
+  if (!visible.some(isPinned)) return ordered;
+  return placeAroundPinned(
+    visible,
+    ordered.filter((item) => !isPinned(item))
+  );
+}
+function hiddenWidgets(definitions, layout) {
+  const hidden = new Set(layout.hidden);
+  return bySortOrder(definitions.filter((d) => hidden.has(d.key)));
+}
+function moveWidget(definitions, layout, key, toIndex) {
+  const current = visibleWidgets(definitions, layout);
+  const fromIndex = current.findIndex((d) => d.key === key);
+  const mover = current[fromIndex];
+  if (mover === void 0 || !Number.isInteger(toIndex) || toIndex < 0 || toIndex >= current.length || toIndex === fromIndex || isPinned(mover) || isPinned(current[toIndex])) {
+    return layout;
+  }
+  const freeSlots = freeSlotIndexes(current);
+  const free = current.filter((item) => !isPinned(item));
+  const fromFree = freeSlots.indexOf(fromIndex);
+  const toFree = freeSlots.indexOf(toIndex);
+  free.splice(fromFree, 1);
+  free.splice(toFree, 0, mover);
+  const next = placeAroundPinned(current, free);
+  return { ...layout, order: next.map((d) => d.key) };
+}
+function freeSlotIndexes(ordered) {
+  const slots = [];
+  ordered.forEach((item, index) => {
+    if (!isPinned(item)) slots.push(index);
+  });
+  return slots;
+}
+function moveWidgetBy(definitions, layout, key, offset) {
+  const current = visibleWidgets(definitions, layout);
+  const fromIndex = current.findIndex((d) => d.key === key);
+  if (fromIndex === -1) return layout;
+  const freeSlots = freeSlotIndexes(current);
+  const fromFree = freeSlots.indexOf(fromIndex);
+  if (fromFree === -1) return layout;
+  const toFree = Math.max(
+    0,
+    Math.min(freeSlots.length - 1, fromFree + Math.trunc(offset))
+  );
+  return moveWidget(definitions, layout, key, freeSlots[toFree]);
+}
+function moveWidgetUp(definitions, layout, key) {
+  return moveWidgetBy(definitions, layout, key, -1);
 }
-var NO_VALUES = Object.freeze({});
-function resolveOptionValues(definition, chosen, context = {}) {
-  const options = definition.options;
-  if (options === void 0 || options.length === 0) return NO_VALUES;
-  const values = {};
-  for (const option of options) {
-    const picked = chosen?.[option.key];
-    const value = (picked === void 0 ? void 0 : coerceOptionValue(option, picked, context)) ?? defaultOptionValue(option, context);
-    if (value !== void 0) values[option.key] = value;
-  }
-  return values;
+function moveWidgetDown(definitions, layout, key) {
+  return moveWidgetBy(definitions, layout, key, 1);
 }
-function sameValue(a, b) {
-  if (Array.isArray(a) && Array.isArray(b)) {
-    return a.length === b.length && a.every((item, i) => item === b[i]);
-  }
-  return a === b;
+function isHidden(layout, key) {
+  return layout.hidden.includes(key);
 }
-function sameOptionValues(a, b) {
-  const keys = Object.keys({ ...a, ...b });
-  return keys.every((key) => sameValue(a[key], b[key]));
+function isMinimized(layout, key) {
+  return layout.minimized.includes(key);
 }
-function optionsCacheSuffix(definition, values, context = {}) {
-  const parts = [];
-  for (const option of definition.options ?? []) {
-    if (isClientApplied(option)) continue;
-    const value = values[option.key];
-    if (sameValue(value, defaultOptionValue(option, context))) continue;
-    parts.push(
-      `${option.key}=${encodeURIComponent(JSON.stringify(value ?? null))}`
-    );
-  }
-  parts.sort();
-  return parts.length === 0 ? "" : `?${parts.join("&")}`;
+function hideWidget(layout, key) {
+  if (isHidden(layout, key)) return layout;
+  return { ...layout, hidden: [...layout.hidden, key] };
 }
-function tableColumnIndex(key) {
-  const match = /^c(\d+)$/.exec(key);
-  return match === null ? void 0 : Number(match[1]);
+function showWidget(layout, key) {
+  if (!isHidden(layout, key)) return layout;
+  return {
+    ...layout,
+    hidden: layout.hidden.filter((k) => k !== key),
+    minimized: layout.minimized.filter((k) => k !== key)
+  };
 }
-function sortBarItems(items, sort) {
-  const sign = sort.direction === "desc" ? -1 : 1;
-  return items.map((item, index) => ({ item, index })).sort((a, b) => {
-    const order = sort.column === "value" ? a.item.value - b.item.value : a.item.label.localeCompare(b.item.label);
-    return order * sign || a.index - b.index;
-  }).map(({ item }) => item);
+function toggleHidden(layout, key) {
+  return isHidden(layout, key) ? showWidget(layout, key) : hideWidget(layout, key);
 }
-function applyClientOptions(definition, data, values) {
-  const options = definition.options ?? [];
-  const sortOption = options.find(
-    (o) => o.type === "sort" && o.apply === "client"
-  );
-  const columnsOption = options.find(
-    (o) => o.type === "columns" && o.apply === "client"
-  );
-  const sortValue = sortOption === void 0 ? void 0 : values[sortOption.key];
-  const columnsValue = columnsOption === void 0 ? void 0 : values[columnsOption.key];
-  let next = data;
-  if (typeof sortValue === "string") {
-    const sort = parseSortValue(sortValue);
-    if (sort !== void 0 && next.kind === "BAR_LIST") {
-      if (sort.column === "label" || sort.column === "value") {
-        next = { ...next, items: sortBarItems(next.items, sort) };
-      }
-    } else if (sort !== void 0 && next.kind === "TABLE") {
-      const index = tableColumnIndex(sort.column);
-      if (index !== void 0 && index < next.columns.length) {
-        const sorted = queryRows(tableDetailData(next), {
-          page: 1,
-          pageSize: Math.max(1, next.rows.length),
-          sort
-        });
-        if (sorted.ok) next = { ...next, rows: sorted.value.rows };
-      }
-    }
+function minimizeWidget(layout, key) {
+  if (isMinimized(layout, key)) return layout;
+  return { ...layout, minimized: [...layout.minimized, key] };
+}
+function restoreWidget(layout, key) {
+  if (!isMinimized(layout, key)) return layout;
+  return { ...layout, minimized: layout.minimized.filter((k) => k !== key) };
+}
+function toggleMinimized(layout, key) {
+  return isMinimized(layout, key) ? restoreWidget(layout, key) : minimizeWidget(layout, key);
+}
+function pruneLayout(definitions, layout) {
+  const known = new Set(definitions.map((d) => d.key));
+  const keep = (keys) => keys.every((k) => known.has(k)) ? keys : keys.filter((k) => known.has(k));
+  return mapLayoutLists(layout, (lists) => ({
+    order: keep(lists.order),
+    hidden: keep(lists.hidden),
+    minimized: keep(lists.minimized)
+  }));
+}
+function mapLayoutLists(layout, change) {
+  const top = change(layout);
+  const pages = layout.pages?.map((page) => {
+    const next = change(page);
+    return next.order === page.order && next.hidden === page.hidden && next.minimized === page.minimized ? page : { ...page, ...next };
+  });
+  const pagesChanged = pages !== void 0 && pages.some((page, i) => page !== layout.pages?.[i]);
+  if (top.order === layout.order && top.hidden === layout.hidden && top.minimized === layout.minimized && !pagesChanged) {
+    return layout;
   }
-  if (Array.isArray(columnsValue) && next.kind === "TABLE") {
-    const table = next;
-    const indexes = columnsValue.map(tableColumnIndex).filter(
-      (index) => index !== void 0 && index < table.columns.length
-    );
-    if (indexes.length > 0) {
-      next = {
-        ...table,
-        columns: indexes.map((i) => table.columns[i]),
-        rows: table.rows.map((row) => indexes.map((i) => row[i]))
-      };
-    }
+  return {
+    ...layout,
+    ...top,
+    ...pages === void 0 ? {} : { pages }
+  };
+}
+function enforceLocks(definitions, layout, options = {}) {
+  if (options.overrideLocks === true) return layout;
+  const noMove = /* @__PURE__ */ new Set();
+  const noHide = /* @__PURE__ */ new Set();
+  const noMinimize = /* @__PURE__ */ new Set();
+  for (const definition of definitions) {
+    const lock = resolveWidgetLock(definition);
+    if (lock.move) noMove.add(definition.key);
+    if (lock.hide) noHide.add(definition.key);
+    if (lock.minimize) noMinimize.add(definition.key);
   }
-  return next;
+  const without2 = (keys, drop) => keys.some((key) => drop.has(key)) ? keys.filter((key) => !drop.has(key)) : keys;
+  return mapLayoutLists(layout, (lists) => ({
+    order: without2(lists.order, noMove),
+    hidden: without2(lists.hidden, noHide),
+    minimized: without2(lists.minimized, noMinimize)
+  }));
 }
 
 // src/core/validate.ts
@@ -1229,7 +1769,7 @@ function describeType2(value) {
   }
   return typeof value;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function join(path, field) {
@@ -1311,7 +1851,7 @@ function requireOneOf(record, field, options, path, problems) {
 function eachRecord(items, path, problems, check) {
   items.forEach((item, index) => {
     const itemPath = `${path}[${index}]`;
-    if (isRecord(item)) {
+    if (isRecord2(item)) {
       check(item, itemPath);
     } else {
       problems.push(
@@ -1460,7 +2000,7 @@ function checkPayloadFields(kind, data, problems) {
 }
 function checkDetailOption(detail, problems) {
   if (detail === void 0 || typeof detail === "boolean") return;
-  if (!isRecord(detail)) {
+  if (!isRecord2(detail)) {
     problems.push(
       `detail must be true, false or an options object, got ${describeType2(detail)}.`
     );
@@ -1479,13 +2019,13 @@ function checkDetailOption(detail, problems) {
 }
 function checkTableControlsOption(controls, kind, problems) {
   if (controls === void 0 || controls === false) return;
-  if (typeof controls !== "boolean" && !isRecord(controls)) {
+  if (typeof controls !== "boolean" && !isRecord2(controls)) {
     problems.push(
       `tableControls must be true, false or an options object, got ${describeType2(controls)}.`
     );
     return;
   }
-  if (isRecord(controls)) {
+  if (isRecord2(controls)) {
     optionalBoolean(controls, "search", "tableControls", problems);
     optionalBoolean(controls, "sort", "tableControls", problems);
   }
@@ -1495,9 +2035,39 @@ function checkTableControlsOption(controls, kind, problems) {
     );
   }
 }
+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}).`
+    );
+    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}).`
+      );
+    }
+  }
+}
 function checkLockedOption(locked, problems) {
   if (locked === void 0 || typeof locked === "boolean") return;
-  if (!isRecord(locked)) {
+  if (!isRecord2(locked)) {
     problems.push(
       `locked must be true, false or an object, got ${describeType2(locked)}.`
     );
@@ -1506,6 +2076,7 @@ function checkLockedOption(locked, problems) {
   optionalBoolean(locked, "move", "locked", problems);
   optionalBoolean(locked, "hide", "locked", problems);
   optionalBoolean(locked, "minimize", "locked", problems);
+  optionalBoolean(locked, "options", "locked", problems);
 }
 function checkOptionColumns(option, path, kind, problems) {
   const columns = option["columns"];
@@ -1518,7 +2089,7 @@ function checkOptionColumns(option, path, kind, problems) {
   const keys = [];
   columns.forEach((entry, index) => {
     const entryPath = `${path}.columns[${index}]`;
-    if (!isRecord(entry)) {
+    if (!isRecord2(entry)) {
       problems.push(
         `${entryPath} must be an object, got ${describeType2(entry)}.`
       );
@@ -1543,7 +2114,7 @@ function checkOptionColumns(option, path, kind, problems) {
   return keys;
 }
 function checkOption(option, path, kind, seenKeys, seenTypes, problems) {
-  if (!isRecord(option)) {
+  if (!isRecord2(option)) {
     problems.push(`${path} must be an object, got ${describeType2(option)}.`);
     return;
   }
@@ -1575,7 +2146,7 @@ function checkOption(option, path, kind, seenKeys, seenTypes, problems) {
       } else {
         choices.forEach((choice, index) => {
           const choicePath = `${path}.choices[${index}]`;
-          if (!isRecord(choice)) {
+          if (!isRecord2(choice)) {
             problems.push(
               `${choicePath} must be an object, got ${describeType2(choice)}.`
             );
@@ -1665,7 +2236,7 @@ function checkOption(option, path, kind, seenKeys, seenTypes, problems) {
         } else {
           presets.forEach((preset, index) => {
             const presetPath = `${path}.presets[${index}]`;
-            if (!isRecord(preset)) {
+            if (!isRecord2(preset)) {
               problems.push(
                 `${presetPath} must be an object, got ${describeType2(preset)}.`
               );
@@ -1785,6 +2356,137 @@ function checkOptions(options, kind, problems) {
     );
   });
 }
+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 checkConversion(conversion, path, baseKind, viewKind2, problems) {
+  if (!isRecord2(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 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 (!isRecord2(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 formatProblems(prefix, problems) {
   const shown = problems.slice(0, MAX_REPORTED_PROBLEMS);
   const more = problems.length - shown.length;
@@ -1792,7 +2494,7 @@ function formatProblems(prefix, problems) {
 }
 function validateWidgetData(value, options = {}) {
   const subject = options.widgetKey === void 0 ? "Widget data" : `Widget ${JSON.stringify(options.widgetKey)}`;
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return err(`${subject}: must be an object, got ${describeType2(value)}.`);
   }
   if (value["empty"] === true) {
@@ -1822,7 +2524,7 @@ function validateWidgetData(value, options = {}) {
   return ok(value);
 }
 function validateWidgetDefinition(value) {
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     return err(
       `Widget definition: must be an object, got ${describeType2(value)}.`
     );
@@ -1856,10 +2558,12 @@ function validateWidgetDefinition(value) {
       `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(
@@ -2517,7 +3221,7 @@ function withoutLockField(definition) {
   delete copy.locked;
   return copy;
 }
-function uniqueTitle(taken, title, index) {
+function uniqueTitle2(taken, title, index) {
   let base = title.trim().slice(0, MAX_PAGE_TITLE_LENGTH);
   if (base === "") base = `Page ${index + 1}`;
   let candidate = base;
@@ -2538,9 +3242,18 @@ function samePages(a, b) {
 }
 function normalizeLayout(definitions, layout, options = {}) {
   const known = pruneLayout(definitions, layout);
-  const locked = enforceLocks(definitions, known, options);
+  const enforced = enforceLocks(definitions, known, options);
+  const locked = normalizeSettings(
+    definitions,
+    enforced,
+    options
+  );
   if (!hasPages(locked)) return locked === layout ? layout : locked;
-  const defs = options.overrideLocks === true ? definitions.map(withoutLockField) : definitions;
+  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();
@@ -2553,7 +3266,7 @@ function normalizeLayout(definitions, layout, options = {}) {
     ];
     const next = {
       ...page,
-      title: uniqueTitle(taken, page.title, index),
+      title: uniqueTitle2(taken, page.title, index),
       order: keep(page.order),
       hidden: keep(page.hidden),
       minimized: keep(page.minimized)
@@ -2641,7 +3354,7 @@ function normalizeLayout(definitions, layout, options = {}) {
     }
     if (!placed) {
       const key = nextPageKey(work());
-      const title = uniqueTitle(
+      const title = uniqueTitle2(
         new Set(pages.map((p) => normalizedTitle(p.title))),
         `Page ${pages.length + 1}`,
         pages.length
@@ -2653,7 +3366,7 @@ function normalizeLayout(definitions, layout, options = {}) {
     }
   }
   const result = work();
-  return samePages(layout.pages ?? [], pages) && sameKeys(layout.order, result.order) ? layout : result;
+  return samePages(layout.pages ?? [], pages) && sameKeys(layout.order, result.order) && locked.settings === layout.settings ? layout : result;
 }
 
 // src/core/scale.ts
@@ -3485,6 +4198,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;
@@ -3501,14 +4215,18 @@ 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_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;
@@ -3516,10 +4234,14 @@ exports.WIDGET_SIZES = WIDGET_SIZES;
 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.clearWidgetSettings = clearWidgetSettings;
 exports.coerceOptionValue = coerceOptionValue;
+exports.convertView = convertView;
 exports.createLayoutPersistence = createLayoutPersistence;
 exports.createTheme = createTheme;
 exports.createWidgetLoader = createWidgetLoader;
@@ -3528,6 +4250,8 @@ exports.defaultOptionValue = defaultOptionValue;
 exports.defineWidget = defineWidget;
 exports.deriveDetailData = deriveDetailData;
 exports.describeUnknownError = describeUnknownError;
+exports.effectiveDefinitions = effectiveDefinitions;
+exports.effectiveViewKey = effectiveViewKey;
 exports.emptyTextFor = emptyTextFor;
 exports.emptyWidget = emptyWidget;
 exports.enforceLocks = enforceLocks;
@@ -3538,26 +4262,32 @@ 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;
 exports.isColumnKeyFor = isColumnKeyFor;
+exports.isFlexible = isFlexible;
 exports.isHidden = isHidden;
 exports.isIsoInterval = isIsoInterval;
 exports.isMinimized = isMinimized;
+exports.isOptionsLocked = isOptionsLocked;
 exports.isSafeHref = isSafeHref;
 exports.isSafeImageUrl = isSafeImageUrl;
+exports.isTitleInUse = isTitleInUse;
 exports.isWidgetEmptyState = isWidgetEmptyState;
 exports.isWidgetKind = isWidgetKind;
 exports.isWidgetVisibleTo = isWidgetVisibleTo;
 exports.isWidgetWidth = isWidgetWidth;
 exports.itemWidth = itemWidth;
+exports.kindLabel = kindLabel;
 exports.kpiDelta = kpiDelta;
 exports.labelStride = labelStride;
 exports.loadingWidgets = loadingWidgets;
@@ -3573,8 +4303,11 @@ exports.nextPageKey = nextPageKey;
 exports.niceDomain = niceDomain;
 exports.niceStep = niceStep;
 exports.normalizeLayout = normalizeLayout;
+exports.normalizeSettings = normalizeSettings;
+exports.normalizeTitle = normalizeTitle;
 exports.ok = ok;
 exports.optionValuesFor = optionValuesFor;
+exports.optionValuesFromLayout = optionValuesFromLayout;
 exports.optionsCacheSuffix = optionsCacheSuffix;
 exports.pageLayout = pageLayout;
 exports.pageList = pageList;
@@ -3583,6 +4316,7 @@ exports.pageRoom = pageRoom;
 exports.pageWidgets = pageWidgets;
 exports.parseDetailQuery = parseDetailQuery;
 exports.parseLayout = parseLayout;
+exports.parseSettings = parseSettings;
 exports.parseSortValue = parseSortValue;
 exports.percentChange = percentChange;
 exports.placeRows = placeRows;
@@ -3605,6 +4339,8 @@ exports.restoreWidget = restoreWidget;
 exports.sameOptionValues = sameOptionValues;
 exports.serializeDetailQuery = serializeDetailQuery;
 exports.serializeLayout = serializeLayout;
+exports.serializeSettings = serializeSettings;
+exports.setWidgetSettings = setWidgetSettings;
 exports.shareOf = shareOf;
 exports.showWidget = showWidget;
 exports.sortDefinitions = sortDefinitions;
@@ -3618,9 +4354,15 @@ 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.withEncoding = withEncoding;
 exports.withFallback = withFallback;
 exports.withLogging = withLogging;