@soybeanjs/headless 0.29.2 → 0.30.0-beta.1

package/dist/components/cascader/cascader-tags.vue.d.ts

@@ -0,0 +1,23 @@
+import { DefinedValue } from "../../types/common.js";
+import { CascaderNode, CascaderTagsProps } from "./types.js";
+import "../../index.js";
+//#region src/components/cascader/cascader-tags.vue.d.ts
+declare var __VLS_1: {
+  node: CascaderNode<DefinedValue>;
+  remove: (node: CascaderNode<DefinedValue>) => void;
+}, __VLS_3: {};
+type __VLS_Slots = {} & {
+  tag?: (props: typeof __VLS_1) => any;
+} & {
+  value?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<CascaderTagsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CascaderTagsProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as default };

package/dist/components/cascader/cascader-trigger.js

@@ -0,0 +1 @@
+import{useForwardElement as e}from"../../composables/use-forward-element.js";import"../../composables/index.js";import{Primitive as t}from"../primitive/primitive.js";import"../primitive/index.js";import n from"../popper/popper-anchor.js";import"../popper/index.js";import{useCascaderRootContext as r,useCascaderUi as i}from"./context.js";import{computed as a,createBlock as o,createVNode as s,defineComponent as c,normalizeClass as l,openBlock as u,renderSlot as d,unref as f,withCtx as p}from"vue";const m=c({name:`CascaderTrigger`,__name:`cascader-trigger`,props:{disabled:{type:Boolean},reference:{},asChild:{type:Boolean},as:{default:`div`}},setup(c){let m=c,{open:h,multiple:g,dataState:_,disabled:v,filterable:y,contentId:b,highlightedId:x,onTriggerElementChange:S,onOpenChange:C,handleKeydown:w}=r(`CascaderTrigger`),[T,E]=e(S),D=i(`trigger`),O=a(()=>!!v.value||!!m.disabled),k=a(()=>!!y.value),A=()=>{O.value||C(!h.value)},j=e=>{if(h.value){w(e);return}[` `,`Enter`,`ArrowDown`,`ArrowUp`].includes(e.key)&&(e.preventDefault(),C(!0))};return(e,r)=>(u(),o(f(n),{"as-child":``,reference:c.reference},{default:p(()=>[s(f(t),{ref:f(E),as:c.as,"as-child":c.asChild,"data-soybean-cascader-trigger":``,class:l(f(D)),"aria-controls":f(b),"aria-expanded":f(h)||!1,"aria-haspopup":`tree`,"aria-activedescendant":f(x)??void 0,"aria-disabled":O.value||void 0,"data-multiple":f(g)?``:void 0,"data-state":f(_),"data-disabled":O.value?``:void 0,tabindex:k.value?-1:O.value?void 0:0,role:`combobox`,onClick:A,onKeydown:j},{default:p(()=>[d(e.$slots,`default`)]),_:3},8,[`as`,`as-child`,`class`,`aria-controls`,`aria-expanded`,`aria-activedescendant`,`aria-disabled`,`data-multiple`,`data-state`,`data-disabled`,`tabindex`])]),_:3},8,[`reference`]))}});export{m as default};

package/dist/components/cascader/cascader-trigger.vue.d.ts

@@ -0,0 +1,20 @@
+import { AsTag } from "../primitive/types.js";
+import "../primitive/index.js";
+import { CascaderTriggerProps } from "./types.js";
+//#region src/components/cascader/cascader-trigger.vue.d.ts
+declare var __VLS_17: {};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_17) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<CascaderTriggerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CascaderTriggerProps> & Readonly<{}>, {
+  as: AsTag | import("vue").Component;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as default };

package/dist/components/cascader/cascader-value.js

@@ -0,0 +1 @@
+import{useCascaderRootContext as e,useCascaderUi as t}from"./context.js";import{computed as n,createElementBlock as r,createTextVNode as i,defineComponent as a,normalizeClass as o,openBlock as s,renderSlot as c,toDisplayString as l,unref as u}from"vue";const d=[`data-placeholder`],f=a({name:`CascaderValue`,__name:`cascader-value`,props:{placeholder:{default:``}},setup(a){let f=a,{modelValue:p,selectedLabels:m,placeholder:h,multiple:g,separator:_}=e(`CascaderValue`),v=t(`value`),y=n(()=>m.value.length===0),b=n(()=>m.value.length===0?f.placeholder||h.value||``:m.value.join(g.value?`, `:_.value??` / `));return(e,t)=>(s(),r(`span`,{"data-soybean-cascader-value":``,class:o(u(v)),"data-placeholder":y.value?b.value:void 0,style:{"pointer-events":`none`}},[c(e.$slots,`default`,{modelValue:u(p),selectedLabels:u(m),slotText:b.value},()=>[i(l(b.value),1)])],10,d))}});export{f as default};

package/dist/components/cascader/cascader-value.vue.d.ts

@@ -0,0 +1,22 @@
+import { CascaderModelValue, CascaderValueProps } from "./types.js";
+//#region src/components/cascader/cascader-value.vue.d.ts
+declare var __VLS_1: {
+  modelValue: CascaderModelValue;
+  selectedLabels: string[];
+  slotText: string;
+};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<CascaderValueProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CascaderValueProps> & Readonly<{}>, {
+  placeholder: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as default };

package/dist/components/cascader/context.d.ts

