@apia/tree 2.0.9 → 2.0.11

package/dist/TreeContext.js

@@ -0,0 +1,22 @@
+import { jsx } from '@apia/theme/jsx-runtime';
+import React from 'react';
+
+const TreeContext = React.createContext({});
+function useTreeContext() {
+  const context = React.useContext(TreeContext);
+  if (!context)
+    throw new Error("There is no tree context");
+  return context;
+}
+const TreeContextProvider = ({
+  children,
+  value
+}) => {
+  const Provider = React.useMemo(() => {
+    return TreeContext.Provider;
+  }, []);
+  return /* @__PURE__ */ jsx(Provider, { value, children });
+};
+
+export { TreeContextProvider, TreeContext as default, useTreeContext };
+//# sourceMappingURL=TreeContext.js.map

package/dist/TreeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeContext.js","sources":["../src/TreeContext.tsx"],"sourcesContent":["import React from 'react';\r\nimport TreeDataController from './TreeDataController';\r\nimport { TDataNode, TTreeProps } from './types';\r\n\r\nexport type TTreeContext<\r\n  NodeProps extends Record<string, unknown> = Record<string, unknown>,\r\n  NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>,\r\n> = {\r\n  forceUpdate: number;\r\n  name: string;\r\n  handler: TreeDataController<NodeProps, NodeType>;\r\n  treeProps: TTreeProps<NodeProps, NodeType>;\r\n} & Pick<TTreeProps, 'focusGetter'>;\r\n\r\nconst TreeContext = React.createContext({} as TTreeContext);\r\n\r\nexport function useTreeContext<\r\n  NodeProps extends Record<string, unknown> = Record<string, unknown>,\r\n  NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>,\r\n>() {\r\n  const context = React.useContext(TreeContext);\r\n  if (!context) throw new Error('There is no tree context');\r\n  return context as unknown as TTreeContext<NodeProps, NodeType>;\r\n}\r\n\r\nexport const TreeContextProvider = <\r\n  NodeProps extends Record<string, unknown> = Record<string, unknown>,\r\n  NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>,\r\n>({\r\n  children,\r\n  value,\r\n}: {\r\n  children: React.ReactNode;\r\n  value: TTreeContext<NodeProps, NodeType>;\r\n}) => {\r\n  const Provider = React.useMemo(() => {\r\n    return TreeContext.Provider as unknown as React.Provider<\r\n      TTreeContext<NodeProps, NodeType>\r\n    >;\r\n  }, []);\r\n\r\n  return <Provider value={value}>{children}</Provider>;\r\n};\r\n\r\nexport default TreeContext;\r\n"],"names":[],"mappings":";;;AAcA,MAAM,WAAc,GAAA,KAAA,CAAM,aAAc,CAAA,EAAkB,EAAA;AAEnD,SAAS,cAGZ,GAAA;AACF,EAAM,MAAA,OAAA,GAAU,KAAM,CAAA,UAAA,CAAW,WAAW,CAAA,CAAA;AAC5C,EAAA,IAAI,CAAC,OAAA;AAAS,IAAM,MAAA,IAAI,MAAM,0BAA0B,CAAA,CAAA;AACxD,EAAO,OAAA,OAAA,CAAA;AACT,CAAA;AAEO,MAAM,sBAAsB,CAGjC;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AACF,CAGM,KAAA;AACJ,EAAM,MAAA,QAAA,GAAW,KAAM,CAAA,OAAA,CAAQ,MAAM;AACnC,IAAA,OAAO,WAAY,CAAA,QAAA,CAAA;AAAA,GAGrB,EAAG,EAAE,CAAA,CAAA;AAEL,EAAO,uBAAA,GAAA,CAAC,QAAS,EAAA,EAAA,KAAA,EAAe,QAAS,EAAA,CAAA,CAAA;AAC3C;;;;"}

package/dist/TreeDataController.d.ts

