@akcelik/strct 4.8.0 → 4.10.0

package/package.json

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

@@ -2367,6 +2367,35 @@ declare class StrctCellStatus {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctCellStatus, "strct-cell-status, [strct-cell-status]", never, { "state": { "alias": "state"; "required": true; "isSignal": true; }; "loadingLabel": { "alias": "loadingLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Text or a control rendered inside the field's box, before the input. */
+declare class StrctFieldPrefix {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctFieldPrefix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldPrefix, "[strctFieldPrefix]", never, {}, {}, never, never, true, never>;
+}
+/** Text or a control rendered inside the field's box, after the input. */
+declare class StrctFieldSuffix {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctFieldSuffix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldSuffix, "[strctFieldSuffix]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * A hint with markup in it, rendered where the string `hint` renders and
+ * carrying the same id, so it is still the control's description.
+ *
+ *   <ng-template strctFieldHint>Hosts with a switch named <strong>{{ n }}</strong> join it.</ng-template>
+ */
+declare class StrctFieldHint {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctFieldHint, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldHint, "ng-template[strctFieldHint]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Wrapper that opts a run of `layout="inline"` fields out of the hairlines
+ * between them — for settings that belong together and should read as one
+ * block.
+ */
+declare class StrctFieldGroup {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctFieldGroup, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StrctFieldGroup, "[strctFieldGroup]", never, {}, {}, never, never, true, never>;
+}
 /**
  * Form-field wrapper: a label (with optional required marker), the projected
  * control, and a hint or error message. It auto-links the control via
@@ -2385,6 +2414,12 @@ declare class StrctField {
     readonly hint: _angular_core.InputSignal<string>;
     /** Error message (string or first-of array); falsy clears the error state. */
     readonly error: _angular_core.InputSignal<string | string[] | null | undefined>;
+    /**
+     * `'inline'` puts the label and its hint in a fixed-width column
+     * (`--strct-field-label-w`, 220px) and the control beside them — how a long
+     * settings form reads. Below 480px of field width it falls back to stacked.
+     */
+    readonly layout: _angular_core.InputSignal<"stacked" | "inline">;
     /**
      * Async-validation state rendered as a trailing adornment (spinner / check /
      * warning) plus its message in the hint/error slot — so apps stop composing a
@@ -2395,7 +2430,12 @@ declare class StrctField {
     private readonly n;
     protected readonly hintId: string;
     protected readonly errorId: string;
+    protected readonly prefixId: string;
+    protected readonly suffixId: string;
     protected readonly controlId: _angular_core.WritableSignal<string>;
+    protected readonly hintTpl: _angular_core.Signal<TemplateRef<any> | undefined>;
+    protected readonly hasPrefix: _angular_core.Signal<StrctFieldPrefix | undefined>;
+    protected readonly hasSuffix: _angular_core.Signal<StrctFieldSuffix | undefined>;
     protected readonly errorText: _angular_core.Signal<string>;
     /** Effective validation status ('idle' when no state supplied). */
     protected readonly stateStatus: _angular_core.Signal<_akcelik_strct.StrctValidationStatus>;
@@ -2409,9 +2449,15 @@ declare class StrctField {
     constructor();
     private control;
     private link;
+    /**
+     * A text addon belongs to the control's description — "Minimum memory, MB" —
+     * while an addon holding its own control (a send button) is a tab stop of its
+     * own and says nothing about the value.
+     */
+    private addonDescription;
     private applyAria;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctField, "strct-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "validationState": { "alias": "validationState"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctField, "strct-field", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "validationState": { "alias": "validationState"; "required": false; "isSignal": true; }; }, {}, ["hintTpl", "hasPrefix", "hasSuffix"], ["[strctFieldPrefix]", "[strctFieldSuffix]", "*"], true, never>;
 }
 
 /**
@@ -3457,6 +3503,19 @@ interface StrctDatagridColumn {
      * change in your handler and pass the updated array back in.
      */
     editable?: boolean;
+    /**
+     * Which editor an `editable` column opens. `'text'` (the default) is the
+     * free-text box; `'number'` opens `strct-number`, and `'select'` opens
+     * `strct-select` over `editorOptions` — a value that is one of a set is
+     * chosen, not typed. The cell shows the chosen option's label at rest.
+     */
+    editor?: 'text' | 'number' | 'select';
+    /** Options for `editor: 'select'` (the library's own option shape). */
+    editorOptions?: StrctOption[];
+    /** Bounds and step for `editor: 'number'`. */
+    editorMin?: number;
+    editorMax?: number;
+    editorStep?: number;
 }
 /** Per-column filter state: contains-text, or the checked value set. */
 type StrctDatagridFilters = Record<string, string | unknown[]>;
@@ -3696,12 +3755,20 @@ declare class StrctDatagrid {
     }>;
     /** Server-side data request (lazy mode): load this page / sort and set `rows`. */
     readonly lazyLoad: _angular_core.OutputEmitterRef<StrctDatagridLazyState>;
-    /** An editable cell was committed (Enter / blur). The grid does not mutate
-     *  rows — apply `value` to your data and pass the updated array back in. */
+    /** An editable cell was committed (Enter / blur, or choosing in a `select`
+     *  editor). The grid does not mutate rows — apply the value to your data and
+     *  pass the updated array back in. */
     readonly cellEdit: _angular_core.OutputEmitterRef<{
         row: StrctRow;
         column: StrctDatagridColumn;
+        /** The committed value as text — what a `text` editor produces. */
         value: string;
+        /**
+         * The same commit, typed: the number a `number` editor holds, or the
+         * option's `value` a `select` editor chose. `value` stays a string so
+         * handlers written against it keep working.
+         */
+        typedValue: unknown;
         previous: unknown;
     }>;
     private readonly menu;
@@ -3790,7 +3857,26 @@ declare class StrctDatagrid {
         colKey: string;
     } | null>;
     protected isEditingCell(row: StrctRow, col: StrctDatagridColumn): boolean;
+    /** The value a typed editor holds while it is open (committed on Enter / blur). */
+    protected readonly editDraft: _angular_core.WritableSignal<unknown>;
     protected startEdit(row: StrctRow, col: StrctDatagridColumn): void;
+    /** A select column reads as its option's label, not as the stored value. */
+    protected displayValue(row: StrctRow, col: StrctDatagridColumn): unknown;
+    /** Close the editor and emit `cellEdit` when the value actually changed. */
+    protected commitValue(row: StrctRow, col: StrctDatagridColumn, raw: unknown): void;
+    /** Enter / blur on a typed editor commits what it currently holds. */
+    protected commitDraft(row: StrctRow, col: StrctDatagridColumn, event?: Event): void;
+    /**
+     * A column that declares bounds means them: Enter commits what the field
+     * holds, and `strct-number` only clamps on blur, so the grid clamps here
+     * rather than letting an out-of-range value reach `cellEdit`.
+     */
+    private clampToColumn;
+    /**
+     * A number editor is a field between two stepper buttons, so focus moves
+     * inside it — only a move that actually leaves the editor is a blur.
+     */
+    protected commitOnLeave(row: StrctRow, col: StrctDatagridColumn, event: FocusEvent): void;
     protected commitEdit(row: StrctRow, col: StrctDatagridColumn, event: Event): void;
     protected cancelEdit(event?: Event): void;
     /**
@@ -6238,5 +6324,5 @@ declare class StrctHeatmap {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctHeatmap, "strct-heatmap", never, { "data": { "alias": "data"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "cols": { "alias": "cols"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "colLabelEvery": { "alias": "colLabelEvery"; "required": false; "isSignal": true; }; "colLabel": { "alias": "colLabel"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "thresholds": { "alias": "thresholds"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "summaryFormat": { "alias": "summaryFormat"; "required": false; "isSignal": true; }; "cellHeight": { "alias": "cellHeight"; "required": false; "isSignal": true; }; "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "rowLabelWidth": { "alias": "rowLabelWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-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, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctList, StrctListItem, StrctListItemDescription, StrctListItemLeading, StrctListItemMeta, StrctListItemTrailing, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone, unlockBodyScroll };
+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, StrctAnnouncer, StrctAvatar, StrctBadge, StrctBreadcrumb, StrctBreadcrumbItem, StrctButton, StrctButtonGroup, StrctBytesPipe, StrctCard, StrctCardBlock, StrctCardFooter, StrctCardHeader, StrctCardHeaderActions, StrctCardHeaderMeta, StrctCardHeaderNote, StrctCascadeColumn, StrctCascadeHost, StrctCascadeSelect, StrctCellDef, StrctCellStatus, StrctChart, StrctCheckbox, StrctChips, StrctCode, StrctCodeInline, StrctColorPicker, StrctCombobox, StrctCommandPalette, StrctConfirmOutlet, StrctConfirmService, StrctContextMenu, StrctContextMenuTrigger, StrctCopy, StrctDatagrid, StrctDatagridActionBar, StrctDatagridActionBarCaption, StrctDatepicker, StrctDatetimePicker, StrctDesc, StrctDescriptionList, StrctDiff, StrctDivider, StrctDonut, StrctDrawer, StrctDrawerFooter, StrctDropdown, StrctDropdownDivider, StrctDropdownItem, StrctDropdownTrigger, StrctDurationPipe, StrctEmptyState, StrctField, StrctFieldGroup, StrctFieldHint, StrctFieldPrefix, StrctFieldSuffix, StrctFile, StrctFilterBar, StrctFlow, StrctFooter, StrctGauge, StrctHeader, StrctHeatmap, StrctHero, StrctHotkeysHelp, StrctHotkeysService, StrctIcon, StrctInlineEdit, StrctInput, StrctInputMask, StrctInputOtp, StrctKbd, StrctKnob, StrctList, StrctListItem, StrctListItemDescription, StrctListItemLeading, StrctListItemMeta, StrctListItemTrailing, StrctLogViewer, StrctLogin, StrctMenuPanel, StrctMenuService, StrctMenubar, StrctMetricTile, StrctModal, StrctModalContent, StrctNav, StrctNavItem, StrctNotificationCenter, StrctNumber, StrctOverlay, StrctPageHeader, StrctPageHeaderActions, StrctPageHeaderCrumbs, StrctPageHeaderTitleMeta, StrctPagination, StrctPassword, StrctPopover, StrctPopoverTrigger, StrctProgress, StrctRadio, StrctRadioGroup, StrctRail, StrctRange, StrctRatePipe, StrctRating, StrctReorder, StrctReorderItem, StrctRowDetailDef, StrctSearchbox, StrctSectionHeader, StrctSectionHeaderActions, StrctSectionHeaderMeta, StrctSectionMenu, StrctSegmented, StrctSelect, StrctShell, StrctShellService, StrctSiPipe, StrctSignpost, StrctSignpostTrigger, StrctSkeleton, StrctSparkline, StrctSpeedDial, StrctSpinner, StrctSplitButton, StrctSplitter, StrctStack, StrctStackItem, StrctStatusDot, StrctStep, StrctSubmenu, StrctTab, StrctTable, StrctTabs, StrctTag, StrctThemeService, StrctThemeSwitcher, StrctTimeRangePicker, StrctTimeline, StrctTimelineItem, StrctToastOutlet, StrctToastService, StrctToggle, StrctToolbar, StrctToolbarCaption, StrctToolbarSpacer, StrctTooltip, StrctTour, StrctTransfer, StrctTree, StrctTreeNode, StrctTreeSelect, StrctVerticalNav, StrctWatermark, StrctWizard, StrctWizardAside, focusFirstIn, keepTabInside, lockBodyScroll, parseAnsi, provideStrctWizardDefaults, registerStrctIcon, restoreFocus, saveFocusedElement, strctComputeDiff, strctDpPad, strctFormatBytes, strctFormatDuration, strctFormatRate, strctFormatSi, strctValidationIcon, strctValidationTone, unlockBodyScroll };
 export type { StrctAlertType, StrctAvatarSize, StrctAvatarStatus, StrctBadgeStatus, StrctButtonSize, StrctButtonVariant, StrctCascadeOption, StrctCellContext, StrctChartAnnotation, StrctChartColor, StrctChartCurve, StrctChartSeries, StrctChartSlot, StrctChartStatus, StrctChartSummaryInfo, StrctChartThreshold, StrctChartType, StrctColumn, StrctCommandItem, StrctConfirmOptions, StrctConfirmTone, StrctDatagridColumn, StrctDatagridColumnState, StrctDatagridFilters, StrctDatagridLabels, StrctDatagridLazyState, StrctDescAlign, StrctDescItem, StrctDiffRow, StrctDonutSegment, StrctDrawerSide, StrctDrawerSize, StrctEmptyVariant, StrctFilterChip, StrctFlowDirection, StrctFlowNode, StrctFlowOrientation, StrctHeatmapCell, StrctHeatmapSummaryInfo, StrctHotkey, StrctIconBadge, StrctIconName, StrctKnobStatus, StrctLogLine, StrctMenuItem, StrctMenuLink, StrctMenuOpenOptions, StrctMenuSection, StrctMenubarItem, StrctMetricStatus, StrctModalSize, StrctMode, StrctNotification, StrctOption, StrctOverlayPlacement, StrctPalette, StrctPaletteInfo, StrctProgressSegment, StrctProgressStatus, StrctRailItem, StrctRailStatus, StrctReorderEvent, StrctRow, StrctRowId, StrctSegmentedOption, StrctSegmentedSize, StrctSignpostPosition, StrctSpeedDialDirection, StrctSpinnerSize, StrctStatus, StrctStatusDotSize, StrctTagStatus, StrctThresholds, StrctTimeRange, StrctTimeRangePreset, StrctTimelineState, StrctToast, StrctToastOptions, StrctToastType, StrctTooltipPosition, StrctTourStep, StrctTransferItem, StrctTreeDropEvent, StrctTreeMenuEvent, StrctTreeNodeData, StrctTreeNodeMenuFn, StrctValidationState, StrctValidationStatus, StrctWizardDefaults };