@wildwinter/app-shell 0.50.0 → 0.52.0

package/dist/value-control.d.cts

@@ -55,7 +55,15 @@ interface FieldDeclLike extends ValueDeclLike {
     name: string;
     /** What the field is for, shown under the control. */
     purpose?: string;
+    /** A sentence about each value (an enum's values, the flags, a quality's stages), as an extension's manifest
+     *  gives them: the chosen value's is shown under the control, and each chosen flag's. */
+    valueHelp?: Readonly<Record<string, string>>;
 }
+/**
+ * The help for what `decl` holds: the chosen enum value's or stage's (the one it falls back to, when unset), or
+ * each chosen flag's, "name: sentence" a line each. Empty when the declaration describes none of them.
+ */
+declare function valueHelpText(decl: FieldDeclLike, value: unknown): string;
 interface FieldRowOptions {
     decl: FieldDeclLike;
     /** The node's own value, typed (a flags value is a string list), or undefined where the node sets none. */
@@ -88,6 +96,14 @@ declare function fieldValueProblem(decl: ValueDeclLike, value: unknown): string;
  * purpose and any message under it. See the section comment above for the rules it carries.
  */
 declare function fieldRow(initial: FieldRowOptions): FieldRowHandle;
+/**
+ * The focus keeping `fieldRows` does, for a host (or a structured row) that keeps row elements itself: call
+ * `settle` before it updates a row and `restore` once the row is back in the page.
+ */
+declare const fieldRowFocus: {
+    settle: (row: HTMLElement) => void;
+    restore: (row: HTMLElement) => void;
+};
 interface FieldRows {
     /**
      * The row for `key` (a node and a field, say `${nodeId}:${field}`): the same element as last time when
@@ -101,4 +117,4 @@ interface FieldRows {
 /** A cache of field rows for a host that redraws its whole view on every change. */
 declare function fieldRows(): FieldRows;
 
-export { type FieldDeclLike, type FieldRowHandle, type FieldRowOptions, type FieldRows, type FieldValue, type RungStripOptions, type ValueDeclLike, defaultLabel, fallbackText, fieldRow, fieldRows, fieldValueProblem, rungStrip, stageGateNote };
+export { type FieldDeclLike, type FieldRowHandle, type FieldRowOptions, type FieldRows, type FieldValue, type RungStripOptions, type ValueDeclLike, defaultLabel, fallbackText, fieldRow, fieldRowFocus, fieldRows, fieldValueProblem, rungStrip, stageGateNote, valueHelpText };

package/dist/value-control.d.ts

@@ -55,7 +55,15 @@ interface FieldDeclLike extends ValueDeclLike {
     name: string;
     /** What the field is for, shown under the control. */
     purpose?: string;
+    /** A sentence about each value (an enum's values, the flags, a quality's stages), as an extension's manifest
+     *  gives them: the chosen value's is shown under the control, and each chosen flag's. */
+    valueHelp?: Readonly<Record<string, string>>;
 }
+/**
+ * The help for what `decl` holds: the chosen enum value's or stage's (the one it falls back to, when unset), or
+ * each chosen flag's, "name: sentence" a line each. Empty when the declaration describes none of them.
+ */
+declare function valueHelpText(decl: FieldDeclLike, value: unknown): string;
 interface FieldRowOptions {
     decl: FieldDeclLike;
     /** The node's own value, typed (a flags value is a string list), or undefined where the node sets none. */
@@ -88,6 +96,14 @@ declare function fieldValueProblem(decl: ValueDeclLike, value: unknown): string;
  * purpose and any message under it. See the section comment above for the rules it carries.
  */
 declare function fieldRow(initial: FieldRowOptions): FieldRowHandle;
+/**
+ * The focus keeping `fieldRows` does, for a host (or a structured row) that keeps row elements itself: call
+ * `settle` before it updates a row and `restore` once the row is back in the page.
+ */
+declare const fieldRowFocus: {
+    settle: (row: HTMLElement) => void;
+    restore: (row: HTMLElement) => void;
+};
 interface FieldRows {
     /**
      * The row for `key` (a node and a field, say `${nodeId}:${field}`): the same element as last time when
@@ -101,4 +117,4 @@ interface FieldRows {
 /** A cache of field rows for a host that redraws its whole view on every change. */
 declare function fieldRows(): FieldRows;
 
-export { type FieldDeclLike, type FieldRowHandle, type FieldRowOptions, type FieldRows, type FieldValue, type RungStripOptions, type ValueDeclLike, defaultLabel, fallbackText, fieldRow, fieldRows, fieldValueProblem, rungStrip, stageGateNote };
+export { type FieldDeclLike, type FieldRowHandle, type FieldRowOptions, type FieldRows, type FieldValue, type RungStripOptions, type ValueDeclLike, defaultLabel, fallbackText, fieldRow, fieldRowFocus, fieldRows, fieldValueProblem, rungStrip, stageGateNote, valueHelpText };

package/dist/value-control.js

@@ -1,4 +1,4 @@
-export { defaultLabel, fallbackText, fieldRow, fieldRows, fieldValueProblem, rungStrip, stageGateNote } from './chunk-JOFRUWTP.js';
+export { defaultLabel, fallbackText, fieldRow, fieldRowFocus, fieldRows, fieldValueProblem, rungStrip, stageGateNote, valueHelpText } from './chunk-4QDD6GF3.js';
 import './chunk-W4WC4FO5.js';
 //# sourceMappingURL=value-control.js.map
 //# sourceMappingURL=value-control.js.map