@@ -0,0 +1,46 @@
+import { DefinedValue, Direction, UiClass } from "../../types/common.js";
+import "../../types/index.js";
+import { UseUiConsumer } from "../../composables/use-ui-context.js";
+import "../../composables/index.js";
+import { CascaderFieldKeys, CascaderModelValue, CascaderNode, CascaderOptionData, CascaderRootContextParams, CascaderUiSlot } from "./types.js";
+import "../../index.js";
+import { ComputedRef, ShallowRef } from "vue";
+//#region src/components/cascader/context.d.ts
+/**
+ * Parameters used to create the CascaderRoot context.
+ */
+interface CascaderRootProviderParams {
+  dir: ComputedRef<Direction | undefined>;
+  disabled: ComputedRef<boolean | undefined>;
+  clearable: ComputedRef<boolean | undefined>;
+  expandTrigger: ComputedRef<'click' | 'hover' | undefined>;
+  checkStrictly: ComputedRef<boolean | undefined>;
+  multiple: ComputedRef<boolean | undefined>;
+  pathMode: ComputedRef<boolean | undefined>;
+  showCheckedStrategy: ComputedRef<'child' | 'parent' | undefined>;
+  separator: ComputedRef<string | undefined>;
+  filterable: ComputedRef<boolean | undefined>;
+  remote: ComputedRef<boolean | undefined>;
+  lazy: ComputedRef<boolean | undefined>;
+  searchDelay: ComputedRef<number | undefined>;
+  virtualScroll: ComputedRef<boolean | undefined>;
+  itemSize: ComputedRef<number | undefined>;
+  height: ComputedRef<number | undefined>;
+  placeholder: ComputedRef<string | undefined>;
+  fieldKeys: ComputedRef<CascaderFieldKeys | undefined>;
+  options: ComputedRef<CascaderOptionData<DefinedValue>[] | undefined>;
+  filter: ((pattern: string, option: CascaderOptionData<DefinedValue>, path: string[]) => boolean) | undefined;
+  onLoad: ((option: CascaderNode<DefinedValue>) => Promise<CascaderOptionData<DefinedValue>[]>) | undefined;
+  onSearch: ((pattern: string) => Promise<CascaderOptionData<DefinedValue>[]>) | undefined;
+  onLoaded: ((node: CascaderNode<DefinedValue>) => void) | undefined;
+  open: ShallowRef<boolean | undefined>;
+  onOpenChange: (value: boolean) => void;
+  modelValue: ShallowRef<CascaderModelValue | undefined>;
+  onModelValueChange: (value: CascaderModelValue) => void;
+  onChange: (value: CascaderModelValue | undefined, nodes: CascaderNode<DefinedValue>[]) => void;
+  onClear: () => void;
+}
+declare const provideCascaderRootContext: (params: CascaderRootProviderParams) => CascaderRootContextParams, useCascaderRootContext: import("@soybeanjs/hooks").ContextConsumer<CascaderRootContextParams>;
+declare const provideCascaderUi: (ui: ComputedRef<Partial<UiClass<CascaderUiSlot>>>) => ComputedRef<Partial<UiClass<CascaderUiSlot>>>, useCascaderUi: UseUiConsumer<CascaderUiSlot>;
+//#endregion
+export { CascaderRootProviderParams, provideCascaderRootContext, provideCascaderUi };

package/dist/components/cascader/context.js

@@ -0,0 +1 @@
+import{getDisclosureState as e}from"../../shared/value.js";import{useContext as t}from"../../composables/use-context.js";import{useDirection as n}from"../config-provider/context.js";import"../../shared/index.js";import{useUiContext as r}from"../../composables/use-ui-context.js";import"../../composables/index.js";import{providePopperUi as i}from"../popper/context.js";import{mergeCascaderFieldKeys as a}from"./shared.js";import{useCascaderData as o}from"./hooks.js";import{computed as s,shallowRef as c,toValue as l,useId as u,watch as d}from"vue";const[f,p]=t(`CascaderRoot`,t=>{let r=s(()=>e(!!t.open.value)),i=n(t.dir),f=`soybean-cascader-${u()}`,p=s(()=>`${f}-content`),m=e=>`${f}-option-${e.uid}`,h=c(),g=c(),_=e=>{h.value=e},v=e=>{g.value=e},y=o({options:t.options,fieldKeys:t.fieldKeys,multiple:t.multiple,pathMode:t.pathMode,checkStrictly:t.checkStrictly,showCheckedStrategy:t.showCheckedStrategy,expandTrigger:t.expandTrigger,separator:t.separator,lazy:t.lazy,searchDelay:t.searchDelay,filterable:t.filterable,remote:t.remote,filter:t.filter,onLoad:t.onLoad,onSearch:t.onSearch,onLoaded:t.onLoaded,modelValue:t.modelValue,onModelValueChange:t.onModelValueChange,onChange:t.onChange,idPrefix:f}),b=(e,n)=>{y.onOptionSelect(e,n),!y.isMultiple.value&&(y.isCheckStrictly.value||e.isLeaf)&&t.onOpenChange(!1)},x=()=>{y.clearValue(),t.onClear()};return d(t.open,e=>{if(e){let e=y.selectedNodes.value;e.length>0&&(y.highlighted.value=e[0])}else y.searchPattern.value=``,y.highlighted.value=null,l(t.filterable)&&(y.expandingPath.value=[])}),{...t,fieldKeys:s(()=>a(t.fieldKeys?.value)),dataState:r,dir:i,contentId:p,getOptionId:m,triggerElement:h,contentElement:g,onTriggerElementChange:_,onContentElementChange:v,rootNodes:y.rootNodes,menus:y.menus,highlighted:y.highlighted,highlightedId:y.highlightedId,selectedNodes:y.selectedNodes,selectedLabels:y.selectedLabels,isSearchMode:y.isSearchMode,searchPattern:y.searchPattern,searchResults:y.searchResults,searchLoading:y.searchLoading,loadingKeys:y.loadingKeys,expandNode:y.expandNode,onOptionSelect:b,onOptionHover:y.onOptionHover,setHighlighted:y.setHighlighted,isChecked:y.isChecked,isIndeterminate:y.isIndeterminate,isSelected:y.isSelected,toggleCheck:y.toggleCheck,removeNode:y.removeNode,clearValue:x,handleKeydown:y.handleKeydown}}),[m,h]=r(`CascaderUi`,e=>(i(e),e));export{f as provideCascaderRootContext,m as provideCascaderUi,p as useCascaderRootContext,h as useCascaderUi};

package/dist/components/cascader/hooks.js

