@oods/component-contracts 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -365,14 +365,23 @@ declare function formatRecordLabel(value: unknown, readableIdentifier?: boolean)
  *
  * Only a `*_name` field names a party: `actor` and `actor_id` are ids, and an entry that names no one renders exactly as
  * it did before, its "Actor: <id>" line included.
+ *
+ * s245-m01: a change someone approved can also point at its approval and name its level of yes:
+ *   approval_id                   the Approval record the yes is kept in: a pointer kept in the record's data, never printed
+ *   approval_level                the level of yes, printed in the words a level is shown in on every screen
+ * "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi (level: Approval)". An entry without a level prints exactly
+ * what it printed before.
  */
 interface HistoryAttribution {
-    /** "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi"; "Ruth Adeyemi" alone for a person acting for herself. */
+    /**
+     * "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi"; "Ruth Adeyemi" alone for a person acting for herself;
+     * "… · approved by Ruth Adeyemi (level: Approval)" when the entry names its level of yes.
+     */
     text: string;
     /** True when the entry names who acted, so its actor id is not printed beside the name. */
     namesActor: boolean;
 }
-/** The phrase for an entry's named parties, or undefined when it names no one. */
+/** The phrase for an entry's named parties and its level of yes, or undefined when it names neither. */
 declare function historyAttribution(entry: unknown): HistoryAttribution | undefined;
 
 /** Preserve generated SVG bytes while admitting only passive, local SVG markup. */

package/dist/index.d.ts

@@ -365,14 +365,23 @@ declare function formatRecordLabel(value: unknown, readableIdentifier?: boolean)
  *
  * Only a `*_name` field names a party: `actor` and `actor_id` are ids, and an entry that names no one renders exactly as
  * it did before, its "Actor: <id>" line included.
+ *
+ * s245-m01: a change someone approved can also point at its approval and name its level of yes:
+ *   approval_id                   the Approval record the yes is kept in: a pointer kept in the record's data, never printed
+ *   approval_level                the level of yes, printed in the words a level is shown in on every screen
+ * "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi (level: Approval)". An entry without a level prints exactly
+ * what it printed before.
  */
 interface HistoryAttribution {
-    /** "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi"; "Ruth Adeyemi" alone for a person acting for herself. */
+    /**
+     * "Billing Agent for Tidewater Co-op · approved by Ruth Adeyemi"; "Ruth Adeyemi" alone for a person acting for herself;
+     * "… · approved by Ruth Adeyemi (level: Approval)" when the entry names its level of yes.
+     */
     text: string;
     /** True when the entry names who acted, so its actor id is not printed beside the name. */
     namesActor: boolean;
 }
-/** The phrase for an entry's named parties, or undefined when it names no one. */
+/** The phrase for an entry's named parties and its level of yes, or undefined when it names neither. */
 declare function historyAttribution(entry: unknown): HistoryAttribution | undefined;
 
 /** Preserve generated SVG bytes while admitting only passive, local SVG markup. */