gesso-framework 0.6.30 → 0.7.0

package/dist/createComponent-DJads88q.js

@@ -0,0 +1,47 @@
+//#region src/metadata.ts
+const metadataStore = /* @__PURE__ */ new WeakMap();
+function getComponentMetadata(constructor) {
+	let metadata = metadataStore.get(constructor);
+	if (metadata === void 0) {
+		metadata = {
+			tag: constructor.name,
+			inputs: /* @__PURE__ */ new Set(),
+			states: /* @__PURE__ */ new Set(),
+			injects: /* @__PURE__ */ new Map(),
+			channels: /* @__PURE__ */ new Map()
+		};
+		metadataStore.set(constructor, metadata);
+	}
+	return metadata;
+}
+//#endregion
+//#region src/createComponent.ts
+/**
+* Creates a ComponentElement for use as a child of a UiElement.
+*
+*   Column(
+*     createComponent(Counter, { label: 'Count' }),
+*     createComponent(TodoItem, { todo }, todo.id)
+*   )
+*
+* The component may be a class extending Component or a function
+* `(props, ctx) => UiChild`. Props are typed from the component: a
+* class's `input()` fields, or a function's `Inputs<P>` parameter. A
+* misspelled prop, a value of the wrong type, and a missing required
+* prop are compile errors; props may be omitted only when none is
+* required.
+*/
+function createComponent(component, ...args) {
+	const [props, key] = args;
+	return {
+		kind: "component",
+		tag: getComponentMetadata(component).tag,
+		component,
+		props: props ?? {},
+		key
+	};
+}
+//#endregion
+export { getComponentMetadata as n, createComponent as t };
+
+//# sourceMappingURL=createComponent-DJads88q.js.map

package/dist/createComponent-DJads88q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createComponent-DJads88q.js","names":[],"sources":["../src/metadata.ts","../src/createComponent.ts"],"sourcesContent":["export const COMPONENT_METADATA_KEY = Symbol('gesso:component:metadata');\n\nexport interface ComponentMetadata {\n  tag: string;\n  inputs: Set<string>;\n  states: Set<string>;\n  injects: Map<string, Function>;\n  /** Property name → the channel token it resolves to (`@Channel`). */\n  channels: Map<string, { name: string }>;\n}\n\nconst metadataStore = new WeakMap<Function, ComponentMetadata>();\n\nexport function getComponentMetadata(constructor: Function): ComponentMetadata {\n  let metadata = metadataStore.get(constructor);\n  if (metadata === undefined) {\n    metadata = { tag: constructor.name, inputs: new Set(), states: new Set(), injects: new Map(), channels: new Map() };\n    metadataStore.set(constructor, metadata);\n  }\n  return metadata;\n}\n\nexport function hasComponentMetadata(constructor: Function): boolean {\n  return metadataStore.has(constructor);\n}\n","import type { ComponentElement } from './ComponentElement';\nimport type { ComponentArgs, ComponentProps, ComponentType } from './FunctionComponent';\nimport { getComponentMetadata } from './metadata';\n\n/**\n * Creates a ComponentElement for use as a child of a UiElement.\n *\n *   Column(\n *     createComponent(Counter, { label: 'Count' }),\n *     createComponent(TodoItem, { todo }, todo.id)\n *   )\n *\n * The component may be a class extending Component or a function\n * `(props, ctx) => UiChild`. Props are typed from the component: a\n * class's `input()` fields, or a function's `Inputs<P>` parameter. A\n * misspelled prop, a value of the wrong type, and a missing required\n * prop are compile errors; props may be omitted only when none is\n * required.\n */\nexport function createComponent<C extends ComponentType>(\n  component: C,\n  ...args: ComponentArgs<C>\n): ComponentElement<ComponentProps<C>> {\n  const [props, key] = args as [ComponentProps<C> | undefined, string | number | undefined];\n  const metadata = getComponentMetadata(component);\n  return {\n    kind: 'component',\n    tag: metadata.tag,\n    component,\n    props: (props ?? {}) as ComponentProps<C>,\n    key\n  };\n}\n"],"mappings":";AAWA,MAAM,gCAAgB,IAAI,QAAqC;AAE/D,SAAgB,qBAAqB,aAA0C;CAC7E,IAAI,WAAW,cAAc,IAAI,WAAW;CAC5C,IAAI,aAAa,KAAA,GAAW;EAC1B,WAAW;GAAE,KAAK,YAAY;GAAM,wBAAQ,IAAI,IAAI;GAAG,wBAAQ,IAAI,IAAI;GAAG,yBAAS,IAAI,IAAI;GAAG,0BAAU,IAAI,IAAI;EAAE;EAClH,cAAc,IAAI,aAAa,QAAQ;CACzC;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;ACDA,SAAgB,gBACd,WACA,GAAG,MACkC;CACrC,MAAM,CAAC,OAAO,OAAO;CAErB,OAAO;EACL,MAAM;EACN,KAHe,qBAAqB,SAGxB,CAAC,CAAC;EACd;EACA,OAAQ,SAAS,CAAC;EAClB;CACF;AACF"}

package/dist/{index-DZbSb8IN.d.ts → index-BENndtaH.d.ts}

