@cntwg/html-ctrls-lists 0.0.32 → 0.0.33

package/lib/lists-btn.d.ts

@@ -1,63 +1,63 @@
-/**
- * A description for list buttons set.
- */
-export type listButtonsSetDesc = {
-    /**
-     * - button 'move to first'
-     */
-    btnFirst: HTMLElement | null;
-    /**
-     * - button 'move to previous'
-     */
-    btnPrev: HTMLElement | null;
-    /**
-     * - button 'move to next'
-     */
-    btnNext: HTMLElement | null;
-    /**
-     * - button 'move to last'
-     */
-    btnLast: HTMLElement | null;
-};
-export const BTS_DEF_GROUP_NAME: "all";
-
-/**
- * This class implements an interface of a pre-defined
- * buttons set that is used in pair with a list elements.
- * A set provide a buttons: <next>, <previous>, <first> and <last>.
- */
-export class THtmlListButtonsController {
-    /**
-     * Creates an instance of a buttons set.
-     */
-    constructor(opt?: listButtonsSetDesc);
-    /**
-     * Disables all buttons.
-     */
-    disableAll(): void;
-    /**
-     * Disables all buttons in 'move_bkwd' group.
-     */
-    disableBkwd(): void;
-    /**
-     * Disables all buttons in 'move_frwd' group.
-     */
-    disableFrwd(): void;
-    /**
-     * Enables all buttons.
-     */
-    enableAll(): void;
-    /**
-     * Enables all buttons in 'move_bkwd' group.
-     */
-    enableBkwd(): void;
-    /**
-     * Enables all buttons in 'move_frwd' group.
-     */
-    enableFrwd(): void;
-    /**
-     * Sets a callback function to handle event.
-     */
-    on(name: string, evnt: Function): void;
-    #private;
-}
+/**
+ * A description for list buttons set.
+ */
+export type listButtonsSetDesc = {
+    /**
+     * - button 'move to first'
+     */
+    btnFirst: HTMLElement | null;
+    /**
+     * - button 'move to previous'
+     */
+    btnPrev: HTMLElement | null;
+    /**
+     * - button 'move to next'
+     */
+    btnNext: HTMLElement | null;
+    /**
+     * - button 'move to last'
+     */
+    btnLast: HTMLElement | null;
+};
+export const BTS_DEF_GROUP_NAME: "all";
+
+/**
+ * This class implements an interface of a pre-defined
+ * buttons set that is used in pair with a list elements.
+ * A set provide a buttons: <next>, <previous>, <first> and <last>.
+ */
+export class THtmlListButtonsController {
+    /**
+     * Creates an instance of a buttons set.
+     */
+    constructor(opt?: listButtonsSetDesc);
+    /**
+     * Disables all buttons.
+     */
+    disableAll(): void;
+    /**
+     * Disables all buttons in 'move_bkwd' group.
+     */
+    disableBkwd(): void;
+    /**
+     * Disables all buttons in 'move_frwd' group.
+     */
+    disableFrwd(): void;
+    /**
+     * Enables all buttons.
+     */
+    enableAll(): void;
+    /**
+     * Enables all buttons in 'move_bkwd' group.
+     */
+    enableBkwd(): void;
+    /**
+     * Enables all buttons in 'move_frwd' group.
+     */
+    enableFrwd(): void;
+    /**
+     * Sets a callback function to handle event.
+     */
+    on(name: string, evnt: Function): void;
+    #private;
+}

package/lib/lists-stubs.d.ts