@@ -0,0 +1 @@
+import{getVueBooleanCasting as e}from"../../shared/vue.js";import"../../shared/index.js";import{buildCascaderNodes as t,createCascaderNode as n,findCascaderNodeByPath as r,findCascaderNodeByValue as i,flattenCascaderNodes as a,getCascaderAncestorPath as o,isLazyCascaderNode as s,mergeCascaderFieldKeys as ee}from"./shared.js";import{computed as c,onWatcherCleanup as te,shallowRef as l,toValue as u,watch as d}from"vue";function f(f){let{options:ne,filter:re,onLoad:p,onSearch:m,onLoaded:ie,modelValue:h,onModelValueChange:g,onChange:_,idPrefix:ae}=f,v=c(()=>ee(u(f.fieldKeys))),y=c(()=>u(ne)),b=c(()=>e(u(f.multiple))),x=c(()=>e(u(f.pathMode))),S=c(()=>!!u(f.checkStrictly)),C=c(()=>u(f.showCheckedStrategy)??`child`),oe=c(()=>u(f.expandTrigger)??`click`),w=c(()=>u(f.separator)??` / `),se=c(()=>!!u(f.lazy)),T=c(()=>!!u(f.filterable)),E=c(()=>!!u(f.remote)),D=c(()=>u(f.searchDelay)??300),O=c(()=>t(y.value,v.value)),k=c(()=>a(O.value)),A=l([]),j=c(()=>{let e=[O.value];for(let t of A.value)if(t.children&&t.children.length>0)e.push(t.children);else break;return e}),M=c(()=>new Set(k.value.filter(e=>e.loading).map(e=>e.uid)));async function N(e){if(p&&!(e.loading||e.loaded)){e.loading=!0;try{e.children=(await p(e)??[]).map((t,r)=>n(t,v.value,e,r)),e.loaded=!0,e.isLeaf=e.children.length===0,ie?.(e)}finally{e.loading=!1}}}let P=l(null);function F(e,t){e.checked=t,e.indeterminate=!1;let n=e.children;if(n)for(let e of n)F(e,t)}function I(e){let t=e.parent;for(;t;){let e=t.children;if(e===null){t.checked=!1,t.indeterminate=!0,t=t.parent;continue}let n=e.filter(e=>e.checked).length,r=e.some(e=>e.indeterminate);n===e.length?(t.checked=!0,t.indeterminate=!1):n>0||r?(t.checked=!1,t.indeterminate=!0):(t.checked=!1,t.indeterminate=!1),t=t.parent}}function L(e){let t=C.value,n=[],r=e=>{for(let i of e)i.checked&&(t===`parent`?(S.value||!i.parent||!i.parent.checked)&&n.push(i):(i.children??[]).some(e=>e.checked)||n.push(i)),i.children&&r(i.children)};return r(e),n}let R=c(()=>b.value?L(O.value):P.value?[P.value]:[]),z=c(()=>{let e=R.value;if(b.value)return e.map(e=>e.label);let t=e[0];return t?[t.pathLabels.join(w.value)]:[]}),ce=c(()=>new Set(k.value.filter(e=>e.checked).map(e=>e.uid))),le=c(()=>new Set(k.value.filter(e=>e.indeterminate).map(e=>e.uid)));function B(e){if(b.value){let t=x.value?e.map(e=>e.pathValues):e.map(e=>e.value);g(t),_?.(t,e);return}let t=e[0],n=t?x.value?t.pathValues:t.value:void 0;g(n),_?.(n,e)}async function V(e){e.disabled||(!S.value&&e.children===null&&await N(e),S.value?(e.checked=!e.checked,e.indeterminate=!1):(F(e,!e.checked),I(e)),B(L(O.value)))}function H(e,t){if(!e.disabled){if(b.value){V(e),e.isLeaf||W(e);return}if(S.value||e.isLeaf){P.value=e,A.value=o(e),Z.value=e,B([e]);return}W(e)}}function U(e){Z.value=e,oe.value===`hover`&&!e.isLeaf&&W(e)}function W(e,t){e.disabled||(A.value=[...A.value.slice(0,e.level),e],s(e)&&N(e))}function ue(){for(let e of k.value)e.checked=!1,e.indeterminate=!1;P.value=null,A.value=[],Z.value=null,g(b.value?[]:void 0)}function de(e){!e.checked&&!e.indeterminate||(F(e,!1),I(e),B(L(O.value)))}function fe(e){return e.checked}function pe(e){return e.indeterminate}function me(e){return b.value?e.checked:P.value?.uid===e.uid}function he(){for(let e of k.value)e.checked=!1,e.indeterminate=!1}function ge(e){if(e==null)return[];let t=b.value?e:[e],n=[];for(let e of t){let t=x.value?r(O.value,e):i(O.value,e);t&&n.push(t)}return n}function G(){let e=h.value;if(he(),e==null){P.value=null;return}let t=ge(e);if(b.value){if(S.value)for(let e of t)e.checked=!0,e.indeterminate=!1;else{for(let e of t)F(e,!0);for(let e of t)I(e)}return}let n=t[0];P.value=n??null,n&&(A.value=o(n))}d([y,v],()=>{P.value=null,A.value=[],G()},{flush:`post`}),d(h,()=>G(),{flush:`post`});let K=l(``),q=l([]),J=l(!1),Y=c(()=>!!K.value&&(T.value||E.value)),X=c(()=>{let e=K.value;if(!e)return[];if(E.value)return q.value;if(T.value){let t=re??((e,t,n)=>n.some(t=>String(t).toLowerCase().includes(e.toLowerCase())));return k.value.filter(n=>!n.disabled&&t(e,n.raw,n.pathLabels))}return[]});d(K,e=>{if(!E.value||!m)return;if(!e){q.value=[],J.value=!1;return}J.value=!0;let t=setTimeout(async()=>{try{let t=(await m(e)??[]).map((e,t)=>n(e,v.value,null,t));q.value=a(t)}finally{J.value=!1}},D.value);te(()=>clearTimeout(t))},{flush:`post`});let Z=l(null),_e=c(()=>Z.value?`${ae}-option-${Z.value.uid}`:null);function ve(e){Z.value=e}function ye(){if(Y.value)return X.value;let e=Z.value,t=e?e.level:j.value.length-1;return j.value[t]??[]}function Q(e){let t=ye().filter(e=>!e.disabled);if(t.length===0)return;let n=Z.value,r;if(e===`home`)r=0;else if(e===`end`)r=t.length-1;else{let i=n?t.findIndex(e=>e.uid===n.uid):-1;i===-1?r=e===`down`?0:t.length-1:(r=e===`down`?i+1:i-1,r>=t.length&&(r=0),r<0&&(r=t.length-1))}Z.value=t[r]}function $(e){let t=Z.value;if(t){if(e===`next`){if(!t.isLeaf){W(t);let e=t.children;e&&e.length>0?Z.value=e.find(e=>!e.disabled)??e[0]:s(t)&&(Z.value=t)}return}t.parent&&(Z.value=t.parent)}}function be(e){if(!(e.ctrlKey||e.altKey||e.metaKey)){if(Y.value){if(e.key===`ArrowDown`||e.key===`ArrowUp`)e.preventDefault(),Q(e.key===`ArrowDown`?`down`:`up`);else if(e.key===`Enter`){let t=Z.value;t&&(e.preventDefault(),H(t,e))}return}switch(e.key){case`ArrowDown`:e.preventDefault(),Q(`down`);break;case`ArrowUp`:e.preventDefault(),Q(`up`);break;case`Home`:e.preventDefault(),Q(`home`);break;case`End`:e.preventDefault(),Q(`end`);break;case`ArrowRight`:e.preventDefault(),$(`next`);break;case`ArrowLeft`:e.preventDefault(),$(`prev`);break;case`Enter`:{let t=Z.value;t&&(e.preventDefault(),H(t,e));break}}}}return{rootNodes:O,flatNodes:k,expandingPath:A,menus:j,isMultiple:b,isPathMode:x,isCheckStrictly:S,showCheckedStrategyRef:C,separatorRef:w,isLazy:se,isFilterable:T,isRemote:E,loadingKeys:M,loadChildren:N,selectedNodes:R,selectedLabels:z,checkedKeys:ce,indeterminateKeys:le,onOptionSelect:H,onOptionHover:U,expandNode:W,clearValue:ue,toggleCheck:V,removeNode:de,isChecked:fe,isIndeterminate:pe,isSelected:me,searchPattern:K,isSearchMode:Y,searchResults:X,searchLoading:J,highlighted:Z,highlightedId:_e,setHighlighted:ve,handleKeydown:be}}export{f as useCascaderData};

