@zidian-primitive/cascader 0.1.1 → 0.1.3

package/README.md

@@ -1,4 +1,4 @@
-# @zidian-base/cascader
+# @zidian-primitive/cascader
 
 A flexible cascader component library built with component composition pattern, providing complete UI and logic for hierarchical selection.
 
@@ -15,7 +15,7 @@ A flexible cascader component library built with component composition pattern,
 ## Installation
 
 ```bash
-npm install @zidian-base/cascader
+npm install @zidian-primitive/cascader
 ```
 
 ## Quick Start
@@ -30,7 +30,7 @@ import {
   CascaderPanelIndicator,
   useCascader,
   type CascaderItem
-} from '@zidian-base/cascader'
+} from '@zidian-primitive/cascader'
 
 const data = [
   { category: 'Electronics', type: 'Phone', brand: 'iPhone' },

package/esm/components/node/CascaderNode.js

@@ -1,11 +1,12 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { useContext } from 'react';
+import { useContext, useRef, useEffect } from 'react';
 import { CascaderContext, CascaderPanelContext } from '../../context/index.js';
 
 const CascaderNode = (props) => {
   const {
     node,
     isLeaf,
+    isActive,
     onClick,
     onTrigger,
     render,
@@ -13,14 +14,28 @@ const CascaderNode = (props) => {
   } = props;
   const { onSelectChange } = useContext(CascaderContext);
   const { showIndicator, registerNode } = useContext(CascaderPanelContext);
+  const nodeRef = useRef(null);
   const handleClick = (event) => {
     if (isLeaf) {
       if (onClick) onClick(node);
+      if (onTrigger) onTrigger(node.level, node.indices);
     } else {
       if (onTrigger) onTrigger(node.level, node.indices);
     }
   };
-  return /* @__PURE__ */ jsx("div", { ref: showIndicator ? (el) => registerNode(node.indices, el) : void 0, onClick: handleClick, ...elementProps, children: render ? render({ node, onSelectChange }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+  useEffect(() => {
+    if (isActive && nodeRef.current) {
+      nodeRef.current.scrollIntoView({
+        behavior: "smooth",
+        block: "nearest",
+        inline: "start"
+      });
+    }
+  }, [isActive]);
+  return /* @__PURE__ */ jsx("div", { ref: (el) => {
+    if (showIndicator) registerNode(node.indices, el);
+    nodeRef.current = el;
+  }, onClick: handleClick, ...elementProps, children: render ? render({ node, onSelectChange }) : /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("span", { style: { flex: 1 }, children: node.label }),
     !isLeaf && /* @__PURE__ */ jsx(
       "svg",

package/esm/hooks/useCascader.js

@@ -1,9 +1,9 @@
-import { useMemo, useState } from 'react';
-import { buildCascaderEngine, getDefaultIndices, getCascadeColumns, getShowIndices } from '../utils/data.js';
+import { useMemo, useState, useEffect } from 'react';
+import { buildCascaderEngine, getShowPath, getCascadeColumns, changeShowPath } from '../utils/data.js';
 import { setMultipleNodeStatus, setNodeCheckStatus } from '../utils/logic.js';
 
 function useCascader(options) {
-  const { data, handleDataConfig, selectOption } = options;
+  const { data, handleDataConfig, selectOption, curShow } = options;
   const sortedData = useMemo(() => {
     return [...data].sort((a, b) => {
       for (const field of handleDataConfig.levels) {
@@ -13,46 +13,45 @@ function useCascader(options) {
       return 0;
     });
   }, [data, handleDataConfig]);
-  const defaultNodes = useMemo(() => {
+  const sourceNodeData = useMemo(() => {
     return buildCascaderEngine(sortedData, handleDataConfig);
   }, [sortedData, handleDataConfig]);
-  const defaultStatusArray = useMemo(() => {
-    const statusArray = new Uint8Array(defaultNodes.length);
+  const logicNodeData = useMemo(() => {
+    const statusArray = new Uint8Array(sourceNodeData.length);
     if (selectOption?.defaultSelected) {
-      const defaultIndices = defaultNodes.filter(
+      const defaultIndices = sourceNodeData.filter(
         (node) => selectOption.defaultSelected.find(
           (selected) => node.raw?.value === selected
         )
       ).map((node) => node.index);
-      return setMultipleNodeStatus(defaultNodes, statusArray, defaultIndices, 1);
+      return setMultipleNodeStatus(sourceNodeData, statusArray, defaultIndices, 1);
     }
     return statusArray;
-  }, [defaultNodes, selectOption?.defaultSelected]);
-  const [checkStatusArray, setCheckStatusArray] = useState(defaultStatusArray);
-  const [showIndices, setShowIndices] = useState(getDefaultIndices(defaultNodes));
-  const columns = useMemo(() => getCascadeColumns(defaultNodes, showIndices), [defaultNodes, showIndices]);
-  const handleShowIndices = (depth, index) => {
-    setShowIndices(getShowIndices(
-      defaultNodes,
-      {
-        oldShowIndices: showIndices,
-        actionIndices: {
-          depth,
-          nodeIdx: index
-        }
-      }
+  }, [sourceNodeData, selectOption?.defaultSelected]);
+  const [checkStatusArray, setCheckStatusArray] = useState(logicNodeData);
+  const [path, setPath] = useState(getShowPath(sourceNodeData, sourceNodeData.find((node) => curShow === node.value || curShow === node.label)));
+  const columns = useMemo(() => getCascadeColumns(sourceNodeData, path), [sourceNodeData, path]);
+  const handleChangePath = (depth, index) => {
+    setPath(changeShowPath(
+      sourceNodeData,
+      { oldPath: path, action: { depth, nodeIdx: index } }
     ));
   };
   const handleChangeCheckStatus = (nodeIdx) => {
-    const newStatusArray = setNodeCheckStatus(defaultNodes, checkStatusArray, nodeIdx);
+    const newStatusArray = setNodeCheckStatus(sourceNodeData, checkStatusArray, nodeIdx);
     setCheckStatusArray(newStatusArray);
   };
+  useEffect(() => {
+    if (curShow || curShow === 0) {
+      setPath(getShowPath(sourceNodeData, sourceNodeData.find((node) => curShow === node.value || curShow === node.label)));
+    }
+  }, [curShow]);
   return {
-    nodes: defaultNodes,
+    nodes: sourceNodeData,
     columns,
-    showIndices,
+    path,
     checkStatusArray,
-    handleShowIndices,
+    handleChangePath,
     handleChangeCheckStatus
   };
 }

package/esm/index.js

@@ -5,5 +5,5 @@ export { CascaderPanel } from './components/panel/CascaderPanel.js';
 export { CascaderPanelHeader } from './components/panel/CascaderPanelHeader.js';
 export { CascaderPanelIndicator } from './components/panel/CascaderPanelIndicator.js';
 export { useCascader } from './hooks/useCascader.js';
-export { buildCascaderEngine, getCascadeColumns, getDefaultIndices, getShowIndices } from './utils/data.js';
+export { buildCascaderEngine, changeShowPath, getCascadeColumns, getShowPath } from './utils/data.js';
 export { setMultipleNodeStatus, setNodeCheckStatus } from './utils/logic.js';

package/esm/utils/data.js

@@ -78,25 +78,38 @@ function getCascadeColumns(nodes, showIndices) {
   });
   return columns;
 }
-function getShowIndices(nodes, option) {
-  const { oldShowIndices, actionIndices } = option;
+function changeShowPath(nodes, option) {
+  const { oldPath, action } = option;
   let targetPath = [];
-  const { depth, nodeIdx } = actionIndices;
+  const { depth, nodeIdx } = action;
   let currentNode = nodes[nodeIdx];
   while (currentNode.childrenIndices.length > 0) {
     targetPath.push(currentNode.index);
     currentNode = nodes[currentNode.childrenIndices[0]];
   }
-  return oldShowIndices.slice(0, depth).concat(targetPath);
+  return oldPath.slice(0, depth).concat(targetPath, currentNode.index);
 }
-function getDefaultIndices(nodes) {
-  let defaultIndices = [];
+function getShowPath(nodes, targetNode) {
   let currentNode = nodes[0];
-  while (currentNode.childrenIndices.length > 0) {
-    defaultIndices.push(currentNode.index);
-    currentNode = nodes[currentNode.childrenIndices[0]];
+  let showPath = [];
+  if (targetNode) {
+    let parentNode = targetNode;
+    showPath = new Array((targetNode?.depth ?? 0) + 1);
+    while (parentNode) {
+      showPath[parentNode.depth] = parentNode.index;
+      parentNode = parentNode.parentIndex !== -1 ? nodes[parentNode.parentIndex] : void 0;
+    }
+    return showPath;
+  }
+  while (currentNode) {
+    showPath.push(currentNode.index);
+    if (currentNode.childrenIndices.length > 0) {
+      currentNode = nodes[currentNode.childrenIndices[0]];
+    } else {
+      currentNode = null;
+    }
   }
-  return defaultIndices;
+  return showPath;
 }
 
-export { buildCascaderEngine, getCascadeColumns, getDefaultIndices, getShowIndices };
+export { buildCascaderEngine, changeShowPath, getCascadeColumns, getShowPath };

package/lib/components/node/CascaderNode.d.ts

@@ -3,6 +3,7 @@ import { CascaderItem, NodeSlotType } from "../../types";
 export interface CascaderNodeProps extends Omit<ComponentProps<'div'>, "onClick"> {
     node: CascaderItem<any>;
     isLeaf: boolean;
+    isActive: boolean;
     onClick?: (node: CascaderItem<any>) => void;
     onTrigger?: (depth: number, nodeIdx: number) => void;
     render?: NodeSlotType;

package/lib/hooks/useCascader.d.ts

@@ -1,14 +1,15 @@
-import { CascaderNodeType, SelectOption, FlatDataConfig } from "../types";
+import { CascaderNodeType, CascaderSelectOption, FlatDataConfig } from "../types";
 export type CascaderHookOption<T> = {
     data: T[];
     handleDataConfig: FlatDataConfig;
-    selectOption?: SelectOption;
+    selectOption?: CascaderSelectOption;
+    curShow?: string | number;
 };
 export declare function useCascader<T extends Record<string, any>>(options: CascaderHookOption<T>): {
     nodes: CascaderNodeType<T>[];
     columns: CascaderNodeType<T>[][];
-    showIndices: number[];
+    path: number[];
     checkStatusArray: Uint8Array<ArrayBufferLike>;
-    handleShowIndices: (depth: number, index: number) => void;
+    handleChangePath: (depth: number, index: number) => void;
     handleChangeCheckStatus: (nodeIdx: number) => void;
 };

package/lib/types/index.d.ts

@@ -1,8 +1,8 @@
 import { ReactNode } from "react";
 export type CheckStatus = 0 | 1 | 2;
-/**============================================
- **               Data
- *=============================================**/
+/**--------------------------------------------
+ *                  Data
+ *---------------------------------------------**/
 export interface CascaderNodeType<T = any> {
     depth: number;
     index: number;
@@ -17,20 +17,21 @@ export interface CascaderNodeType<T = any> {
 export interface CascaderItem<T> {
     indices: number;
     level: number;
+    field: string;
     label: string;
     value: string | number;
     originData?: T;
     checkStatus?: CheckStatus;
 }
-/**============================================
- **               Utils
- *=============================================**/
+/**--------------------------------------------
+ *                  Util
+ *---------------------------------------------**/
 export type FlatDataConfig = {
     levels: (string | [string, string])[];
 };
 export type GetShowIndicesOption = {
-    oldShowIndices: number[];
-    actionIndices: {
+    oldPath: number[];
+    action: {
         depth: number;
         nodeIdx: number;
     };
@@ -38,16 +39,16 @@ export type GetShowIndicesOption = {
 export type GetCascaderColumnsOption = {
     checkStatusArray?: Uint8Array<ArrayBufferLike>;
 };
-/**============================================
- **               Others
- *=============================================**/
-export type SelectOption = {
+/**--------------------------------------------
+ *                  Other
+ *---------------------------------------------**/
+export type CascaderSelectOption = {
     defaultSelected: string[];
     selectType: "single" | "multiple";
 };
-/**============================================
- **               Slot
- *=============================================**/
+/**--------------------------------------------
+ *                  Slot
+ *---------------------------------------------**/
 export type PanelHeaderSlot = (props: {
     column: CascaderNodeType<any>[];
     showNode: CascaderItem<any> | null;

package/lib/utils/data.d.ts

@@ -1,5 +1,5 @@
 import { CascaderNodeType, FlatDataConfig, GetShowIndicesOption } from '../types/index.js';
 export declare function buildCascaderEngine<T extends Record<string, any>>(data: T[], config: FlatDataConfig): CascaderNodeType<T>[];
 export declare function getCascadeColumns<T>(nodes: CascaderNodeType<T>[], showIndices: number[]): CascaderNodeType<T>[][];
-export declare function getShowIndices<T>(nodes: CascaderNodeType<T>[], option: GetShowIndicesOption): number[];
-export declare function getDefaultIndices<T>(nodes: CascaderNodeType<T>[]): number[];
+export declare function changeShowPath<T>(nodes: CascaderNodeType<T>[], option: GetShowIndicesOption): number[];
+export declare function getShowPath<T>(nodes: CascaderNodeType<T>[], targetNode?: CascaderNodeType): number[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zidian-primitive/cascader",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "main": "./src/index.ts",
   "license": "MIT",
   "type": "module",
@@ -30,4 +30,4 @@
     "react": "19.0.0",
     "react-dom": "19.0.0"
   }
-}
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from "./components"
+
+export * from "./hooks/useCascader"
+
+export * from "./utils/index"
+
+export * from "./types"
+