@@ -0,0 +1,116 @@
+import React__default, { RefObject } from 'react';
+import { TDataNode, TId, TTreeDataControllerConfig, TTreeDataControllerState, TDataNodeContainer } from './types.js';
+import { EventEmitter, PropsStore, TModify, TRequireOnlyOne, TUpdateFieldConfiguration, TPropsConfiguration } from '@apia/util';
+
+declare function useTreeDataController<TreeType extends TreeDataController<any, any> = TreeDataController<any, any>>(name: string): TreeType;
+declare class TreeDataController<NodeProps extends Record<string, unknown> = Record<string, unknown>, NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>> extends EventEmitter<{
+    onArrowUpOnFirstElement: boolean;
+    expandNode: NodeType;
+    mustFocus: TId;
+    stateUpdate: null;
+}> {
+    name: string;
+    propsStore: PropsStore<NodeType>;
+    _configuration: RefObject<TTreeDataControllerConfig<NodeProps, NodeType>>;
+    get configuration(): {
+        current: TTreeDataControllerConfig<NodeProps, NodeType> | null;
+    };
+    hasApendedFirstChild: boolean;
+    /**
+     * Este array se usa para conocer los padres faltantes al momento de la
+     * construcción del árbol, de forma de optimizar el proceso
+     */
+    missingParents: TId[];
+    nonEmittedUpdates: TId[];
+    get state(): TTreeDataControllerState;
+    stateKey: string;
+    get stateStore(): PropsStore<TTreeDataControllerState>;
+    constructor(name: string, configuration: RefObject<Partial<TTreeDataControllerConfig<NodeProps, NodeType>>>, propsStore?: PropsStore<NodeType>);
+    destructor(): void;
+    append(node: Omit<TModify<NodeType, {
+        children?: NodeType['children'];
+        parentId?: NodeType['parentId'];
+    }>, 'nodeProps' | 'actualParentId'> & Partial<Pick<NodeType, 'nodeProps'>>): void;
+    /**
+     * Cuando se quieren agregar muchos nodos, es conveniente llamar primero al
+     * método batchInit y luego de finalizar, al método batchFinish()
+     */
+    batchInit(): void;
+    private getNodesRecursive;
+    /**
+     * Cuando se quieren agregar muchos nodos, es conveniente llamar primero al
+     * método batchInit y luego de finalizar, al método batchFinish()
+     */
+    batchFinish(): void;
+    config(newConf: Partial<TTreeDataControllerConfig<NodeProps, NodeType>>): void;
+    deselectAll(): void;
+    forceEmitUpdate(): void;
+    getInitialState(): TTreeDataControllerState;
+    getNodesAsArray(): NodeType[];
+    /**
+     * Devuelve un array que contiene el id de todos los nodos pertenecientes al
+     * árbol
+     */
+    getNodesIds(): string[];
+    getParentId(parentId: TId): TId;
+    /**
+     * Este método permite controlar el comportamiento con el teclado desde fuera
+     * del componente.
+     */
+    handleKey(ev: React__default.KeyboardEvent): void;
+    isNode(node: NodeType | TDataNodeContainer<NodeProps> | TId): node is NodeType;
+    isNodeContainer(node: NodeType | TDataNodeContainer<NodeProps> | TId): node is TDataNodeContainer<NodeProps>;
+    includes(searchNode: NodeType): boolean;
+    initRoot(): void;
+    move(moveNode: TId, destinationNode: TId, afterOrBefore?: TRequireOnlyOne<{
+        after: NodeType | TId;
+        before: NodeType | TId;
+        position: number;
+    }>): void;
+    /**
+     * Borra el nodo del árbol, y dependiendo del parámetro removeChildren, borra
+     * también sus hijos.
+     *
+     * @param removeChildren - Si se pasa en false, los nodos hijos son movidos al root
+     */
+    remove(removeNode: NodeType | TId, removeChildren?: boolean): void;
+    removeMultiple(nodes: TId[], removeChildren?: boolean): void;
+    previousNodes: TId[];
+    /**
+     * Borra todos los nodos del árbol.
+     */
+    removeAll(): void;
+    selectAll(): void;
+    setExpandedNodes(nodes: TId[]): void;
+    setFocusedNode(key: TId, avoidSelection?: boolean): void;
+    setSelectedNodes(nodes: TId[], force?: boolean): void;
+    setSelectedNodesByClickEvent(ev: React__default.MouseEvent): void;
+    setState: (updateProps: Partial<TTreeDataControllerState>, conf?: TUpdateFieldConfiguration) => void;
+    useState: <T>(selector: (state: TTreeDataControllerState) => T) => T;
+    toggleNodeExpandedState(key: TId, shouldExpand?: boolean): void;
+    toggleNodeSelectedState(key: TId, isSelected?: boolean): void;
+}
+/**
+ * Este hook permite escuchar las props de un árbol, para ello es necesario
+ * pasar el handler.
+ *
+ * @param handler
+ * @param configuration
+ * @returns
+ */
+declare function useTreeSelector<NodeProps extends Record<string, unknown> = Record<string, unknown>, NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>, Selected = Record<string, unknown>, PropsType extends Record<string, unknown> = TTreeDataControllerState>(handler: TreeDataController<NodeProps, NodeType>, configuration?: TPropsConfiguration<Selected, PropsType>): Selected;
+/**
+ * Este hook permite escuchar las props de un árbol, para ello es necesario
+ * pasar el handler.
+ *
+ * @param handler
+ * @param configuration
+ * @returns
+ */
+declare function useTreeSelectorByName<NodeProps extends Record<string, unknown> = Record<string, unknown>, NodeType extends TDataNode<NodeProps> = TDataNode<NodeProps>, Selected = Record<string, unknown>, PropsType extends Record<string, unknown> = TTreeDataControllerState>(treeName: string, configuration?: TPropsConfiguration<Selected, PropsType>): {
+    handler: TreeDataController<NodeProps, NodeType>;
+    selection: Selected;
+};
+
+export { TreeDataController as default, useTreeDataController, useTreeSelector, useTreeSelectorByName };
+//# sourceMappingURL=TreeDataController.d.ts.map

package/dist/TreeDataController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeDataController.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}