@@ -1,134 +1,134 @@
-/**
- * A set of options for a `THtmlStubItemsSet`-class constructor
- */
-export type IStubItemsSetOptions = {
-    /**
-     * - array of `name`-`element` pairs
-     */
-    items: pairOfNameAndElement[];
-    /**
-     * - a default element name
-     */
-    defaultItem?: string;
-    /**
-     * - run in a force mode
-     */
-    force?: boolean | undefined;
-};
-export const IStubItemsSetOptions: IStubItemsSetOptions;
-/**
- * A `name`-`element` pair
- */
-export type pairOfNameAndElement = [ name: string, item: HTMLElement ];
-/**
- * A settings to load a stub-elements.
- */
-export type OPT_ldstubs = {
-    /**
-     * - a default element name
-     * @deprecated
-     */
-    defaultItem?: string;
-    /**
-     * - to clear before load an elements
-     */
-    useClear?: boolean;
-    /**
-     * - run in a force mode
-     */
-    force?: boolean;
-};
-/**
- * A stub-elements list descriptor
- */
-export type IStubEListDesc = {
-    /**
-     * - array of `name`-`element` pairs
-     */
-    items: pairOfNameAndElement[];
-    /**
-     * - a default element name
-     */
-    defaultItem?: string;
-};
-
-/**
- * This class implements an interface of a stub-items set
- */
-export class THtmlStubItemsSet {
-    /**
-     * Creates an instance of a stub-items set
-     * @todo [since v0.0.26] use of an `array`-type as a value of an `opt` is deprecated
-     */
-    constructor(host: HTMLElement, opt?: pairOfNameAndElement[] | IStubEListDesc | IStubItemsSetOptions);
-    /**
-     * Defines a default element name
-     * @type {string}
-     */
-    set defItem(name: string);
-    get defItem(): string;
-    /**
-     * Contains a Qty of an elements
-     * @type {number}
-     */
-    get count(): number;
-    /**
-     * Clears an instance content.
-     * @todo check if any item is shown
-     */
-    clear(): void;
-    /**
-     * Sets a default item.
-     */
-    setDefItem(name: string): boolean;
-    /**
-     * Resets a default item.
-     * @todo check if item is shown
-     */
-    rstDefItem(): void;
-    /**
-     * Checks if an item exists.
-     */
-    hasItem(name: string): boolean;
-    /**
-     * Checks if any items exists.
-     */
-    hasItems(): boolean;
-    /**
-     * Returns an item by its name.
-     */
-    getItem(name: string): HTMLElement | null;
-    /**
-     * Adds an item to an instance members.
-     */
-    addItem(name: string, item: HTMLElement, opt?: boolean): boolean;
-    /**
-     * Deletes an item from an instance members.
-     * @todo check if item is shown
-     */
-    delItem(name: string): boolean;
-    /**
-     * Shows an item.
-     */
-    showItem(name: string): boolean;
-    /**
-     * Shows a default item.
-     */
-    showDefItem(): boolean;
-    /**
-     * Hides an item.
-     */
-    hideItem(name: string): boolean;
-    /**
-     * Hides a default item.
-     */
-    hideDefItem(): boolean;
-    /**
-     * Adds an items to an instance members.
-     * @todo [since 0.0.25] deprecate use of `opt` as `boolean`
-     * @todo [since v0.0.26] for `OPT_ldstubs` a `defaultItem`-option deprecated
-     * @todo [since 0.0.32] deprecate use of `data` as `array`
-     */
-    loadItems(data: pairOfNameAndElement[] | IStubEListDesc, opt?: boolean | OPT_ldstubs): number;
-    #private;
-}
+/**
+ * A set of options for a `THtmlStubItemsSet`-class constructor
+ */
+export type IStubItemsSetOptions = {
+    /**
+     * - array of `name`-`element` pairs
+     */
+    items: pairOfNameAndElement[];
+    /**
+     * - a default element name
+     */
+    defaultItem?: string;
+    /**
+     * - run in a force mode
+     */
+    force?: boolean | undefined;
+};
+export const IStubItemsSetOptions: IStubItemsSetOptions;
+/**
+ * A `name`-`element` pair
+ */
+export type pairOfNameAndElement = [ name: string, item: HTMLElement ];
+/**
+ * A settings to load a stub-elements.
+ */
+export type OPT_ldstubs = {
+    /**
+     * - a default element name
+     * @deprecated
+     */
+    defaultItem?: string;
+    /**
+     * - to clear before load an elements
+     */
+    useClear?: boolean;
+    /**
+     * - run in a force mode
+     */
+    force?: boolean;
+};
+/**
+ * A stub-elements list descriptor
+ */
+export type IStubEListDesc = {
+    /**
+     * - array of `name`-`element` pairs
+     */
+    items: pairOfNameAndElement[];
+    /**
+     * - a default element name
+     */
+    defaultItem?: string;
+};
+
+/**
+ * This class implements an interface of a stub-items set
+ */
+export class THtmlStubItemsSet {
+    /**
+     * Creates an instance of a stub-items set
+     * @todo [since v0.0.26] use of an `array`-type as a value of an `opt` is deprecated
+     */
+    constructor(host: HTMLElement, opt?: pairOfNameAndElement[] | IStubEListDesc | IStubItemsSetOptions);
+    /**
+     * Defines a default element name
+     * @type {string}
+     */
+    set defItem(name: string);
+    get defItem(): string;
+    /**
+     * Contains a Qty of an elements
+     * @type {number}
+     */
+    get count(): number;
+    /**
+     * Clears an instance content.
+     * @todo check if any item is shown
+     */
+    clear(): void;
+    /**
+     * Sets a default item.
+     */
+    setDefItem(name: string): boolean;
+    /**
+     * Resets a default item.
+     * @todo check if item is shown
+     */
+    rstDefItem(): void;
+    /**
+     * Checks if an item exists.
+     */
+    hasItem(name: string): boolean;
+    /**
+     * Checks if any items exists.
+     */
+    hasItems(): boolean;
+    /**
+     * Returns an item by its name.
+     */
+    getItem(name: string): HTMLElement | null;
+    /**
+     * Adds an item to an instance members.
+     */
+    addItem(name: string, item: HTMLElement, opt?: boolean): boolean;
+    /**
+     * Deletes an item from an instance members.
+     * @todo check if item is shown
+     */
+    delItem(name: string): boolean;
+    /**
+     * Shows an item.
+     */
+    showItem(name: string): boolean;
+    /**
+     * Shows a default item.
+     */
+    showDefItem(): boolean;
+    /**
+     * Hides an item.
+     */
+    hideItem(name: string): boolean;
+    /**
+     * Hides a default item.
+     */
+    hideDefItem(): boolean;
+    /**
+     * Adds an items to an instance members.
+     * @todo [since 0.0.25] deprecate use of `opt` as `boolean`
+     * @todo [since v0.0.26] for `OPT_ldstubs` a `defaultItem`-option deprecated
+     * @todo [since 0.0.32] deprecate use of `data` as `array`
+     */
+    loadItems(data: pairOfNameAndElement[] | IStubEListDesc, opt?: boolean | OPT_ldstubs): number;
+    #private;
+}

