@valbuild/shared 0.150.2 → 0.150.8

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @valbuild/shared
 
+## 0.150.8
+
+### Patch Changes
+
+- [#960](https://github.com/valbuild/val/pull/960) [`5960071`](https://github.com/valbuild/val/commit/59600711af792f489b050ab47bcdc103d7d8c028) Thanks [@freekh](https://github.com/freekh)! - The design tab can point the assistant at anything on the page. Hold ⌥ (Alt) and click any element in the preview, or press **Select** first: the element under the pointer is outlined and named, and the one picked is shown above the assistant and sent with the next message. A **Pages** menu shows any of the site's pages in the preview, and **Publish** publishes the proposal from the tab, the same way its own Studio does. The checks are now a single quiet status beside the proposal's name, the history is behind a button, and the changed files are listed in the Changes view instead of a panel of their own.
+
+  The picking runs in the proposal's own page, through the canvas bridge in `@valbuild/next` and `@valbuild/tanstack`, so a site needs those packages at this version for picking to work in its design tab.
+
+- [#963](https://github.com/valbuild/val/pull/963) [`f7d56ec`](https://github.com/valbuild/val/commit/f7d56ecaed8567c0ea2889bbf1ba64844356cb1a) Thanks [@freekh](https://github.com/freekh)! - The assistant's chats in a proposal are shared with everyone on the project. A chat started while you are in a proposal belongs to it: anyone on the project who opens the proposal sees it in the chat list, with who is in it, and can read it and keep asking. Messages are named once more than one person has written, and the chat header has a link to the chat. One question runs at a time: if someone else's question is running, what you write is sent when its answer is done. Chats started on the site stay your own.
+
+  It needs the content server that knows about proposal chats; with an older one, chats work as before.
+
+## 0.150.3
+
+### Patch Changes
+
+- [#954](https://github.com/valbuild/val/pull/954) [`bc0cc43`](https://github.com/valbuild/val/commit/bc0cc433e157cca08f9ee384a4fb8be9bd3dad2c) Thanks [@freekh](https://github.com/freekh)! - Proposals in the Studio, reworked:
+
+  - **Save becomes Publish.** In a proposal, one split button stands where Publish is on the site. Its main half is the next step (Save, then Build, then Publish), and its caret offers every step, so you can publish straight away: Publish saves first. The separate Publish button beside the switcher is gone.
+  - **The switcher is where the proposal is managed**, as on a phone: its name and changes, Compare with the site, Rename, Copy link and Close, then where else to go.
+  - **Upgrade proposals** have one Publish (the bar's), say what they upgrade in the Publish dialog, cannot be published while Val Build is still working them out, are discarded rather than closed, and have their own icon.
+  - **A published proposal** shows a dialog with the ways out (the site, a new proposal, all proposals), since nothing more can be done in it.
+  - **Notices about where you are** (an upgrade, an upgrade under way, a restore) pop up from the bottom right and stay until dismissed; a dismissed one folds into the status bar and comes back from there.
+  - **No more flash of the site's chrome** at a proposal's address: the bar says "Loading…" until it knows, a return visit starts in the proposal at once, and opening a proposal says "Opening …" while the browser gets there.
+  - **After a save**, "Updating the preview…" and a failed render check are shown beside the switcher, and the status bar counts what is not saved to the proposal instead of saying "All changes saved".
+  - **Dialogs** dim the Studio instead of hiding it.
+  - **`theme.proposal`** in `s.settings()` sets the colour the Studio wears in a proposal (Val's violet when unset), under Settings → Studio. Like the accent, its shades are generated so text on them stays legible.
+
+- Updated dependencies [[`bc0cc43`](https://github.com/valbuild/val/commit/bc0cc433e157cca08f9ee384a4fb8be9bd3dad2c)]:
+  - @valbuild/core@0.150.3
+
 ## 0.150.2
 
 ### Patch Changes

package/client/dist/valbuild-shared-client.cjs.dev.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-0fa0569c.cjs.dev.js');
-require('../../dist/createForOfIteratorHelper-d86bb352.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-be70d9fc.cjs.dev.js');
+require('../../dist/createForOfIteratorHelper-87a33eff.cjs.dev.js');
 require('@valbuild/core');
 
 
@@ -15,6 +15,10 @@ exports.VAL_CANVAS_MESSAGE = getSitemapTree.VAL_CANVAS_MESSAGE;
 exports.VAL_CANVAS_PARAM = getSitemapTree.VAL_CANVAS_PARAM;
 exports.VAL_CONFIG_SESSION_STORAGE_KEY = getSitemapTree.VAL_CONFIG_SESSION_STORAGE_KEY;
 exports.VAL_THEME_SESSION_STORAGE_KEY = getSitemapTree.VAL_THEME_SESSION_STORAGE_KEY;
+exports.attachElementPicker = getSitemapTree.attachElementPicker;
+exports.createPickerOverlay = getSitemapTree.createPickerOverlay;
+exports.describeElement = getSitemapTree.describeElement;
+exports.elementLabel = getSitemapTree.elementLabel;
 exports.formatRoutePattern = getSitemapTree.formatRoutePattern;
 exports.getNextAppRouterSourceFolder = getSitemapTree.getNextAppRouterSourceFolder;
 exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
@@ -25,5 +29,7 @@ exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
 exports.isValCanvasPageMessage = getSitemapTree.isValCanvasPageMessage;
 exports.isValCanvasStudioMessage = getSitemapTree.isValCanvasStudioMessage;
+exports.modifierLabel = getSitemapTree.modifierLabel;
 exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
+exports.startElementPicking = getSitemapTree.startElementPicking;
 exports.withValCanvasParam = getSitemapTree.withValCanvasParam;

package/client/dist/valbuild-shared-client.cjs.prod.js

@@ -2,8 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-667bcb3c.cjs.prod.js');
-require('../../dist/createForOfIteratorHelper-90e6a8b6.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-873f7266.cjs.prod.js');
+require('../../dist/createForOfIteratorHelper-fef4fa7d.cjs.prod.js');
 require('@valbuild/core');
 
 
@@ -15,6 +15,10 @@ exports.VAL_CANVAS_MESSAGE = getSitemapTree.VAL_CANVAS_MESSAGE;
 exports.VAL_CANVAS_PARAM = getSitemapTree.VAL_CANVAS_PARAM;
 exports.VAL_CONFIG_SESSION_STORAGE_KEY = getSitemapTree.VAL_CONFIG_SESSION_STORAGE_KEY;
 exports.VAL_THEME_SESSION_STORAGE_KEY = getSitemapTree.VAL_THEME_SESSION_STORAGE_KEY;
+exports.attachElementPicker = getSitemapTree.attachElementPicker;
+exports.createPickerOverlay = getSitemapTree.createPickerOverlay;
+exports.describeElement = getSitemapTree.describeElement;
+exports.elementLabel = getSitemapTree.elementLabel;
 exports.formatRoutePattern = getSitemapTree.formatRoutePattern;
 exports.getNextAppRouterSourceFolder = getSitemapTree.getNextAppRouterSourceFolder;
 exports.getPageRouterSitemapTree = getSitemapTree.getPageRouterSitemapTree;
@@ -25,5 +29,7 @@ exports.isTanStackRoutesFolder = getSitemapTree.isTanStackRoutesFolder;
 exports.isValCanvasFrame = getSitemapTree.isValCanvasFrame;
 exports.isValCanvasPageMessage = getSitemapTree.isValCanvasPageMessage;
 exports.isValCanvasStudioMessage = getSitemapTree.isValCanvasStudioMessage;
+exports.modifierLabel = getSitemapTree.modifierLabel;
 exports.parseRoutePattern = getSitemapTree.parseRoutePattern;
+exports.startElementPicking = getSitemapTree.startElementPicking;
 exports.withValCanvasParam = getSitemapTree.withValCanvasParam;

package/client/dist/valbuild-shared-client.esm.js

@@ -1,3 +1,3 @@
-export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, h as formatRoutePattern, j as getNextAppRouterSourceFolder, n as getPageRouterSitemapTree, l as getPageRouterSourceFolder, o as getPatternFromModuleFilePath, k as getTanStackRouterSourceFolder, m as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, p as parseRoutePattern, w as withValCanvasParam } from '../../dist/getSitemapTree-5afbc3ac.esm.js';
-import '../../dist/createForOfIteratorHelper-3db5d737.esm.js';
+export { D as DEFAULT_CANVAS_SELECTION, e as DEFAULT_CANVAS_SELECTION_SOFT, b as VAL_AI_SESSION_STORAGE_KEY, d as VAL_CANVAS_MESSAGE, c as VAL_CANVAS_PARAM, V as VAL_CONFIG_SESSION_STORAGE_KEY, a as VAL_THEME_SESSION_STORAGE_KEY, j as attachElementPicker, k as createPickerOverlay, h as describeElement, l as elementLabel, n as formatRoutePattern, o as getNextAppRouterSourceFolder, u as getPageRouterSitemapTree, r as getPageRouterSourceFolder, v as getPatternFromModuleFilePath, q as getTanStackRouterSourceFolder, t as isTanStackRoutesFolder, g as isValCanvasFrame, i as isValCanvasPageMessage, f as isValCanvasStudioMessage, m as modifierLabel, p as parseRoutePattern, s as startElementPicking, w as withValCanvasParam } from '../../dist/getSitemapTree-b6161fd8.esm.js';
+import '../../dist/createForOfIteratorHelper-666a6d17.esm.js';
 import '@valbuild/core';

package/dist/{acquireTypes-50960f2c.esm.js → acquireTypes-6e2f7961.esm.js}

@@ -1,5 +1,5 @@
-import { _ as _inherits, a as _createClass, c as _wrapNativeSuper, g as _slicedToArray, e as _classCallCheck, f as _callSuper, h as _toConsumableArray, b as _asyncToGenerator, d as _regenerator } from './slicedToArray-6cd80315.esm.js';
-import { _ as _typeof, a as _createForOfIteratorHelper, c as _defineProperty, b as _objectSpread2 } from './createForOfIteratorHelper-3db5d737.esm.js';
+import { _ as _inherits, a as _createClass, c as _wrapNativeSuper, g as _slicedToArray, e as _classCallCheck, f as _callSuper, b as _asyncToGenerator, d as _regenerator } from './slicedToArray-22567815.esm.js';
+import { _ as _typeof, c as _createForOfIteratorHelper, b as _toConsumableArray, d as _defineProperty, a as _objectSpread2 } from './createForOfIteratorHelper-666a6d17.esm.js';
 import { parseAllDocuments } from 'yaml';
 
 /**

package/dist/{acquireTypes-de10005d.cjs.dev.js → acquireTypes-84a4077a.cjs.dev.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var slicedToArray = require('./slicedToArray-62e428df.cjs.dev.js');
-var createForOfIteratorHelper = require('./createForOfIteratorHelper-d86bb352.cjs.dev.js');
+var slicedToArray = require('./slicedToArray-c8a29f6b.cjs.dev.js');
+var createForOfIteratorHelper = require('./createForOfIteratorHelper-87a33eff.cjs.dev.js');
 var yaml = require('yaml');
 
 /**
@@ -911,7 +911,7 @@ function hoist(lockfile, graph, skipped, kindOf, workspacePackages) {
   entries.sort(function (a, b) {
     return a.depth - b.depth || compareBytes(a.sortKey, b.sortKey);
   });
-  var claimed = new Set(slicedToArray._toConsumableArray((_direct$get$keys = (_direct$get = direct.get(".")) === null || _direct$get === void 0 ? void 0 : _direct$get.keys()) !== null && _direct$get$keys !== void 0 ? _direct$get$keys : []).map(function (alias) {
+  var claimed = new Set(createForOfIteratorHelper._toConsumableArray((_direct$get$keys = (_direct$get = direct.get(".")) === null || _direct$get === void 0 ? void 0 : _direct$get.keys()) !== null && _direct$get$keys !== void 0 ? _direct$get$keys : []).map(function (alias) {
     return alias.toLowerCase();
   }));
   var hoisted = new Map();
@@ -923,7 +923,7 @@ function hoist(lockfile, graph, skipped, kindOf, workspacePackages) {
   var workspaceDone = false;
   var hoistWorkspace = function hoistWorkspace() {
     workspaceDone = true;
-    var candidates = slicedToArray._toConsumableArray(workspacePackages).flatMap(function (_ref2) {
+    var candidates = createForOfIteratorHelper._toConsumableArray(workspacePackages).flatMap(function (_ref2) {
       var _ref3 = slicedToArray._slicedToArray(_ref2, 2),
         name = _ref3[0],
         dir = _ref3[1];
@@ -1351,7 +1351,7 @@ var LinkedFileSystem = /*#__PURE__*/function () {
     key: "getDirectories",
     value: function getDirectories(path) {
       var entries = this.directories.get(this.lookup(path));
-      return entries ? slicedToArray._toConsumableArray(entries.directories).sort() : [];
+      return entries ? createForOfIteratorHelper._toConsumableArray(entries.directories).sort() : [];
     }
 
     /** The files in `path`. */
@@ -1359,7 +1359,7 @@ var LinkedFileSystem = /*#__PURE__*/function () {
     key: "getFiles",
     value: function getFiles(path) {
       var entries = this.directories.get(this.lookup(path));
-      return entries ? slicedToArray._toConsumableArray(entries.files).sort() : [];
+      return entries ? createForOfIteratorHelper._toConsumableArray(entries.files).sort() : [];
     }
 
     /** Every file written, by real path. */

package/dist/{acquireTypes-e9467a2a.cjs.prod.js → acquireTypes-dd976839.cjs.prod.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var slicedToArray = require('./slicedToArray-af50e684.cjs.prod.js');
-var createForOfIteratorHelper = require('./createForOfIteratorHelper-90e6a8b6.cjs.prod.js');
+var slicedToArray = require('./slicedToArray-d99b4e2e.cjs.prod.js');
+var createForOfIteratorHelper = require('./createForOfIteratorHelper-fef4fa7d.cjs.prod.js');
 var yaml = require('yaml');
 
 /**
@@ -911,7 +911,7 @@ function hoist(lockfile, graph, skipped, kindOf, workspacePackages) {
   entries.sort(function (a, b) {
     return a.depth - b.depth || compareBytes(a.sortKey, b.sortKey);
   });
-  var claimed = new Set(slicedToArray._toConsumableArray((_direct$get$keys = (_direct$get = direct.get(".")) === null || _direct$get === void 0 ? void 0 : _direct$get.keys()) !== null && _direct$get$keys !== void 0 ? _direct$get$keys : []).map(function (alias) {
+  var claimed = new Set(createForOfIteratorHelper._toConsumableArray((_direct$get$keys = (_direct$get = direct.get(".")) === null || _direct$get === void 0 ? void 0 : _direct$get.keys()) !== null && _direct$get$keys !== void 0 ? _direct$get$keys : []).map(function (alias) {
     return alias.toLowerCase();
   }));
   var hoisted = new Map();
@@ -923,7 +923,7 @@ function hoist(lockfile, graph, skipped, kindOf, workspacePackages) {
   var workspaceDone = false;
   var hoistWorkspace = function hoistWorkspace() {
     workspaceDone = true;
-    var candidates = slicedToArray._toConsumableArray(workspacePackages).flatMap(function (_ref2) {
+    var candidates = createForOfIteratorHelper._toConsumableArray(workspacePackages).flatMap(function (_ref2) {
       var _ref3 = slicedToArray._slicedToArray(_ref2, 2),
         name = _ref3[0],
         dir = _ref3[1];
@@ -1351,7 +1351,7 @@ var LinkedFileSystem = /*#__PURE__*/function () {
     key: "getDirectories",
     value: function getDirectories(path) {
       var entries = this.directories.get(this.lookup(path));
-      return entries ? slicedToArray._toConsumableArray(entries.directories).sort() : [];
+      return entries ? createForOfIteratorHelper._toConsumableArray(entries.directories).sort() : [];
     }
 
     /** The files in `path`. */
@@ -1359,7 +1359,7 @@ var LinkedFileSystem = /*#__PURE__*/function () {
     key: "getFiles",
     value: function getFiles(path) {
       var entries = this.directories.get(this.lookup(path));
-      return entries ? slicedToArray._toConsumableArray(entries.files).sort() : [];
+      return entries ? createForOfIteratorHelper._toConsumableArray(entries.files).sort() : [];
     }
 
     /** Every file written, by real path. */

package/dist/{createForOfIteratorHelper-3db5d737.esm.js → createForOfIteratorHelper-666a6d17.esm.js}

@@ -8,6 +8,36 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+
 function _toPrimitive(t, r) {
   if ("object" != typeof t || !t) return t;
   var e = t[Symbol.toPrimitive];
@@ -55,20 +85,6 @@ function _objectSpread2(e) {
   return e;
 }
 
-function _arrayLikeToArray(r, a) {
-  (null == a || a > r.length) && (a = r.length);
-  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
-  return n;
-}
-
-function _unsupportedIterableToArray(r, a) {
-  if (r) {
-    if ("string" == typeof r) return _arrayLikeToArray(r, a);
-    var t = {}.toString.call(r).slice(8, -1);
-    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
-  }
-}
-
 function _createForOfIteratorHelper(r, e) {
   var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
   if (!t) {
@@ -118,4 +134,4 @@ function _createForOfIteratorHelper(r, e) {
   };
 }
 
-export { _typeof as _, _createForOfIteratorHelper as a, _objectSpread2 as b, _defineProperty as c, _toPropertyKey as d, _arrayLikeToArray as e, _unsupportedIterableToArray as f };
+export { _typeof as _, _objectSpread2 as a, _toConsumableArray as b, _createForOfIteratorHelper as c, _defineProperty as d, _toPropertyKey as e, _unsupportedIterableToArray as f };

package/dist/{createForOfIteratorHelper-90e6a8b6.cjs.prod.js → createForOfIteratorHelper-87a33eff.cjs.dev.js}

@@ -10,6 +10,36 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+
 function _toPrimitive(t, r) {
   if ("object" != typeof t || !t) return t;
   var e = t[Symbol.toPrimitive];
@@ -57,20 +87,6 @@ function _objectSpread2(e) {
   return e;
 }
 
-function _arrayLikeToArray(r, a) {
-  (null == a || a > r.length) && (a = r.length);
-  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
-  return n;
-}
-
-function _unsupportedIterableToArray(r, a) {
-  if (r) {
-    if ("string" == typeof r) return _arrayLikeToArray(r, a);
-    var t = {}.toString.call(r).slice(8, -1);
-    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
-  }
-}
-
 function _createForOfIteratorHelper(r, e) {
   var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
   if (!t) {
@@ -120,10 +136,10 @@ function _createForOfIteratorHelper(r, e) {
   };
 }
 
-exports._arrayLikeToArray = _arrayLikeToArray;
 exports._createForOfIteratorHelper = _createForOfIteratorHelper;
 exports._defineProperty = _defineProperty;
 exports._objectSpread2 = _objectSpread2;
+exports._toConsumableArray = _toConsumableArray;
 exports._toPropertyKey = _toPropertyKey;
 exports._typeof = _typeof;
 exports._unsupportedIterableToArray = _unsupportedIterableToArray;

package/dist/{createForOfIteratorHelper-d86bb352.cjs.dev.js → createForOfIteratorHelper-fef4fa7d.cjs.prod.js}

@@ -10,6 +10,36 @@ function _typeof(o) {
   }, _typeof(o);
 }
 
+function _arrayLikeToArray(r, a) {
+  (null == a || a > r.length) && (a = r.length);
+  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
+  return n;
+}
+
+function _arrayWithoutHoles(r) {
+  if (Array.isArray(r)) return _arrayLikeToArray(r);
+}
+
+function _iterableToArray(r) {
+  if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
+}
+
+function _unsupportedIterableToArray(r, a) {
+  if (r) {
+    if ("string" == typeof r) return _arrayLikeToArray(r, a);
+    var t = {}.toString.call(r).slice(8, -1);
+    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
+  }
+}
+
+function _nonIterableSpread() {
+  throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+
+function _toConsumableArray(r) {
+  return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
+}
+
 function _toPrimitive(t, r) {
   if ("object" != typeof t || !t) return t;
   var e = t[Symbol.toPrimitive];
@@ -57,20 +87,6 @@ function _objectSpread2(e) {
   return e;
 }
 
-function _arrayLikeToArray(r, a) {
-  (null == a || a > r.length) && (a = r.length);
-  for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
-  return n;
-}
-
-function _unsupportedIterableToArray(r, a) {
-  if (r) {
-    if ("string" == typeof r) return _arrayLikeToArray(r, a);
-    var t = {}.toString.call(r).slice(8, -1);
-    return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0;
-  }
-}
-
 function _createForOfIteratorHelper(r, e) {
   var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
   if (!t) {
@@ -120,10 +136,10 @@ function _createForOfIteratorHelper(r, e) {
   };
 }
 
-exports._arrayLikeToArray = _arrayLikeToArray;
 exports._createForOfIteratorHelper = _createForOfIteratorHelper;
 exports._defineProperty = _defineProperty;
 exports._objectSpread2 = _objectSpread2;
+exports._toConsumableArray = _toConsumableArray;
 exports._toPropertyKey = _toPropertyKey;
 exports._typeof = _typeof;
 exports._unsupportedIterableToArray = _unsupportedIterableToArray;

package/dist/declarations/src/client/index.d.ts

@@ -16,6 +16,7 @@
  */
 export * from "../internal/sessionStorage.js";
 export * from "../internal/valCanvasProtocol.js";
+export * from "../internal/elementPicker.js";
 export * from "../internal/parseRoutePattern.js";
 export * from "../internal/getNextAppRouterSourceFolder.js";
 export * from "../internal/getSitemapTree.js";

package/dist/declarations/src/internal/ApiRoutes.d.ts

@@ -1988,6 +1988,12 @@ export declare const Api: {
                     limit: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
                     cursor_updatedAt: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
                     cursor_id: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
+                    /**
+                     * The proposal the Studio is in, by name: lists that proposal's
+                     * chats, everyone's, instead of your own (valbuild/home
+                     * `docs/proposals.md`, Flow H).
+                     */
+                    proposal: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string, string[]>>>;
                 };
                 cookies: {
                     [VAL_SESSION_COOKIE]: z.ZodOptional<z.ZodString>;
@@ -2006,6 +2012,7 @@ export declare const Api: {
                         name: z.ZodNullable<z.ZodString>;
                         createdAt: z.ZodString;
                         updatedAt: z.ZodString;
+                        authorIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     }, z.core.$strip>>;
                     nextCursor: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         updatedAt: z.ZodString;
@@ -2067,6 +2074,7 @@ export declare const Api: {
                 status: z.ZodLiteral<200>;
                 json: z.ZodObject<{
                     messages: z.ZodArray<z.ZodObject<{
+                        authorId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                         role: z.ZodString;
                         content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                             type: z.ZodLiteral<"text">;

package/dist/declarations/src/internal/elementPicker.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Pointing at anything on a page, as Lovable's picker does: hover outlines
+ * the element under the pointer, a click picks it, and the assistant is told
+ * which (valbuild/home `docs/design-tab.md`).
+ *
+ * ANY element, not only what Val marks. The design tab changes code, and the
+ * thing a person wants changed is as often a wrapper, a gap or a button as a
+ * field -- so a field's path is extra information when there is one
+ * (`valPath`), never the condition for picking.
+ *
+ * Picking is on while a MODIFIER is held, so the page stays a page: links
+ * follow, menus open, and nothing has to be switched back off. `active`
+ * turns it on without one, for a Select button or a touch screen.
+ *
+ * Plain DOM, nothing of React's or the Studio's, and in `shared` because
+ * both halves need it: the canvas bridge (`@valbuild/next`,
+ * `@valbuild/tanstack`) runs it inside the proposal's page, which is another
+ * origin than the design tab and the only place the page's elements can be
+ * reached; the Studio's stories run it on a page of their own. Only the
+ * `PickedElement` crosses the frame (`valCanvasProtocol.ts`).
+ */
+export type PickedElement = {
+    /** `h2`, `section`, `button`… */
+    tag: string;
+    /** The words in it, shortened: what a person recognises it by. */
+    text: string;
+    /** Its own classes, as written. */
+    classes: string[];
+    /**
+     * Where it is, from the root down, short enough to read:
+     * `section:nth-of-type(2) > h2`. An `id` ends the walk, since it is
+     * already unique.
+     */
+    selector: string;
+    /** The Val field it shows, or is inside of; absent when it shows none. */
+    valPath?: string;
+};
+export type PickModifier = "alt" | "meta" | "shift" | "ctrl";
+export declare function describeElement(element: Element, root: Element): PickedElement;
+/** What a person is told to hold, on their own keyboard. */
+export declare function modifierLabel(modifier: PickModifier, mac: boolean): string;
+export type ElementPickerOptions = {
+    modifier: PickModifier;
+    /** On without the modifier: a Select button, or a touch screen. */
+    active: () => boolean;
+    /** The element under the pointer while picking; `null` when not picking. */
+    onHover: (element: Element | null) => void;
+    onPick: (element: Element) => void;
+};
+/**
+ * Listens on `root` (capturing, so the page's own handlers never see a pick)
+ * and returns what stops it.
+ */
+export declare function attachElementPicker(root: HTMLElement, options: ElementPickerOptions): () => void;
+/**
+ * The outlines over the page while picking: the element under the pointer,
+ * named, and the one picked.
+ *
+ * Boxes `position: fixed` on top of everything, with `pointer-events: none`,
+ * appended to the page's body -- not outlines on the elements themselves.
+ * The canvas's field outlines are a stylesheet so they cannot disturb the
+ * page's layout (`ValCanvasBridge`); a fixed box is out of the flow, so it
+ * cannot either, and it is the one way to put a NAME beside any element, which
+ * a selector cannot reach.
+ *
+ * In a shadow root of one host element: the bridge re-measures the page on
+ * every `style` change under `body`, and a box that follows the pointer
+ * changes its style every frame. Inside a shadow root those changes are not
+ * the page's, so the host's one insertion is all the bridge sees.
+ */
+export type PickerOverlay = {
+    show: (kind: "hover" | "picked", element: Element | null) => void;
+    setColor: (color: string) => void;
+    destroy: () => void;
+};
+export declare function createPickerOverlay(doc: Document, initialColor: string): PickerOverlay;
+/** `h2.mb-6.text-2xl`: what the hover box is named. */
+export declare function elementLabel(element: Element): string;
+export type ElementPicking = {
+    /** Take the picked outline down, when the Studio no longer holds the pick. */
+    clearPicked: () => void;
+    setColor: (color: string) => void;
+    stop: () => void;
+};
+/**
+ * Picking on a page, whole: the listeners, the outlines, and Esc to stop
+ * picking without the modifier. What a canvas bridge mounts.
+ */
+export declare function startElementPicking(root: HTMLElement, options: {
+    modifier: PickModifier;
+    active: () => boolean;
+    color: string;
+    onPick: (picked: PickedElement) => void;
+    /** Esc while `active`: the Studio turns Select off. */
+    onStop: () => void;
+}): ElementPicking;

package/dist/declarations/src/internal/index.d.ts

@@ -24,6 +24,7 @@ export * from "./localeAt.js";
 export * from "./getErrorMessageFromUnknownJson.js";
 export * from "./zod/SerializedSchema.js";
 export * from "./valCanvasProtocol.js";
+export * from "./elementPicker.js";
 export * from "./emptyOf.js";
 export * from "./aiTools/toolNames.js";
 export * from "./aiTools/aiImageToolPatches.js";

package/dist/declarations/src/internal/theme/accentRamp.d.ts

@@ -71,7 +71,27 @@ export declare function themeCustomProperties(theme: {
     accent?: string | null;
     /** A `--radius` length. The caller maps the named step; see `THEME_RADIUS_LENGTHS`. */
     radius?: string | null;
+    /** The proposal colour, a hex. See {@link proposalCustomProperties}. */
+    proposal?: string | null;
 }): Record<string, string>;
+/**
+ * The proposal colour's tokens, for light and dark at once.
+ *
+ * The six `--*-proposal` tokens are declared per mode in `index.css`, each as
+ * `var(--theme-proposal-<mode>-<token>, <Val's violet>)`, so the ones written
+ * here are picked up where the mode block is declared -- on every element the
+ * Studio stamps `data-mode` on, which is where these go (see
+ * `themeCustomProperties` on why a `var()` resolves where it is declared).
+ * Both modes' values are written because an element does not know which mode
+ * its subtree will be in by the time it is styled.
+ *
+ * From the same ramp as the accent: the hue is the project's, the lightness
+ * of each step Val's, so the steps chosen here have the contrast Val's violet
+ * had. Text on the filled colour is white unless white would not read, then
+ * the ramp's darkest step. Empty for a value that is not a usable hex, so
+ * Val's violet stays.
+ */
+export declare function proposalCustomProperties(hex: string): Record<string, string>;
 /**
  * WCAG relative luminance of a six-digit hex.
  *

package/dist/declarations/src/internal/valCanvasProtocol.d.ts

@@ -20,6 +20,7 @@
  * the frame's URL is scoped to exactly the one document that needs it.
  */
 import type { ModuleFilePath, SourcePath } from "@valbuild/core";
+import type { PickedElement, PickModifier } from "./elementPicker.js";
 /** Marks a page load as the studio's canvas frame. */
 export declare const VAL_CANVAS_PARAM = "val_canvas";
 /**
@@ -170,6 +171,23 @@ export type ValCanvasPageMessage = {
      * from outside, so the page says so and the canvas can show it is working.
      */
     pending: boolean;
+} | {
+    /**
+     * Something on the page was picked while `pickElements` was on: ANY
+     * element, described (`describeElement`), since the element itself
+     * cannot leave the page.
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "elementPicked";
+    element: PickedElement;
+} | {
+    /**
+     * Esc on the page while Select was on. The key went to the page, which
+     * has the focus once it has been clicked, so the studio hears it only
+     * from here.
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "elementPickingStopped";
 };
 /** What the studio tells the page. */
 export type ValCanvasStudioMessage = {
@@ -255,6 +273,24 @@ export type ValCanvasStudioMessage = {
      * on a link should follow the link.
      */
     picking: boolean;
+} | {
+    /**
+     * Picking ANY element, as the design tab does (`elementPicker.ts`),
+     * rather than the fields Val tagged, as `setPicking` does.
+     *
+     * While `enabled`, holding `modifier` outlines what is under the
+     * pointer and a click picks it; `active` picks without the modifier (the
+     * tab's Select). Sent whole every time, so a page that missed one
+     * message is put right by the next. A bridge that predates it ignores
+     * it, and the tab then simply never hears of a pick.
+     */
+    val: typeof VAL_CANVAS_MESSAGE;
+    type: "pickElements";
+    enabled: boolean;
+    active: boolean;
+    modifier: PickModifier;
+    /** Whether the studio still holds the last pick: false takes its outline down. */
+    keepPicked: boolean;
 };
 /** Narrow an unknown `event.data` to a message from the page. */
 export declare function isValCanvasPageMessage(data: unknown): data is ValCanvasPageMessage;