@@ -1,56 +1,7 @@
-import { f as ChannelToken, m as CommandMap, o as Patch, p as Command, r as ChannelPort } from "./ChannelProtocol-ByNoHujM.js";
-import { E as WorkerHandle, s as AgentConfirmation, t as UiHost, y as ChannelSource } from "./ui-CHtNccR8.js";
-import { C as InternalState, T as Component, a as ComponentType, c as Inputs, g as OutputCell, h as InputCell, i as ComponentProps, n as ComponentArgs, r as ComponentContext, u as ChannelReplica, v as ReadableCell } from "./FunctionComponent-CHtojpp7.js";
+import { L as ChannelToken, R as Command, a as ComponentType, c as Inputs, i as ComponentProps, j as Patch, n as ComponentArgs, p as InternalState, r as ComponentContext, u as Component, v as InputCell, x as ReadableCell, y as OutputCell } from "./FunctionComponent-Czkex8fp.js";
+import { C as ServiceRegistry, E as DesignThemes, O as AgentConfirmation, U as ChannelSource, X as WorkerHandle, b as ComponentElement, s as UiHost, t as AgentToolDefinition, w as ChannelRegistry, x as FrameworkChild } from "./tools-BFBwuinE.js";
 import { BehaviorSubject, Observable, Subscription } from "rxjs";
-import { AnimatedCell, AnimationDriver, CanvasHost, CaretRect, ComponentLikeElement, ComponentResolver, EditingState, EditingState as EditingState$1, FocusOptions, IconRasterizer, ImageResolver, LayoutExplanation, LayoutInspector, MARK_PREFIX, MotionStateInput, MotionTiming, Reactive, RendererBackend, Size, TextMeasureRequest, TextMeasurer, UI_ROLES, UI_SEMANTIC_STATES, UiAnimation, UiChild, UiContrast, UiDurationToken, UiEasing, UiEasingToken, UiEditingController, UiElement, UiFileDropMessage, UiFindController, UiFocusManager, UiFrameClockFactory, UiInputDispatcher, UiInsets, UiKeyModifiers, UiKeyboardController, UiLength, UiModifier, UiMotion, UiNode, UiPlatformAdapter, UiPointerController, UiPointerDevice, UiReducedMotionPolicy, UiRole, UiScrollability, UiSelectionController, UiSemanticState, UiSemanticsAction, UiSemanticsMap, UiSemanticsMap as UiSemanticsMap$1, UiSemanticsPatch, UiSemanticsRecord, UiSemanticsRecord as UiSemanticsRecord$1, UiSemanticsUpdate, UiShortcutRegistry, UiSpringSpec, UiSpringToken, UiTextPosition, UiThemeExtension, UiTouchScroller, UiWheelController, VideoClock, VideoResolver, markInstant, markNow, measureSpan, performanceMarksEnabled, setPerformanceMarks as setPerformanceMarks$1 } from "gesso-core";
-//#region src/service/ServiceRegistry.d.ts
-/**
- * The runtime services a component may inject.
- *
- * A service is a plain class the runtime constructs once and hands to
- * whoever asks: the clipboard and window (`ShellService`), overlays,
- * focus, find, media, animation. They are not application state and
- * they never cross a thread — they hold a `UiNode`, an `ImageResolver`,
- * decoded bitmaps, a focus manager — so there is no replica, no patch
- * and no wire format anywhere near them.
- *
- * That is the whole difference from what used to be here. Application
- * state crosses the barrier and is declared as a channel; a service
- * stays on the render thread and is simply called. Both used to be
- * `Store`, and the single name hid which of the two rules applied.
- */
-declare class ServiceRegistry {
-  private readonly services;
-  /** Constructs and registers a service, once. */
-  register<T extends object>(ServiceClass: new () => T): T;
-  /**
-   * Points an existing service at a replacement class of the same
-   * name, keeping the instance (the HMR).
-   *
-   * A registry is keyed by the class object, which is the right key
-   * for every purpose but one: replacing a module produces a new class
-   * object, so a component from the replaced module injects a class
-   * the registry has never seen even though a service of that name is
-   * sitting in it. Re-keying is what lets the tree be rebuilt from new
-   * code while the service it depends on carries on holding what it
-   * was holding.
-   *
-   * **The instance keeps the behaviour it was constructed with.** It
-   * was built from the old class and its methods are the old code, so
-   * a change to a service's own body needs a full reload to take
-   * effect. State survives; behaviour does not. That is the trade
-   * every hot-replacement system makes, and pretending otherwise would
-   * be worse than saying it.
-   *
-   * Returns false when nothing of that name was registered, which
-   * means the caller is looking at a genuinely new service rather than
-   * a replacement.
-   */
-  adopt(ServiceClass: new () => object): boolean;
-  get<T extends object>(ServiceClass: new () => T): T;
-  has(ServiceClass: Function): boolean;
-}
-//#endregion
+import { AnimatedCell, AnimationDriver, CanvasHost, CaretRect, ComponentLikeElement, ComponentResolver, EditingState, EditingState as EditingState$1, FocusOptions, IconRasterizer, ImageResolver, LayoutExplanation, LayoutInspector, MARK_PREFIX, MotionStateInput, MotionTiming, Reactive, RendererBackend, Size, SvgResolver, TextMeasureRequest, TextMeasurer, UI_ROLES, UI_SEMANTIC_STATES, UiAnimation, UiChild, UiContrast, UiDurationToken, UiEasing, UiEasingToken, UiEditingController, UiElement, UiFileDropMessage, UiFindController, UiFocusManager, UiFrameClockFactory, UiInputDispatcher, UiInsets, UiKeyModifiers, UiKeyboardController, UiLength, UiModifier, UiMotion, UiNode, UiPlatformAdapter, UiPointer, UiPointerController, UiPointerDevice, UiReducedMotionPolicy, UiRole, UiScrollability, UiSelectionController, UiSemanticState, UiSemanticsAction, UiSemanticsMap, UiSemanticsMap as UiSemanticsMap$1, UiSemanticsPatch, UiSemanticsRecord, UiSemanticsRecord as UiSemanticsRecord$1, UiSemanticsUpdate, UiShortcutRegistry, UiSourceLocation, UiSpringSpec, UiSpringToken, UiTextPosition, UiTheme, UiThemeExtension, UiTouchScroller, UiWheelController, VideoClock, VideoResolver, markInstant, markNow, measureSpan, performanceMarksEnabled, setPerformanceMarks as setPerformanceMarks$1 } from "gesso-core";
 //#region src/derive.d.ts
 /** How `derive` decides that a new value is not a change. */
 type Equality<T> = 'reference' | 'structural' | ((a: T, b: T) => boolean);
