@magmonium/one 0.4.37 → 0.4.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magmonium/one",
-  "version": "0.4.37",
+  "version": "0.4.38",
   "description": "Magmonium One — Angular design-system primitives for mm Apps",
   "author": "magmonium",
   "license": "MIT",

package/types/magmonium-one.d.ts

@@ -13047,12 +13047,28 @@ type NavWidgetEntry = Type<unknown> | NavWidgetConfig | NavMenuConfig | NavRowsC
  * `root_search` rather than at it, because a Platform panel stays the host's.
  */
 export declare const SEARCH_ANSWER_KEY = "search_answer";
+/**
+ * Where an app registers the text its own search bar shows in its empty field
+ * (app GLOSSARY.md SearchLabel, ADR 0042): a TranslationAsset key the host's
+ * bar renders through `translate`, so the word follows the Visitor's language
+ * without the app shipping them. Beside `root_search` for the reason
+ * `SEARCH_ANSWER_KEY` is: the panel stays the host's, and this is a word the
+ * host says rather than a body it mounts.
+ *
+ * The only entry in this map that is a string rather than a component.
+ */
+export declare const SEARCH_LABEL_KEY = "search_label";
 /**
  * What an app hands `provideNavWidgets`. Keyed by NavId — the same string as
- * the nav asset filename and the route stamp (ADR 0014) — plus the one
- * non-Nav key, `SEARCH_ANSWER_KEY`.
+ * the nav asset filename and the route stamp (ADR 0014) — plus the two non-Nav
+ * keys, whose values are typed on their own because neither is a Nav's panel:
+ * `SEARCH_ANSWER_KEY` names the element that answers the host's search, and
+ * `SEARCH_LABEL_KEY` names the key the host's search bar is worded by.
  */
-type NavWidgetMap = Partial<Record<NavIdKey | typeof SEARCH_ANSWER_KEY, NavWidgetEntry>>;
+type NavWidgetMap = Partial<Record<NavIdKey, NavWidgetEntry>> & {
+  [SEARCH_ANSWER_KEY]?: NavWidgetEntry;
+  [SEARCH_LABEL_KEY]?: string;
+};
 export declare function isNavMenuConfig(entry: NavWidgetEntry): entry is NavMenuConfig;
 export declare function isNavRowsConfig(entry: NavWidgetEntry): entry is NavRowsConfig;
 export declare function isNavInstanceConfig(entry: NavWidgetEntry): entry is NavInstanceConfig;
@@ -13062,7 +13078,7 @@ export declare function isNavVisibilityConfig(entry: NavWidgetEntry): entry is N
  * Platform Nav panels first so an app registering at the same NavId replaces
  * them (ADR 0016).
  */
-export declare const NAV_WIDGET_MAP: InjectionToken<Signal<Partial<Record<NavIdKey | "search_answer", NavWidgetEntry>>>>;
+export declare const NAV_WIDGET_MAP: InjectionToken<Signal<NavWidgetMap>>;
 /**
  * List of Angular components to register as custom elements for cross-bundle nav widget rendering.
  * Provided by WC apps in their providers so BaseRootWebComponent can register them on bootstrap.
@@ -13141,6 +13157,7 @@ export declare class FrameComponent {
     searchAnswer: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    searchLabel: import("@angular/core").Signal<string | null>;
     breadcrumb: import("@angular/core").Signal<import("@magmonium/one").BreadCrumb>;
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
@@ -13550,6 +13567,7 @@ export declare const NavStore: import("@angular/core").Type<{
   searchAnswer: Signal<(NavWidgetConfig & {
     ceSelector?: string;
   }) | null>;
+  searchLabel: Signal<string | null>;
   breadcrumb: Signal<BreadCrumb>;
   navMenus: Signal<import("@magmonium/one").BreadcrumbTrail[]>;
   navHasContent: Signal<boolean>;
@@ -14024,6 +14042,7 @@ export declare class NavDetailsComponent {
     searchAnswer: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    searchLabel: import("@angular/core").Signal<string | null>;
     breadcrumb: import("@angular/core").Signal<import("@magmonium/one").BreadCrumb>;
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
@@ -14276,6 +14295,7 @@ export declare class NavHeaderComponent {
     searchAnswer: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    searchLabel: import("@angular/core").Signal<string | null>;
     breadcrumb: import("@angular/core").Signal<import("@magmonium/one").BreadCrumb>;
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
@@ -14394,6 +14414,13 @@ export declare class NavHeaderComponent {
   _isUser: import("@angular/core").Signal<boolean>;
   _isSearch: import("@angular/core").Signal<boolean>;
   _hasParent: import("@angular/core").Signal<boolean>;
+  /**
+   * The text the app the Address stands in words its search bar with
+   * (GLOSSARY.md SearchLabel), or `''` where it named none — the bar's input is
+   * a `string` and its own resolution falls through an empty one to the
+   * library's `search`, so nothing has to be told apart here.
+   */
+  _searchLabel: import("@angular/core").Signal<string>;
   _trail: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[] | null>;
   _user: import("@angular/core").Signal<import("@magmonium/one").AuthUser | null>;
   _header: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail | null>;