@akcelik/strct 5.3.0 → 5.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",

package/types/akcelik-strct.d.ts

@@ -5034,6 +5034,16 @@ interface StrctFlowEdge {
     style?: 'solid' | 'dashed';
     animated?: boolean;
 }
+/**
+ * A column of a `fan-out` / `tree`, when a heading alone is not enough: a
+ * column that no node lands in is still part of the answer — "Lands on: no
+ * other member" — so it is drawn with its note in it.
+ */
+interface StrctFlowColumn {
+    heading: string;
+    /** What the column says when nothing is in it. Empty keeps it undrawn. */
+    emptyText?: string;
+}
 /** One endpoint in a `StrctFlow`. */
 interface StrctFlowNode {
     /** Stable identity (used as the @for track key). */
@@ -5048,6 +5058,12 @@ interface StrctFlowNode {
     status?: StrctStatus;
     /** Which column this node sits in (`fan-out`). Derived from depth in `tree`. */
     column?: number;
+    /**
+     * How far the node's `status` reaches. `border` (the default) tints the
+     * outline; `surface` tints the whole box — for a node that *is* the finding,
+     * like a blast radius's "Nowhere".
+     */
+    emphasis?: 'border' | 'surface';
     /** Anything the node template needs — chips, a bar, a count. */
     data?: unknown;
 }
@@ -5091,8 +5107,13 @@ declare class StrctFlow {
     readonly layout: _angular_core.InputSignal<"tree" | "chain" | "fan-out">;
     /** The edges of a fan-out / tree. `null` keeps the consecutive chain. */
     readonly edges: _angular_core.InputSignal<StrctFlowEdge[] | null>;
-    /** Column headings, in order. */
-    readonly columns: _angular_core.InputSignal<string[] | null>;
+    /**
+     * Column headings, in order — a string, or a `{ heading, emptyText }` for a
+     * column that must be drawn even when no node lands in it.
+     */
+    readonly columns: _angular_core.InputSignal<readonly (string | StrctFlowColumn)[] | null>;
+    /** The columns as declared, normalised. */
+    private readonly columnDefs;
     private readonly host;
     private readonly destroyRef;
     protected readonly nodeTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
@@ -5102,6 +5123,7 @@ declare class StrctFlow {
     protected readonly columnsView: _angular_core.Signal<{
         index: number;
         heading: string;
+        emptyText: string;
         nodes: StrctFlowNode[];
     }[]>;
     /** What a node says to assistive tech: itself, then where it leads. */
@@ -5164,10 +5186,27 @@ declare class StrctMetricTile {
     readonly href: _angular_core.InputSignal<string | null>;
     /** Makes the whole tile a control that emits `activated`. */
     readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * What a plain click on an `href` tile does. `browser` follows the link, as
+     * today. `app` belongs to a single-page app: the click is prevented and
+     * `activated` fires, so the router navigates and the page is not reloaded —
+     * while a middle click or a modified one (Ctrl / Cmd / Shift / Alt) still
+     * opens the link the way the browser would, because the tile is a real
+     * link, not a button painted like one.
+     */
+    readonly navigate: _angular_core.InputSignal<"browser" | "app">;
     /** Emitted when an `interactive` tile is activated. */
     readonly activated: _angular_core.OutputEmitterRef<void>;
     /** The link / button's name: the KPI and its value, since the tile is the target. */
     protected readonly hitLabel: _angular_core.Signal<string>;
+    /**
+     * A plain primary click on an `href` tile, when `navigate="app"`: the
+     * browser's own navigation is prevented and `activated` carries it, so a
+     * single-page app routes instead of reloading. Anything the browser treats
+     * as "open this somewhere else" — a middle click, Ctrl / Cmd / Shift / Alt,
+     * or a link with a target — is left alone.
+     */
+    protected onHrefClick(event: MouseEvent): void;
     /** Change indicator; sign drives the arrow + colour. Null hides it. */
     readonly delta: _angular_core.InputSignal<number | null>;
     /** Suffix for the delta number. */
@@ -5192,7 +5231,7 @@ declare class StrctMetricTile {
     protected readonly deltaTone: _angular_core.Signal<"flat" | "up" | "down">;
     protected readonly sparkStatus: _angular_core.Signal<StrctChartStatus>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctMetricTile, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMetricTile, "strct-metric-tile", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "captionStatus": { "alias": "captionStatus"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaSuffix": { "alias": "deltaSuffix"; "required": false; "isSignal": true; }; "deltaAriaLabel": { "alias": "deltaAriaLabel"; "required": false; "isSignal": true; }; "invertDelta": { "alias": "invertDelta"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[strctMetricMeter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctMetricTile, "strct-metric-tile", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "captionStatus": { "alias": "captionStatus"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "navigate": { "alias": "navigate"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaSuffix": { "alias": "deltaSuffix"; "required": false; "isSignal": true; }; "deltaAriaLabel": { "alias": "deltaAriaLabel"; "required": false; "isSignal": true; }; "invertDelta": { "alias": "invertDelta"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[strctMetricMeter]"], true, never>;
 }
 
 /**
@@ -6427,6 +6466,14 @@ interface StrctLegendItem {
     muted?: boolean;
     /** Only with `interactive`: the row reads as switched off. */
     off?: boolean;
+    /**
+     * Only with `interactive`: the row cannot be switched at all — a counter
+     * this host does not collect, a series the query cannot answer. Give
+     * `reason` with it: an item that cannot be picked must say why.
+     */
+    disabled?: boolean;
+    /** Why a `disabled` row cannot be picked; its title and its description. */
+    reason?: string;
 }
 /**
  * A chart's key is a component. The same swatch · label · value rows serve a
@@ -6446,17 +6493,24 @@ declare class StrctLegend {
     readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
     /** Rows become toggle buttons carrying `aria-pressed`. */
     readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * `legend` is the key of what is drawn: an off row is struck through,
+     * because it is a series that has been hidden. `picker` is a catalogue —
+     * the counters a host could show — where an off row is simply not picked,
+     * so it stays plain and the picked ones carry a check.
+     */
+    readonly appearance: _angular_core.InputSignal<"legend" | "picker">;
     /** The label of the row that was toggled. */
     readonly itemToggle: _angular_core.OutputEmitterRef<string>;
     /** The status vocabulary's own tokens — 'accent' is `--acc`, not `--accent`. */
     private static readonly TONE;
     protected swatchColor(item: StrctLegendItem): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctLegend, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctLegend, "strct-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; }, { "itemToggle": "itemToggle"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctLegend, "strct-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, { "itemToggle": "itemToggle"; }, never, never, true, never>;
 }
 
 /** Where one step of a watched process has got to. */
-type StrctStepPhase = 'pending' | 'active' | 'done' | 'failed' | 'skipped' | 'blocked';
+type StrctStepPhase = 'planned' | 'pending' | 'active' | 'done' | 'failed' | 'skipped' | 'blocked';
 /** One step of a process the user watches rather than drives. */
 interface StrctStepState {
     id: string;
@@ -6499,13 +6553,20 @@ declare class StrctSteps {
     readonly numbered: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Tighter pills, for one row per host in a long list. */
     readonly dense: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * The list's accessible name — "Migration plan", "Upgrade progress". An
+     * `<ol>` of steps with no name is one of several lists on a page.
+     */
+    readonly label: _angular_core.InputSignal<string>;
+    /** Let a long pill label wrap instead of ending in an ellipsis. */
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The state words read after each label. */
     readonly labels: _angular_core.InputSignal<Partial<StrctStepsLabels>>;
     protected readonly actionTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
     private readonly L;
     protected stateWord(state: StrctStepPhase): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctSteps, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSteps, "strct-steps", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "numbered": { "alias": "numbered"; "required": false; "isSignal": true; }; "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; }, {}, ["actionTpl"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSteps, "strct-steps", never, { "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "numbered": { "alias": "numbered"; "required": false; "isSignal": true; }; "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; }, {}, ["actionTpl"], never, true, never>;
 }
 
 /** What the frame is showing instead of a picture. */
@@ -7492,4 +7553,4 @@ declare function strctCheckHostInputs(host: HTMLElement, selector: string, owns:
 declare function strctCheckHostDisplay(host: HTMLElement, selector: string, expected: string): void;
 
 export { FOCUSABLE_SELECTOR, STRCT_DP_DOW, STRCT_DP_DOW_FULL, STRCT_DP_MONTHS, STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_NOTIFICATION_HISTORY_LIMIT, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAlertActions, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderLeading, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChange, StrctChart, StrctChatAttachment, StrctChatComposer, StrctChatMessage, StrctChatThread, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctControlDescription, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownItemAction, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFieldGroup, StrctFieldHint, StrctFieldPrefix, StrctFieldSuffix, StrctFieldValue, StrctFile, StrctFilterBar, StrctFlow, StrctFlowNodeTemplate, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLegend, StrctList, StrctListItem, StrctListItemDescription, StrctListItemLeading, StrctListItemMeta, StrctListItemTrailing, StrctLiveIndicator, StrctLogViewer, StrctLogin, StrctMediaFrame, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctQr, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderGroup, StrctReorderHandle, StrctReorderItem, StrctResizeHandle, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctStepAction, StrctSteps, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctTagLeading, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWindow, StrctWindowDock, StrctWindowService, StrctWizard, StrctWizardAside, __qrInternals, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctCheckHostDisplay, strctCheckHostInputs, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctQrMatrix, strctValidationIcon, strctValidationTone, unlockBodyScroll };
-export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctChatAuthor, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowEdge, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLegendItem, StrctLiveLabels, StrctLiveState, StrctLogLine, StrctMediaState, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuPlacement, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressSegment, StrctProgressStatus, StrctQrEcc, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctReorderMoveEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctStepPhase, StrctStepState, StrctStepsLabels, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWindowBounds, StrctWindowLabels, StrctWizardDefaults };
+export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctChatAuthor, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowColumn, StrctFlowDirection, StrctFlowEdge, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLegendItem, StrctLiveLabels, StrctLiveState, StrctLogLine, StrctMediaState, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuPlacement, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressSegment, StrctProgressStatus, StrctQrEcc, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctReorderMoveEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctStepPhase, StrctStepState, StrctStepsLabels, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWindowBounds, StrctWindowLabels, StrctWizardDefaults };