@@ -989,25 +940,6 @@ declare function Channel(token: {
   name: string;
 }): PropertyDecorator;
 //#endregion
-//#region src/channel/ChannelRegistry.d.ts
-/**
- * The channels a runtime can hand to its components, by name.
- *
- * A replica is the only thing kept: whether the data lives in another
- * worker or on this very thread is settled by the port it was attached
- * with, and nothing above here can tell.
- */
-declare class ChannelRegistry {
-  private readonly replicas;
-  /** Attaches a channel over `port`. */
-  attach<View extends object, Commands extends object>(token: ChannelToken<View, Commands>, port: ChannelPort): ChannelReplica<View, Commands>;
-  get<View extends object, Commands extends object>(token: ChannelToken<View, Commands>): ChannelReplica<View, Commands>;
-  has(token: ChannelToken<object, CommandMap>): boolean;
-  /** Every attached replica, for frame-aligned patch flushing. */
-  all(): ChannelReplica<object, CommandMap>[];
-  dispose(): void;
-}
-//#endregion
 //#region src/channel/plainData.d.ts
 /**
  * Checks that a value can cross the barrier.
@@ -1124,28 +1056,6 @@ declare function pickKeys<T extends object, K extends keyof T>(source: Observabl
 //#region src/channel/structuralEquals.d.ts
 declare function structurallyEqual<T>(a: T, b: T): boolean;
 //#endregion
-//#region src/ComponentElement.d.ts
-/**
- * Declarative representation of a component instance in the tree.
- *
- * ComponentElements are resolved by ComponentRenderer into plain
- * UiElement trees before being passed to UiGraphBuilder.
- */
-interface ComponentElement<P = Record<string, unknown>> {
-  readonly kind: 'component';
-  readonly tag: string;
-  /** The class or function to mount. */
-  readonly component: ComponentType;
-  readonly props: P;
-  readonly key?: string | number;
-}
-declare function isComponentElement(value: unknown): value is ComponentElement;
-/**
- * Anything the framework accepts as a child: a runtime element, an
- * observable stream of elements, or a component definition.
- */
-type FrameworkChild = UiChild | ComponentElement;
-//#endregion
 //#region src/createComponent.d.ts
 /**
  * Creates a ComponentElement for use as a child of a UiElement.
@@ -1440,6 +1350,13 @@ declare class ComponentHost<P extends Record<string, unknown> = Record<string, u
   private createInputRecord;
   private createContext;
   private wireInputs;
+  /**
+   * What the parent most recently supplied for each input, as given:
+   * a value, an element or a stream, whether or not the component has
+   * read it yet. For a tool reading the tree, such as the inspector's
+   * owner report; nothing here changes it.
+   */
+  suppliedInputs(): ReadonlyMap<string, unknown>;
   /**
    * Connects one input cell to whatever the parent supplied.
    *
@@ -1562,6 +1479,13 @@ interface UiNodeReport {
   readonly semantics?: UiSemanticsReport;
   /** `formatExplanation` of the node's layout, which is L8's answer. */
   readonly explanation: string;
