@akcelik/strct 1.13.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "1.13.0",
+  "version": "1.15.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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy, TemplateRef, PipeTransform } from '@angular/core';
+import { OnDestroy, InjectionToken, Provider, TemplateRef, PipeTransform } from '@angular/core';
 import { SafeHtml, SafeStyle } from '@angular/platform-browser';
 import { ControlValueAccessor } from '@angular/forms';
 import * as _akcelik_strct from '@akcelik/strct';
@@ -1309,10 +1309,12 @@ declare class StrctSubmenu {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctSubmenu, "strct-submenu", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, ["[strctSubmenuLabel]", "*"], true, never>;
 }
 
-/** A single wizard step. `label` names it in the step header. */
+/** A single wizard step. `label` names it in the step header / rail. */
 declare class StrctStep {
     /** Label text. */
     readonly label: _angular_core.InputSignal<string>;
+    /** Rail sublabel (vertical mode; shown while the step is active). */
+    readonly description: _angular_core.InputSignal<string>;
     /** When false, the wizard's Next / Finish is disabled on this step. */
     readonly canAdvance: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly _active;
@@ -1320,17 +1322,73 @@ declare class StrctStep {
     /** @internal */
     setActive(value: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctStep, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctStep, "strct-step", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "canAdvance": { "alias": "canAdvance"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctStep, "strct-step", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "canAdvance": { "alias": "canAdvance"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+/** Marks the live-summary column projected beside a vertical wizard. */
+declare class StrctWizardAside {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctWizardAside, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctWizardAside, "[strctWizardAside]", never, {}, {}, never, never, true, never>;
 }
-/** Multi-step flow with a numbered header and Back / Next / Finish controls. */
+/** App-wide wizard defaults, provided once (see {@link provideStrctWizardDefaults}). */
+interface StrctWizardDefaults {
+    /** Make every wizard vertical unless an instance opts out. */
+    vertical?: boolean;
+}
+declare const STRCT_WIZARD_DEFAULTS: InjectionToken<StrctWizardDefaults>;
+/**
+ * Flip wizard defaults for the whole app — the way to make a house rule like
+ * "steps are always vertical" hold without repeating the attribute:
+ *
+ *   providers: [provideStrctWizardDefaults({ vertical: true })]
+ *
+ * A per-instance binding still wins: `[vertical]="false"` opts one wizard out.
+ */
+declare function provideStrctWizardDefaults(defaults: StrctWizardDefaults): Provider;
+/**
+ * Multi-step flow with Back / Next / Finish controls.
+ *
+ * Default: a numbered horizontal header. With `vertical`, steps become a left
+ * rail — dashed-ring states (idle ⊙ / active ●⊙ / done ✓), a progress bar
+ * with an “n/N” counter, and click-back navigation to visited steps — plus an
+ * optional right column projected via `strctWizardAside` (live summaries).
+ * The rail never flips horizontal: under ~720px of component width it
+ * collapses to a compact vertical ring column (container query).
+ *
+ *   <strct-wizard vertical title="Create virtual machine">
+ *     <strct-step label="Identity" description="Name, environment">…</strct-step>
+ *     …
+ *     <aside strctWizardAside>…live summary…</aside>
+ *   </strct-wizard>
+ */
 declare class StrctWizard {
+    private readonly defaults;
     readonly steps: _angular_core.Signal<readonly StrctStep[]>;
+    protected readonly asideDef: _angular_core.Signal<StrctWizardAside | undefined>;
     readonly current: _angular_core.ModelSignal<number>;
+    /**
+     * Vertical mode: steps become a left rail with dashed-ring states, a
+     * progress bar and click-back navigation; `strctWizardAside` projects a
+     * right column. The rail collapses to a compact vertical ring column under
+     * ~720px of component width — it never flips horizontal.
+     *
+     * The default can be flipped app-wide via `provideStrctWizardDefaults`;
+     * this input always wins when bound.
+     */
+    readonly vertical: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Rail heading shown above the progress bar (vertical mode). */
+    readonly title: _angular_core.InputSignal<string>;
     /** Label for the final-step button (default "Finish"). */
     readonly finishLabel: _angular_core.InputSignal<string>;
-    /** Labels for the Back / Next buttons (localizable). */
+    /** Labels for the Back / Next / Cancel buttons (localizable). */
     readonly backLabel: _angular_core.InputSignal<string>;
     readonly nextLabel: _angular_core.InputSignal<string>;
+    readonly cancelLabel: _angular_core.InputSignal<string>;
+    /** Busy label while `submitting` (localizable). */
+    readonly submittingLabel: _angular_core.InputSignal<string>;
+    /** Counter suffix in the rail: "2/5 {progressLabel}". */
+    readonly progressLabel: _angular_core.InputSignal<string>;
+    /** Accessible name of the vertical step rail. */
+    readonly stepsLabel: _angular_core.InputSignal<string>;
     /** Disable Finish and show a busy label while an async submit is in flight. */
     readonly submitting: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Show a Cancel button on the left. */
@@ -1339,17 +1397,22 @@ declare class StrctWizard {
     readonly finished: _angular_core.OutputEmitterRef<void>;
     /** Emitted when the user clicks Cancel. */
     readonly cancelled: _angular_core.OutputEmitterRef<void>;
-    /** Emits the new step index after a Back / Next move. */
+    /** Emits the new step index after a Back / Next / rail move. */
     readonly stepChange: _angular_core.OutputEmitterRef<number>;
+    /** Furthest step reached — drives the progress bar and rail clickability. */
+    protected readonly maxVisited: _angular_core.WritableSignal<number>;
+    protected readonly progressPct: _angular_core.Signal<number>;
     protected readonly isLast: _angular_core.Signal<boolean>;
     /** Whether the current step permits advancing (its `canAdvance`). */
     protected readonly canAdvance: _angular_core.Signal<boolean>;
     constructor();
     next(): void;
     back(): void;
+    /** Jump to a visited step (rail click). Forward moves still go through Next. */
+    goTo(index: number): void;
     finish(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctWizard, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWizard, "strct-wizard", never, { "current": { "alias": "current"; "required": false; "isSignal": true; }; "finishLabel": { "alias": "finishLabel"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "cancelable": { "alias": "cancelable"; "required": false; "isSignal": true; }; }, { "current": "currentChange"; "finished": "finished"; "cancelled": "cancelled"; "stepChange": "stepChange"; }, ["steps"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctWizard, "strct-wizard", never, { "current": { "alias": "current"; "required": false; "isSignal": true; }; "vertical": { "alias": "vertical"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "finishLabel": { "alias": "finishLabel"; "required": false; "isSignal": true; }; "backLabel": { "alias": "backLabel"; "required": false; "isSignal": true; }; "nextLabel": { "alias": "nextLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "submittingLabel": { "alias": "submittingLabel"; "required": false; "isSignal": true; }; "progressLabel": { "alias": "progressLabel"; "required": false; "isSignal": true; }; "stepsLabel": { "alias": "stepsLabel"; "required": false; "isSignal": true; }; "submitting": { "alias": "submitting"; "required": false; "isSignal": true; }; "cancelable": { "alias": "cancelable"; "required": false; "isSignal": true; }; }, { "current": "currentChange"; "finished": "finished"; "cancelled": "cancelled"; "stepChange": "stepChange"; }, ["steps", "asideDef"], ["*", "[strctWizardAside]"], true, never>;
 }
 
 /**
@@ -4334,5 +4397,5 @@ declare class StrctReorderItem {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctReorderItem, "[strctReorderItem]", never, {}, {}, never, never, true, never>;
 }
 
-export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionMenu, StrctSegmented, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWatermark, StrctWizard, parseAnsi, registerStrctIcon, strctComputeDiff, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone };
-export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus };
+export { STRCT_ICONS, STRCT_ICON_GROUPS, STRCT_ICON_NAMES, STRCT_MASKS, STRCT_PALETTES, STRCT_RAW_ICONS, STRCT_TIME_RANGE_PRESETS, STRCT_WIZARD_DEFAULTS, StrctAccordion, StrctAccordionPanel, StrctAlert, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCascadeHost, StrctCascadeNode, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatepicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctNav, StrctNavItem, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPagination, StrctPassword, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionMenu, StrctSegmented, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, strctComputeDiff, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone };
+export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWizardDefaults };