@operato/board 10.29.8 → 10.29.9

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+### [10.29.9](https://github.com/hatiolab/operato/compare/v10.29.8...v10.29.9) (2026-10-05)
+
+
+### :rocket: New Features
+
+* **board:** ask figures by full name in one batch from one type map release (ADR-0114) ([c422925](https://github.com/hatiolab/operato/commit/c42292525db3f0b9d96d4d2deb2b0e57ada844dd))
+
+
+### :bug: Bug Fix
+
+* **board:** a tray template without a translation shows its description ([8e828c8](https://github.com/hatiolab/operato/commit/8e828c8075dd9f5c0c2463b4ac9aba08b14f3b87))
+
+
+### :mega: Other
+
+* **board:** depend on things-scene 10.1.74 — full figure names (ADR-0114) ([1647ead](https://github.com/hatiolab/operato/commit/1647ead17795dd34ee08c86f16e36db2c0311f95))
+
+
+
 ### [10.29.8](https://github.com/hatiolab/operato/compare/v10.29.7...v10.29.8) (2026-10-05)
 
 **Note:** Version bump only for package @operato/board

package/coverage/lcov-report/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">47.34% </span>
+                <span class="strong">48.17% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>1542/3257</span>
+                <span class='fraction'>1588/3296</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">59.09% </span>
+                <span class="strong">61.15% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>65/110</span>
+                <span class='fraction'>74/121</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">18.97% </span>
+                <span class="strong">21.27% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>26/137</span>
+                <span class='fraction'>30/141</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">47.34% </span>
+                <span class="strong">48.17% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>1542/3257</span>
+                <span class='fraction'>1588/3296</span>
             </div>
         
             
@@ -80,17 +80,17 @@
 </thead>
 <tbody><tr>
 	<td class="file low" data-value="__wds-outside-root__/1/graphql/src"><a href="__wds-outside-root__/1/graphql/src/index.html">__wds-outside-root__/1/graphql/src</a></td>
-	<td data-value="36.77" class="pic low">
-	<div class="chart"><div class="cover-fill" style="width: 36%"></div><div class="cover-empty" style="width: 64%"></div></div>
+	<td data-value="37.23" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 37%"></div><div class="cover-empty" style="width: 63%"></div></div>
 	</td>
-	<td data-value="36.77" class="pct low">36.77%</td>
-	<td data-value="571" class="abs low">210/571</td>
+	<td data-value="37.23" class="pct low">37.23%</td>
+	<td data-value="564" class="abs low">210/564</td>
 	<td data-value="100" class="pct high">100%</td>
 	<td data-value="1" class="abs high">1/1</td>
 	<td data-value="4.16" class="pct low">4.16%</td>
 	<td data-value="24" class="abs low">1/24</td>
-	<td data-value="36.77" class="pct low">36.77%</td>
-	<td data-value="571" class="abs low">210/571</td>
+	<td data-value="37.23" class="pct low">37.23%</td>
+	<td data-value="564" class="abs low">210/564</td>
 	</tr>
 
 <tr>
@@ -185,17 +185,17 @@
 
 <tr>
 	<td class="file high" data-value="src"><a href="src/index.html">src</a></td>
-	<td data-value="92.2" class="pic high">
-	<div class="chart"><div class="cover-fill" style="width: 92%"></div><div class="cover-empty" style="width: 8%"></div></div>
+	<td data-value="93.22" class="pic high">
+	<div class="chart"><div class="cover-fill" style="width: 93%"></div><div class="cover-empty" style="width: 7%"></div></div>
 	</td>
-	<td data-value="92.2" class="pct high">92.2%</td>
-	<td data-value="308" class="abs high">284/308</td>
-	<td data-value="84.31" class="pct high">84.31%</td>
-	<td data-value="51" class="abs high">43/51</td>
-	<td data-value="84.61" class="pct high">84.61%</td>
-	<td data-value="13" class="abs high">11/13</td>
-	<td data-value="92.2" class="pct high">92.2%</td>
-	<td data-value="308" class="abs high">284/308</td>
+	<td data-value="93.22" class="pct high">93.22%</td>
+	<td data-value="354" class="abs high">330/354</td>
+	<td data-value="83.87" class="pct high">83.87%</td>
+	<td data-value="62" class="abs high">52/62</td>
+	<td data-value="88.23" class="pct high">88.23%</td>
+	<td data-value="17" class="abs high">15/17</td>
+	<td data-value="93.22" class="pct high">93.22%</td>
+	<td data-value="354" class="abs high">330/354</td>
 	</tr>
 
 </tbody>
@@ -206,7 +206,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-09-26T19:21:33.618Z
+                at 2026-10-05T11:51:08.409Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov.info

@@ -195,9 +195,9 @@ TN:
 SF:__wds-outside-root__/1/graphql/src/graphql-env.ts
 FN:44,shouldRetry
 FN:61,ERROR_HANDLER
-FN:146,setClientLink
-FN:150,getClientLink
-FN:173,createMockLink
+FN:139,setClientLink
+FN:143,getClientLink
+FN:166,createMockLink
 FNF:5
 FNH:1
 FNDA:0,shouldRetry
@@ -342,13 +342,13 @@ DA:134,0
 DA:135,0
 DA:136,0
 DA:137,0
-DA:138,0
-DA:139,0
+DA:138,1
+DA:139,1
 DA:140,0
 DA:141,0
-DA:142,0
-DA:143,0
-DA:144,0
+DA:142,1
+DA:143,1
+DA:144,1
 DA:145,1
 DA:146,1
 DA:147,0
@@ -358,8 +358,8 @@ DA:150,1
 DA:151,1
 DA:152,1
 DA:153,1
-DA:154,0
-DA:155,0
+DA:154,1
+DA:155,1
 DA:156,1
 DA:157,1
 DA:158,1
@@ -371,13 +371,13 @@ DA:163,1
 DA:164,1
 DA:165,1
 DA:166,1
-DA:167,1
-DA:168,1
-DA:169,1
-DA:170,1
-DA:171,1
-DA:172,1
-DA:173,1
+DA:167,0
+DA:168,0
+DA:169,0
+DA:170,0
+DA:171,0
+DA:172,0
+DA:173,0
 DA:174,0
 DA:175,0
 DA:176,0
@@ -386,16 +386,9 @@ DA:178,0
 DA:179,0
 DA:180,0
 DA:181,0
-DA:182,0
-DA:183,0
-DA:184,0
-DA:185,0
-DA:186,0
-DA:187,0
-DA:188,0
-LF:188
+LF:181
 LH:86
-BRDA:150,0,0,1
+BRDA:143,0,0,1
 BRF:1
 BRH:1
 end_of_record
@@ -3688,17 +3681,25 @@ BRH:0
 end_of_record
 TN:
 SF:src/figure-provider.ts
-FN:47,registerFigurePayload
-FN:58,fetchFigureBlueprint
-FN:83,createFigureResolver
-FN:84,resolveFigureTypes
-FN:127,installFigureResolver
-FNF:5
-FNH:3
-FNDA:11,registerFigurePayload
-FNDA:0,fetchFigureBlueprint
-FNDA:10,createFigureResolver
-FNDA:10,resolveFigureTypes
+FN:76,fetchFigureBlueprints
+FN:98,setFigureMapChoice
+FN:103,figureMapReleaseOfPage
+FN:108,resetFigureMapPage
+FN:113,sameRelease
+FN:120,createFigureResolver
+FN:121,resolveFigureTypes
+FN:159,registerFigurePayload
+FN:171,installFigureResolver
+FNF:9
+FNH:7
+FNDA:0,fetchFigureBlueprints
+FNDA:2,setFigureMapChoice
+FNDA:4,figureMapReleaseOfPage
+FNDA:9,resetFigureMapPage
+FNDA:2,sameRelease
+FNDA:9,createFigureResolver
+FNDA:12,resolveFigureTypes
+FNDA:9,registerFigurePayload
 FNDA:0,installFigureResolver
 DA:1,1
 DA:2,1
@@ -3747,9 +3748,9 @@ DA:44,1
 DA:45,1
 DA:46,1
 DA:47,1
-DA:48,11
-DA:49,11
-DA:50,11
+DA:48,1
+DA:49,1
+DA:50,1
 DA:51,1
 DA:52,1
 DA:53,1
@@ -3758,102 +3759,156 @@ DA:55,1
 DA:56,1
 DA:57,1
 DA:58,1
-DA:59,0
-DA:60,0
-DA:61,0
-DA:62,0
-DA:63,0
-DA:64,0
-DA:65,0
-DA:66,0
-DA:67,0
-DA:68,0
-DA:69,0
-DA:70,0
-DA:71,0
-DA:72,0
-DA:73,0
-DA:74,0
-DA:75,0
-DA:76,0
-DA:77,1
-DA:78,1
-DA:79,1
-DA:80,1
-DA:81,1
-DA:82,1
-DA:83,1
-DA:84,10
-DA:85,10
-DA:86,10
-DA:87,1
-DA:88,1
-DA:89,9
-DA:90,9
-DA:91,9
-DA:92,9
-DA:93,9
-DA:94,15
-DA:95,15
-DA:96,15
-DA:97,3
-DA:98,3
-DA:99,3
-DA:100,11
-DA:101,11
-DA:102,15
-DA:103,4
+DA:59,1
+DA:60,1
+DA:61,1
+DA:62,1
+DA:63,1
+DA:64,1
+DA:65,1
+DA:66,1
+DA:67,1
+DA:68,1
+DA:69,1
+DA:70,1
+DA:71,1
+DA:72,1
+DA:73,1
+DA:74,1
+DA:75,1
+DA:76,1
+DA:77,0
+DA:78,0
+DA:79,0
+DA:80,0
+DA:81,0
+DA:82,0
+DA:83,0
+DA:84,0
+DA:85,0
+DA:86,0
+DA:87,0
+DA:88,0
+DA:89,0
+DA:90,0
+DA:91,0
+DA:92,0
+DA:93,1
+DA:94,1
+DA:95,1
+DA:96,1
+DA:97,1
+DA:98,1
+DA:99,2
+DA:100,2
+DA:101,1
+DA:102,1
+DA:103,1
 DA:104,4
-DA:105,9
-DA:106,9
-DA:107,9
-DA:108,10
-DA:109,4
-DA:110,4
-DA:111,4
-DA:112,4
-DA:113,4
-DA:114,4
-DA:115,4
-DA:116,4
-DA:117,4
-DA:118,4
-DA:119,10
-DA:120,10
-DA:121,1
-DA:122,1
-DA:123,1
+DA:105,4
+DA:106,1
+DA:107,1
+DA:108,1
+DA:109,9
+DA:110,9
+DA:111,9
+DA:112,1
+DA:113,1
+DA:114,1
+DA:115,1
+DA:116,1
+DA:117,1
+DA:118,1
+DA:119,1
+DA:120,1
+DA:121,9
+DA:122,12
+DA:123,12
 DA:124,1
 DA:125,1
-DA:126,1
-DA:127,1
-DA:128,0
-DA:129,0
-LF:129
-LH:109
-BRDA:47,0,0,11
-BRDA:48,1,0,0
-BRDA:48,2,0,10
-BRDA:48,3,0,1
-BRDA:49,4,0,10
-BRDA:49,5,0,10
-BRDA:49,6,0,0
-BRDA:83,7,0,10
-BRDA:84,8,0,10
-BRDA:86,9,0,1
-BRDA:89,10,0,9
-BRDA:108,11,0,4
-BRDA:85,12,0,19
-BRDA:85,13,0,19
-BRDA:93,14,0,15
-BRDA:96,15,0,14
-BRDA:96,16,0,3
-BRDA:100,17,0,11
-BRDA:102,18,0,4
-BRDA:115,19,0,4
-BRDA:115,20,0,4
-BRF:21
-BRH:19
+DA:126,11
+DA:127,11
+DA:128,11
+DA:129,10
+DA:130,12
+DA:131,8
+DA:132,8
+DA:133,2
+DA:134,2
+DA:135,2
+DA:136,2
+DA:137,2
+DA:138,8
+DA:139,8
+DA:140,8
+DA:141,8
+DA:142,8
+DA:143,8
+DA:144,8
+DA:145,12
+DA:146,9
+DA:147,9
+DA:148,9
+DA:149,9
+DA:150,1
+DA:151,1
+DA:152,9
+DA:153,8
+DA:154,8
+DA:155,8
+DA:156,9
+DA:157,1
+DA:158,1
+DA:159,1
+DA:160,9
+DA:161,0
+DA:162,0
+DA:163,9
+DA:164,9
+DA:165,1
+DA:166,1
+DA:167,1
+DA:168,1
+DA:169,1
+DA:170,1
+DA:171,1
+DA:172,0
+DA:173,0
+LF:173
+LH:153
+BRDA:98,0,0,2
+BRDA:103,1,0,4
+BRDA:108,2,0,9
+BRDA:113,3,0,2
+BRDA:113,4,0,2
+BRDA:113,5,0,2
+BRDA:120,6,0,9
+BRDA:121,7,0,12
+BRDA:123,8,0,1
+BRDA:126,9,0,11
+BRDA:129,10,0,10
+BRDA:130,11,0,8
+BRDA:132,12,0,2
+BRDA:132,13,0,2
+BRDA:138,14,0,6
+BRDA:138,15,0,6
+BRDA:138,16,0,6
+BRDA:138,17,0,6
+BRDA:140,18,0,8
+BRDA:145,19,0,9
+BRDA:146,20,0,0
+BRDA:149,21,0,1
+BRDA:150,22,0,0
+BRDA:153,23,0,8
+BRDA:122,24,0,19
+BRDA:136,25,0,2
+BRDA:142,26,0,4
+BRDA:143,27,0,4
+BRDA:159,28,0,9
+BRDA:160,29,0,0
+BRDA:160,30,0,0
+BRF:31
+BRH:27
 end_of_record
 TN:
 SF:src/ox-board-preview.ts
@@ -4067,9 +4122,9 @@ DA:41,4
 DA:42,4
 DA:43,4
 DA:44,4
-DA:45,2
-DA:46,2
-DA:47,2
+DA:45,4
+DA:46,4
+DA:47,4
 DA:48,2
 DA:49,2
 DA:50,2
@@ -4078,23 +4133,26 @@ DA:52,2
 DA:53,2
 DA:54,2
 DA:55,2
-DA:56,4
-DA:57,4
-DA:58,1
-DA:59,1
-DA:60,3
-DA:61,3
+DA:56,2
+DA:57,2
+DA:58,4
+DA:59,4
+DA:60,1
+DA:61,1
 DA:62,3
-LF:62
-LH:62
+DA:63,3
+DA:64,3
+LF:64
+LH:64
 BRDA:38,0,0,4
-BRDA:44,1,0,2
-BRDA:52,2,0,0
-BRDA:57,3,0,2
-BRDA:57,4,0,1
-BRDA:60,5,0,3
-BRDA:50,6,0,2
-BRDA:51,7,0,2
-BRF:8
-BRH:7
+BRDA:45,1,0,0
+BRDA:47,2,0,2
+BRDA:59,3,0,2
+BRDA:59,4,0,1
+BRDA:62,5,0,3
+BRDA:54,6,0,2
+BRDA:54,7,0,2
+BRDA:54,8,0,2
+BRF:9
+BRH:8
 end_of_record

package/dist/src/figure-provider.d.ts

@@ -1,26 +1,62 @@
+/** Which type map a page draws from: the active one, or the candidate in a preview. */
+export type FigureMapChoice = 'ACTIVE' | 'CANDIDATE';
+/** The type map release a page registered its figures from. */
+export interface FigureMapRelease {
+    map: FigureMapChoice;
+    version: number;
+    revision: number;
+}
+/** What `figureBlueprints` answers: one map release, an item or a refusal per name asked. */
+export interface FigureBlueprintsAnswer {
+    release: {
+        version: number;
+        revision: number;
+    } | null;
+    items: {
+        type: string;
+        ref: string;
+        asset: unknown;
+    }[];
+    refused: {
+        type: string;
+        code: string;
+        message: string;
+    }[];
+}
+export type BlueprintsFetch = (types: readonly string[], map: FigureMapChoice) => Promise<FigureBlueprintsAnswer>;
+/** Why a type was not registered, for the stand-in. The shape things-scene's seat reads. */
+type Refusals = {
+    refused: {
+        type: string;
+        message: string;
+    }[];
+};
+export declare const FIGURE_TYPE_MAP_CHANGED = "figure-type-map-changed";
 /**
- * What the server hands over for one released type: the figure asset. The board does not read the asset; the scene's
- * own registration compiles it with the kernel (ADR-0087 decision 5), which refuses an asset of any other format by
- * its version. A payload without an asset is not a figure this board can draw.
+ * Asks the server. An active map is asked without the argument, so an authoring server whose door
+ * has no `map` (it serves the latest release) answers the same query shape.
  */
-export type FigurePayload = {
-    type: string;
-    asset: any;
-};
-/** Asks for one type's payload. Null when no released figure carries that name. */
-export type BlueprintFetch = (type: string) => Promise<FigurePayload | null>;
-/** Registers one released figure with the scene. Anything but a figure asset is refused by name. */
-export declare function registerFigurePayload(type: string, payload: FigurePayload): void;
-export declare const fetchFigureBlueprint: BlueprintFetch;
+export declare const fetchFigureBlueprints: BlueprintsFetch;
+/** Sets which map this page draws from. A preview page sets CANDIDATE before its board opens. */
+export declare function setFigureMapChoice(next: FigureMapChoice): void;
+/** The map release this page registered its figures from, or null before any (or from an authoring server). */
+export declare function figureMapReleaseOfPage(): FigureMapRelease | null;
+/** For tests: forget the page's map release and draw from the active map again. */
+export declare function resetFigureMapPage(): void;
 /**
  * Builds the resolver that fills things-scene's seat.
  *
  * `fetch` is a seam for tests — the default one talks to the server.
  */
-export declare function createFigureResolver(fetch?: BlueprintFetch): (types: readonly string[]) => Promise<void>;
+export declare function createFigureResolver(fetch?: BlueprintsFetch): (types: readonly string[]) => Promise<Refusals | undefined>;
+/** Registers one figure under the name the board asked. Anything but a figure asset is refused by name. */
+export declare function registerFigurePayload(type: string, payload: {
+    asset?: unknown;
+}): void;
 /**
  * Takes the seat. The package entry (`index.ts`) calls this, so an app that has `@operato/board`
- * gets published figures on its boards without registering anything itself. Returns the function
- * that takes the seat back.
+ * gets figures on its boards without registering anything itself. Returns the function that takes
+ * the seat back.
  */
-export declare function installFigureResolver(fetch?: BlueprintFetch): () => void;
+export declare function installFigureResolver(fetch?: BlueprintsFetch): () => void;
+export {};