package/dist/components/cascader/index.d.ts

@@ -0,0 +1,14 @@
+import { CascaderArrowProps, CascaderClearProps, CascaderCompactEmits, CascaderCompactOptionSlotProps, CascaderCompactProps, CascaderCompactSlots, CascaderCompactTagSlotProps, CascaderCompactTriggerValueSlotProps, CascaderContentEmits, CascaderContentProps, CascaderEmptyProps, CascaderExpandEvent, CascaderFieldKeys, CascaderMenuProps, CascaderModelValue, CascaderNode, CascaderOptionData, CascaderOptionEmits, CascaderOptionProps, CascaderPortalProps, CascaderRootContextParams, CascaderRootEmits, CascaderRootProps, CascaderSearchInputProps, CascaderSelectEvent, CascaderTagsProps, CascaderTagsSlots, CascaderTriggerProps, CascaderUi, CascaderUiSlot, CascaderValue, CascaderValueProps } from "./types.js";
+import _default$6 from "./cascader-root.vue.js";
+import _default$9 from "./cascader-trigger.vue.js";
+import _default$10 from "./cascader-value.vue.js";
+import _default$7 from "./cascader-search-input.vue.js";
+import _default$2 from "./cascader-content.vue.js";
+import _default$4 from "./cascader-menu.vue.js";
+import _default$5 from "./cascader-option.vue.js";
+import _default$3 from "./cascader-empty.vue.js";
+import _default$8 from "./cascader-tags.vue.js";
+import _default from "./cascader-clear.vue.js";
+import _default$1 from "./cascader-compact.vue.js";
+import { provideCascaderRootContext, provideCascaderUi } from "./context.js";
+export { type CascaderArrowProps, _default as CascaderClear, type CascaderClearProps, _default$1 as CascaderCompact, type CascaderCompactEmits, type CascaderCompactOptionSlotProps, type CascaderCompactProps, type CascaderCompactSlots, type CascaderCompactTagSlotProps, type CascaderCompactTriggerValueSlotProps, _default$2 as CascaderContent, type CascaderContentEmits, type CascaderContentProps, _default$3 as CascaderEmpty, type CascaderEmptyProps, type CascaderExpandEvent, type CascaderFieldKeys, _default$4 as CascaderMenu, type CascaderMenuProps, type CascaderModelValue, type CascaderNode, _default$5 as CascaderOption, type CascaderOptionData, type CascaderOptionEmits, type CascaderOptionProps, type CascaderPortalProps, _default$6 as CascaderRoot, type CascaderRootContextParams, type CascaderRootEmits, type CascaderRootProps, _default$7 as CascaderSearchInput, type CascaderSearchInputProps, type CascaderSelectEvent, _default$8 as CascaderTags, type CascaderTagsProps, type CascaderTagsSlots, _default$9 as CascaderTrigger, type CascaderTriggerProps, type CascaderUi, type CascaderUiSlot, _default$10 as CascaderValue, type CascaderValueProps, type CascaderValue as CascaderValueType, provideCascaderRootContext, provideCascaderUi };

package/dist/components/cascader/index.js

@@ -0,0 +1 @@
+import{provideCascaderRootContext as e,provideCascaderUi as t}from"./context.js";import n from"./cascader-root.js";import r from"./cascader-trigger.js";import i from"./cascader-value.js";import a from"./cascader-search-input.js";import o from"./cascader-empty.js";import s from"./cascader-option.js";import c from"./cascader-menu.js";import l from"./cascader-content.js";import u from"./cascader-tags.js";import d from"./cascader-clear.js";import f from"./cascader-compact.js";export{d as CascaderClear,f as CascaderCompact,l as CascaderContent,o as CascaderEmpty,c as CascaderMenu,s as CascaderOption,n as CascaderRoot,a as CascaderSearchInput,u as CascaderTags,r as CascaderTrigger,i as CascaderValue,e as provideCascaderRootContext,t as provideCascaderUi};

package/dist/components/cascader/shared.js

