@maropost-ui/liquidsky-ui 0.1.48 → 0.1.49

package/dist/types/TreeDropdownProps.d.ts

@@ -1,61 +1,91 @@
-import type { AppDropdownProps } from './AppDropdownProps';
+import type { AppDropdownProps, AppDropdownService, DataFetcher } from './AppDropdownProps';
 export interface TreeDropdownItem {
     [key: string]: unknown;
     children?: TreeDropdownItem[];
     disabled?: boolean;
     selectable?: boolean;
 }
-export interface TreeDropdownProps<T = TreeDropdownItem> extends AppDropdownProps<T> {
+/** Shape for `v-model:select-all` when `selectAllInModel` is false. */
+export interface TreeDropdownSelectAllModel<T = TreeDropdownItem> {
+    select_all: boolean;
+    ids: T[];
+}
+/**
+ * Props for AppTreeDropdown (`TreeDropdown.vue`).
+ * Extends AppDropdown data-loading props; adds tree-specific selection and display options.
+ */
+export interface TreeDropdownProps<T = TreeDropdownItem> extends Omit<AppDropdownProps<T>, 'allowNewItem' | 'loadItemById'> {
     /**
-     * Static hierarchical items. When provided, the tree renders without an initial fetch.
+     * Async loader for tree nodes. Results are merged with `items`, `default-items`, and
+     * drive the empty / `#no-data-append` state when a search returns no catalog rows.
      */
-    items?: T[];
+    dataFetcher?: DataFetcher<T>;
     /**
-     * When the data source is flat, builds a tree using this parent reference field.
-     * Ignored when items already contain nested children.
+     * Injectable service with `findAll` / `items` / `pagination` — same contract as AppDropdown.
+     * Flat `parent_id` rows are built into a tree when nested `children` are absent.
      */
-    parentIdKey?: string;
+    service?: AppDropdownService<T>;
+    /** Item ids to omit from the tree and from fetch results. */
+    exclude?: number[];
+    /** Extra params merged into every `dataFetcher` / `service.findAll` request. */
+    customParams?: Record<string, unknown>;
     /**
-     * Restrict selection to nodes without children (or nodes with `selectable: false` on parents).
+     * Rows merged into the tree after fetch (e.g. user-created categories).
+     * Not used for exact-search matching; does not block `#no-data-append` when the catalog fetch is empty.
      */
-    leafOnly?: boolean;
+    defaultItems?: T[];
+    /** Normalizes each row before tree build and after fetch (default: identity). */
+    compactItem?: (item: T) => T;
+    /** When `chips` is on, show only `maxVisibleChips` chips plus a "+N others" label. */
+    chipCollapsible?: boolean;
+    /** Number of chips shown before the "+N others" summary (requires `chipCollapsible`). */
+    maxVisibleChips?: number;
+    /** Show a search icon in the field (`prepend-inner` slot). */
+    showSearchIcon?: boolean;
     /**
-     * Lazy-load child nodes for a branch (passed through to VTreeview `load-children`).
+     * Show **Select All / Deselect All** with total selectable count (multiple mode only).
+     * Hidden while the user is searching.
      */
-    loadChildren?: (item: T) => Promise<void>;
+    allowSelectAll?: boolean;
     /**
-     * Expand all branches while searching.
+     * Static hierarchical items. When provided, the tree renders without an initial fetch
+     * unless `dataFetcher` or `service` is also set.
      */
-    openAllOnSearch?: boolean;
+    items?: T[];
     /**
-     * Show the full ancestor path in chips and single selection display.
+     * When the data source is flat, builds a tree using this parent reference field.
+     * Ignored when items already contain nested `children`.
      */
-    showPathInSelection?: boolean;
+    parentIdKey?: string;
     /**
-     * VTreeview select strategy for multiple mode.
-     * - `independent` — select parent and children separately
-     * - `all` — selecting a parent selects the parent and all descendants; deselecting any child deselects the parent
-     * - `classic` — same cascade UI as `all`, but the model only stores leaf nodes (Vuetify default)
+     * Lazy-load child nodes for a branch (passed through to `v-treeview` `load-children`).
+     * After loading, `fetchItems` runs again when a `dataFetcher` / `service` is configured.
      */
-    selectStrategy?: 'classic' | 'independent' | 'all' | 'leaf' | 'single-leaf' | 'single-independent' | 'trunk';
-    /** v-autocomplete: enable multiple selection */
+    loadChildren?: (item: T) => Promise<void>;
+    /** v-autocomplete: enable multiple selection with tree checkboxes. */
     multiple?: boolean;
-    /** v-autocomplete: show selection as chips (requires multiple) */
+    /** v-autocomplete: show selection as chips (requires `multiple`). */
     chips?: boolean;
-    /** v-autocomplete: chips can be closed/removed */
+    /** v-autocomplete: chips can be closed/removed (requires `chips`). */
     closableChips?: boolean;
-    /** v-autocomplete: v-model stores full item objects */
+    /** v-autocomplete: v-model stores full item objects instead of `itemValue` keys. */
     returnObject?: boolean;
-    /** v-autocomplete: show clear button */
+    /** v-autocomplete: show clear button on the input. */
     clearable?: boolean;
-    /** v-autocomplete / field label */
+    /** v-autocomplete / field label. */
     label?: string;
-    /** Key used for item display text */
-    itemTitle?: string | ((item: T) => string);
-    /** Key used as the item value */
-    itemValue?: string;
-    /** Key used for nested children */
-    itemChildren?: string;
+    /**
+     * Restrict selection to nodes without children (or nodes with `selectable: false` on parents).
+     * Parent rows show a count of selectable leaf descendants in the menu.
+     */
+    leafOnly?: boolean;
+    /**
+     * VTreeview select strategy for multiple mode.
+     * - `independent` — select parent and children separately (default)
+     * - `all` — selecting a parent selects the parent and all descendants; deselecting any child deselects the parent
+     * - `classic` — same cascade UI as `all`, but the model only stores leaf nodes
+     */
+    selectStrategy?: 'classic' | 'independent' | 'all' | 'leaf' | 'single-leaf' | 'single-independent' | 'trunk';
     /**
      * How Select All updates selection when `allowSelectAll` is true.
      * - `false` (default) — uses `v-model:select-all` with `{ select_all, ids }` for
@@ -63,5 +93,15 @@ export interface TreeDropdownProps<T = TreeDropdownItem> extends AppDropdownProp
      * - `true` — Select All puts every selectable value in `v-model`; Deselect All clears `v-model`.
      */
     selectAllInModel?: boolean;
+    /** Key used for item display text (string key or formatter function). Menu titles are title-cased for string keys. */
+    itemTitle?: string | ((item: T) => string);
+    /** Key used as the stable node id / v-model value. */
+    itemValue?: string;
+    /** Key used for nested children (default `children`). */
+    itemChildren?: string;
+    /** Expand all branches while the user types in the search field. */
+    openAllOnSearch?: boolean;
+    /** Show the full ancestor path in chips and single selection display. */
+    showPathInSelection?: boolean;
 }
 //# sourceMappingURL=TreeDropdownProps.d.ts.map

package/dist/types/TreeDropdownProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeDropdownProps.d.ts","sourceRoot":"","sources":["../../src/types/TreeDropdownProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,gBAAgB,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAClF;;OAEG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,cAAc,CAAC,EACX,SAAS,GACT,aAAa,GACb,KAAK,GACL,MAAM,GACN,aAAa,GACb,oBAAoB,GACpB,OAAO,CAAC;IACZ,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IAC3C,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"TreeDropdownProps.d.ts","sourceRoot":"","sources":["../../src/types/TreeDropdownProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,gBAAgB;IAC9D,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,CAAC,EAAE,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,gBAAgB,CACrD,SAAQ,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,cAAc,GAAG,cAAc,CAAC;IAGlE;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAEhC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC;IAEnB,iFAAiF;IACjF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAE7B,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAIzB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAEZ;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAI1C,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,cAAc,CAAC,EACX,SAAS,GACT,aAAa,GACb,KAAK,GACL,MAAM,GACN,aAAa,GACb,oBAAoB,GACpB,OAAO,CAAC;IAEZ;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAI3B,sHAAsH;IACtH,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IAE3C,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maropost-ui/liquidsky-ui",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "description": "Shared UI components, composables, and utils for Vue + Vuetify",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",