package/lib/lists-stubs.js

@@ -1,4 +1,4 @@
-// [v0.1.057-20260505]
+// [v0.1.058-20260510]
 
 // === module init block ===
 
@@ -278,7 +278,6 @@ class THtmlStubItemsSet {
     if (typeof useClear !== 'boolean') useClear = true;
     if (typeof force !== 'boolean') force = false;
     if (defaultItem === undefined) defaultItem = _options.defaultItem;  /* deprecated */
-    const setDefs = defaultItem !== undefined;
     let count = 0;
     if (isArray(items)) {
       if (useClear) this.clear();
@@ -292,7 +291,7 @@ class THtmlStubItemsSet {
         };
       });
     };
-    if (setDefs && count > 0) this.setDefItem(defaultItem);
+    if (defaultItem && count > 0) this.setDefItem(defaultItem);
     return count;
   }
 

package/lib/mod-hfunc.d.ts

@@ -1,18 +1,18 @@
-export type IClickEventInfo = {
-    /**
-     * - some target element
-     */
-    item: object | null;
-    /**
-     * - reflects a current click count
-     */
-    onClickNum: number;
-};
-
-/**
- * @function readOnClickEventInfo
- * @param {UIEvent} e - event
- * @returns {IClickEventInfo}
- * @inner
- */
-export function readOnClickEventInfo(e: UIEvent): IClickEventInfo;
+export type IClickEventInfo = {
+    /**
+     * - some target element
+     */
+    item: object | null;
+    /**
+     * - reflects a current click count
+     */
+    onClickNum: number;
+};
+
+/**
+ * @function readOnClickEventInfo
+ * @param {UIEvent} e - event
+ * @returns {IClickEventInfo}
+ * @inner
+ */
+export function readOnClickEventInfo(e: UIEvent): IClickEventInfo;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cntwg/html-ctrls-lists",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "An HTML-form component: lists",
   "author": "ygracs <cs70th-om@rambler.ru>",
   "license": "MIT",
@@ -17,9 +17,10 @@
   "types": "./index.d.ts",
   "files": [
     "doc/*.md",
+    "lib/list-cont.js",
+    "lib/list-ctrl.js",
     "lib/lists-stubs.js",
     "lib/lists-btn.js",
-    "lib/list.js",
     "lib/mod-hfunc.js",
     "lib/*.d.ts",
     "index.js",