@magmonium/one 0.4.77 → 0.4.79

package/package.json

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

package/types/magmonium-one.d.ts

@@ -11795,6 +11795,232 @@ export declare class ScoreComponent {
     };
   }, {}, never, never, true, never>;
 }
+/** The band a Score falls in, or `no-data` when it has none. */
+type ScoreBand = 'exceptional' | 'strong' | 'average' | 'weak' | 'no-data';
+/** How a ScoreSet is laid out: ring + bars, or one row of chips. */
+type ScoreSetVariant = 'default' | 'compact';
+/**
+ * The band a Score falls in. Painted on the primary item only — the rest of a
+ * set wear their dimension's own colour, a band being a second colour no bar
+ * fill should carry beside it.
+ */
+export declare const scoreBand: (value: number | null) => ScoreBand;
+/**
+ * The `n` of "Top n%": a Score is a percentile, so what it honestly says is a
+ * standing in the Scored Universe, never a quality reading. Floored at 1 — the
+ * stock that ranks first is in the top 1%, not the top 0%.
+ */
+export declare const scoreStanding: (value: number | null) => number | null;
+/**
+ * Whether a Score Date is older than `staleAfterDays` whole days. A Score that
+ * failed to rescore keeps its old value and its old date, so the date is the
+ * only thing that tells tonight's standing from March's. No date, or one that
+ * does not parse, is not evidence of staleness.
+ */
+export declare const isScoreStale: (scoreDate: string | undefined, today: Date, staleAfterDays: number) => boolean;
+/**
+ * How many identity colours a set has before it reuses one. Six Okabe–Ito
+ * hues, yellow left out for failing contrast on a light surface; the values,
+ * one pair per theme, live in the set's own stylesheet.
+ */
+export declare const SCORE_TONE_COUNT = 6;
+/**
+ * The identity colour of the `index`-th non-primary item — a fixed hue per
+ * dimension, so Momentum is the same colour on every stock whatever its value.
+ */
+export declare const categoricalTone: (index: number) => string;
+/**
+ * What a ScoreSetItem reads off the set it sits in. A token rather than the
+ * component class, so the item and the set do not import each other: the set
+ * decides which item is primary and in what order the rows stand, and each
+ * item draws itself from that.
+ */
+interface ScoreSetHost {
+  readonly variant: Signal<ScoreSetVariant>;
+  readonly bandShown: Signal<boolean>;
+  /** Whether a Score shows "Top n%" beside its number. */
+  readonly standingShown: Signal<boolean>;
+  readonly stale: Signal<boolean>;
+  /** "based on n of m", or '' when every row has a Score. */
+  readonly basis: Signal<string>;
+  /** The item drawn large, or null when none is primary. */
+  readonly primaryItem: Signal<unknown>;
+  /** An item's position among the rows, -1 for the primary. */
+  readonly rowIndex: (item: unknown) => number;
+  /** "Top n%", with the set's peer group when it names one. */
+  readonly standingText: (value: number | null) => string;
+  readonly choose: (key: string) => void;
+}
+declare const SCORE_SET_HOST: InjectionToken<ScoreSetHost>;
+/**
+ * One Score of a ScoreSet, written as a tag inside `m-score-set` so a set's
+ * dimensions are markup rather than an array literal (GLOSSARY.md
+ * ScoreSetItem). It draws itself, in the shape the set gives it — the large
+ * primary or a row — so the tag is the Score's own box: whatever is put on it
+ * (an editor's selection, a test id) lands on what is drawn. Outside a set it
+ * draws nothing.
+ */
+export declare class ScoreSetItemComponent {
+  /**
+   * What the set's `scoreSelect` output emits when this item is chosen. Not
+   * required: an item dropped in the editor has none until it is typed, and a
+   * missing required input would throw in the emitted app.
+   */
+  readonly key: import("@angular/core").InputSignal<string>;
+  /** TranslationAsset key naming the dimension. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** 0–100. `null` is a Score that was not computed — drawn as "—", never 0. */
+  readonly value: import("@angular/core").InputSignal<number | null | undefined>;
+  /** Bare attribute. The first primary item in a set is drawn large. */
+  readonly primary: import("@angular/core").InputSignal<string | boolean | undefined>;
+  /** A ThemeColor key or CSS colour replacing this item's identity colour. */
+  readonly color: import("@angular/core").InputSignal<string | undefined>;
+  /** TranslationAsset key for the tooltip. */
+  readonly description: import("@angular/core").InputSignal<string | undefined>;
+  readonly isPrimary: import("@angular/core").Signal<boolean>;
+  protected readonly set: ScoreSetHost | null;
+  private readonly translateService;
+  private readonly themeStore;
+  protected readonly tipId: string;
+  protected readonly tipDismissed: import("@angular/core").WritableSignal<boolean>;
+  protected readonly shape: import("@angular/core").Signal<"none" | "row" | "primary">;
+  protected readonly tone: import("@angular/core").Signal<string | null>;
+  protected readonly model: import("@angular/core").Signal<{
+    value: number | null;
+    name: string;
+    standing: string;
+    display: string;
+    bandText: string;
+    valueText: string;
+    tip: string;
+  }>;
+  protected readonly choose: () => void | undefined;
+  protected readonly onKeydown: (event: KeyboardEvent) => void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ScoreSetItemComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ScoreSetItemComponent, "m-score-set-item", never, {
+    "key": {
+      "alias": "key";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "primary": {
+      "alias": "primary";
+      "required": false;
+      "isSignal": true;
+    };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
+    "description": {
+      "alias": "description";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Several Scores drawn as one control: a headline, one primary Score drawn
+ * large, and the rest as identity-coloured rows inside (GLOSSARY.md ScoreSet).
+ * It decides which item is primary and in what order the rows stand; each
+ * `m-score-set-item` draws itself from that, so every Score is its own box.
+ * No border, background or radius of its own — what holds it pays for those.
+ */
+export declare class ScoreSetComponent implements ScoreSetHost {
+  /** TranslationAsset key for the headline. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** TranslationAsset key naming the peer group a standing is taken against. */
+  readonly of: import("@angular/core").InputSignal<string | undefined>;
+  /** The run date the Scores were computed on (Score Date), ISO. */
+  readonly scoreDate: import("@angular/core").InputSignal<string | undefined>;
+  /** Whole days a Score Date may age before the set reads as stale. */
+  readonly staleAfterDays: import("@angular/core").InputSignal<number>;
+  /** The band word under the primary. `showBand="false"` drops it. */
+  readonly showBand: import("@angular/core").InputSignal<string | boolean | undefined>;
+  /**
+   * Bare attribute. Shows "Top n%" beside each Score; off, a Score is its
+   * number alone.
+   */
+  readonly showStanding: import("@angular/core").InputSignal<string | boolean | undefined>;
+  /**
+   * `default` — primary ring beside identity-coloured bars. `compact` — one
+   * row of chips, for a table cell or a list row.
+   */
+  readonly variant: import("@angular/core").InputSignal<ScoreSetVariant>;
+  /** The `key` of the item chosen by click, Enter or Space. */
+  readonly scoreSelect: import("@angular/core").OutputEmitterRef<string>;
+  private readonly items;
+  protected readonly id: string;
+  private readonly translateService;
+  protected readonly labelText: import("@angular/core").Signal<string>;
+  readonly bandShown: import("@angular/core").Signal<boolean>;
+  readonly standingShown: import("@angular/core").Signal<boolean>;
+  readonly stale: import("@angular/core").Signal<boolean>;
+  protected readonly dateText: import("@angular/core").Signal<string>;
+  readonly primaryItem: import("@angular/core").Signal<ScoreSetItemComponent | null>;
+  private readonly rows;
+  /** How many rows the primary spans beside, so it centres against them. */
+  protected readonly rowCount: import("@angular/core").Signal<number>;
+  readonly rowIndex: (item: unknown) => number;
+  /**
+   * "based on 4 of 5" when a row has no Score — the primary is a composite of
+   * the rows, so a missing row changes what it means. Empty when all are there.
+   */
+  readonly basis: import("@angular/core").Signal<string>;
+  readonly choose: (key: string) => void;
+  readonly standingText: (value: number | null) => string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ScoreSetComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ScoreSetComponent, "m-score-set", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "of": {
+      "alias": "of";
+      "required": false;
+      "isSignal": true;
+    };
+    "scoreDate": {
+      "alias": "scoreDate";
+      "required": false;
+      "isSignal": true;
+    };
+    "staleAfterDays": {
+      "alias": "staleAfterDays";
+      "required": false;
+      "isSignal": true;
+    };
+    "showBand": {
+      "alias": "showBand";
+      "required": false;
+      "isSignal": true;
+    };
+    "showStanding": {
+      "alias": "showStanding";
+      "required": false;
+      "isSignal": true;
+    };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "scoreSelect": "scoreSelect";
+  }, ["items"], ["m-score-set-item"], true, never>;
+}
 export declare class ImgComponent {
   #private;
   readonly src: import("@angular/core").InputSignal<string | null | undefined>;
@@ -13055,7 +13281,7 @@ export declare class InstrumentScoreComponent {
   readonly variant: import("@angular/core").InputSignal<"compact" | "detailed">;
   readonly showDescription: import("@angular/core").InputSignal<boolean>;
   readonly label: import("@angular/core").InputSignal<string>;
-  readonly status: import("@angular/core").Signal<"no-data" | "exceptional" | "strong" | "average" | "weak">;
+  readonly status: import("@angular/core").Signal<"exceptional" | "strong" | "average" | "weak" | "no-data">;
   readonly hex: import("@angular/core").Signal<"#94a3b8" | "#10b981" | "#3b82f6" | "#f59e0b" | "#ef4444">;
   readonly description: import("@angular/core").Signal<"insufficient-data-to-provide-analysis" | "this-company-shows-exceptional-fundamentals-and-momentum" | "solid-performance-with-good-growth-potential" | "fair-valuation-but-requires-careful-monitoring" | "higher-risk-profile-with-weakening-metrics">;
   static ɵfac: i0.ɵɵFactoryDeclaration<InstrumentScoreComponent, never>;
@@ -17958,4 +18184,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, BadgeCount, 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, HeatSwatchRadius, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavCountConfig, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, RowDropEvent, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionChartConfig, SectionChartPoints, SectionChartScale, SectionChartWindow, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, 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 };
+export type { Accordion, AccordionGroup, AccordionVariant, AppCardData, AppCardInputs, AppCardVariant, AppLogoTone, AppLogoVariant, AppManifest, AppTileData, AssetOption, Audience, AudienceLevel, AudienceMember, AudiencePicker, AuthResult, Badge, BadgeCount, 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, HeatSwatchRadius, Icon, KeyValueVariant, LabelSegment, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavCountConfig, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, ResolvedUserTab, RowDropEvent, ScoreBand, ScoreSetVariant, SearchChangeEvent, SectionAccordion, SectionAccordionGroup, SectionAccordionGroupContext, SectionAccordionRef, SectionButtonGroupConfig, SectionChartConfig, SectionChartPoints, SectionChartScale, SectionChartWindow, SectionFilterGroupConfig, SectionHero, SectionHeroVariant, SectionTableAlign, SectionTableColumn, SectionTableConfig, SectionTableDataType, SectionTableSort, 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 };