@magmonium/one 0.4.79 → 0.4.80

package/package.json

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

package/types/magmonium-one.d.ts

@@ -12021,6 +12021,445 @@ export declare class ScoreSetComponent implements ScoreSetHost {
     "scoreSelect": "scoreSelect";
   }, ["items"], ["m-score-set-item"], true, never>;
 }
+/** A level as a percent change from the current value: 110 vs 100 → +10. */
+export declare const gapPct: (level: number, value: number) => number;
+/** A gap as signed text, one decimal: +12.7%, −1.6%, 0.0%. */
+export declare const formatGap: (gap: number) => string;
+interface LadderScaleInput {
+  /** The featured value — the current price. */
+  value: number;
+  /** Past-window levels and bounds; always on the scale. */
+  levels: readonly number[];
+  /** Forward estimates; on the scale only within `maxSpanPct` of `value`. */
+  forward?: readonly number[];
+  maxSpanPct: number;
+}
+interface LadderScale {
+  /** Position on the axis, 0–100 (%). */
+  pos: (v: number) => number;
+  /** Whether a forward value sits on the scale rather than off its edge. */
+  within: (v: number) => boolean;
+  /** `pos` held to the axis, for a band that runs off it. */
+  clamp: (v: number) => number;
+}
+/**
+ * One linear price axis for a value, its levels and its forward estimates. A
+ * forward value further than `maxSpanPct` from the value is left off the
+ * domain, so one far forecast cannot squeeze every level together.
+ */
+export declare const ladderScale: ({ value, levels, forward, maxSpanPct }: LadderScaleInput) => LadderScale;
+interface LaneItem {
+  key: string;
+  /** Position along the axis, in px. */
+  x: number;
+}
+interface LaneLabel {
+  /** 0 = nearest the axis, 1 = below it. */
+  lane: 0 | 1;
+  /** Where the label is anchored — its first item's position. */
+  x: number;
+  /** Items sharing this label, left to right; more than one when merged. */
+  keys: string[];
+}
+/**
+ * Lays axis labels into two lanes by pixel collision: a label too close to
+ * the last one on the first lane drops to the second; when both are taken it
+ * joins the nearer neighbour as one merged label ("SMA 50 · 100").
+ */
+export declare const layoutLanes: (items: readonly LaneItem[], minGapPx: number) => LaneLabel[];
+/** `line` — one price axis. `list` — rows, highest first. `auto` — list under 360px. */
+type PriceLadderVariant = 'line' | 'list' | 'auto';
+/** `level` — a tick (SMA, EMA). `bound` — a range end-cap (52-week low/high).
+ * `current` / `forecast` — the ladder's own price and forecast, given as a mark. */
+type PriceLadderMarkKind = 'level' | 'bound' | 'current' | 'forecast';
+/** How a host-computed signal reads. `gold` is a golden cross. */
+type PriceLadderTone = 'up' | 'down' | 'warn' | 'gold' | 'neutral';
+/**
+ * Every predefined reading a ladder can take off its levels, in the order a
+ * ladder lists them. Each is the TranslationAsset key of its chip, and
+ * `${rule}-detail` explains it.
+ */
+export declare const PRICE_LADDER_RULES: readonly ["golden-cross", "death-cross", "death-cross-near", "golden-cross-near", "bullish-alignment", "bearish-alignment", "strongly-bullish", "bullish-support", "recovering", "bearish-pressure", "stretched", "far-below-sma-200", "averages-converging", "52w-breakout", "near-52w-high", "new-52w-low", "near-52w-low", "forecast-against-trend", "forecast-above-52w-high"];
+type PriceLadderRule = (typeof PRICE_LADDER_RULES)[number];
+/**
+ * The levels the rules read, by the mark keys a ladder names them with
+ * (`sma50`, `high52w`), plus the ladder's own `value` and `target`.
+ */
+interface LadderLevels {
+  value: number;
+  target?: number | null;
+  sma10?: number | null;
+  sma50?: number | null;
+  sma100?: number | null;
+  sma200?: number | null;
+  low52w?: number | null;
+  high52w?: number | null;
+}
+interface LadderSignal {
+  rule: PriceLadderRule;
+  tone: PriceLadderTone;
+  /** Figures `${rule}-detail` is filled from. */
+  params: Record<string, string>;
+}
+/**
+ * Every predefined rule the levels match, read from one snapshot. A golden or
+ * death cross here is the regime — SMA 50 above or below SMA 200 now — not the
+ * crossing itself: a snapshot holds no date it happened on.
+ */
+export declare const ladderSignals: (levels: LadderLevels, symbol?: string) => LadderSignal[];
+/** Whether a name is one of the predefined rules — `custom` and '' are not. */
+export declare const isLadderRule: (name: unknown) => name is PriceLadderRule;
+interface LadderLevel {
+  /** The mark key — what rules and a ladder's cross pair name it by. */
+  key: string;
+  /** TranslationAsset key a mark takes when it names none of its own. */
+  label: string;
+  kind: PriceLadderMarkKind;
+  /** Tick weight 1–4: the longer the average, the heavier. */
+  rank: number;
+}
+/**
+ * Every level a PriceLadderMark may stand for. The key is fixed rather than
+ * typed because the predefined rules read levels by it — `sma50` and
+ * `high52w` — so a mark keyed anything else is one no rule can see.
+ */
+export declare const PRICE_LADDER_LEVELS: readonly LadderLevel[];
+/** The fixed level a key names, or undefined for a key off the list. */
+export declare const ladderLevelOf: (key: string) => LadderLevel | undefined;
+interface Mark {
+  key: string;
+  name: string;
+  value: number;
+  kind: PriceLadderMarkKind;
+  rank: number;
+}
+/** One chip above the axis, fixed or drawn from a rule. */
+interface Chip {
+  key: string;
+  rule: PriceLadderRule | undefined;
+  label: string;
+  tone: PriceLadderTone;
+  detail: string;
+}
+/**
+ * A value, its reference levels and a forward estimate on one price axis
+ * (research 0108): the current value as a dot, levels as ticks weighted by
+ * `rank`, bounds as end-caps, the estimate as a dashed tick or a band. Shape,
+ * not colour alone, says which is past and which is forward. Finance-agnostic:
+ * what the levels mean arrives as `m-price-ladder-signal` tags from the host.
+ */
+export declare class PriceLadderComponent {
+  /** The featured value — current price. `null` draws a dash. */
+  readonly value: import("@angular/core").InputSignal<number | null | undefined>;
+  /** TranslationAsset key for the featured value. */
+  readonly valueLabel: import("@angular/core").InputSignal<string>;
+  /** Forward point estimate. Missing → no forecast drawn, never the value. */
+  readonly target: import("@angular/core").InputSignal<number | null | undefined>;
+  readonly targetLow: import("@angular/core").InputSignal<number | null | undefined>;
+  readonly targetHigh: import("@angular/core").InputSignal<number | null | undefined>;
+  /** TranslationAsset key for the estimate; `target-price` only for analyst consensus. */
+  readonly targetLabel: import("@angular/core").InputSignal<string>;
+  /** Basis or horizon after the estimate's name, e.g. `1Y`. */
+  readonly targetNote: import("@angular/core").InputSignal<string>;
+  /** A target further than this % from the value is pinned to the axis edge. */
+  readonly maxSpanPct: import("@angular/core").InputSignal<number>;
+  readonly variant: import("@angular/core").InputSignal<PriceLadderVariant>;
+  /** Prefix for every price. */
+  readonly symbol: import("@angular/core").InputSignal<string>;
+  /**
+   * The predefined indicators to show (PRICE_LADDER_RULES), comma- or
+   * space-separated, or `all`. Each draws as a chip while its rule holds; a
+   * golden or death cross shown also brackets SMA 50 and SMA 200.
+   */
+  readonly signals: import("@angular/core").InputSignal<string | readonly string[] | undefined>;
+  /** Keys of two marks to bracket as a crossed pair, e.g. `sma50` and `sma200`. */
+  readonly crossFrom: import("@angular/core").InputSignal<string | undefined>;
+  readonly crossTo: import("@angular/core").InputSignal<string | undefined>;
+  readonly crossTone: import("@angular/core").InputSignal<PriceLadderTone>;
+  private readonly markTags;
+  private readonly signalTags;
+  private readonly translateService;
+  private readonly width;
+  constructor();
+  private readonly t;
+  readonly money: (v: number) => string;
+  private readonly anchor;
+  protected readonly current: import("@angular/core").Signal<number | null>;
+  /** The forecast point: a `forecast` mark, else the `target` input. */
+  private readonly targetPoint;
+  protected readonly shownAs: import("@angular/core").Signal<"line" | "list">;
+  /** Every drawable mark, the `current` and `forecast` stand-ins included. */
+  private readonly everyMark;
+  /** The reference levels drawn as ticks and labels. */
+  protected readonly marks: import("@angular/core").Signal<Mark[]>;
+  /** Every predefined rule the drawn levels match, by rule. */
+  private readonly matched;
+  /** The indicators picked by `signals`: every rule for `all`. */
+  private readonly picked;
+  /**
+   * The chips to draw: a fixed signal as written; a rule signal only while
+   * its rule holds, in the rule's words and tone unless the tag names its own;
+   * then every picked indicator that holds and no tag already shows.
+   */
+  protected readonly chips: import("@angular/core").Signal<Chip[]>;
+  private readonly ruleChip;
+  private readonly tagChips;
+  /**
+   * The pair bracketed as a cross: the one named by `crossFrom`/`crossTo`,
+   * else SMA 50 and SMA 200 while a golden or death cross chip shows.
+   */
+  protected readonly crossPair: import("@angular/core").Signal<{
+    from: string;
+    to: string;
+    tone: PriceLadderTone;
+  } | null>;
+  /** The forward estimate: a point, a range, both, or null. */
+  protected readonly forward: import("@angular/core").Signal<{
+    point: number | null;
+    range: {
+      low: number;
+      high: number;
+    } | null;
+    label: string;
+    name: string;
+    valueText: string;
+    /** As a list row shows it: the point, else the range. */
+    rowText: string;
+    up: boolean;
+    /** Where a list row sorts it. */
+    shown: number;
+  } | null>;
+  /** Everything the `line` layout places, in % along the axis. */
+  protected readonly line: import("@angular/core").Signal<{
+    valuePos: number;
+    ticks: {
+      key: string;
+      kind: PriceLadderMarkKind;
+      rank: number;
+      pos: number;
+    }[];
+    labels: {
+      key: string;
+      lane: 0 | 1;
+      pos: number;
+      bound: boolean;
+      name: string;
+      valueText: string;
+      gapText: string;
+    }[];
+    lanes: number;
+    target: {
+      pos: number;
+      offScale: boolean;
+      point: boolean;
+    } | null;
+    connector: {
+      left: number;
+      width: number;
+    } | null;
+    band: {
+      left: number;
+      width: number;
+    } | null;
+    cross: {
+      tone: PriceLadderTone;
+      left: number;
+      width: number;
+    } | null;
+    bounds: {
+      left: number;
+      width: number;
+    } | null;
+  } | null>;
+  /** Every value as a row, highest first, for the `list` layout. */
+  protected readonly rows: import("@angular/core").Signal<{
+    gapText: string;
+    up: boolean;
+    pos: number;
+    key: string;
+    kind: string;
+    name: string;
+    value: number;
+    valueText: string;
+  }[]>;
+  protected readonly summary: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PriceLadderComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PriceLadderComponent, "m-price-ladder", never, {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "valueLabel": {
+      "alias": "valueLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "target": {
+      "alias": "target";
+      "required": false;
+      "isSignal": true;
+    };
+    "targetLow": {
+      "alias": "targetLow";
+      "required": false;
+      "isSignal": true;
+    };
+    "targetHigh": {
+      "alias": "targetHigh";
+      "required": false;
+      "isSignal": true;
+    };
+    "targetLabel": {
+      "alias": "targetLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "targetNote": {
+      "alias": "targetNote";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxSpanPct": {
+      "alias": "maxSpanPct";
+      "required": false;
+      "isSignal": true;
+    };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "symbol": {
+      "alias": "symbol";
+      "required": false;
+      "isSignal": true;
+    };
+    "signals": {
+      "alias": "signals";
+      "required": false;
+      "isSignal": true;
+    };
+    "crossFrom": {
+      "alias": "crossFrom";
+      "required": false;
+      "isSignal": true;
+    };
+    "crossTo": {
+      "alias": "crossTo";
+      "required": false;
+      "isSignal": true;
+    };
+    "crossTone": {
+      "alias": "crossTone";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["markTags", "signalTags"], never, true, never>;
+}
+/**
+ * One reference level of a price ladder, written as a tag inside
+ * `m-price-ladder` so the levels are markup rather than an array literal. It
+ * draws nothing itself: the ladder reads it and places it on the shared axis.
+ */
+export declare class PriceLadderMarkComponent {
+  /**
+   * Which fixed level this is (`sma50`, `high52w` — PRICE_LADDER_LEVELS):
+   * what the rules and the ladder's `crossFrom`/`crossTo` name it by.
+   */
+  readonly key: import("@angular/core").InputSignal<string>;
+  /** TranslationAsset key naming the level; unset, the key's own (`sma-50`). */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** Missing, NaN or ≤ 0 → the level is not drawn. */
+  readonly value: import("@angular/core").InputSignal<number | null | undefined>;
+  /** Unset, the key's own: `bound` for the 52-week ends, else `level`. */
+  readonly kind: import("@angular/core").InputSignal<PriceLadderMarkKind | undefined>;
+  /** Visual weight 1–4 of a `level` tick; unset, the key's (SMA 10 → 1 … SMA 200 → 4). */
+  readonly rank: import("@angular/core").InputSignal<number | undefined>;
+  /** TranslationAsset key appended to the label, e.g. `support`. */
+  readonly note: import("@angular/core").InputSignal<string | undefined>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PriceLadderMarkComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PriceLadderMarkComponent, "m-price-ladder-mark", never, {
+    "key": {
+      "alias": "key";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "kind": {
+      "alias": "kind";
+      "required": false;
+      "isSignal": true;
+    };
+    "rank": {
+      "alias": "rank";
+      "required": false;
+      "isSignal": true;
+    };
+    "note": {
+      "alias": "note";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * A reading the host draws from the levels (a golden cross, a 52-week
+ * breakout), shown as a chip above the ladder. The ladder does not decide what
+ * the levels mean — that stays with the host, which writes one tag per signal.
+ */
+export declare class PriceLadderSignalComponent {
+  readonly key: import("@angular/core").InputSignal<string>;
+  /**
+   * A predefined reading (`golden-cross`, `52w-breakout`, …). Set, the chip
+   * shows only while the ladder's levels match it, and takes its words, tone
+   * and explanation from the rule. Unset — or any name that is not a rule,
+   * such as `custom` — the chip is the fixed one written.
+   */
+  readonly rule: import("@angular/core").InputSignal<string | undefined>;
+  /** TranslationAsset key for the chip; a rule's own key when blank. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly tone: import("@angular/core").InputSignal<PriceLadderTone>;
+  /** Already-translated explanation, shown as the chip's title. */
+  readonly detail: import("@angular/core").InputSignal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PriceLadderSignalComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PriceLadderSignalComponent, "m-price-ladder-signal", never, {
+    "key": {
+      "alias": "key";
+      "required": false;
+      "isSignal": true;
+    };
+    "rule": {
+      "alias": "rule";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "tone": {
+      "alias": "tone";
+      "required": false;
+      "isSignal": true;
+    };
+    "detail": {
+      "alias": "detail";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 export declare class ImgComponent {
   #private;
   readonly src: import("@angular/core").InputSignal<string | null | undefined>;
@@ -18184,4 +18623,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, 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 };
+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, LadderLevel, LadderLevels, LadderSignal, ListConfig, ListContext, ListItem, ListOrientation, ListVariant, MenuItem, MoneySystem, NavCountConfig, NavInstanceConfig, NavMenuConfig, NavRowsConfig, NavVisibilityConfig, NavVisibleAnswer, NavWidgetConfig, NavWidgetEntry, NavWidgetMap, OverlayWidgetLoader, OverlayWidgetMap, PageChangeEvent, Pagination, PaginationWindow, PriceLadderMarkKind, PriceLadderRule, PriceLadderTone, PriceLadderVariant, 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 };