@magmonium/one 0.4.41 → 0.4.43

package/types/magmonium-one.d.ts

@@ -714,6 +714,8 @@ export interface LoadingActionsApi {
 export declare class SharedStoreRegistry {
   static setNavStore(store: unknown): void;
   static getNavStore(): unknown;
+  static setAppLogoState(state: unknown): void;
+  static getAppLogoState(): unknown;
   static setLoginStore(store: unknown): void;
   static getLoginStore(): unknown;
   /** First-write-wins: host registers its store; WC bundles reuse it so popups render in the host outlet. */
@@ -747,15 +749,15 @@ export interface RemoteSelectorConfig {
   prefix?: string;
   separator?: string;
 }
+/**
+ * A WC app's runtime wiring. Never its name, description, AppLogo or App
+ * Color — those are the Store App's (nx ADR 0007, `AppIdentity`).
+ */
 export interface WebComponentConfig {
   selector?: string;
   app: string;
-  /** What the app is called, from Store's App — `app` is its link. */
-  name?: string;
   version: string;
-  company?: string;
   timestamp?: string;
-  logo?: string;
   inputs?: string[];
   outputs?: string[];
   autoRegister?: boolean;
@@ -2575,6 +2577,137 @@ export declare abstract class ResizeElementComponent<T extends Config> extends C
   static ɵfac: i0.ɵɵFactoryDeclaration<ResizeElementComponent<any>, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ResizeElementComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
+/**
+ * LogoGlyph rules (nx ADR 0007) — the same allowlist rebuild api runs on
+ * save, so the editor refuses what api would refuse before anything is sent.
+ * api's rebuild is the rule; this one is the early answer.
+ */
+/** The size bound on a LogoGlyph's markup, in UTF-8 bytes. */
+export declare const LOGO_GLYPH_MAX_BYTES: number;
+/** Why a glyph was refused — the codes api answers with. */
+export type LogoGlyphError = '' | 'logo_invalid' | 'logo_too_large';
+/**
+ * A rebuilt glyph. Flat rather than a union: the wc build does not narrow
+ * discriminated unions. `error` is empty on success, `svg` empty on refusal.
+ */
+export type LogoGlyphResult = {
+  svg: string;
+  error: LogoGlyphError;
+};
+/**
+ * The LogoGlyph as it will be stored: shape elements, their geometry and
+ * on/off paint inside a fresh `<svg>` root. Refuses `logo_too_large` over
+ * the size bound and `logo_invalid` for anything not a drawable SVG.
+ */
+export declare function rebuildLogoGlyph(markup: string): LogoGlyphResult;
+/** App Color as stored: `#rrggbb`, lowercased — or undefined when it is not one. */
+export declare const normalizeAppColor: (value: string) => string | undefined;
+/** The AppLogo's shadow: App Color mixed with 20% black. */
+export declare const appLogoShadowColor: (color: string) => string;
+/**
+ * The theme's brand tokens (`mm`, `mmLite`, `mmDark`) as one App Color draws
+ * them — what an app's own boundary paints its `mm` with in place of the
+ * theme's.
+ */
+export declare const appColorBrand: (color: string) => {
+  mm: string;
+  mmLite: string;
+  mmDark: string;
+};
+/**
+ * Whether a white glyph reads poorly over this App Color: contrast under 3:1,
+ * the WCAG floor for graphical objects. A warning, never a refusal.
+ */
+export declare const isLightAppColor: (color: string) => boolean;
+/** A LogoGlyph as a CSS `url(...)`, for painting it through a mask. */
+export declare const logoGlyphMaskUrl: (svg: string) => string;
+/**
+ * What a Store App says about itself (nx ADR 0007), as `GET
+ * store/v1/identity/<link>` answers it. The one source of an app's name,
+ * description, AppLogo and App Color — never a WebComponentConfig.
+ */
+export type AppIdentity = {
+  id: string;
+  link: string;
+  name: string;
+  description: string | null;
+  /** The LogoGlyph, rebuilt from the shape allowlist; null until the Owner sets one. */
+  logoGlyph: string | null;
+  /** App Color, `#rrggbb`; null until the Owner sets one. */
+  appColor: string | null;
+  /** Availability `open` — AppLogo optional, never released as a PWA. */
+  open: boolean;
+};
+/**
+ * Reads App Identity from Store — the one read every surface shares (host
+ * nav, a standalone app's chrome, store cards that hold only a link). One
+ * request per link per session; a failed read is not cached, so the next
+ * ask retries.
+ */
+export declare class AppIdentityService {
+  #private;
+  readonly identity: (link: string) => Observable<AppIdentity | undefined>;
+  /** Drops a link's held read, after its Owner changed it. */
+  readonly forget: (link: string) => void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AppIdentityService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * The reserved icon name that draws the running app's own AppLogo as a glyph
+ * (GLOSSARY.md AppLogoIcon). Never an IconAsset or a file in `icons/`: `m-icon`
+ * reads it from APP_LOGO_SOURCE instead of fetching anything. Its own file so
+ * codegen can read it without Angular.
+ */
+export declare const APP_LOGO_ICON = "app_logo";
+/**
+ * The running app's AppLogo as an icon draws it. `glyph` is a Store App's
+ * LogoGlyph (already rebuilt from the allowlist); `src` is the host's
+ * file-based AppLogo; neither is the first letter of `name`.
+ */
+export type AppLogoSource = {
+  glyph?: string | null;
+  src?: string;
+  name?: string | null;
+  /** App Color, `#rrggbb`, as Store holds it; null until the Owner sets one. */
+  color?: string | null;
+};
+/**
+ * Where NavStore publishes the AppLogo. Shared rather than read off NavStore
+ * because `m-icon` sits below features and cannot import it — and handed to a
+ * mounted WC through SharedStoreRegistry, since a WC reads the host's NavStore.
+ * `logos` is every app NavStore knows the identity of, by AppLink: a host may
+ * mount several at once, so each WC looks up its own. `source` is the fallback.
+ */
+export declare class AppLogoState {
+  #private;
+  readonly source: Signal<AppLogoSource | undefined>;
+  readonly logos: Signal<Record<string, AppLogoSource>>;
+  readonly set: (source: AppLogoSource | undefined) => void;
+  readonly setLogos: (logos: Record<string, AppLogoSource>) => void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AppLogoState, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * What `m-icon name="app_logo"` draws: this app's own entry, by the AppLink
+ * AssetStore holds (a mounted WC's, from `bindApp`), else the fallback. A
+ * visual editor provides its own so the Canvas shows the AppTarget's logo.
+ */
+export declare const APP_LOGO_SOURCE: InjectionToken<Signal<AppLogoSource | undefined>>;
+/**
+ * This app's App Color, which its own boundary paints as the theme's `mm`
+ * (ThemeStore `color`). Unset at the host's root, so the host's chrome keeps
+ * the theme's brand; a WC and a standalone Run provide it from
+ * `appThemeColorFactory`. Unset too while the Owner has set none, and the
+ * theme's own `mm` stands.
+ */
+export declare const APP_THEME_COLOR: InjectionToken<Signal<string | undefined>>;
+/** This app's App Color off the identities NavStore publishes, by its AppLink. */
+export declare const appThemeColorFactory: () => Signal<string | undefined>;
+/**
+ * Paints an App Color's brand tokens onto the element that bounds the app —
+ * every `m.$mm` inside it reads them — or clears them, leaving the theme's.
+ */
+export declare const paintAppColor: (element: HTMLElement, color: string | undefined) => void;
 type ButtonBadge = {
   count?: number;
   variant?: 'default' | 'primary' | 'danger';
@@ -2627,7 +2760,7 @@ export declare class ButtonComponent extends ReactiveElementComponent<Button> {
   navParams: import("@angular/core").InputSignal<Record<string, string | number> | undefined>;
   href: import("@angular/core").InputSignal<string | undefined>;
   disabled: import("@angular/core").InputSignal<boolean | undefined>;
-  variant: import("@angular/core").InputSignal<"ghost" | "primary" | "secondary" | "tab" | undefined>;
+  variant: import("@angular/core").InputSignal<"primary" | "ghost" | "secondary" | "tab" | undefined>;
   name: import("@angular/core").InputSignal<string | undefined>;
   baseUrl: import("@angular/core").InputSignal<string | undefined>;
   one: import("@angular/core").InputSignal<boolean | undefined>;
@@ -2822,16 +2955,19 @@ type CustomIconEdit = {
   linecap: 'butt' | 'round' | 'square';
   linejoin: 'miter' | 'round' | 'bevel';
 };
-type Icon = Partial<Config>;
+type Icon = Partial<Config> & {
+  shadow?: boolean;
+};
 export declare class IconComponent {
-  config: import("@angular/core").ModelSignal<Partial<import("@magmonium/one").Config> | undefined>;
+  config: import("@angular/core").ModelSignal<Icon | undefined>;
   readonly name: import("@angular/core").InputSignal<string | undefined>;
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<string | number | undefined>;
   readonly one: import("@angular/core").InputSignal<boolean | undefined>;
   readonly baseUrl: import("@angular/core").InputSignal<string | undefined>;
   readonly remote: import("@angular/core").InputSignal<string | undefined>;
-  protected readonly resolvedConfig: import("@angular/core").Signal<Partial<import("@magmonium/one").Config> | undefined>;
+  readonly shadow: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
+  protected readonly resolvedConfig: import("@angular/core").Signal<Icon | undefined>;
   private readonly elementRef;
   private readonly sizeContext;
   private readonly assetStore;
@@ -2842,9 +2978,12 @@ export declare class IconComponent {
   private readonly remoteBaseUrl;
   private readonly iconSource;
   private readonly inlineSvg;
+  private readonly appLogoSource;
+  private readonly appLogo;
   private readonly text;
   private readonly pallet;
   constructor();
+  private readonly applyShadow;
   private readonly applySize;
   private readonly updateElement;
   static ɵfac: i0.ɵɵFactoryDeclaration<IconComponent, never>;
@@ -2884,6 +3023,11 @@ export declare class IconComponent {
       "required": false;
       "isSignal": true;
     };
+    "shadow": {
+      "alias": "shadow";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "config": "configChange";
   }, never, ["*"], true, never>;
@@ -3236,7 +3380,7 @@ export declare class ButtonGroupComponent extends ConfigComponent<ButtonGroup> {
     color?: string | keyof import("dist/libs/cli/src").ThemeColor;
     align?: ConfigAlign;
     isLoading?: boolean;
-    variant?: "ghost" | "primary" | "secondary" | "tab" | undefined;
+    variant?: "primary" | "ghost" | "secondary" | "tab" | undefined;
     label?: string;
     noTranslate?: boolean;
     params?: Record<string, string>;
@@ -4598,7 +4742,7 @@ export declare class SectionFilterGroupComponent {
   readonly paddingX: import("@angular/core").InputSignal<boolean | undefined>;
   readonly paddingY: import("@angular/core").InputSignal<boolean | undefined>;
   readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
   readonly config: import("@angular/core").InputSignal<SectionFilterGroupConfig | undefined>;
   /**
    * The whole group's selection, keyed by each Filter's `name` — one key per
@@ -4616,7 +4760,7 @@ export declare class SectionFilterGroupComponent {
   protected readonly resolvedPadding: import("@angular/core").Signal<boolean>;
   protected readonly resolvedPaddingX: import("@angular/core").Signal<boolean>;
   protected readonly resolvedPaddingY: import("@angular/core").Signal<boolean>;
-  protected readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right">;
+  protected readonly resolvedAlign: import("@angular/core").Signal<"left" | "center" | "right">;
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | undefined>;
   protected readonly noBorder: import("@angular/core").Signal<boolean>;
   /**
@@ -4795,7 +4939,7 @@ export declare class SectionStepperComponent implements OnDestroy {
 export declare class SectionBadgesComponent {
   readonly wrap: import("@angular/core").InputSignal<boolean>;
   readonly border: import("@angular/core").InputSignal<boolean>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
   private readonly sectionContext;
   protected readonly hasBorder: import("@angular/core").Signal<boolean>;
   static ɵfac: i0.ɵɵFactoryDeclaration<SectionBadgesComponent, never>;
@@ -4912,7 +5056,7 @@ export declare class SectionToggleComponent<T extends SectionToggleItem = Sectio
 }
 export declare class SectionFooterComponent {
   readonly sticky: import("@angular/core").InputSignal<boolean>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
   private readonly scrollSticky;
   protected readonly isSticky: import("@angular/core").Signal<boolean>;
   private readonly sectionContext;
@@ -4965,7 +5109,7 @@ export declare class SectionPaginationComponent {
    * Entries that are not positive numbers drop rather than throw.
    */
   readonly perPageOptions: import("@angular/core").InputSignal<string | undefined>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right">;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right">;
   readonly showPerPage: import("@angular/core").InputSignal<boolean>;
   /** Hides the band outright once everything fits one page. */
   readonly hideOnSinglePage: import("@angular/core").InputSignal<boolean>;
@@ -5303,7 +5447,7 @@ export declare class SectionComponent extends ConfigComponent<SectionConfig> {
   readonly align: import("@angular/core").InputSignal<SectionAlign | undefined>;
   readonly alignX: import("@angular/core").InputSignal<GridAlignX | undefined>;
   readonly alignY: import("@angular/core").InputSignal<GridAlignY | undefined>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
+  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
   private readonly parentSize;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
   protected readonly sizeLength: import("@angular/core").Signal<string>;
@@ -5443,8 +5587,8 @@ export declare class SectionHeaderComponent {
   readonly visibilityRule: import("@angular/core").InputSignal<((key: string, data?: unknown) => boolean) | undefined>;
   readonly disableRule: import("@angular/core").InputSignal<((key: string, data?: unknown) => boolean) | undefined>;
   readonly extraData: import("@angular/core").InputSignal<unknown>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
-  readonly alignment: import("@angular/core").Signal<"center" | "left" | "right">;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
+  readonly alignment: import("@angular/core").Signal<"left" | "center" | "right">;
   readonly showBack: import("@angular/core").InputSignal<boolean>;
   readonly actionButton: import("@angular/core").InputSignal<string | undefined>;
   readonly actionLabel: import("@angular/core").InputSignal<string | undefined>;
@@ -5461,7 +5605,7 @@ export declare class SectionHeaderComponent {
   protected readonly sidepanel: import("@angular/core").Signal<boolean>;
   protected readonly noBorder: import("@angular/core").Signal<boolean>;
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | undefined>;
-  protected readonly boxAlign: import("@angular/core").Signal<"center" | "left" | "right">;
+  protected readonly boxAlign: import("@angular/core").Signal<"left" | "center" | "right">;
   protected readonly iconBox: import("@angular/core").Signal<string>;
   protected readonly isSticky: import("@angular/core").Signal<boolean>;
   protected readonly hasMenu: import("@angular/core").Signal<boolean>;
@@ -5572,7 +5716,7 @@ export declare class SectionHeaderComponent {
     "actionClick": "actionClick";
     "action": "action";
     "back": "back";
-  }, never, ["*", "m-section-filter-group"], true, never>;
+  }, never, ["m-app-logo", "*", "m-section-filter-group"], true, never>;
 }
 /**
  * Config for `m-section-button-group`. Carries no `names` and no `buttons` —
@@ -5601,7 +5745,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
   readonly vertical: import("@angular/core").InputSignal<boolean | undefined>;
   readonly align: import("@angular/core").InputSignal<ConfigAlign>;
   readonly variant: import("@angular/core").InputSignal<"spaced" | "joined" | undefined>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
+  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean | undefined>;
   private readonly parentSize;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
@@ -5609,7 +5753,7 @@ export declare class SectionButtonGroupComponent extends ConfigComponent<Section
   protected readonly resolvedFullWidth: import("@angular/core").Signal<boolean>;
   protected readonly resolvedVertical: import("@angular/core").Signal<boolean>;
   protected readonly resolvedVariant: import("@angular/core").Signal<"spaced" | "joined">;
-  protected readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right" | "bottom" | "top">;
+  protected readonly resolvedAlign: import("@angular/core").Signal<"left" | "top" | "bottom" | "center" | "right">;
   static ɵfac: i0.ɵɵFactoryDeclaration<SectionButtonGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SectionButtonGroupComponent, "m-section-button-group", never, {
     "vertical": {
@@ -7117,7 +7261,7 @@ declare class DropdownBoxComponent {
 }
 /** The trigger both option Fields draw: a searchable text input and a chevron. */
 declare const DROPDOWN_TEMPLATE = "\n  @if (config(); as dropdown) {\n    @if (dropdown.label) {\n      <m-label\n        [for]=\"dropdown.name ?? ''\"\n        [placeholder]=\"dropdown.label\"\n        [params]=\"dropdown.params\"\n        [required]=\"required()\"\n        [disabled]=\"disabled()\"\n      />\n    }\n    <div\n      class=\"trigger-wrap\"\n      #wrapper\n      [mSelector]=\"selectorConfig()\"\n      [disabled]=\"disabled() || readonly() || !!config()?.readonly\"\n      (opened)=\"onOpened()\"\n      (closed)=\"onClosed()\"\n      (focusin)=\"isFocused.set(true)\"\n      (focusout)=\"isFocused.set(false)\"\n    >\n      <m-text-input\n        [config]=\"triggerInputConfig()\"\n        [value]=\"displayValue()\"\n        [disabled]=\"disabled()\"\n        [invalid]=\"invalid()\"\n        [hideErrors]=\"true\"\n        [(touched)]=\"touched\"\n        [focused]=\"focused()\"\n        (valueChange)=\"onInput($event)\"\n        (click)=\"preventToggleWhenOpen($event)\"\n        (keydown.space)=\"$event.stopPropagation()\"\n        (keydown.enter)=\"onEnter($event)\"\n        (keydown.arrowdown)=\"onArrow($event, 1)\"\n        (keydown.arrowup)=\"onArrow($event, -1)\"\n        (keydown.tab)=\"$event.stopPropagation()\"\n      />\n      <m-button [disabled]=\"disabled()\" [config]=\"chevron()\" />\n    </div>\n    @if (showErrors()) {\n      @for (error of errors(); track $index) {\n        <m-text-output\n          variant=\"footer\"\n          color=\"error\"\n          [label]=\"error.message\"\n        />\n      }\n    }\n  }\n";
-declare const DROPDOWN_IMPORTS: (typeof ButtonComponent | typeof LabelComponent | typeof TextOutputComponent | typeof SelectorDirective | typeof TextInputComponent)[];
+declare const DROPDOWN_IMPORTS: (typeof TextOutputComponent | typeof ButtonComponent | typeof LabelComponent | typeof SelectorDirective | typeof TextInputComponent)[];
 /**
  * Everything a Dropdown and a Multiselect share: the options, the search, the
  * keyboard walk and the panel. What differs is only what the Field holds — one
@@ -8472,14 +8616,14 @@ export declare class SectionFormComponent<T extends object = Record<string, unkn
   readonly heightMode: import("@angular/core").InputSignal<"fixed" | "full" | undefined>;
   readonly maxHeight: import("@angular/core").InputSignal<string | number | undefined>;
   readonly height: import("@angular/core").InputSignal<string | number | undefined>;
-  readonly align: import("@angular/core").InputSignal<"center" | "left" | "right" | undefined>;
+  readonly align: import("@angular/core").InputSignal<"left" | "center" | "right" | undefined>;
   readonly padding: import("@angular/core").InputSignal<string | number | undefined>;
   readonly paddingX: import("@angular/core").InputSignal<string | number | undefined>;
   readonly paddingY: import("@angular/core").InputSignal<string | number | undefined>;
   readonly margin: import("@angular/core").InputSignal<string | number | undefined>;
   readonly marginX: import("@angular/core").InputSignal<string | number | undefined>;
   readonly marginY: import("@angular/core").InputSignal<string | number | undefined>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | Size | undefined>;
+  readonly size: import("@angular/core").InputSignal<Size | "sm" | "md" | "lg" | undefined>;
   readonly autofocus: import("@angular/core").InputSignal<boolean>;
   data: import("@angular/core").InputSignal<T | undefined>;
   readonly dataChange: import("@angular/core").OutputEmitterRef<T>;
@@ -8524,7 +8668,7 @@ export declare class SectionFormComponent<T extends object = Record<string, unkn
   protected readonly handleSubmit: (event: Event) => void;
   readonly resolvedSize: import("@angular/core").Signal<Size>;
   protected readonly sizeLength: import("@angular/core").Signal<string | null>;
-  readonly resolvedAlign: import("@angular/core").Signal<"center" | "left" | "right">;
+  readonly resolvedAlign: import("@angular/core").Signal<"left" | "center" | "right">;
   readonly resolvedVariant: import("@angular/core").Signal<string | undefined>;
   readonly resolvedMaxWidth: import("@angular/core").Signal<string | number | undefined>;
   private readonly resolvedPadding;
@@ -10153,6 +10297,7 @@ export declare class RemoteComponent implements OnDestroy {
   private readonly navRef;
   private readonly reloadPage;
   private readonly assetStore;
+  private readonly appLogoState;
   private loadedElement?;
   /** Bumped per load, so an answer for a link since replaced is dropped. */
   private loadId;
@@ -10205,6 +10350,8 @@ export declare class RemoteComponent implements OnDestroy {
   private readonly carriesQuery;
   private readonly remotePath;
   private readonly ownTail;
+  /** The mounted app's App Color — the `mm` everything inside this mount draws. */
+  private readonly appColor;
   constructor();
   ngOnDestroy(): void;
   private mountName;
@@ -10588,7 +10735,7 @@ export declare class SortComponent extends ConfigComponent<Sort> {
   protected readonly currentSortLabel: import("@angular/core").Signal<string>;
   protected readonly remainingOptions: import("@angular/core").Signal<import("@magmonium/one").SortOption[]>;
   readonly toggleButtonConfig: import("@angular/core").Signal<Button>;
-  readonly menuIconConfig: import("@angular/core").Signal<Partial<Partial<import("@magmonium/one").Config>>>;
+  readonly menuIconConfig: import("@angular/core").Signal<Partial<Icon>>;
   readonly menuItems: import("@angular/core").Signal<MenuItem[][]>;
   readonly menuSelectorConfig: import("@angular/core").Signal<SelectorConfig<ContextMenuBoxComponent>>;
   readonly selectOption: (value: string) => void;
@@ -10669,7 +10816,7 @@ export declare class ImgComponent {
   readonly boxHeight: import("@angular/core").Signal<number | null>;
   readonly isSized: import("@angular/core").Signal<boolean>;
   readonly autoNgSrcset: import("@angular/core").Signal<string | undefined>;
-  readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "loaded">;
+  readonly status: import("@angular/core").WritableSignal<"loading" | "loaded" | "error">;
   readonly effectiveSrc: import("@angular/core").Signal<string | null | undefined>;
   readonly showFallback: import("@angular/core").Signal<boolean>;
   readonly isDataUri: import("@angular/core").Signal<boolean>;
@@ -11013,7 +11160,7 @@ export type DocAiPhase = 'idle' | 'asking' | 'question' | 'outline' | 'writing'
  */
 export declare class DocEditorComponent implements ControlValueAccessor {
   protected readonly groups: readonly import("@magmonium/one").DocToolbarGroup[];
-  protected readonly icons: Record<"code" | "link" | "table" | "strike" | "list" | "bold" | "heading" | "italic" | "quote", string>;
+  protected readonly icons: Record<"list" | "code" | "link" | "table" | "strike" | "bold" | "heading" | "italic" | "quote", string>;
   protected readonly docActionKey: typeof docActionKey;
   private readonly translate;
   protected readonly value: import("@angular/core").WritableSignal<string>;
@@ -11943,20 +12090,20 @@ export declare class ScrollComponent implements OnDestroy {
 }
 type AppCardVariant = 'small' | 'row' | 'card' | 'tile';
 /**
- * Deployed app-wc.json manifest. Card consumes only: name, description,
- * company, version, logo, pwa.color (-> AppCardData.accentColor) and
- * timestamp (-> AppCardData.lastUpdated). Remaining fields ignored.
+ * Deployed app-wc.json manifest. Card consumes only version and timestamp
+ * (-> AppCardData.lastUpdated) — never identity, which is the Store App's
+ * (nx ADR 0007).
  */
-interface AppManifest extends WebComponentConfig$1 {
-  pwa?: {
-    color?: string;
-  };
-}
+type AppManifest = WebComponentConfig$1;
 interface AppCardData {
   id: string;
   name: string;
-  iconUrl?: string;
-  remote?: string;
+  /** The app's AppLink. */
+  link?: string;
+  /** The Store App's LogoGlyph; the AppLogo draws a letter without one. */
+  logoGlyph?: string | null;
+  /** The Store App's App Color — the AppLogo's ground and the card's accent. */
+  appColor?: string | null;
   notificationsCount?: number;
   lastUsed?: number;
   latestNotification?: string;
@@ -11968,9 +12115,6 @@ interface AppCardData {
   statusLabel?: string;
   created?: string;
   version?: string;
-  company?: string;
-  /** Accent tint sourced from deployed manifest pwa.color. */
-  accentColor?: string;
   /** Deployed build time sourced from manifest timestamp. */
   lastUpdated?: string;
 }
@@ -12029,6 +12173,109 @@ export declare class AppCardComponent {
     "actionClick": "actionClick";
   }, never, never, true, never>;
 }
+/**
+ * The one renderer of an AppLogo (nx ADR 0007): the LogoGlyph painted white
+ * over App Color, with a shadow in App Color mixed with 20% black. The glyph
+ * is a mask, never inserted markup — its own colours never show and nothing
+ * in it can run. Without a glyph it draws the name's first letter instead.
+ * Fills its box; the caller sizes the host.
+ */
+export declare class AppLogoComponent {
+  /** The LogoGlyph as Store holds it — already rebuilt from the allowlist. */
+  readonly glyph: import("@angular/core").InputSignal<string | null | undefined>;
+  /** App Color, `#rrggbb`. A neutral ground when unset. */
+  readonly appColor: import("@angular/core").InputSignal<string | null | undefined>;
+  /** The app's name (or AppLink): the accessible label and the letter fallback. */
+  readonly name: import("@angular/core").InputSignal<string | null | undefined>;
+  protected readonly color: import("@angular/core").Signal<string | null>;
+  protected readonly shadow: import("@angular/core").Signal<string | null>;
+  protected readonly mask: import("@angular/core").Signal<string | undefined>;
+  protected readonly letter: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AppLogoComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<AppLogoComponent, "m-app-logo", never, {
+    "glyph": {
+      "alias": "glyph";
+      "required": false;
+      "isSignal": true;
+    };
+    "appColor": {
+      "alias": "appColor";
+      "required": false;
+      "isSignal": true;
+    };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Where an Owner sets a LogoGlyph and App Color (libs/one GLOSSARY
+ * LogoGlyphInput): an SVG uploaded or pasted, rebuilt from the shape
+ * allowlist before it is kept, and a colour — picked, or one of the
+ * suggestions a host offers. Previewed live as the AppLogo it becomes. A
+ * host's AI panel rides the `[logoAi]` slot and writes through the same two
+ * models. Nothing here saves: the host decides when.
+ */
+export declare class LogoGlyphInputComponent {
+  /** The kept LogoGlyph — only ever a rebuilt one. */
+  readonly glyph: import("@angular/core").ModelSignal<string | null>;
+  /** The kept App Color, `#rrggbb`. */
+  readonly appColor: import("@angular/core").ModelSignal<string | null>;
+  /** The app's name: the preview's label and its letter fallback. */
+  readonly name: import("@angular/core").InputSignal<string | null | undefined>;
+  /** Colours a host suggests (an AI's ten); picking one sets App Color. */
+  readonly suggestedColors: import("@angular/core").InputSignal<readonly string[]>;
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /** What was pasted or uploaded, as typed — kept even while it is refused. */
+  protected readonly markup: import("@angular/core").WritableSignal<string>;
+  protected readonly error: import("@angular/core").WritableSignal<LogoGlyphError>;
+  protected readonly errorKey: import("@angular/core").Signal<string | undefined>;
+  protected readonly lightColor: import("@angular/core").Signal<boolean>;
+  protected readonly suggestions: import("@angular/core").Signal<string[]>;
+  /** The form's fields: upload and paste both feed `take`, the colour picker App Color. */
+  protected readonly formData: import("@angular/core").Signal<{
+    logo_glyph_paste: string;
+    app_color: string;
+  }>;
+  private lastUpload;
+  /** Takes markup from any path: kept when it rebuilds, told why when not. */
+  readonly take: (markup: string) => void;
+  protected readonly onForm: (data: Record<string, unknown>) => void;
+  protected readonly pickSuggestion: (color: string) => void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LogoGlyphInputComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<LogoGlyphInputComponent, "m-logo-glyph-input", never, {
+    "glyph": {
+      "alias": "glyph";
+      "required": false;
+      "isSignal": true;
+    };
+    "appColor": {
+      "alias": "appColor";
+      "required": false;
+      "isSignal": true;
+    };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+    "suggestedColors": {
+      "alias": "suggestedColors";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "glyph": "glyphChange";
+    "appColor": "appColorChange";
+  }, never, ["[logoAi]"], true, never>;
+}
 export declare class PlaygroundComponent {
   config: import("@angular/core").InputSignal<unknown>;
   copied: import("@angular/core").WritableSignal<boolean>;
@@ -12798,6 +13045,15 @@ export type BreadcrumbTrail = {
    * Browses into it while the row itself follows it (GLOSSARY.md Browse).
    */
   browsable?: boolean;
+  /**
+   * A row standing for a mounted app draws that app's AppLogo instead of an
+   * icon (nx ADR 0007) — its root carries no `icon:` of its own.
+   */
+  appLogo?: {
+    glyph: string | null;
+    color: string | null;
+    name: string;
+  };
 };
 export type BreadCrumb = {
   trail?: BreadcrumbTrail[];
@@ -13140,6 +13396,7 @@ export declare class FrameComponent {
     remoteWidgets: import("@angular/core").Signal<Record<string, NavWidgetRegistryEntry>>;
     navMap: import("@angular/core").Signal<import("@magmonium/one").NavMap>;
     wcConfigMap: import("@angular/core").Signal<Record<string, import("dist/libs/cli/src").WebComponentConfig>>;
+    identityMap: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppIdentity>>;
     navLoading: import("@angular/core").Signal<boolean>;
     visibilityAnswers: import("@angular/core").Signal<Record<string, boolean>>;
     navigationEnd: import("@angular/core").Signal<import("@angular/router").RouterStateSnapshot>;
@@ -13174,6 +13431,10 @@ export declare class FrameComponent {
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
     currentWcConfig: import("@angular/core").Signal<import("dist/libs/cli/src").WebComponentConfig | undefined>;
+    currentIdentity: import("@angular/core").Signal<import("@magmonium/one").AppIdentity | undefined>;
+    appLogoLink: import("@angular/core").Signal<string | undefined>;
+    appLogo: import("@angular/core").Signal<import("@magmonium/one").AppLogoSource | undefined>;
+    appLogos: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppLogoSource>>;
     activeAppOpen: import("@angular/core").Signal<boolean>;
     transparentNavIds: import("@angular/core").Signal<ReadonlySet<string>>;
     resolvedNavMenuConfig: import("@angular/core").Signal<import("@magmonium/one").NavMenuConfig | null>;
@@ -13220,6 +13481,8 @@ export declare class FrameComponent {
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
     loadWcConfig: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
+    setIdentity: (identity: import("@magmonium/one").AppIdentity) => void;
+    loadIdentity: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
     loadNav: import("@ngrx/signals/rxjs-interop").RxMethod<{
       navId: string;
       appNavId: string | undefined;
@@ -13265,6 +13528,7 @@ export declare class FrameComponent {
     remoteWidgets: Record<string, NavWidgetRegistryEntry>;
     navMap: import("@magmonium/one").NavMap;
     wcConfigMap: Record<string, import("dist/libs/cli/src").WebComponentConfig>;
+    identityMap: Record<string, import("@magmonium/one").AppIdentity>;
     navLoading: boolean;
     visibilityAnswers: Record<string, boolean>;
   }>;
@@ -13485,6 +13749,11 @@ interface NavState {
    */
   navMap: NavMap;
   wcConfigMap: Record<string, WebComponentConfig$1>;
+  /**
+   * Each app's name, AppLogo and App Color as Store holds them (nx ADR 0007),
+   * keyed by AppLink — the chrome's only source of an app's identity.
+   */
+  identityMap: Record<string, AppIdentity>;
   navLoading: boolean;
   /**
    * What an **async** NavVisibilityConfig answered, keyed by NavId and the
@@ -13550,6 +13819,7 @@ export declare const NavStore: import("@angular/core").Type<{
   remoteWidgets: Signal<Record<string, NavWidgetRegistryEntry>>;
   navMap: Signal<NavMap>;
   wcConfigMap: Signal<Record<string, WebComponentConfig$1>>;
+  identityMap: Signal<Record<string, AppIdentity>>;
   navLoading: Signal<boolean>;
   visibilityAnswers: Signal<Record<string, boolean>>;
   navigationEnd: Signal<RouterStateSnapshot>;
@@ -13581,9 +13851,13 @@ export declare const NavStore: import("@angular/core").Type<{
   }) | null>;
   searchLabel: Signal<string | null>;
   breadcrumb: Signal<BreadCrumb>;
-  navMenus: Signal<import("@magmonium/one").BreadcrumbTrail[]>;
+  navMenus: Signal<BreadcrumbTrail[]>;
   navHasContent: Signal<boolean>;
   currentWcConfig: Signal<WebComponentConfig$1 | undefined>;
+  currentIdentity: Signal<AppIdentity | undefined>;
+  appLogoLink: Signal<string | undefined>;
+  appLogo: Signal<AppLogoSource | undefined>;
+  appLogos: Signal<Record<string, AppLogoSource>>;
   activeAppOpen: Signal<boolean>;
   transparentNavIds: Signal<ReadonlySet<string>>;
   resolvedNavMenuConfig: Signal<NavMenuConfig | null>;
@@ -13630,6 +13904,8 @@ export declare const NavStore: import("@angular/core").Type<{
   mountOf: (navId: string) => RemoteMount | undefined;
   setWcConfig: (appLink: string, config: WebComponentConfig$1) => void;
   loadWcConfig: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
+  setIdentity: (identity: AppIdentity) => void;
+  loadIdentity: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
   loadNav: import("@ngrx/signals/rxjs-interop").RxMethod<{
     navId: string;
     appNavId: string | undefined;
@@ -13675,6 +13951,7 @@ export declare const NavStore: import("@angular/core").Type<{
   remoteWidgets: Record<string, NavWidgetRegistryEntry>;
   navMap: NavMap;
   wcConfigMap: Record<string, WebComponentConfig$1>;
+  identityMap: Record<string, AppIdentity>;
   navLoading: boolean;
   visibilityAnswers: Record<string, boolean>;
 }>>;
@@ -13925,14 +14202,23 @@ export declare class NavComponent {
   /** An Open App draws as part of the host: the host's logo, no apps button. */
   protected activeAppOpen: import("@angular/core").Signal<boolean>;
   protected logoPending: import("@angular/core").Signal<boolean>;
+  /**
+   * A WC app's AppLogo is drawn from its Store identity (nx ADR 0007) — its
+   * first letter until the identity arrives or while it has no LogoGlyph. The
+   * host, which is not a Store App, keeps its file-based AppLogo.
+   */
   protected logo: import("@angular/core").Signal<{
-    src: string;
-    alt: string;
     app: string;
-  } | {
-    src: string;
     alt: string;
+    glyph: string | null;
+    color: string | null;
+    src: undefined;
+  } | {
     app: undefined;
+    alt: string;
+    glyph: null;
+    color: null;
+    src: string;
   } | undefined>;
   /**
    * The App Rail below the AppLogo (GLOSSARY.md App Rail): the Main Slot's App,
@@ -13943,8 +14229,8 @@ export declare class NavComponent {
     key: string;
     appNavId: string;
     pending: boolean;
-    src: string | undefined;
-    remote: string | undefined;
+    glyph: string | null;
+    color: string | null;
     alt: string;
     active: boolean;
   }[]>;
@@ -14025,6 +14311,7 @@ export declare class NavDetailsComponent {
     remoteWidgets: import("@angular/core").Signal<Record<string, NavWidgetRegistryEntry>>;
     navMap: import("@angular/core").Signal<import("@magmonium/one").NavMap>;
     wcConfigMap: import("@angular/core").Signal<Record<string, import("dist/libs/cli/src").WebComponentConfig>>;
+    identityMap: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppIdentity>>;
     navLoading: import("@angular/core").Signal<boolean>;
     visibilityAnswers: import("@angular/core").Signal<Record<string, boolean>>;
     navigationEnd: import("@angular/core").Signal<import("@angular/router").RouterStateSnapshot>;
@@ -14059,6 +14346,10 @@ export declare class NavDetailsComponent {
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
     currentWcConfig: import("@angular/core").Signal<import("dist/libs/cli/src").WebComponentConfig | undefined>;
+    currentIdentity: import("@angular/core").Signal<import("@magmonium/one").AppIdentity | undefined>;
+    appLogoLink: import("@angular/core").Signal<string | undefined>;
+    appLogo: import("@angular/core").Signal<import("@magmonium/one").AppLogoSource | undefined>;
+    appLogos: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppLogoSource>>;
     activeAppOpen: import("@angular/core").Signal<boolean>;
     transparentNavIds: import("@angular/core").Signal<ReadonlySet<string>>;
     resolvedNavMenuConfig: import("@angular/core").Signal<import("@magmonium/one").NavMenuConfig | null>;
@@ -14105,6 +14396,8 @@ export declare class NavDetailsComponent {
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
     loadWcConfig: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
+    setIdentity: (identity: import("@magmonium/one").AppIdentity) => void;
+    loadIdentity: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
     loadNav: import("@ngrx/signals/rxjs-interop").RxMethod<{
       navId: string;
       appNavId: string | undefined;
@@ -14150,6 +14443,7 @@ export declare class NavDetailsComponent {
     remoteWidgets: Record<string, NavWidgetRegistryEntry>;
     navMap: import("@magmonium/one").NavMap;
     wcConfigMap: Record<string, import("dist/libs/cli/src").WebComponentConfig>;
+    identityMap: Record<string, import("@magmonium/one").AppIdentity>;
     navLoading: boolean;
     visibilityAnswers: Record<string, boolean>;
   }>;
@@ -14278,6 +14572,7 @@ export declare class NavHeaderComponent {
     remoteWidgets: import("@angular/core").Signal<Record<string, NavWidgetRegistryEntry>>;
     navMap: import("@angular/core").Signal<import("@magmonium/one").NavMap>;
     wcConfigMap: import("@angular/core").Signal<Record<string, import("dist/libs/cli/src").WebComponentConfig>>;
+    identityMap: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppIdentity>>;
     navLoading: import("@angular/core").Signal<boolean>;
     visibilityAnswers: import("@angular/core").Signal<Record<string, boolean>>;
     navigationEnd: import("@angular/core").Signal<import("@angular/router").RouterStateSnapshot>;
@@ -14312,6 +14607,10 @@ export declare class NavHeaderComponent {
     navMenus: import("@angular/core").Signal<import("@magmonium/one").BreadcrumbTrail[]>;
     navHasContent: import("@angular/core").Signal<boolean>;
     currentWcConfig: import("@angular/core").Signal<import("dist/libs/cli/src").WebComponentConfig | undefined>;
+    currentIdentity: import("@angular/core").Signal<import("@magmonium/one").AppIdentity | undefined>;
+    appLogoLink: import("@angular/core").Signal<string | undefined>;
+    appLogo: import("@angular/core").Signal<import("@magmonium/one").AppLogoSource | undefined>;
+    appLogos: import("@angular/core").Signal<Record<string, import("@magmonium/one").AppLogoSource>>;
     activeAppOpen: import("@angular/core").Signal<boolean>;
     transparentNavIds: import("@angular/core").Signal<ReadonlySet<string>>;
     resolvedNavMenuConfig: import("@angular/core").Signal<import("@magmonium/one").NavMenuConfig | null>;
@@ -14358,6 +14657,8 @@ export declare class NavHeaderComponent {
     mountOf: (navId: string) => import("@magmonium/one").RemoteMount | undefined;
     setWcConfig: (appLink: string, config: import("dist/libs/cli/src").WebComponentConfig) => void;
     loadWcConfig: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
+    setIdentity: (identity: import("@magmonium/one").AppIdentity) => void;
+    loadIdentity: import("@ngrx/signals/rxjs-interop").RxMethod<string | undefined>;
     loadNav: import("@ngrx/signals/rxjs-interop").RxMethod<{
       navId: string;
       appNavId: string | undefined;
@@ -14403,6 +14704,7 @@ export declare class NavHeaderComponent {
     remoteWidgets: Record<string, NavWidgetRegistryEntry>;
     navMap: import("@magmonium/one").NavMap;
     wcConfigMap: Record<string, import("dist/libs/cli/src").WebComponentConfig>;
+    identityMap: Record<string, import("@magmonium/one").AppIdentity>;
     navLoading: boolean;
     visibilityAnswers: Record<string, boolean>;
   }>;
@@ -15300,7 +15602,7 @@ type AvatarUser = {
 };
 export declare class UserAvatarComponent {
   user: import("@angular/core").InputSignal<AvatarUser | null | undefined>;
-  variant: import("@angular/core").InputSignal<"rounded" | "square">;
+  variant: import("@angular/core").InputSignal<"square" | "rounded">;
   protected readonly name: import("@angular/core").Signal<string>;
   protected readonly abbr: import("@angular/core").Signal<string>;
   protected readonly profilePic: import("@angular/core").Signal<string | undefined>;
@@ -15722,8 +16024,11 @@ export declare function settingsWidgets(): Record<string, NavWidgetEntry>;
 interface AppTileData {
   id: string;
   name: string;
+  /** An icon name, for a tile that is not an app; an app draws its AppLogo. */
   icon?: string;
-  remote?: string;
+  /** The Store App's LogoGlyph and App Color (nx ADR 0007). */
+  logoGlyph?: string | null;
+  appColor?: string | null;
   link: string;
   isDraft: boolean;
 }
@@ -15734,10 +16039,7 @@ export declare class AppTileComponent {
   readonly openApp: import("@angular/core").OutputEmitterRef<AppTileData>;
   readonly clearAll: import("@angular/core").OutputEmitterRef<void>;
   protected readonly expanded: import("@angular/core").WritableSignal<boolean>;
-  protected readonly fallback = "apps";
   protected readonly icon: import("@angular/core").Signal<string | undefined>;
-  protected readonly remote: import("@angular/core").Signal<string | undefined>;
-  protected readonly isUrl: import("@angular/core").Signal<boolean>;
   protected readonly notificationCount: import("@angular/core").Signal<number>;
   protected readonly expandOrNavigate: (_event: Event) => void;
   protected readonly handleAction: (button: Button | undefined) => void;