@joanroucoux/cairn-ui 0.3.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joanroucoux/cairn-ui",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Cairn UI — a monochrome, accessible Angular design system.",
   "keywords": [
     "angular",
@@ -32,6 +32,8 @@
     "@angular/core": "^22.0.0"
   },
   "dependencies": {
+    "d3-scale": "4.0.2",
+    "d3-shape": "3.2.0",
     "tslib": "2.8.1"
   },
   "sideEffects": false,

package/types/joanroucoux-cairn-ui.d.ts

@@ -77,7 +77,7 @@ type AvatarSize = (typeof AVATAR_SIZES)[number];
 declare class UiAvatar {
     readonly initials: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
-    readonly size: _angular_core.InputSignal<"md" | "sm">;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
     protected readonly classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiAvatar, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiAvatar, "ui-avatar", never, { "initials": { "alias": "initials"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -136,7 +136,7 @@ type CardPadding = (typeof CARD_PADDINGS)[number];
  */
 declare class UiCard {
     readonly variant: _angular_core.InputSignal<"default" | "elevated">;
-    readonly padding: _angular_core.InputSignal<"md" | "sm" | "none">;
+    readonly padding: _angular_core.InputSignal<"sm" | "md" | "none">;
     protected readonly classes: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiCard, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiCard, "ui-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -211,6 +211,55 @@ declare class UiDialog {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiDialog, "ui-dialog", never, { "heading": { "alias": "heading"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[dialogActions]"], true, never>;
 }
 
+type DonutSlice = {
+    id: string;
+    label: string;
+    value: number;
+    sublabel?: string;
+};
+type Ramp = 1 | 2 | 3 | 4 | 5 | 6;
+type RankedSlice = DonutSlice & {
+    share: number;
+    ramp: Ramp;
+    members: string[];
+};
+
+type PositionedSlice = RankedSlice & {
+    path: string;
+};
+
+/**
+ * A ring chart with a legend: slices rank from largest to smallest on a grey ramp, and hovering,
+ * focusing or activating a legend row highlights its slice and centres it in the ring.
+ *
+ * @example
+ * <ui-donut [slices]="byAssetClass()" label="Par classe d'actif" othersLabel="Autres" [valueFormat]="formatEur" [shareFormat]="formatShare" (sliceSelect)="goToHoldings($event)" />
+ */
+declare class UiDonut {
+    readonly slices: _angular_core.InputSignal<DonutSlice[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly othersLabel: _angular_core.InputSignal<string>;
+    readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
+    readonly shareFormat: _angular_core.InputSignal<(share: number) => string>;
+    readonly sliceSelect: _angular_core.OutputEmitterRef<string>;
+    protected readonly activeId: _angular_core.WritableSignal<string | null>;
+    protected readonly ranked: _angular_core.Signal<RankedSlice[]>;
+    protected readonly positioned: _angular_core.Signal<PositionedSlice[]>;
+    protected readonly active: _angular_core.Signal<RankedSlice | null>;
+    protected readonly ariaLabel: _angular_core.Signal<string>;
+    protected pathClasses(slice: RankedSlice): string;
+    protected dotClasses(slice: RankedSlice): string;
+    protected rowClasses(slice: RankedSlice): string;
+    protected subLabel(slice: RankedSlice): string;
+    protected arcTransform(slice: RankedSlice): string;
+    protected isActive(slice: RankedSlice): boolean;
+    protected highlight(id: string): void;
+    protected clearHighlight(id: string): void;
+    protected select(slice: RankedSlice): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiDonut, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiDonut, "ui-donut", never, { "slices": { "alias": "slices"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "othersLabel": { "alias": "othersLabel"; "required": true; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "shareFormat": { "alias": "shareFormat"; "required": false; "isSignal": true; }; }, { "sliceSelect": "sliceSelect"; }, never, never, true, never>;
+}
+
 /**
  * Label, control, hint and error as one unit. The control stays a plain native element:
  * the field finds it in its own projected content and wires the ARIA attributes onto it.
@@ -269,7 +318,7 @@ type ControlSize = (typeof CONTROL_SIZES)[number];
  * <input uiInput type="email" placeholder="you@example.com" />
  */
 declare class UiInput implements UiControl {
-    readonly size: _angular_core.InputSignal<"md" | "sm">;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
     readonly errors: _angular_core.InputSignal<readonly UiControlError[]>;
     readonly touched: _angular_core.InputSignal<boolean>;
     protected readonly classes: _angular_core.Signal<string>;
@@ -294,6 +343,81 @@ declare class UiTextarea implements UiControl {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<UiTextarea, "textarea[uiTextarea]", never, { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+type ChartPoint = {
+    t: number;
+    v: number;
+};
+type PlottedPoint = ChartPoint & {
+    x: number;
+    y: number;
+};
+type ChartGeometry = {
+    line: string;
+    end: {
+        x: number;
+        y: number;
+    };
+    start: {
+        y: number;
+    };
+    points: PlottedPoint[];
+    plotBottom: number;
+    plotTop: number;
+};
+
+type StartLabelPlacement = {
+    x: number;
+    y: number;
+    anchor: 'start' | 'end';
+};
+
+type PlotRef = ElementRef<SVGSVGElement>;
+/**
+ * Value over time: a monotone curve with a dashed line at the starting value and a tooltip.
+ *
+ * @example
+ * <ui-line-chart [points]="points" label="Net worth over one month" startLabel="Since" [valueFormat]="formatEur" />
+ */
+declare class UiLineChart {
+    #private;
+    readonly points: _angular_core.InputSignal<ChartPoint[]>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
+    readonly deltaFormat: _angular_core.InputSignal<(delta: number) => string>;
+    readonly timeFormat: _angular_core.InputSignal<(time: number) => string>;
+    readonly axisFormat: _angular_core.InputSignal<(time: number) => string>;
+    readonly startLabel: _angular_core.InputSignal<string>;
+    readonly timeColumnLabel: _angular_core.InputSignal<string>;
+    readonly valueColumnLabel: _angular_core.InputSignal<string>;
+    protected readonly svgRef: _angular_core.Signal<PlotRef>;
+    protected readonly activeIndex: _angular_core.WritableSignal<number | null>;
+    protected readonly animatedLine: _angular_core.WritableSignal<string | null>;
+    protected readonly measuredSize: _angular_core.WritableSignal<{
+        width: number;
+        height: number;
+    } | null>;
+    protected readonly effectiveWidth: _angular_core.Signal<number>;
+    protected readonly effectiveHeight: _angular_core.Signal<number>;
+    protected readonly geometry: _angular_core.Signal<ChartGeometry | null>;
+    protected readonly displayLine: _angular_core.Signal<string>;
+    protected readonly ticks: _angular_core.Signal<PlottedPoint[]>;
+    protected readonly active: _angular_core.Signal<PlottedPoint | null>;
+    protected readonly startLabelInfo: _angular_core.Signal<{
+        label: string;
+        placement: StartLabelPlacement;
+    } | null>;
+    constructor();
+    protected coreTick(index: number, count: number): boolean;
+    protected deltaFor(point: PlottedPoint): number;
+    protected deltaClasses(point: PlottedPoint): string;
+    protected tooltipStyle(point: PlottedPoint): string;
+    protected onPointerMove(event: PointerEvent): void;
+    protected onPointerLeave(): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiLineChart, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiLineChart, "ui-line-chart", never, { "points": { "alias": "points"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "deltaFormat": { "alias": "deltaFormat"; "required": false; "isSignal": true; }; "timeFormat": { "alias": "timeFormat"; "required": false; "isSignal": true; }; "axisFormat": { "alias": "axisFormat"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "timeColumnLabel": { "alias": "timeColumnLabel"; "required": false; "isSignal": true; }; "valueColumnLabel": { "alias": "valueColumnLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * One action of a `ui-menu`; `destructive` paints it in `--negative`.
  *
@@ -363,7 +487,7 @@ declare class UiMeter {
     readonly value: _angular_core.InputSignal<number>;
     readonly label: _angular_core.InputSignal<string>;
     readonly valueText: _angular_core.InputSignal<string>;
-    readonly tone: _angular_core.InputSignal<2 | 1 | 3 | 4 | 5 | 6>;
+    readonly tone: _angular_core.InputSignal<2 | 4 | 1 | 3 | 5 | 6>;
     protected readonly percent: _angular_core.Signal<number>;
     protected readonly fillClasses: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UiMeter, never>;
@@ -437,7 +561,7 @@ declare class UiSegmented {
  * <select uiSelect><option value="pea">PEA</option></select>
  */
 declare class UiSelect implements UiControl {
-    readonly size: _angular_core.InputSignal<"md" | "sm">;
+    readonly size: _angular_core.InputSignal<"sm" | "md">;
     readonly errors: _angular_core.InputSignal<readonly UiControlError[]>;
     readonly touched: _angular_core.InputSignal<boolean>;
     protected readonly classes: _angular_core.Signal<string>;
@@ -454,7 +578,7 @@ declare class UiSelect implements UiControl {
  * <ui-skeleton [lines]="3" />
  */
 declare class UiSkeleton {
-    readonly shape: _angular_core.InputSignal<"figure" | "text" | "row" | "chart" | "ring">;
+    readonly shape: _angular_core.InputSignal<"text" | "figure" | "row" | "chart" | "ring">;
     readonly lines: _angular_core.InputSignal<number>;
     readonly height: _angular_core.InputSignal<number>;
     protected readonly animation = "cairn-pulse var(--pulse-duration) var(--ease-out) infinite alternate";
@@ -572,5 +696,5 @@ declare class UiTab {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UiTab, "a[ui-tab]", never, { "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, ["[tabIcon]", "*"], true, never>;
 }
 
-export { AMOUNT_MASKINGS, AMOUNT_NUMERICS, ASYNC_STATES, AVATAR_SIZES, BADGE_VARIANTS, BUTTON_SIZES, BUTTON_VARIANTS, CARD_PADDINGS, CARD_VARIANTS, CELL_BREAKPOINTS, CONTROL_SIZES, DELTA_EMPHASES, DIALOG_WIDTHS, METER_TONES, STAT_SIZES, UI_AMOUNT_MASKED, UiAmount, UiAsync, UiAvatar, UiBadge, UiButton, UiCard, UiDelta, UiDialog, UiField, UiInput, UiMenu, UiMenuItem, UiMenuTrigger, UiMeter, UiNavItem, UiRow, UiSegmented, UiSelect, UiSkeleton, UiStat, UiSwitch, UiTab, UiTabBar, UiTable, UiTd, UiTextarea, UiTh, UiTr, formatAmount };
-export type { AmountFormatOptions, AmountMasking, AmountNumeric, AsyncState, AvatarSize, BadgeVariant, ButtonSize, ButtonVariant, CardPadding, CardVariant, CellBreakpoint, ControlSize, DeltaEmphasis, DialogWidth, MeterTone, SegmentedOption, StatSize, UiControlError };
+export { AMOUNT_MASKINGS, AMOUNT_NUMERICS, ASYNC_STATES, AVATAR_SIZES, BADGE_VARIANTS, BUTTON_SIZES, BUTTON_VARIANTS, CARD_PADDINGS, CARD_VARIANTS, CELL_BREAKPOINTS, CONTROL_SIZES, DELTA_EMPHASES, DIALOG_WIDTHS, METER_TONES, STAT_SIZES, UI_AMOUNT_MASKED, UiAmount, UiAsync, UiAvatar, UiBadge, UiButton, UiCard, UiDelta, UiDialog, UiDonut, UiField, UiInput, UiLineChart, UiMenu, UiMenuItem, UiMenuTrigger, UiMeter, UiNavItem, UiRow, UiSegmented, UiSelect, UiSkeleton, UiStat, UiSwitch, UiTab, UiTabBar, UiTable, UiTd, UiTextarea, UiTh, UiTr, formatAmount };
+export type { AmountFormatOptions, AmountMasking, AmountNumeric, AsyncState, AvatarSize, BadgeVariant, ButtonSize, ButtonVariant, CardPadding, CardVariant, CellBreakpoint, ChartPoint, ControlSize, DeltaEmphasis, DialogWidth, DonutSlice, MeterTone, SegmentedOption, StatSize, UiControlError };