@magmonium/one 0.4.36 → 0.4.38

package/package.json

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

package/types/magmonium-one.d.ts

@@ -13041,10 +13041,34 @@ interface NavVisibilityConfig {
 }
 type NavWidgetEntry = Type<unknown> | NavWidgetConfig | NavMenuConfig | NavRowsConfig | NavInstanceConfig | NavVisibilityConfig;
 /**
- * What an app hands `provideNavWidgets`. Keyed by NavId and nothing else — the
- * same string as the nav asset filename and the route stamp (ADR 0014).
+ * Where an app registers its search answer (ADR 0042): the element the host's
+ * search panel mounts in place of its groups, with `query` bound, while the
+ * Address stands inside that app's mount and the query is non-empty. Beside
+ * `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 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, 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;
@@ -13054,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, 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.
@@ -13130,6 +13154,10 @@ export declare class FrameComponent {
     resolvedWidget: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    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>;
@@ -13536,6 +13564,10 @@ export declare const NavStore: import("@angular/core").Type<{
   resolvedWidget: Signal<(NavWidgetConfig & {
     ceSelector?: string;
   }) | null>;
+  searchAnswer: Signal<(NavWidgetConfig & {
+    ceSelector?: string;
+  }) | null>;
+  searchLabel: Signal<string | null>;
   breadcrumb: Signal<BreadCrumb>;
   navMenus: Signal<import("@magmonium/one").BreadcrumbTrail[]>;
   navHasContent: Signal<boolean>;
@@ -14007,6 +14039,10 @@ export declare class NavDetailsComponent {
     resolvedWidget: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    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>;
@@ -14106,10 +14142,22 @@ export declare class NavDetailsComponent {
     visibilityAnswers: Record<string, boolean>;
   }>;
   _device: DeviceService;
+  private readonly _searchStore;
   private readonly _settingsSearch;
   protected readonly Size: typeof Size;
   protected readonly _skeletonItems: number[];
   protected readonly _isInSettings: import("@angular/core").Signal<boolean>;
+  /**
+   * The app's search answer, drawn in place of the search groups only while
+   * the search panel is up and there is text to answer (ADR 0042). The bar
+   * stays in the header and keeps writing `SearchStore`.
+   */
+  protected readonly _searchAnswer: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
+    ceSelector?: string;
+  }) | null>;
+  protected readonly _answerInputs: import("@angular/core").Signal<{
+    query: string;
+  }>;
   protected isScrolledDown: import("@angular/core").Signal<boolean>;
   protected readonly _draggable: import("@angular/core").WritableSignal<Draggable>;
   constructor();
@@ -14244,6 +14292,10 @@ export declare class NavHeaderComponent {
     resolvedWidget: import("@angular/core").Signal<(import("@magmonium/one").NavWidgetConfig & {
       ceSelector?: string;
     }) | null>;
+    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>;
@@ -14362,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>;