+  /**
+   * Where the element was written, when it was compiled for
+   * development. The one part of the report that is a handle after
+   * all: it names a line an editor can open, and an owner's `usedAt`
+   * names the line that used the component around it.
+   */
+  readonly source?: UiSourceLocation;
 }
 /** A node under the inspected one at the pointer. */
 interface UiBeneathReport {
@@ -1576,7 +1500,21 @@ interface UiOwnerReport {
   /** The `@Define` tag, else the class or function name. */
   readonly name: string;
   readonly anchorId: string;
+  /** Where the component was used, when compiled for development. */
+  readonly usedAt?: UiSourceLocation;
+  /**
+   * What its parent supplied for each input, as far as plain data can
+   * say: a word, a number or a flag as it is, and an element (a slot the
+   * parent filled) as `{ element: true }`. Handlers, data objects and
+   * streams with no current value are left out. What a design tool
+   * needs to write a component's use back as code: `label="Email"`.
+   */
+  readonly inputs?: Readonly<Record<string, UiOwnerInput>>;
 }
+/** One input's value in an owner report; see `UiOwnerReport.inputs`. */
+type UiOwnerInput = string | number | boolean | null | {
+  readonly element: true;
+};
 /** As much of a node as a one-line path needs. */
 interface NodePathTarget {
   /** `UiNodeType`, as its string value. */
@@ -1704,6 +1642,8 @@ interface UiSemanticsReport {
  */
 declare function printPropValue(value: unknown): string;
 /** The report as text, for a console or a test failure. */
+/** `file:line:column`, the form editors and terminals turn into a link. */
+declare function formatSourceLocation(source: UiSourceLocation): string;
 declare function formatNodeReport(report: UiNodeReport): string;
 //#endregion
 //#region src/app/colorScheme.d.ts
@@ -1956,6 +1896,7 @@ declare class ShellService {
   private leaving;
   private readonly scheme;
   private readonly contrastState;
+  private readonly pointerState;
   private readonly activeState;
   private readonly insets;
   private readonly isFullscreen;
@@ -2015,6 +1956,13 @@ declare class ShellService {
    *   );
    */
   readonly contrast: ReadableCell<UiContrast>;
+  /**
+   * What the person points with: `coarse` on a touch screen, `fine` with
+   * a mouse or a trackpad. Fine until a shell says otherwise. The
+   * runtime also provides it at the root (`UiEnvironmentKeys.pointer`),
+   * where controls read it; this is for the application's own choices.
+   */
+  readonly pointer: ReadableCell<UiPointer>;
   /**
    * Whether the window is the one the person is using: shown, and holding
    * the keyboard focus. False while it is behind another window,
@@ -2064,6 +2012,8 @@ declare class ShellService {
   /** Called by the runtime when the shell reports whether the window is active; not for applications. */
   applyWindowActive(active: boolean): void;
   /** Called by the runtime when the shell reports the contrast; not for applications. */
+  /** Called by the runtime when the shell reports what the person points with. */
+  applyPointer(pointer: UiPointer): void;
   applyContrast(contrast: UiContrast): void;
   /**
    * Called by the runtime when the shell reports the platform's insets.
@@ -3140,6 +3090,8 @@ interface MediaOptions {
   resolver?: ImageResolver;
   /** Where an `Icon` finds its raster. */
   rasterizer?: IconRasterizer;
+  /** Where an `Image` reads an SVG source. */
+  vectors?: SvgResolver;
   /** Where a `Video` finds its decoder. */
   videoResolver?: VideoResolver;
 }
@@ -3162,6 +3114,7 @@ interface MediaOptions {
 declare class MediaService {
   private imageResolver;
   private iconRasterizer;
+  private svgResolver;
   private videoResolver;
   /**
    * Whether each of the three is the service's to dispose.
@@ -3177,6 +3130,10 @@ declare class MediaService {
   private ownsRasterizer;
   private ownsVideoResolver;
   get images(): ImageResolver;
+  /** Where an `Image` reads an SVG source, which it draws as vectors rather than decoding. */
+  get vectors(): SvgResolver;
+  /** The same seam, for SVG. A read file holds no pixels, so there is nothing to dispose either way. */
+  setSvgResolver(resolver: SvgResolver): void;
   get icons(): IconRasterizer;
   /**
    * Built on first use rather than in the field, because a decoder is
@@ -3478,6 +3435,8 @@ declare class GessoRuntime {
   readonly inspector: LayoutInspector;
   private readonly resolver;
   private readonly graph;
+  /** The properties `InspectionService.preview` is drawing over, by node; gone with the node. */
+  private readonly previewed;
   private readonly engine;
   private readonly builder;
   private readonly scheduler;
@@ -3653,6 +3612,8 @@ declare class GessoRuntime {
   private audioListener;
   private caretTimer;
   private scrollbarTimer;
+  /** Pending frame the renderer asked for though nothing changes; see \`UiRenderer.nextRepaint\`. */
+  private rendererTimer;
   private inspectorTimer;
   /** Pending wake-up for an animation that does not want every frame. */
   private animationTimer;
@@ -3874,6 +3835,21 @@ declare class GessoRuntime {
    * request produced it.
    */
   private sendTree;
+  /**
+   * The theme a node sees, by id, or with none named the theme the
+   * application's outermost content sees: from the application's root,
+   * down through every node with exactly one child, which passes the
+   * wrappers an application usually puts its theme on. Undefined before
+   * the root is built, or for an id the tree does not hold.
+   */
+  themeAt(id?: string): UiTheme | undefined;
+  /**
+   * `InspectionService.preview`: a write over the node's own value, as
+   * a modifier's is, from a source of its own placed after every
+   * modifier, so it wins and ending it restores what was under it.
+   */
+  private previewProperty;
+  private endPreviews;
   /** `inspectNode` for a node named by id, or null when the tree has no such node. */
   inspectNodeById(id: string): UiNodeReport | null;
   /**
@@ -4000,6 +3976,14 @@ declare class GessoRuntime {
   setColorScheme(scheme: ColorScheme): void;
   /** Whether the window is the one in use, passed straight to `ShellService`; see `ShellService.windowActive`. */
   setWindowActive(active: boolean): void;
+  /**
+   * What the person points with, as the shell reports it: kept on
+   * `ShellService.pointer`, and provided at the root, so every theme in
+   * the tree is turned for a finger on a touch device (`withPointer`)
+   * without the application doing anything. A subtree that says
+   * `pointer` itself keeps what it says.
+   */
+  setPointer(pointer: UiPointer): void;
   /** The contrast the platform asks for, passed straight to `ShellService`; see `ShellService.contrast`. */
   setContrast(contrast: UiContrast): void;
   /**
@@ -4104,6 +4088,7 @@ declare class GessoRuntime {
    */
   private pathOf;
   /** The components that rendered a node, nearest first. */
+  private sourceReport;
   private ownersOf;
   private propsOf;
   /**
@@ -4592,6 +4577,13 @@ declare class GessoRuntime {
    * property change asks for. The engine says when the next change is
    * due; one pending timer marks a repaint for it.
    */
+  /**
+   * The renderer wants a frame though nothing changes: Canvas2D's kept
+   * subtrees are drawn sharp once a zoom settles. One pending timer
+   * marks the root for paint then, which leaves every kept thing as it
+   * is; a frame before it that is still not settled asks again.
+   */
+  private scheduleRendererRepaint;
   private scheduleScrollbarFade;
   /**
    * The caret blinks, which needs frames no property change asks for.
@@ -4608,7 +4600,7 @@ declare class GessoRuntime {
    * for; one pending timer marks a repaint for the next step due.
    */
   private scheduleInspectorRepaint;
-  /** Hands the listener the hovered node's cursor, when it changed. */
+  /** Hands the listener the hovered node's cursor, when it changed: the arrow over a scrollbar, as a native one shows. */
   private sendCursor;
   /**
    * Hands the listener the pointer's scroll chain, when it changed.
@@ -4949,6 +4941,9 @@ type ShellToRuntimeMessage = {
 } | {
   type: 'contrast';
   contrast: UiContrast;
+} | {
+  type: 'pointer';
+  pointer: UiPointer;
 } |
 /** Whether the window is shown and holds the focus; once at start-up and on every change. See `ShellService.windowActive`. */
 {
@@ -6421,6 +6416,8 @@ declare class GessoAppBuilder {
   private root;
   private readonly channelRegistrations;
   private readonly serviceRegistrations;
+  /** The application's own agent tools (`useAgentTools`). */
+  private readonly agentTools;
   private frameListener;
   private inspectListener;
   private devtoolsListener;
@@ -6462,6 +6459,8 @@ declare class GessoAppBuilder {
    * service.
    */
   useService(ServiceClass: new () => object): this;
+  /** Offers an agent tools of the application's own; see `renderRoot(...).useAgentTools`. */
+  useAgentTools(tools: readonly AgentToolDefinition[]): this;
   /**
    * Declares the app's routes, which is all it takes to make a
    * `RouterOutlet` in the tree resolve them. Mirrors
@@ -7626,6 +7625,78 @@ declare class FrameService {
   publish(metrics: FrameMetrics): void;
 }
 //#endregion
+//#region src/app/InspectionService.d.ts
+/**
+ * What is on the screen, as a component can ask: the nodes under a
+ * point, and what each one is.
+ *
+ * The inspector already answers both, for the devtools panel, from the
+ * runtime's hit tester and its node report. A tool built in Gesso that
+ * points at Gesso needs the same answers from inside the tree: a design
+ * editor whose canvas holds live frames, where a click picks the box
+ * under it instead of pressing it and says which line wrote it. So the
+ * runtime puts them here, as it puts frames in `FrameService`.
+ * Injected like any service: `ctx.inject(InspectionService)`.
+ */
+declare class InspectionService {
+  private host;
+  /** Called by the runtime; not for components. */
+  attach(host: InspectionHost): void;
+  /**
+   * Every node under a point, topmost first, in the coordinates a
+   * pointer event carries: the one a press would reach, then each one
+   * it is painted over. Empty before the first frame.
+   */
+  nodesAt(x: number, y: number): readonly UiNode[];
+  /**
+   * What the node is, as the inspector reports it: its box, its props,
+   * the components that rendered it and, compiled for development, the
+   * line that wrote it (`source`) and where each of those components
+   * was used (`owners[].usedAt`).
+   */
+  inspect(node: UiNode): UiNodeReport;
+  /**
+   * Where the node is drawn, as `inspect(node).box` reports it, without
+   * the rest of the report: for an editor that reads the boxes of many
+   * nodes as its view moves (a minimap of a board of frames), where
+   * building each node's props, owners and source was most of the cost.
+   */
+  box(node: UiNode): {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+  };
+  /**
+   * Draws a node as though it declared `value` for `property`, until
+   * the preview is ended or the node leaves the tree.
+   *
+   * What a design editor shows while a value is being chosen: a padding
+   * dragged or a colour hovered in a list is drawn at once, on the
+   * live tree, and only written to the source when the designer lets go.
+   * It wins over the element's own value and over its modifiers, and
+   * ending it restores whichever of those was there, inheritance
+   * included. The name and value are a prop's, as JSX would write them.
+   */
+  preview(node: UiNode, property: string, value: unknown): void;
+  /** Ends a preview of one property, or of every property previewed on the node. */
+  endPreview(node: UiNode, property?: string): void;
+}
+/** What the runtime gives the service. */
+interface InspectionHost {
+  nodesAt(x: number, y: number): readonly UiNode[];
+  inspect(node: UiNode): UiNodeReport;
+  /** The node's box alone, as `inspect` reports it. */
+  box?(node: UiNode): {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+  };
+  preview?(node: UiNode, property: string, value: unknown): void;
+  endPreview?(node: UiNode, property?: string): void;
+}
+//#endregion
 //#region src/app/videoClock.d.ts
 /**
  * A clip's position, taken from the sound playing beside it.
@@ -8701,6 +8772,13 @@ interface WorkerGlobal {
  * useChannel() calls always land before the shell's init message is
  * processed.
  */
+/** An error the render worker reported, as an application's `onError` hears it. */
+interface RenderWorkerError {
+  readonly message: string;
+  readonly stack?: string;
+  /** Where it came from: a frame, a listener, the renderer, a channel, a message, or nothing that caught it. */
+  readonly source: RuntimeErrorSource;
+}
 declare function renderRoot(root: FrameworkChild | ComponentType): RenderWorkerApp;
 declare class RenderWorkerApp {
   private readonly channelRegistrations;
@@ -8711,6 +8789,14 @@ declare class RenderWorkerApp {
   private root;
   private readonly host;
   private runtime;
+  /** See `renderThemesWith`. */
+  private renderThemes;
+  /** See `loadModulesWith`. */
+  private loadModule;
+  /** The application's own agent tools (`useAgentTools`). */
+  private readonly agentTools;
+  /** What the application asked to hear of the errors this worker reports (`onError`). */
+  private readonly errorListeners;
   /** Held so forwarded display refreshes can be handed to it. */
   private clock;
   private channels;
@@ -8728,6 +8814,11 @@ declare class RenderWorkerApp {
    * would be a bare sentence with nothing to look up.
    */
   private reportUncaught;
+  /**
+   * Tells the shell about an error, which shows it (the development
+   * overlay), and every listener the application gave `onError`.
+   */
+  private reportError;
   /**
    * Replaces the application's root and rebuilds its tree, for hot
    * module replacement.
@@ -8752,6 +8843,24 @@ declare class RenderWorkerApp {
    * message it simply changes which root will be built.
    */
   reload(root: FrameworkChild | ComponentType, services?: readonly (new () => object)[]): void;
+  /**
+   * How `render_frame` loads a module an agent names, given its path from
+   * the project root with a leading slash (`/mocks/Settings.tsx`). By
+   * default it is imported from where the application is served, which
+   * suits an application drawing its own modules. One whose modules are
+   * served from somewhere else says where: a design editor serving the
+   * project it designs from another folder.
+   *
+   *   renderRoot(Editor).loadModulesWith(path => import(`/@fs${projectRoot}${path}`))
+   */
+  loadModulesWith(load: (path: string) => Promise<Record<string, unknown>>): this;
+  /**
+   * The themes an application designs in, asked on each call, when they
+   * are not the one it is drawn in: a design editor's project's. They
+   * are what `render_frame` draws in and `tokens_view` reports unless an
+   * agent asks for the application's own; see `designedTheme`.
+   */
+  renderThemesWith(themes: () => DesignThemes): this;
   /**
    * Registers a channel.
    *
@@ -8777,6 +8886,23 @@ declare class RenderWorkerApp {
    * service.
    */
   useService(ServiceClass: new () => object): this;
+  /**
+   * Offers an agent tools of the application's own, beside its
+   * channels' and its screen's: ones that answer with something other
+   * than a view, such as a measurement or a composed picture. See
+   * `AgentToolDefinition`. Called again, it adds to them.
+   *
+   *   renderRoot(Editor).useAgentTools(editorTools);
+   */
+  useAgentTools(tools: readonly AgentToolDefinition[]): this;
+  /**
+   * Hears every error this worker reports to the shell: a frame that
+   * threw, a listener, the renderer, a channel, anything uncaught. For
+   * an application that shows errors itself, where they happen: a design
+   * editor listing what is wrong with a mock rather than an overlay over
+   * the editor, with the plugin's `overlay: false`.
+   */
+  onError(listener: (error: RenderWorkerError) => void): this;
   /**
    * Declares the app's routes, which is all it takes to make a
    * `RouterOutlet` in the tree resolve them.
@@ -8862,5 +8988,5 @@ declare class RenderWorkerApp {
   private initialize;
 }
 //#endregion
-export { StorageAdapter as $, UiNodeReport as $n, mutate as $r, UiFramePhase as $t, Presence as A, AudioService as An, ChannelRegistry as Ar, createShellHistory as At, PersistedOptions as B, ShellFileResult as Bn, themeTokenCell as Br, UiTreeNode as Bt, FocusService as C, buildPath as Cn, pick as Cr, createApp as Ct, FindService as D, AudioMetadata as Dn, createChannelRegistry as Dr, ShellHistory as Dt, TextService as E, AudioAction as En, ChannelRegistryHandle as Er, WorkerAppOptions as Et, AudioSinkOptions as F, SpringOptions as Fn, Output as Fr, ConsoleEntry as Ft, IndexedDbStorage as G, ShellStorageOp as Gn, Each as Gr, ShellToRuntimeMessage as Gt, persisted as H, ShellRecentFile as Hn, Show as Hr, treeText as Ht, AudioSinkOutput as I, UiDuration as In, ControlledOptions as Ir, DevtoolsEvent as It, OpfsFileHandle as J, ColorSchemePreference as Jn, each as Jr, GessoRuntime as Jt, IndexedDbStorageOptions as K, ShellStorageResult as Kn, EachKey as Kr, FrameMetrics as Kt, MediaSessionLike as L, UiEasingChoice as Ln, ControlledValue as Lr, DevtoolsRequest as Lt, RouterOutlet as M, AudioStatus as Mn, Define as Mr, ActionEntry as Mt, AudioElementLike as N, AnimateOptions as Nn, Inject as Nr, ChannelErrorEntry as Nt, observeMediaQuery as O, AudioRequest as On, findUnplainPath as Or, ShellHistoryMode as Ot, AudioSink as P, AnimationService as Pn, Input as Pr, CommandEntry as Pt, MemoryStorage as Q, UiEnvironmentReport as Qn, Mutation as Qr, UI_FRAME_PHASES as Qt, audioClock as R, ShellFile as Rn, controlled as Rr, FrameEntry as Rt, writeClipboard as S, RouteParams as Sn, structurallyEqual as Sr, CreateAppOptions as St, EditingService as T, parseUrl as Tn, ChannelRegistration as Tr, WorkerApp as Tt, ShellStorage as U, ShellRequest as Un, ShowProps as Ur, RuntimeErrorSource as Ut, PersistedState as V, ShellFileType as Vn, bind as Vr, UiTreeSnapshot as Vt, ShellStorageOptions as W, ShellService as Wn, show as Wr, RuntimeToShellMessage as Wt, OpfsStorageOptions as X, BoundStream as Xn, throttled as Xr, RendererChoice as Xt, OpfsStorage as Y, observeColorScheme as Yn, debounced as Yr, GessoRuntimeOptions as Yt, OpfsWritable as Z, NodePathTarget as Zn, MutateOptions as Zr, RuntimeInput as Zt, EditingMirrorTarget as _, Equality as _i, RouteGuard as _n, OverlayService as _r, GessoApp as _t, UiRole as a, SelectOptions as ai, FontService as an, describeStream as ar, storageReadValue as at, EditingProxy as b, route as bn, FrameworkChild as br, GessoAppBuilder as bt, UiSemanticsPatch as c, FanKey as ci, RouteAnswer as cn, formatNodeReport as cr, UndoableOptions as ct, markNow as d, fanOut as di, RouterRoutes as dn, ComponentHostResolver as dr, UndoStackOptions as dt, Resource as ei, FontFaceDeclaration as en, UiOwnerReport as er, StorageOutcome as et, measureSpan as f, ComputedCell as fi, RouterService as fn, ComponentHost as fr, UndoTransaction as ft, renderRoot as g, DeriveOptions as gi, RouteDefinition as gn, OverlayRect as gr, shellStorageDenied as gt, RenderWorkerApp as h, computed as hi, RouteContext as hn, OverlayPlacement as hr, performShellStorage as ht, UI_SEMANTIC_STATES as i, resource as ii, FontHost as in, UiStreamReport as ir, storageReadFailure as it, PresenceProps as j, AudioState as jn, Channel as jr, ActionCause as jt, observeReducedMotion as k, AudioSample as kn, requirePlainData as kr, ShellHistoryOptions as kt, UiSemanticsRecord$1 as l, FanOut as li, RouteMatch as ln, formatStream as lr, undoable as lt, setPerformanceMarks$1 as m, ReadSource as mi, OutletProps as mn, OverlayEntry as mr, ShellLocalStore as mt, MARK_PREFIX as n, ResourceState as ni, FontFamilyDeclaration as nn, UiPropReport as nr, classifyStorageError as nt, UiSemanticState as o, select as oi, MediaOptions as on, formatAge as or, UndoShortcutOptions as ot, performanceMarksEnabled as p, ComputedOptions as pi, RouteState as pn, OverlayLayer as pr, rememberedDirectory as pt, OpfsDirectory as q, ColorScheme as qn, EachProps as qr, FramePhaseTimings as qt, UI_ROLES as r, ResourceStatus as ri, FontFamilyStatus as rn, UiSemanticsReport as rr, storageErrorMessage as rt, UiSemanticsMap$1 as s, FanCell as si, MediaService as sn, formatNodePath as sr, registerUndoShortcuts as st, EditingState$1 as t, ResourceOptions as ti, FontFaceLike as tn, UiPropOrigin as tr, StorageRead as tt, markInstant as u, FanOutOptions as ui, RouterHistorySink as un, printPropValue as ur, UndoStack as ut, SemanticsMirror as v, derive as vi, RouteOptions as vn, createComponent as vr, GessoAppOptions as vt, ScrollService as w, formatUrl as wn, pickKeys as wr, AppLogicEndpoint as wt, EditingProxySink as x, to as xn, isComponentElement as xr, WebMcpChoice as xt, SemanticsMirrorSink as y, ServiceRegistry as yi, RouteTarget as yn, ComponentElement as yr, createSyncApp as yt, FrameService as z, ShellFileRequest as zn, ThemeTokenCell as zr, PatchEntry as zt };
-//# sourceMappingURL=index-DZbSb8IN.d.ts.map
+export { OpfsStorageOptions as $, BoundStream as $n, Mutation as $r, RendererChoice as $t, observeReducedMotion as A, AudioMetadata as An, findUnplainPath as Ar, ShellHistory as At, InspectionHost as B, UiEasingChoice as Bn, ThemeTokenCell as Br, DevtoolsRequest as Bt, writeClipboard as C, route as Cn, createComponent as Cr, GessoAppBuilder as Ct, TextService as D, formatUrl as Dn, ChannelRegistration as Dr, AppLogicEndpoint as Dt, EditingService as E, buildPath as En, pickKeys as Er, createApp as Et, AudioSink as F, AudioStatus as Fn, Input as Fr, ActionEntry as Ft, persisted as G, ShellRecentFile as Gn, show as Gr, treeText as Gt, FrameService as H, ShellFileRequest as Hn, bind as Hr, PatchEntry as Ht, AudioSinkOptions as I, AnimateOptions as In, Output as Ir, ChannelErrorEntry as It, IndexedDbStorage as J, ShellStorageOp as Jn, EachProps as Jr, ShellToRuntimeMessage as Jt, ShellStorage as K, ShellRequest as Kn, Each as Kr, RuntimeErrorSource as Kt, AudioSinkOutput as L, AnimationService as Ln, ControlledOptions as Lr, CommandEntry as Lt, PresenceProps as M, AudioSample as Mn, Channel as Mr, ShellHistoryOptions as Mt, RouterOutlet as N, AudioService as Nn, Define as Nr, createShellHistory as Nt, FindService as O, parseUrl as On, ChannelRegistryHandle as Or, WorkerApp as Ot, AudioElementLike as P, AudioState as Pn, Inject as Pr, ActionCause as Pt, OpfsStorage as Q, observeColorScheme as Qn, MutateOptions as Qr, GessoRuntimeOptions as Qt, MediaSessionLike as R, SpringOptions as Rn, ControlledValue as Rr, ConsoleEntry as Rt, EditingProxySink as S, RouteTarget as Sn, OverlayService as Sr, createSyncApp as St, ScrollService as T, RouteParams as Tn, pick as Tr, CreateAppOptions as Tt, PersistedOptions as U, ShellFileResult as Un, Show as Ur, UiTreeNode as Ut, InspectionService as V, ShellFile as Vn, themeTokenCell as Vr, FrameEntry as Vt, PersistedState as W, ShellFileType as Wn, ShowProps as Wr, UiTreeSnapshot as Wt, OpfsDirectory as X, ColorScheme as Xn, debounced as Xr, FramePhaseTimings as Xt, IndexedDbStorageOptions as Y, ShellStorageResult as Yn, each as Yr, FrameMetrics as Yt, OpfsFileHandle as Z, ColorSchemePreference as Zn, throttled as Zr, GessoRuntime as Zt, renderRoot as _, DeriveOptions as _i, OutletProps as _n, ComponentHost as _r, ShellLocalStore as _t, UiRole as a, resource as ai, FontFamilyDeclaration as an, UiPropOrigin as ar, classifyStorageError as at, SemanticsMirrorSink as b, RouteGuard as bn, OverlayPlacement as br, GessoApp as bt, UiSemanticsPatch as c, FanCell as ci, FontService as cn, UiStreamReport as cr, storageReadValue as ct, markNow as d, FanOutOptions as di, RouteAnswer as dn, formatNodePath as dr, UndoableOptions as dt, mutate as ei, RuntimeInput as en, NodePathTarget as er, OpfsWritable as et, measureSpan as f, fanOut as fi, RouteMatch as fn, formatNodeReport as fr, undoable as ft, RenderWorkerError as g, computed as gi, RouteState as gn, ComponentHostResolver as gr, rememberedDirectory as gt, RenderWorkerApp as h, ReadSource as hi, RouterService as hn, printPropValue as hr, UndoTransaction as ht, UI_SEMANTIC_STATES as i, ResourceStatus as ii, FontFaceLike as in, UiOwnerReport as ir, StorageRead as it, Presence as j, AudioRequest as jn, requirePlainData as jr, ShellHistoryMode as jt, observeMediaQuery as k, AudioAction as kn, createChannelRegistry as kr, WorkerAppOptions as kt, UiSemanticsRecord$1 as l, FanKey as li, MediaOptions as ln, describeStream as lr, UndoShortcutOptions as lt, setPerformanceMarks$1 as m, ComputedOptions as mi, RouterRoutes as mn, formatStream as mr, UndoStackOptions as mt, MARK_PREFIX as n, ResourceOptions as ni, UiFramePhase as nn, UiNodeReport as nr, StorageAdapter as nt, UiSemanticState as o, SelectOptions as oi, FontFamilyStatus as on, UiPropReport as or, storageErrorMessage as ot, performanceMarksEnabled as p, ComputedCell as pi, RouterHistorySink as pn, formatSourceLocation as pr, UndoStack as pt, ShellStorageOptions as q, ShellService as qn, EachKey as qr, RuntimeToShellMessage as qt, UI_ROLES as r, ResourceState as ri, FontFaceDeclaration as rn, UiOwnerInput as rr, StorageOutcome as rt, UiSemanticsMap$1 as s, select as si, FontHost as sn, UiSemanticsReport as sr, storageReadFailure as st, EditingState$1 as t, Resource as ti, UI_FRAME_PHASES as tn, UiEnvironmentReport as tr, MemoryStorage as tt, markInstant as u, FanOut as ui, MediaService as un, formatAge as ur, registerUndoShortcuts as ut, EditingMirrorTarget as v, Equality as vi, RouteContext as vn, OverlayLayer as vr, performShellStorage as vt, FocusService as w, to as wn, structurallyEqual as wr, WebMcpChoice as wt, EditingProxy as x, RouteOptions as xn, OverlayRect as xr, GessoAppOptions as xt, SemanticsMirror as y, derive as yi, RouteDefinition as yn, OverlayEntry as yr, shellStorageDenied as yt, audioClock as z, UiDuration as zn, controlled as zr, DevtoolsEvent as zt };
+//# sourceMappingURL=index-BENndtaH.d.ts.map