@magmonium/one 0.4.44 → 0.4.47

package/package.json

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

package/types/magmonium-one.d.ts

@@ -809,6 +809,23 @@ export interface MountRoute {
   navId: string;
   params: Record<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;
+};
 export interface NavStoreRef {
   /** Current NavId — route's NavId plus any open Murl segments. */
   id: Signal<string | undefined>;
@@ -883,6 +900,12 @@ export interface NavStoreRef {
    * forgets it. Optional: a host built before it existed provides none.
    */
   setMountRoute?: (name: string, route: MountRoute | undefined) => void;
+  /**
+   * Writes an app's App Identity over the one held — what an Owner's save
+   * hands back, so every AppLogo drawn from it follows. Optional: a host built
+   * before it existed provides none.
+   */
+  setIdentity?: (identity: AppIdentity) => void;
 }
 export declare enum AppRelationType {
   OWNER = 1,
@@ -2621,23 +2644,6 @@ export declare const appColorBrand: (color: string) => {
 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
@@ -10395,14 +10401,21 @@ export declare class RemoteComponent implements OnDestroy {
   private readonly chosenGlyph;
   /**
    * The mounted app's Splash (GLOSSARY.md Splash) while it loads: its AppLogo
-   * on the theme's background. The host's `glyph` first, then the app's own
-   * entry when it has a `glyph` key, else the host's own AppLogo glyph; no
-   * glyph draws the name's first letter. App Color: `appColor`, then Store.
+   * on the theme's background. The host's `glyph`/`appColor` first. An app
+   * the host holds is drawn from its entry — an Open App with no glyph of its
+   * own from the host's AppLogo; one it does not is left to `m-app-logo`,
+   * which asks Store for that link itself (undefined = look it up).
    */
   protected readonly splash: import("@angular/core").Signal<{
+    link: string | undefined;
+    glyph: string | undefined;
+    color: string | undefined;
+    name: undefined;
+  } | {
+    link: string | undefined;
     glyph: string | null;
     color: string | null;
-    name: string;
+    name: string | undefined;
   }>;
   constructor();
   ngOnDestroy(): void;
@@ -11353,6 +11366,36 @@ type TableConfig = Config & {
   selectionActions?: SelectionAction[];
   selectDisableExpression?: string;
   hiddenColumns?: number[];
+  /** The menu every [TableGroup] header carries, by asset name. */
+  groupMenuName?: string;
+  /** Rows drag: within the table, or from one [TableGroup] into another. */
+  draggableRows?: boolean;
+};
+/**
+ * One group of a grouped Table: a full-width header row, then its own rows
+ * under the Table's columns. A grouped Table neither pages nor sorts — the
+ * groups and their order are the caller's.
+ */
+type TableGroup = {
+  id: string;
+  label: string;
+  rows: unknown[][];
+  noTranslate?: boolean;
+  /** The header reads as broken. */
+  error?: boolean;
+  /** No header menu on this group, though the Table names one. */
+  noMenu?: boolean;
+  /** Header menu items this group leaves out. */
+  menuExclude?: string[];
+  /** A trailing ghost button on the header. */
+  actionLabel?: string;
+  actionIcon?: string;
+  /** What an empty group says, over the Table's own `emptyMessage`. */
+  emptyMessage?: string;
+  /** The header drags, among the other draggable headers. */
+  draggable?: boolean;
+  /** Rows may not be dropped into this group. */
+  noDrop?: boolean;
 };
 type SelectionChangeEvent = {
   selectedRows: unknown[][];
@@ -11371,6 +11414,31 @@ type ContextMenuEvent = {
   actionName: string;
   columnKey: string;
   rowData: unknown[];
+  /** The [TableGroup] the row sits in, on a grouped Table. */
+  groupId?: string;
+};
+type GroupMenuEvent = {
+  groupId: string;
+  actionName: string;
+};
+type GroupActionEvent = {
+  groupId: string;
+};
+/**
+ * A row dropped. `toIndex` is the place it lands at in the target group (or
+ * the table), counted before it left: a drop on a header lands first.
+ */
+type RowDropEvent = {
+  fromGroupId?: string;
+  fromIndex: number;
+  toGroupId?: string;
+  toIndex: number;
+  rowData: unknown[];
+};
+/** A group header dropped on another: it takes that header's place. */
+type GroupDropEvent = {
+  groupId: string;
+  toGroupId: string;
 };
 type CellChangeEvent = {
   rowIndex: number;
@@ -11429,6 +11497,16 @@ export declare class TableComponent extends ConfigComponent<TableConfig> {
   readonly searchChanged: import("@angular/core").OutputEmitterRef<SearchChangeEvent>;
   readonly selectionChanged: import("@angular/core").OutputEmitterRef<SelectionChangeEvent>;
   readonly selectionActionClicked: import("@angular/core").OutputEmitterRef<SelectionActionEvent>;
+  /**
+   * The Table drawn as groups ([TableGroup]) rather than from `data`: one
+   * header row and its rows per group, in the order given, unpaged and
+   * unsorted.
+   */
+  readonly groups: import("@angular/core").InputSignal<TableGroup[] | undefined>;
+  readonly groupMenuClicked: import("@angular/core").OutputEmitterRef<GroupMenuEvent>;
+  readonly groupActionClicked: import("@angular/core").OutputEmitterRef<GroupActionEvent>;
+  readonly rowDropped: import("@angular/core").OutputEmitterRef<RowDropEvent>;
+  readonly groupDropped: import("@angular/core").OutputEmitterRef<GroupDropEvent>;
   readonly selectedRows: import("@angular/core").WritableSignal<Set<unknown[]>>;
   readonly selectedCount: import("@angular/core").Signal<number>;
   readonly showSelectionBar: import("@angular/core").Signal<boolean>;
@@ -11472,6 +11550,7 @@ export declare class TableComponent extends ConfigComponent<TableConfig> {
     columnKey: string;
     item: MenuItem;
     rowData: unknown[];
+    groupId?: string;
   }) => void;
   readonly onCellChanged: (event: CellChangeEvent) => void;
   readonly onPageChange: (page: number) => void;
@@ -11527,6 +11606,11 @@ export declare class TableComponent extends ConfigComponent<TableConfig> {
       "required": false;
       "isSignal": true;
     };
+    "groups": {
+      "alias": "groups";
+      "required": false;
+      "isSignal": true;
+    };
     "hiddenColumns": {
       "alias": "hiddenColumns";
       "required": false;
@@ -11547,6 +11631,10 @@ export declare class TableComponent extends ConfigComponent<TableConfig> {
     "searchChanged": "searchChanged";
     "selectionChanged": "selectionChanged";
     "selectionActionClicked": "selectionActionClicked";
+    "groupMenuClicked": "groupMenuClicked";
+    "groupActionClicked": "groupActionClicked";
+    "rowDropped": "rowDropped";
+    "groupDropped": "groupDropped";
   }, never, never, true, never>;
 }
 /**
@@ -12254,7 +12342,8 @@ type AppLogoTone = 'app' | 'light';
  * Fills its box unless `size` is set.
  *
  * What it draws is handed in or looked up: `glyph`, `appColor` and `name`
- * win when set; `link` reads the rest for that app from Store (AppLogoState);
+ * win when set; `link` reads the rest for that app — from AppLogoState when
+ * the host already holds it, else asked of Store once (AppIdentityService);
  * none of the four reads the running app's own AppLogo, as `m-icon app_logo`
  * does (APP_LOGO_SOURCE).
  */
@@ -16816,4 +16905,4 @@ export declare const toggleUid: (audience: Audience, uid: string) => Audience;
 export declare const toggleGroup: (audience: Audience, groupId: string) => Audience;
 /** How many Users and Groups an Audience names. */
 export declare const pickCount: (audience: Audience) => number;
-export type { Accordion, AccordionGroup, AccordionVariant, AppCardData, AppCardInputs, AppCardVariant, AppLogoTone, AppLogoVariant, AppManifest, AppTileData, AssetOption, Audience, AudienceLevel, AudienceMember, AudiencePicker, AuthResult, Badge, BadgePosition, BadgeVariant, Button, ButtonGroup, CellChangeEvent, CellClickEvent, ColBreakpoint, ColSpan, ColorPallet, ColumnDef, Comment, CommentItem, Config, ContextMenu, ContextMenuEvent, Cursor, CustomIcon, DragListReorder, Draggable, DraggableState, FileUploadConfig, FileUploadEvent, FilterGroupContext, FilterGroupMember, FilterOption, FilterPanel, FilterPanelIo, FilterRangeMode, FilterSelectionMap, FilterValue, FilterVariant, FilteredTreeGrid, FlatTreeGridRow, FlexAlign, FlexAlignSelf, FlexConfig, FlexDirection, FlexItemConfig, FlexJustify, FlexVariant, GridAlignX, GridAlignY, GroupKind, Header, HeaderLevel, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, SectionTableSortDirection, SectionTableVariant, SectionToggleItem, SectionToggleItemContext, SelectionAction, SelectionActionEvent, SelectionChangeEvent, SelectorConfig, SharingClient, SharingGroup, SocketMessage, Sort, SortChange, SortChangeEvent, SortOption, SortOrder, SourceAudience, SpacingInward, SqueezeMode, StatAlign, StatCornerEdge, StatCornerPosition, StatCornerSide, StatSurface, StatVariant, TabGroup, TableConfig, TableFilterCondition, TableFilterDef, TextOrNumberInput, Timeline, TimelineItem, TreeGridCellClickEvent, TreeGridLoadChildrenEvent, TreeGridRow, TreeGridRowSelectEvent, TreeGridToggleEvent, User };
+export type { Accordion, AccordionGroup, AccordionVariant, AppCardData, AppCardInputs, AppCardVariant, AppLogoTone, AppLogoVariant, AppManifest, AppTileData, AssetOption, Audience, AudienceLevel, AudienceMember, AudiencePicker, AuthResult, Badge, BadgePosition, BadgeVariant, Button, ButtonGroup, CellChangeEvent, CellClickEvent, ColBreakpoint, ColSpan, ColorPallet, ColumnDef, Comment, CommentItem, Config, ContextMenu, ContextMenuEvent, Cursor, CustomIcon, DragListReorder, Draggable, DraggableState, FileUploadConfig, FileUploadEvent, FilterGroupContext, FilterGroupMember, FilterOption, FilterPanel, FilterPanelIo, FilterRangeMode, FilterSelectionMap, FilterValue, FilterVariant, FilteredTreeGrid, FlatTreeGridRow, FlexAlign, FlexAlignSelf, FlexConfig, FlexDirection, FlexItemConfig, FlexJustify, FlexVariant, GridAlignX, GridAlignY, GroupActionEvent, GroupDropEvent, GroupKind, GroupMenuEvent, Header, HeaderLevel, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, RowDropEvent, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, SectionTableSortDirection, SectionTableVariant, SectionToggleItem, SectionToggleItemContext, SelectionAction, SelectionActionEvent, SelectionChangeEvent, SelectorConfig, SharingClient, SharingGroup, SocketMessage, Sort, SortChange, SortChangeEvent, SortOption, SortOrder, SourceAudience, SpacingInward, SqueezeMode, StatAlign, StatCornerEdge, StatCornerPosition, StatCornerSide, StatSurface, StatVariant, TabGroup, TableConfig, TableFilterCondition, TableFilterDef, TableGroup, TextOrNumberInput, Timeline, TimelineItem, TreeGridCellClickEvent, TreeGridLoadChildrenEvent, TreeGridRow, TreeGridRowSelectEvent, TreeGridToggleEvent, User };