@@ -0,0 +1 @@
+import{shallowReactive as e}from"vue";const t=(()=>{let e=0;return()=>`cascader-node-${e++}`})(),n=`cascader.select`,r=`cascader.expand`,i={value:`value`,label:`label`,children:`children`,disabled:`disabled`};function a(e){return{...i,...e}}function o(n,r,i,a){let s=n[r.value]??a,c=n[r.label]??String(s),l=!!n[r.disabled],u=n[r.children],d=u===!0,f=e({uid:t(),value:s,label:c,disabled:l,raw:n,children:null,isLeaf:!0,level:i?i.level+1:0,pathValues:i?[...i.pathValues,s]:[s],pathLabels:i?[...i.pathLabels,c]:[c],loading:!1,loaded:!d,parent:i,checked:!1,indeterminate:!1});if(d)f.children=null,f.isLeaf=!1,f.loaded=!1;else if(Array.isArray(u)){let e=u.map((e,t)=>o(e,r,f,t));f.children=e,f.isLeaf=e.length===0}else f.children=[],f.isLeaf=!0;return f}function s(e,t){return(e??[]).map((e,n)=>o(e,t,null,n))}function c(e,t=[]){for(let n of e)t.push(n),n.children&&c(n.children,t);return t}function l(e,t){for(let n of e){if(n.value===t)return n;if(n.children){let e=l(n.children,t);if(e)return e}}}function u(e,t){return d(e,t,0)}function d(e,t,n){if(n>=t.length)return;let r=t[n];for(let i of e)if(i.value===r)return n===t.length-1?i:i.children?d(i.children,t,n+1):void 0}function f(e){let t=[],n=e;for(;n;)t.unshift(n),n=n.parent;return t}function p(e,t){let n=e.parent;for(;n;){if(n.uid===t.uid)return!0;n=n.parent}return!1}function m(e){return e.children===null}export{r as CASCADER_EXPAND_EVENT,n as CASCADER_SELECT_EVENT,s as buildCascaderNodes,o as createCascaderNode,u as findCascaderNodeByPath,l as findCascaderNodeByValue,c as flattenCascaderNodes,f as getCascaderAncestorPath,p as isCascaderNodeAncestor,m as isLazyCascaderNode,a as mergeCascaderFieldKeys};

package/dist/components/cascader/types.d.ts

