@nanahoshi/mona-ui 0.23.0 → 0.23.2

package/types/nanahoshi-mona-ui-internal-tree.d.ts

@@ -67,6 +67,11 @@ declare class TreeNode<T> {
     readonly data: T;
     readonly loading: _angular_core.WritableSignal<boolean>;
     readonly uid: string;
+    /**
+     * Whether children from an asynchronous children selector have been loaded. Loaded children are cached,
+     * so collapsing and re-expanding the node does not request them again.
+     */
+    childrenLoaded: boolean;
     index: string;
     parent: TreeNode<T> | null;
     constructor(data: T);
@@ -269,6 +274,15 @@ declare class TreeService<T> {
     static flatten<T>(nodes: Iterable<TreeNode<T>>): List<TreeNode<T>>;
     clearFilter(): void;
     detachNode(node: TreeNode<T>): void;
+    /**
+     * Expands every expandable, enabled sibling of a node (the `*` key of the WAI-ARIA tree pattern).
+     */
+    expandSiblings(node: TreeNode<T>): void;
+    /**
+     * Finds the next visible node, after the navigated node and wrapping around, whose text starts with `prefix`
+     * (case-insensitive). Used for typeahead.
+     */
+    findNodeByText(prefix: string): TreeNode<T> | null;
     getNodeByUid(uid: string): TreeNode<T> | null;
     getNodeElementId(uid: string): string;
     getNodeText(node: TreeNode<T>): string;
@@ -283,7 +297,15 @@ declare class TreeService<T> {
     isSelected(node: TreeNode<T>): boolean;
     isTreeFiltered(): boolean;
     isVisible(node: TreeNode<T>): boolean;
-    loadNodeChildren(node: TreeNode<T>): void;
+    /**
+     * Loads the children of a node from an asynchronous children selector.
+     * Children are loaded once and cached; pass `reload` to request them again. A new load cancels a pending one.
+     */
+    loadNodeChildren(node: TreeNode<T>, reload?: boolean): void;
+    /**
+     * Moves a node relative to a target node. Moving a node onto itself or into its own subtree is ignored,
+     * because it would detach the subtree and create a parent cycle.
+     */
     moveNode(sourceNode: TreeNode<T>, targetNode: TreeNode<T>, position: DropPosition): void;
     navigate(direction: "next" | "previous" | "first" | "last"): TreeNode<T> | null;
     notifySelectionChange(node: TreeNode<T>): void;
@@ -314,21 +336,40 @@ declare class TreeService<T> {
     setSelectedDataItems(dataItems: Iterable<T>): void;
     setSelectedKeys(keys: Iterable<any>): void;
     setTextField(selector: string | Selector<T, string>): void;
+    /**
+     * Expands or collapses a node the way user interaction does: disabled nodes are left alone, children of an
+     * asynchronous children selector are loaded on first expand, and `nodeExpand$` is notified.
+     * @returns whether the expand state changed.
+     */
+    toggleNodeExpand(node: TreeNode<T>, expanded: boolean): boolean;
     getCheckKey(node: TreeNode<T>): any;
     getDisableKey(node: TreeNode<T>): any;
     private applyCheckedKeysToNodes;
     private computeVisibleUids;
     private createFlatNodes;
+    /**
+     * Builds tree nodes for hierarchical data, reusing the existing node of each data item so node state survives
+     * a data refresh. A data object that appears more than once gets a node of its own for every extra occurrence.
+     */
     private createHierarchicalNodes;
     private createNodeDictionary;
     private createNodes;
+    /**
+     * The derived check state of a parent: `true` when all of its check-state children are checked,
+     * or `null` when it has none (its own state then stands).
+     */
+    private deriveParentChecked;
+    /**
+     * Children that determine a parent's derived check state: those with a checkbox and, unless
+     * `checkDisabledChildren` is set, only enabled ones, because the user cannot change disabled children.
+     */
+    private getCheckStateChildren;
     private getExpandKey;
     private getChildNodes;
     private getDataItemSelectKey;
     private getParentNodes;
     private getSelectKey;
     private isAnyParentCollapsed;
-    private isAnyParentDisabled;
     private isFiltered;
     private loadCheckedKeysForChildren;
     private moveNodeAfter;
@@ -360,6 +401,7 @@ declare class TreeComponent<T> {
     private setKeydownSubscription;
     private setNodeDragHandlerSubscription;
     private setSubscriptions;
+    private setTypeaheadSubscription;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeComponent<any>, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeComponent<any>, "mona-tree", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; }, {}, ["nodeTemplate"], never, true, never>;
 }
@@ -378,6 +420,8 @@ declare const TREE_DEFAULT_MESSAGES: MonaTreeViewMessages;
  * @param idKey - The property key used to uniquely identify each node (e.g., 'id').
  * @param parentIdKey - The property key holding the parent node's id, or null for roots (e.g., 'parentId').
  * @returns A new array representing the updated flat tree, with the moved node's parentIdKey updated.
+ * The array is returned unchanged when the position is "outside" or the target is the dragged node or one of its
+ * descendants, which would otherwise create a parent cycle.
  */
 declare function moveFlatTreeNode<T extends Record<string, any>>(treeData: Iterable<T>, event: NodeDropEvent<T>, idKey: keyof T, parentIdKey: keyof T): T[];
 
@@ -387,7 +431,10 @@ declare function moveFlatTreeNode<T extends Record<string, any>>(treeData: Itera
  * @param event - The drag-and-drop event payload.
  * @param idKey - The property key used to identify nodes (e.g., 'id').
  * @param childrenKey - The property key containing the nested items (e.g., 'items').
- * @returns A new array representing the updated tree structure.
+ * @returns A new top-level array representing the updated tree structure.
+ * Nested children arrays are updated in place, so untouched data items keep their identity (and their tree state).
+ * The move is skipped, returning the tree unchanged, when the position is "outside", the target is missing,
+ * or the target is the dragged node or one of its descendants, so a node is never lost or made its own ancestor.
  */
 declare function moveTreeNode<T extends Record<string, any>>(treeData: Iterable<T>, event: NodeDropEvent<T>, idKey: keyof T, childrenKey: keyof T): T[];
 

package/types/nanahoshi-mona-ui-internal.d.ts

@@ -72,7 +72,8 @@ type Action<P = void, R = void> = (arg: P) => R;
 
 /**
  * Generates a unique control ID for an element.
- * The ID consists of a prefix, a random hexadecimal string, and a suffix.
+ * The ID consists of the `mona-` prefix followed by a random hexadecimal string.
+ * It contains only characters that are safe in CSS selectors, so it can be used with `querySelector("#…")` unescaped.
  * @param {number} [level=0] - The nesting level of the element. This increases the length of the generated ID.
  * @param {number} [length=7] - The base length of the random part of the ID.
  * @returns {string} A unique control ID string for use for elements.
@@ -99,12 +100,12 @@ declare const themeOverlaySurfaceClasses = "\n    [background-color:var(--mona-e
 declare const restoreOverlayScroll: (overlayRef: OverlayRef, element: HTMLElement) => void;
 
 interface WindowStyleSettings {
+    left?: number;
     maxHeight?: number;
     maxWidth?: number;
     minHeight?: number;
     minWidth?: number;
     top?: number;
-    left?: number;
     windowClass?: string | string[];
 }
 declare const setWindowStyles: (element: HTMLElement, settings: WindowStyleSettings) => void;
@@ -136,8 +137,21 @@ declare enum NavigationKeys {
 declare const NavigationKeysList: string[];
 declare const isNavigationKey: (key: string) => boolean;
 
-declare const isTypeaheadKey: (key: string) => boolean;
+/**
+ * Modifier state of a keyboard event. Typeahead is skipped while Ctrl, Meta or Alt is held,
+ * so shortcuts such as Ctrl+A or Cmd+C keep their default behavior.
+ */
+interface TypeaheadModifiers {
+    readonly altKey?: boolean;
+    readonly ctrlKey?: boolean;
+    readonly metaKey?: boolean;
+}
+/**
+ * Returns whether a `KeyboardEvent.key` value should feed typeahead.
+ * Any single letter or digit in any script counts, plus space, `-` and `_`.
+ */
+declare const isTypeaheadKey: (key: string, modifiers?: TypeaheadModifiers) => boolean;
 declare const setupTypeahead: (typeaheadKey$: Observable<string>) => Observable<string>;
 
 export { AttributeBinderDirective, NavigationKeys, NavigationKeysList, createElementControlId, focusElement, hex2rgba, hsla2hsva, hsva2rgba, isNavigationKey, isTypeaheadKey, isValidHex, isValidHsla, isValidRgb, restoreOverlayScroll, rgba2hex, rgba2hsla, rgba2hsva, rxFromResize, rxTimeout, setWindowStyles, setupTypeahead, string2Hsla, string2rgba, themeControlBackdropClasses, themeControlSurfaceClasses, themeOverlayBackdropClasses, themeOverlaySurfaceClasses, themeRaisedBackdropClasses, themeRaisedSurfaceClasses, toCssValue };
-export type { Action, AttributeConfig, Channel, ColorScheme, HSL, HSLA, HSV, HSVA, HSVChannel, RGB, RGBA, RGBAChannel, RGBChannel, VariantInputs, WindowStyleSettings };
+export type { Action, AttributeConfig, Channel, ColorScheme, HSL, HSLA, HSV, HSVA, HSVChannel, RGB, RGBA, RGBAChannel, RGBChannel, TypeaheadModifiers, VariantInputs, WindowStyleSettings };

package/types/nanahoshi-mona-ui-locales.d.ts

@@ -239,6 +239,7 @@ declare const MONA_AR_SA_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -616,6 +617,7 @@ declare const MONA_ES_ES_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -993,6 +995,7 @@ declare const MONA_DE_DE_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -1370,6 +1373,7 @@ declare const MONA_FR_FR_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -1747,6 +1751,7 @@ declare const MONA_IT_IT_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -2124,6 +2129,7 @@ declare const MONA_JA_JP_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -2501,6 +2507,7 @@ declare const MONA_KO_KR_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -2878,6 +2885,7 @@ declare const MONA_PT_BR_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -3255,6 +3263,7 @@ declare const MONA_ZH_CN_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -3632,6 +3641,7 @@ declare const MONA_ZH_TW_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -4009,6 +4019,7 @@ declare const MONA_TR_TR_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -4386,6 +4397,7 @@ declare const MONA_ID_ID_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {
@@ -4763,6 +4775,7 @@ declare const MONA_RU_RU_LOCALE: {
             selectRow: (rowNumber: number) => string;
         };
         list: {
+            filterList: string;
             noData: string;
         };
         listBox: {

package/types/nanahoshi-mona-ui-numeric-text-box.d.ts

@@ -146,6 +146,11 @@ declare class NumericTextBoxComponent implements NumericTextboxVariantInputs, Fo
     private formatEditValue;
     private formatValueForDisplay;
     protected onPaste(event: ClipboardEvent): void;
+    /**
+     * The numpad decimal key types "." or "," depending on the keyboard layout, not the locale. Insert the
+     * locale's decimal separator instead, so a de-DE layout used with an en-US locale still types a decimal.
+     */
+    private insertLocaleDecimal;
     private parseValue;
     private setBeforeInputSubscription;
     private setInputFocusSubscription;