@@ -0,0 +1,479 @@
+import { DefinedValue, Direction, UiClass } from "../../types/common.js";
+import { PointerDownOutsideEvent } from "../../types/event.js";
+import { DismissableLayerProps, ForceMountProps, FormFieldCommonProps } from "../../types/component.js";
+import { BaseProps, PropsToContext } from "../../types/vue.js";
+import "../../types/index.js";
+import { PrimitiveWithBaseProps } from "../primitive/types.js";
+import { PopperAnchorProps, PopperArrowProps, PopperPositionerProps } from "../popper/types.js";
+import { PortalProps } from "../portal/types.js";
+import { ComputedRef, ShallowRef } from "vue";
+//#region src/components/cascader/types.d.ts
+/** Alias of the popper arrow props used by the cascader arrow part. */
+type CascaderArrowProps = PopperArrowProps;
+/** Alias of the portal props used by the cascader portal part. */
+type CascaderPortalProps = PortalProps;
+/**
+ * Raw option data for the Cascader component.
+ *
+ * The fields `value`, `label`, `children` and `disabled` can be mapped to arbitrary keys
+ * of the raw option via the `fieldKeys` prop.
+ */
+interface CascaderOptionData<T extends DefinedValue = DefinedValue> {
+  value?: T;
+  label?: string;
+  children?: CascaderOptionData<T>[] | true;
+  disabled?: boolean;
+  [key: string]: unknown;
+}
+/**
+ * Field keys used to extract the `value`, `label`, `children` and `disabled` fields
+ * from the raw option data.
+ */
+interface CascaderFieldKeys {
+  /** Key of the option value. @defaultValue 'value' */
+  value?: string;
+  /** Key of the option label. @defaultValue 'label' */
+  label?: string;
+  /** Key of the option children. A `true` value marks a lazy-loadable node. @defaultValue 'children' */
+  children?: string;
+  /** Key of the option disabled state. @defaultValue 'disabled' */
+  disabled?: string;
+}
+/**
+ * Internal node model of the Cascader component.
+ *
+ * Paths (`pathValues`, `pathLabels`) and `level` are cached while the tree is built so
+ * that lookups at runtime are O(1).
+ */
+interface CascaderNode<T extends DefinedValue = DefinedValue> {
+  /** Stable unique id of the node. */
+  uid: string;
+  /** Value of the node. */
+  value: T;
+  /** Label of the node. */
+  label: string;
+  /** Whether the node is disabled. */
+  disabled: boolean;
+  /** The raw option data the node was built from. */
+  raw: CascaderOptionData<T>;
+  /**
+   * Child nodes. `null` means the children have not been loaded yet
+   * (lazy loading has been triggered but not resolved, or the node is marked loadable).
+   */
+  children: CascaderNode<T>[] | null;
+  /** Whether the node is a leaf (no children). */
+  isLeaf: boolean;
+  /** Depth of the node, root nodes are `0`. */
+  level: number;
+  /** Values of the ancestors plus the node itself, root first. */
+  pathValues: T[];
+  /** Labels of the ancestors plus the node itself, root first. */
+  pathLabels: string[];
+  /** Whether the node is currently loading its children. */
+  loading: boolean;
+  /** Whether the children of the node have been loaded. */
+  loaded: boolean;
+  /** Parent node, `null` for root nodes. */
+  parent: CascaderNode<T> | null;
+  /** Whether the node is checked. */
+  checked: boolean;
+  /** Whether the node is in an indeterminate checked state. */
+  indeterminate: boolean;
+}
+/** Loose value shape used internally for the Cascader model value. */
+type CascaderModelValue = DefinedValue | DefinedValue[] | DefinedValue[][] | undefined;
+type SingleCascaderValue<T extends DefinedValue, P extends boolean> = P extends true ? T[] : T;
+type MultipleCascaderValue<T extends DefinedValue, P extends boolean> = P extends true ? T[][] : T[];
+/**
+ * The value type of the Cascader component.
+ *
+ * - `M = false`: single selection. `P = false` -> `T`, `P = true` -> `T[]` (one path).
+ * - `M = true`: multiple selection. `P = false` -> `T[]`, `P = true` -> `T[][]` (multiple paths).
+ */
+type CascaderValue<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> = M extends true ? MultipleCascaderValue<T, P> : SingleCascaderValue<T, P>;
+/**
+ * Properties for the CascaderRoot component.
+ */
+interface CascaderRootProps<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> extends FormFieldCommonProps {
+  /** The controlled value of the selected node(s). Can be bound with `v-model`. */
+  modelValue?: CascaderValue<T, M, P>;
+  /** The default value of the selected node(s). */
+  defaultValue?: CascaderValue<T, M, P>;
+  /** When `true`, multiple nodes can be selected. */
+  multiple?: M;
+  /**
+   * When `true`, the model value is the full path array(s) instead of the node value(s).
+   *
+   * @defaultValue false
+   */
+  pathMode?: P;
+  /** Options of the cascader. */
+  options?: CascaderOptionData<T>[];
+  /** Field keys used to extract the option fields. */
+  fieldKeys?: CascaderFieldKeys;
+  /** The controlled open state of the Cascader. Can be bound as `v-model:open`. */
+  open?: boolean;
+  /** The open state of the cascader when it is initially rendered. */
+  defaultOpen?: boolean;
+  /** When `true`, prevents the user from interacting with the Cascader. */
+  disabled?: boolean;
+  /** When `true`, the value can be cleared by the clear button. */
+  clearable?: boolean;
+  /**
+   * The trigger to expand the children of a node.
+   *
+   * @defaultValue 'click'
+   */
+  expandTrigger?: 'click' | 'hover';
+  /**
+   * When `false`, only leaf nodes can be selected (single) or the parent-children check states
+   * are linked (multiple). When `true`, any node can be selected independently.
+   *
+   * @defaultValue false
+   */
+  checkStrictly?: boolean;
+  /**
+   * The strategy used to collect and display checked nodes in multiple mode.
+   *
+   * - `child`: collect the leaves of the checked region.
+   * - `parent`: collect the topmost checked nodes (fold fully-checked subtrees into parents).
+   *
+   * @defaultValue 'child'
+   */
+  showCheckedStrategy?: 'child' | 'parent';
+  /** The separator used to join the path labels. @defaultValue ' / ' */
+  separator?: string;
+  /** When `true`, the trigger becomes a search input and the panel shows flat filtered results. */
+  filterable?: boolean;
+  /**
+   * Custom filter function used in local filtering mode. The default performs a
+   * case-insensitive `includes` match against every label of the path.
+   */
+  filter?: (pattern: string, option: CascaderOptionData<T>, path: string[]) => boolean;
+  /** When `true`, the panel loads its options from `onSearch` instead of filtering locally. */
+  remote?: boolean;
+  /** Async search function used in remote mode. Returns the flat options for the keyword. */
+  onSearch?: (pattern: string) => Promise<CascaderOptionData<T>[]>;
+  /** Debounce delay in milliseconds for filtering and remote search. @defaultValue 300 */
+  searchDelay?: number;
+  /** When `true`, children of a node are loaded asynchronously via `onLoad`. */
+  lazy?: boolean;
+  /** Async function used to load the children of a node when `lazy` is `true`. */
+  onLoad?: (option: CascaderNode<T>) => Promise<CascaderOptionData<T>[]>;
+  /** When `true`, only the visible rows of each column are rendered. */
+  virtualScroll?: boolean;
+  /** The fixed height of a row used by virtual scrolling. @defaultValue 34 */
+  itemSize?: number;
+  /** The height of the panel used by virtual scrolling. @defaultValue 204 */
+  height?: number;
+  /** The reading direction of the component. */
+  dir?: Direction;
+  /** The content shown when no node is selected. */
+  placeholder?: string;
+}
+/**
+ * Events for the CascaderRoot component.
+ */
+type CascaderRootEmits<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> = {
+  /** Event handler called when the value of the cascader changes. Can be bound as `v-model`. */
+  'update:modelValue': [value: CascaderValue<T, M, P>];
+  /** Event handler called when the open state of the cascader changes. Can be bound as `v-model:open`. */
+  'update:open': [value: boolean];
+  /** Event handler called when the value changes, with the selected nodes. */
+  change: [value: CascaderValue<T, M, P> | undefined, nodes: CascaderNode<T>[]];
+  /** Event handler called when the selection is cleared. */
+  clear: [];
+  /** Event handler called when the children of a node have been loaded (lazy mode). */
+  loaded: [node: CascaderNode<T>];
+};
+/**
+ * Properties for the CascaderTrigger component.
+ */
+interface CascaderTriggerProps extends PopperAnchorProps {
+  /** When `true`, prevents the user from interacting with the trigger. */
+  disabled?: boolean;
+}
+/**
+ * Properties for the CascaderValue component.
+ */
+interface CascaderValueProps extends BaseProps {
+  /** The content shown when no node is selected. */
+  placeholder?: string;
+}
+/**
+ * Properties for the CascaderSearchInput component.
+ */
+interface CascaderSearchInputProps extends BaseProps {}
+/**
+ * Properties for the CascaderContent component.
+ */
+interface CascaderContentProps extends PopperPositionerProps, DismissableLayerProps, ForceMountProps {
+  /** Properties forwarded to every menu part. */
+  menuProps?: CascaderMenuProps;
+  /** Properties forwarded to the empty part. */
+  emptyProps?: CascaderEmptyProps;
+}
+/**
+ * Events for the CascaderContent component.
+ */
+type CascaderContentEmits = {
+  /** Emitted when close auto focus occurs. */
+  closeAutoFocus: [event: Event];
+  /** Event handler called when the escape key is down. Can be prevented. */
+  escapeKeyDown: [event: KeyboardEvent];
+  /** Event handler called when the a `pointerdown` event happens outside of the `DismissableLayer`. Can be prevented. */
+  pointerDownOutside: [event: PointerDownOutsideEvent];
+  /** Emitted when the content is placed. */
+  placed: [];
+};
+/**
+ * Properties for the CascaderMenu component.
+ */
+interface CascaderMenuProps extends BaseProps {
+  /** The depth of the menu column. */
+  level?: number;
+  /** Properties forwarded to every option part. */
+  optionProps?: Partial<CascaderOptionProps<DefinedValue>>;
+}
+/**
+ * Type information for the Cascader select event.
+ */
+type CascaderSelectEvent<T extends DefinedValue = DefinedValue> = CustomEvent<{
+  /** Original event. */
+  originalEvent: PointerEvent | KeyboardEvent;
+  /** The node being selected. */
+  node: CascaderNode<T>;
+}>;
+/**
+ * Type information for the Cascader expand event.
+ */
+type CascaderExpandEvent<T extends DefinedValue = DefinedValue> = CustomEvent<{
+  /** Original event. */
+  originalEvent: PointerEvent | KeyboardEvent;
+  /** The node being expanded. */
+  node: CascaderNode<T>;
+}>;
+/**
+ * Properties for the CascaderOption component.
+ */
+interface CascaderOptionProps<T extends DefinedValue = DefinedValue> extends Omit<PrimitiveWithBaseProps, 'onSelect'> {
+  /** The node rendered by the option. */
+  node: CascaderNode<T>;
+  /** The position of the node inside its column. */
+  index?: number;
+  /** The depth of the column the option belongs to. */
+  level?: number;
+}
+/**
+ * Events for the CascaderOption component.
+ */
+type CascaderOptionEmits<T extends DefinedValue = DefinedValue> = {
+  /** Event handler called when the node is selected. Can be prevented by calling `event.preventDefault`. */
+  select: [event: CascaderSelectEvent<T>];
+  /** Event handler called when the node is expanded. Can be prevented by calling `event.preventDefault`. */
+  expand: [event: CascaderExpandEvent<T>];
+};
+/**
+ * Properties for the CascaderEmpty component.
+ */
+interface CascaderEmptyProps extends BaseProps {}
+/**
+ * Properties for the CascaderTags component.
+ */
+interface CascaderTagsProps extends BaseProps {}
+/**
+ * Slots for the CascaderTags component.
+ */
+type CascaderTagsSlots<T extends DefinedValue = DefinedValue> = {
+  /** Custom content for a single tag in multiple mode. */
+  tag?: (props: CascaderCompactTagSlotProps<T>) => any;
+  /** Custom content shown when there is no selection. */
+  value?: () => any;
+};
+/**
+ * Properties for the CascaderClear component.
+ */
+interface CascaderClearProps extends BaseProps {
+  /** The accessible label of the clear button. @defaultValue '清除' */
+  ariaLabel?: string;
+}
+/**
+ * Properties for the CascaderCompact component.
+ */
+interface CascaderCompactProps<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> extends CascaderRootProps<T, M, P> {
+  /** When `true`, the arrow icon is rendered. @defaultValue true */
+  showArrow?: boolean;
+  /** The placement of the content. */
+  placement?: CascaderContentProps['placement'];
+  /** Properties forwarded to the trigger part. */
+  triggerProps?: CascaderTriggerProps;
+  /** Properties forwarded to the value part. */
+  valueProps?: CascaderValueProps;
+  /** Properties forwarded to the search input part. */
+  searchInputProps?: CascaderSearchInputProps;
+  /** Properties forwarded to the portal part. */
+  portalProps?: PortalProps;
+  /** Properties forwarded to the content part. */
+  contentProps?: CascaderContentProps;
+  /** Properties forwarded to every menu part. */
+  menuProps?: CascaderMenuProps;
+  /** Properties forwarded to every option part. */
+  optionProps?: Partial<CascaderOptionProps<T>>;
+  /** Properties forwarded to the empty part. */
+  emptyProps?: CascaderEmptyProps;
+  /** The text shown in the empty state. @defaultValue The locale message */
+  emptyLabel?: string;
+  /** The accessible label of the clear button. @defaultValue The locale message */
+  clearLabel?: string;
+  /** Properties forwarded to the arrow part. */
+  arrowProps?: CascaderArrowProps;
+}
+/**
+ * Events for the CascaderCompact component.
+ */
+type CascaderCompactEmits<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> = CascaderRootEmits<T, M, P> & CascaderContentEmits;
+/**
+ * Slot properties for the CascaderCompact trigger value.
+ */
+interface CascaderCompactTriggerValueSlotProps<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> {
+  /** Current model value. */
+  modelValue: CascaderValue<T, M, P>;
+  /** Labels of the selected nodes. */
+  selectedLabels: string[];
+  /** Text shown in the trigger (selected path or placeholder). */
+  slotText: string;
+}
+/**
+ * Slot properties for the CascaderCompact option.
+ */
+interface CascaderCompactOptionSlotProps<T extends DefinedValue = DefinedValue> {
+  /** The node being rendered. */
+  node: CascaderNode<T>;
+  /** Whether the node is checked. */
+  checked: boolean;
+  /** Whether the node is in an indeterminate state. */
+  indeterminate: boolean;
+  /** Whether the node is the currently selected node (single-select). */
+  selected: boolean;
+  /** Whether the node is currently highlighted. */
+  highlighted: boolean;
+  /** Whether a descendant of the node is currently highlighted (breadcrumb emphasis). */
+  childActive: boolean;
+  /** Whether the node is currently loading its children. */
+  loading: boolean;
+  /** Expands the children column of the node without toggling its selection. */
+  expand: () => void;
+}
+/**
+ * Slot properties for the CascaderCompact tag.
+ */
+interface CascaderCompactTagSlotProps<T extends DefinedValue = DefinedValue> {
+  /** The node of the tag. */
+  node: CascaderNode<T>;
+  /** Removes the tag from the selection. */
+  remove: (node: CascaderNode<T>) => void;
+}
+/**
+ * Slots for the CascaderCompact component.
+ */
+type CascaderCompactSlots<T extends DefinedValue = DefinedValue, M extends boolean = false, P extends boolean = false> = {
+  /** Custom content for the trigger icon (arrow). */
+  'trigger-icon'?: () => any;
+  /** Custom content for the trigger value. */
+  'trigger-value'?: (props: CascaderCompactTriggerValueSlotProps<T, M, P>) => any;
+  /** Custom content for the search input. */
+  'search-input'?: () => any;
+  /** Custom content for a single option. */
+  option?: (props: CascaderCompactOptionSlotProps<T>) => any;
+  /** Custom content for a tag in multiple mode. */
+  tag?: (props: CascaderCompactTagSlotProps<T>) => any;
+  /** Custom content for the empty state. */
+  empty?: () => any;
+};
+/**
+ * Available UI slots for the Cascader component.
+ */
+type CascaderUiSlot = 'trigger' | 'triggerIcon' | 'value' | 'tag' | 'clear' | 'searchInput' | 'positioner' | 'popup' | 'panel' | 'menu' | 'option' | 'optionText' | 'optionCheck' | 'optionArrow' | 'empty' | 'arrow';
+/**
+ * UI class overrides for the Cascader component.
+ */
+type CascaderUi = UiClass<CascaderUiSlot>;
+/**
+ * Parameters used to create the CascaderRoot context.
+ */
+interface CascaderRootContextParams extends PropsToContext<CascaderRootProps<DefinedValue, boolean, boolean>, 'dir' | 'disabled' | 'clearable' | 'expandTrigger' | 'checkStrictly' | 'multiple' | 'pathMode' | 'showCheckedStrategy' | 'separator' | 'filterable' | 'remote' | 'lazy' | 'searchDelay' | 'virtualScroll' | 'itemSize' | 'height' | 'placeholder'> {
+  /** Merged field keys with defaults. */
+  fieldKeys: ComputedRef<CascaderFieldKeys>;
+  /** Custom filter function. */
+  filter: ((pattern: string, option: CascaderOptionData<DefinedValue>, path: string[]) => boolean) | undefined;
+  /** Async load function used by lazy mode. */
+  onLoad: ((option: CascaderNode<DefinedValue>) => Promise<CascaderOptionData<DefinedValue>[]>) | undefined;
+  /** Async search function used by remote mode. */
+  onSearch: ((pattern: string) => Promise<CascaderOptionData<DefinedValue>[]>) | undefined;
+  /** The open state of the cascader. */
+  open: ShallowRef<boolean | undefined>;
+  /** The disclosure state derived from `open`. */
+  dataState: ComputedRef<'open' | 'closed'>;
+  /** Handler used to update the open state. */
+  onOpenChange: (value: boolean) => void;
+  /** Current model value (loose internal shape). */
+  modelValue: ShallowRef<CascaderModelValue | undefined>;
+  /** The trigger element. */
+  triggerElement: ShallowRef<HTMLElement | undefined>;
+  /** The content (panel) element. */
+  contentElement: ShallowRef<HTMLElement | undefined>;
+  /** Id of the content element, linked to the trigger via `aria-controls`. */
+  contentId: ComputedRef<string>;
+  /** Returns the id of an option element, used by `aria-activedescendant`. */
+  getOptionId: (node: CascaderNode<DefinedValue>) => string;
+  /** Reports the trigger element. */
+  onTriggerElementChange: (node: HTMLElement | undefined) => void;
+  /** Reports the content element. */
+  onContentElementChange: (node: HTMLElement | undefined) => void;
+  /** Root level nodes. */
+  rootNodes: ComputedRef<CascaderNode<DefinedValue>[]>;
+  /** The linked columns of the panel. */
+  menus: ComputedRef<CascaderNode<DefinedValue>[][]>;
+  /** The currently highlighted node (keyboard / hover). */
+  highlighted: ShallowRef<CascaderNode<DefinedValue> | null>;
+  /** Id used as `aria-activedescendant` of the highlighted node. */
+  highlightedId: ComputedRef<string | null>;
+  /** The nodes collected per `showCheckedStrategy`. */
+  selectedNodes: ComputedRef<CascaderNode<DefinedValue>[]>;
+  /** Labels of the selected nodes used for display. */
+  selectedLabels: ComputedRef<string[]>;
+  /** Whether the panel is in search mode. */
+  isSearchMode: ComputedRef<boolean>;
+  /** The current search pattern. */
+  searchPattern: ShallowRef<string>;
+  /** Flat search results. */
+  searchResults: ComputedRef<CascaderNode<DefinedValue>[]>;
+  /** Whether the remote search is loading. */
+  searchLoading: ShallowRef<boolean>;
+  /** Set of uids of the nodes currently loading. */
+  loadingKeys: ComputedRef<Set<string>>;
+  /** Expands a node (truncates the following columns and pushes the children column). */
+  expandNode: (node: CascaderNode<DefinedValue>, originalEvent?: Event) => void;
+  /** Handles a select interaction on a node. */
+  onOptionSelect: (node: CascaderNode<DefinedValue>, originalEvent: PointerEvent | KeyboardEvent) => void;
+  /** Handles a hover interaction on a node. */
+  onOptionHover: (node: CascaderNode<DefinedValue>) => void;
+  /** Sets the highlighted node. */
+  setHighlighted: (node: CascaderNode<DefinedValue> | null) => void;
+  /** Whether a node is checked. */
+  isChecked: (node: CascaderNode<DefinedValue>) => boolean;
+  /** Whether a node is in an indeterminate state. */
+  isIndeterminate: (node: CascaderNode<DefinedValue>) => boolean;
+  /** Whether a node is the currently selected node (single-select). */
+  isSelected: (node: CascaderNode<DefinedValue>) => boolean;
+  /** Toggles the checked state of a node. */
+  toggleCheck: (node: CascaderNode<DefinedValue>) => void;
+  /** Removes a checked node (or its whole checked subtree) from the selection. */
+  removeNode: (node: CascaderNode<DefinedValue>) => void;
+  /** Clears the current selection. */
+  clearValue: () => void;
+  /** Handles the keyboard navigation. */
+  handleKeydown: (event: KeyboardEvent) => void;
+}
+//#endregion
+export { CascaderArrowProps, CascaderClearProps, CascaderCompactEmits, CascaderCompactOptionSlotProps, CascaderCompactProps, CascaderCompactSlots, CascaderCompactTagSlotProps, CascaderCompactTriggerValueSlotProps, CascaderContentEmits, CascaderContentProps, CascaderEmptyProps, CascaderExpandEvent, CascaderFieldKeys, CascaderMenuProps, CascaderModelValue, CascaderNode, CascaderOptionData, CascaderOptionEmits, CascaderOptionProps, CascaderPortalProps, CascaderRootContextParams, CascaderRootEmits, CascaderRootProps, CascaderSearchInputProps, CascaderSelectEvent, CascaderTagsProps, CascaderTagsSlots, CascaderTriggerProps, CascaderUi, CascaderUiSlot, CascaderValue, CascaderValueProps };