@sprawlify/primitives 0.0.1

package/dist/machines/tree-view/index.d.cts

@@ -0,0 +1,215 @@
+import { n as AnatomyInstance } from "../../create-anatomy-BGQ8pv8J.cjs";
+import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-BivBkYg9.cjs";
+import { t as TreeCollection } from "../../tree-collection-DP_eznnI.cjs";
+import { p as Machine, y as Service } from "../../types-DejIu60O.cjs";
+import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-Bqw3r34-.cjs";
+import { n as TypeaheadState } from "../../typeahead-BdNwVP09.cjs";
+
+//#region src/machines/tree-view/tree-view.anatomy.d.ts
+declare const anatomy: AnatomyInstance<"root" | "item" | "label" | "itemText" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "itemIndicator" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+//#endregion
+//#region src/machines/tree-view/tree-view.collection.d.ts
+declare const collection: {
+  <T>(options: TreeCollectionOptions<T>): TreeCollection<T>;
+  empty(): TreeCollection;
+};
+declare function filePathCollection(paths: string[]): TreeCollection<FilePathTreeNode>;
+//#endregion
+//#region src/machines/tree-view/tree-view.types.d.ts
+interface FocusChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  focusedNode: T | null;
+}
+interface ExpandedChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  expandedValue: string[];
+  expandedNodes: T[];
+}
+interface SelectionChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  selectedValue: string[];
+  selectedNodes: T[];
+}
+interface CheckedChangeDetails {
+  checkedValue: string[];
+}
+interface RenameStartDetails<T extends TreeNode = TreeNode> {
+  value: string;
+  node: T;
+  indexPath: IndexPath;
+}
+interface RenameCompleteDetails {
+  value: string;
+  label: string;
+  indexPath: IndexPath;
+}
+interface LoadChildrenDetails<T extends TreeNode = TreeNode> {
+  valuePath: ValuePath;
+  indexPath: IndexPath;
+  node: T;
+  signal: AbortSignal;
+}
+interface LoadChildrenCompleteDetails<T extends TreeNode = TreeNode> {
+  collection: TreeCollection<T>;
+}
+interface NodeWithError<T extends TreeNode = TreeNode> {
+  node: T;
+  error: Error;
+  indexPath: IndexPath;
+  valuePath: ValuePath;
+}
+interface LoadChildrenErrorDetails<T extends TreeNode = TreeNode> {
+  nodes: NodeWithError<T>[];
+}
+interface ScrollToIndexDetails<T extends TreeNode = TreeNode> {
+  index: number;
+  node: T;
+  indexPath: IndexPath;
+  getElement: () => HTMLElement | null;
+}
+interface VisibleNode<T extends TreeNode = TreeNode> {
+  node: T;
+  indexPath: IndexPath;
+}
+type ElementIds = Partial<{
+  root: string;
+  tree: string;
+  label: string;
+  node: (value: string) => string;
+}>;
+interface TreeViewProps<T extends TreeNode = TreeNode> extends DirectionProperty, CommonProperties {
+  collection?: TreeCollection<T> | undefined;
+  ids?: ElementIds | undefined;
+  expandedValue?: string[] | undefined;
+  defaultExpandedValue?: string[] | undefined;
+  selectedValue?: string[] | undefined;
+  defaultSelectedValue?: string[] | undefined;
+  defaultCheckedValue?: string[] | undefined;
+  checkedValue?: string[] | undefined;
+  defaultFocusedValue?: string | null | undefined;
+  focusedValue?: string | null | undefined;
+  selectionMode?: "single" | "multiple" | undefined;
+  onExpandedChange?: ((details: ExpandedChangeDetails<T>) => void) | undefined;
+  onSelectionChange?: ((details: SelectionChangeDetails<T>) => void) | undefined;
+  onFocusChange?: ((details: FocusChangeDetails<T>) => void) | undefined;
+  onCheckedChange?: ((details: CheckedChangeDetails) => void) | undefined;
+  canRename?: ((node: T, indexPath: IndexPath) => boolean) | undefined;
+  onRenameStart?: ((details: RenameStartDetails<T>) => void) | undefined;
+  onBeforeRename?: ((details: RenameCompleteDetails) => boolean) | undefined;
+  onRenameComplete?: ((details: RenameCompleteDetails) => void) | undefined;
+  onLoadChildrenComplete?: ((details: LoadChildrenCompleteDetails<T>) => void) | undefined;
+  onLoadChildrenError?: ((details: LoadChildrenErrorDetails<T>) => void) | undefined;
+  expandOnClick?: boolean | undefined;
+  typeahead?: boolean | undefined;
+  loadChildren?: ((details: LoadChildrenDetails<T>) => Promise<T[]>) | undefined;
+  scrollToIndexFn?: ((details: ScrollToIndexDetails<T>) => void) | undefined;
+}
+type PropsWithDefault = "collection" | "selectionMode" | "expandOnClick" | "typeahead" | "defaultExpandedValue" | "defaultSelectedValue";
+type TreeLoadingStatus = "loading" | "loaded";
+type TreeLoadingStatusMap = Record<string, TreeLoadingStatus>;
+interface TreeViewSchema<T extends TreeNode = TreeNode> {
+  state: "idle" | "renaming";
+  props: RequiredBy<TreeViewProps<T>, PropsWithDefault>;
+  context: {
+    expandedValue: string[];
+    selectedValue: string[];
+    checkedValue: string[];
+    focusedValue: string | null;
+    loadingStatus: TreeLoadingStatusMap;
+    renamingValue: string | null;
+  };
+  refs: {
+    typeaheadState: TypeaheadState;
+    pendingAborts: Map<string, AbortController>;
+  };
+  computed: {
+    isTypingAhead: boolean;
+    isMultipleSelection: boolean;
+    visibleNodes: {
+      node: T;
+      indexPath: number[];
+    }[];
+  };
+  action: string;
+  effect: string;
+  guard: string;
+}
+type TreeViewService<T extends TreeNode = TreeNode> = Service<TreeViewSchema<T>>;
+type TreeViewMachine<T extends TreeNode = TreeNode> = Machine<TreeViewSchema<T>>;
+interface NodeProps {
+  node: TreeNode;
+  indexPath: number[];
+}
+type CheckedState = boolean | "indeterminate";
+interface NodeState {
+  id: string;
+  value: string;
+  indexPath: IndexPath;
+  valuePath: ValuePath;
+  disabled: boolean;
+  selected: boolean;
+  focused: boolean;
+  depth: number;
+  expanded: boolean;
+  isBranch: boolean;
+  loading: boolean;
+  checked: CheckedState;
+  renaming: boolean;
+}
+type CheckedValueMap = Map<string, {
+  type: "leaf" | "branch";
+  checked: CheckedState;
+}>;
+interface TreeViewApi<T extends PropTypes = PropTypes, V extends TreeNode = TreeNode> {
+  collection: TreeCollection<V>;
+  expandedValue: string[];
+  setExpandedValue: (value: string[]) => void;
+  selectedValue: string[];
+  setSelectedValue: (value: string[]) => void;
+  checkedValue: string[];
+  toggleChecked: (value: string, isBranch: boolean) => void;
+  setChecked: (value: string[]) => void;
+  clearChecked: VoidFunction;
+  getCheckedMap: () => CheckedValueMap;
+  getVisibleNodes: () => VisibleNode<V>[];
+  expand: (value?: string[]) => void;
+  collapse: (value?: string[]) => void;
+  select: (value?: string[]) => void;
+  deselect: (value?: string[]) => void;
+  focus: (value: string) => void;
+  selectParent: (value: string) => void;
+  expandParent: (value: string) => void;
+  startRenaming: (value: string) => void;
+  submitRenaming: (value: string, label: string) => void;
+  cancelRenaming: () => void;
+  getRootProps: () => T["element"];
+  getLabelProps: () => T["element"];
+  getTreeProps: () => T["element"];
+  getNodeState: (props: NodeProps) => NodeState;
+  getItemProps: (props: NodeProps) => T["element"];
+  getNodeCheckboxProps: (props: NodeProps) => T["element"];
+  getItemIndicatorProps: (props: NodeProps) => T["element"];
+  getItemTextProps: (props: NodeProps) => T["element"];
+  getBranchProps: (props: NodeProps) => T["element"];
+  getBranchIndicatorProps: (props: NodeProps) => T["element"];
+  getBranchTriggerProps: (props: NodeProps) => T["element"];
+  getBranchControlProps: (props: NodeProps) => T["element"];
+  getBranchContentProps: (props: NodeProps) => T["element"];
+  getBranchTextProps: (props: NodeProps) => T["element"];
+  getBranchIndentGuideProps: (props: NodeProps) => T["element"];
+  getNodeRenameInputProps: (props: NodeProps) => T["input"];
+}
+//#endregion
+//#region src/machines/tree-view/tree-view.connect.d.ts
+declare function connect<T extends PropTypes, V extends TreeNode = TreeNode>(service: TreeViewService<V>, normalize: NormalizeProps<T>): TreeViewApi<T, V>;
+//#endregion
+//#region src/machines/tree-view/tree-view.machine.d.ts
+declare const machine: Machine<TreeViewSchema<any>>;
+//#endregion
+//#region src/machines/tree-view/tree-view.props.d.ts
+declare const props: (keyof TreeViewProps<any>)[];
+declare const splitProps: <Props extends Partial<TreeViewProps<any>>>(props: Props) => [Partial<TreeViewProps<any>>, Omit<Props, keyof TreeViewProps<any>>];
+declare const itemProps: (keyof NodeProps)[];
+declare const splitItemProps: <Props extends NodeProps>(props: Props) => [NodeProps, Omit<Props, keyof NodeProps>];
+//#endregion
+export { type TreeViewApi as Api, type CheckedChangeDetails, type CheckedState, type CheckedValueMap, type ElementIds, type ExpandedChangeDetails, type FocusChangeDetails, type LoadChildrenCompleteDetails, type LoadChildrenDetails, type LoadChildrenErrorDetails, type TreeViewMachine as Machine, type NodeProps, type NodeState, type NodeWithError, type TreeViewProps as Props, type RenameCompleteDetails, type RenameStartDetails, type ScrollToIndexDetails, type SelectionChangeDetails, type TreeViewService as Service, type TreeLoadingStatus, type TreeLoadingStatusMap, type TreeNode, type VisibleNode, anatomy, collection, connect, filePathCollection, itemProps, machine, props, splitItemProps, splitProps };

package/dist/machines/tree-view/index.d.mts

@@ -0,0 +1,215 @@
+import { n as AnatomyInstance } from "../../create-anatomy-B3XYc-qG.mjs";
+import { f as TreeCollectionOptions, g as ValuePath, p as TreeNode, s as FilePathTreeNode, u as IndexPath } from "../../types-Bl_6JtPQ.mjs";
+import { t as TreeCollection } from "../../tree-collection-BwU5WhGQ.mjs";
+import { p as Machine, y as Service } from "../../types-DDTcG99l.mjs";
+import { b as NormalizeProps, g as RequiredBy, r as DirectionProperty, t as CommonProperties, x as PropTypes } from "../../index-C0MKXQmE.mjs";
+import { n as TypeaheadState } from "../../typeahead-XN6lZ7G9.mjs";
+
+//#region src/machines/tree-view/tree-view.anatomy.d.ts
+declare const anatomy: AnatomyInstance<"root" | "item" | "label" | "itemText" | "branch" | "branchContent" | "branchControl" | "branchIndentGuide" | "branchIndicator" | "branchText" | "branchTrigger" | "itemIndicator" | "nodeCheckbox" | "nodeRenameInput" | "tree">;
+//#endregion
+//#region src/machines/tree-view/tree-view.collection.d.ts
+declare const collection: {
+  <T>(options: TreeCollectionOptions<T>): TreeCollection<T>;
+  empty(): TreeCollection;
+};
+declare function filePathCollection(paths: string[]): TreeCollection<FilePathTreeNode>;
+//#endregion
+//#region src/machines/tree-view/tree-view.types.d.ts
+interface FocusChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  focusedNode: T | null;
+}
+interface ExpandedChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  expandedValue: string[];
+  expandedNodes: T[];
+}
+interface SelectionChangeDetails<T extends TreeNode = TreeNode> {
+  focusedValue: string | null;
+  selectedValue: string[];
+  selectedNodes: T[];
+}
+interface CheckedChangeDetails {
+  checkedValue: string[];
+}
+interface RenameStartDetails<T extends TreeNode = TreeNode> {
+  value: string;
+  node: T;
+  indexPath: IndexPath;
+}
+interface RenameCompleteDetails {
+  value: string;
+  label: string;
+  indexPath: IndexPath;
+}
+interface LoadChildrenDetails<T extends TreeNode = TreeNode> {
+  valuePath: ValuePath;
+  indexPath: IndexPath;
+  node: T;
+  signal: AbortSignal;
+}
+interface LoadChildrenCompleteDetails<T extends TreeNode = TreeNode> {
+  collection: TreeCollection<T>;
+}
+interface NodeWithError<T extends TreeNode = TreeNode> {
+  node: T;
+  error: Error;
+  indexPath: IndexPath;
+  valuePath: ValuePath;
+}
+interface LoadChildrenErrorDetails<T extends TreeNode = TreeNode> {
+  nodes: NodeWithError<T>[];
+}
+interface ScrollToIndexDetails<T extends TreeNode = TreeNode> {
+  index: number;
+  node: T;
+  indexPath: IndexPath;
+  getElement: () => HTMLElement | null;
+}
+interface VisibleNode<T extends TreeNode = TreeNode> {
+  node: T;
+  indexPath: IndexPath;
+}
+type ElementIds = Partial<{
+  root: string;
+  tree: string;
+  label: string;
+  node: (value: string) => string;
+}>;
+interface TreeViewProps<T extends TreeNode = TreeNode> extends DirectionProperty, CommonProperties {
+  collection?: TreeCollection<T> | undefined;
+  ids?: ElementIds | undefined;
+  expandedValue?: string[] | undefined;
+  defaultExpandedValue?: string[] | undefined;
+  selectedValue?: string[] | undefined;
+  defaultSelectedValue?: string[] | undefined;
+  defaultCheckedValue?: string[] | undefined;
+  checkedValue?: string[] | undefined;
+  defaultFocusedValue?: string | null | undefined;
+  focusedValue?: string | null | undefined;
+  selectionMode?: "single" | "multiple" | undefined;
+  onExpandedChange?: ((details: ExpandedChangeDetails<T>) => void) | undefined;
+  onSelectionChange?: ((details: SelectionChangeDetails<T>) => void) | undefined;
+  onFocusChange?: ((details: FocusChangeDetails<T>) => void) | undefined;
+  onCheckedChange?: ((details: CheckedChangeDetails) => void) | undefined;
+  canRename?: ((node: T, indexPath: IndexPath) => boolean) | undefined;
+  onRenameStart?: ((details: RenameStartDetails<T>) => void) | undefined;
+  onBeforeRename?: ((details: RenameCompleteDetails) => boolean) | undefined;
+  onRenameComplete?: ((details: RenameCompleteDetails) => void) | undefined;
+  onLoadChildrenComplete?: ((details: LoadChildrenCompleteDetails<T>) => void) | undefined;
+  onLoadChildrenError?: ((details: LoadChildrenErrorDetails<T>) => void) | undefined;
+  expandOnClick?: boolean | undefined;
+  typeahead?: boolean | undefined;
+  loadChildren?: ((details: LoadChildrenDetails<T>) => Promise<T[]>) | undefined;
+  scrollToIndexFn?: ((details: ScrollToIndexDetails<T>) => void) | undefined;
+}
+type PropsWithDefault = "collection" | "selectionMode" | "expandOnClick" | "typeahead" | "defaultExpandedValue" | "defaultSelectedValue";
+type TreeLoadingStatus = "loading" | "loaded";
+type TreeLoadingStatusMap = Record<string, TreeLoadingStatus>;
+interface TreeViewSchema<T extends TreeNode = TreeNode> {
+  state: "idle" | "renaming";
+  props: RequiredBy<TreeViewProps<T>, PropsWithDefault>;
+  context: {
+    expandedValue: string[];
+    selectedValue: string[];
+    checkedValue: string[];
+    focusedValue: string | null;
+    loadingStatus: TreeLoadingStatusMap;
+    renamingValue: string | null;
+  };
+  refs: {
+    typeaheadState: TypeaheadState;
+    pendingAborts: Map<string, AbortController>;
+  };
+  computed: {
+    isTypingAhead: boolean;
+    isMultipleSelection: boolean;
+    visibleNodes: {
+      node: T;
+      indexPath: number[];
+    }[];
+  };
+  action: string;
+  effect: string;
+  guard: string;
+}
+type TreeViewService<T extends TreeNode = TreeNode> = Service<TreeViewSchema<T>>;
+type TreeViewMachine<T extends TreeNode = TreeNode> = Machine<TreeViewSchema<T>>;
+interface NodeProps {
+  node: TreeNode;
+  indexPath: number[];
+}
+type CheckedState = boolean | "indeterminate";
+interface NodeState {
+  id: string;
+  value: string;
+  indexPath: IndexPath;
+  valuePath: ValuePath;
+  disabled: boolean;
+  selected: boolean;
+  focused: boolean;
+  depth: number;
+  expanded: boolean;
+  isBranch: boolean;
+  loading: boolean;
+  checked: CheckedState;
+  renaming: boolean;
+}
+type CheckedValueMap = Map<string, {
+  type: "leaf" | "branch";
+  checked: CheckedState;
+}>;
+interface TreeViewApi<T extends PropTypes = PropTypes, V extends TreeNode = TreeNode> {
+  collection: TreeCollection<V>;
+  expandedValue: string[];
+  setExpandedValue: (value: string[]) => void;
+  selectedValue: string[];
+  setSelectedValue: (value: string[]) => void;
+  checkedValue: string[];
+  toggleChecked: (value: string, isBranch: boolean) => void;
+  setChecked: (value: string[]) => void;
+  clearChecked: VoidFunction;
+  getCheckedMap: () => CheckedValueMap;
+  getVisibleNodes: () => VisibleNode<V>[];
+  expand: (value?: string[]) => void;
+  collapse: (value?: string[]) => void;
+  select: (value?: string[]) => void;
+  deselect: (value?: string[]) => void;
+  focus: (value: string) => void;
+  selectParent: (value: string) => void;
+  expandParent: (value: string) => void;
+  startRenaming: (value: string) => void;
+  submitRenaming: (value: string, label: string) => void;
+  cancelRenaming: () => void;
+  getRootProps: () => T["element"];
+  getLabelProps: () => T["element"];
+  getTreeProps: () => T["element"];
+  getNodeState: (props: NodeProps) => NodeState;
+  getItemProps: (props: NodeProps) => T["element"];
+  getNodeCheckboxProps: (props: NodeProps) => T["element"];
+  getItemIndicatorProps: (props: NodeProps) => T["element"];
+  getItemTextProps: (props: NodeProps) => T["element"];
+  getBranchProps: (props: NodeProps) => T["element"];
+  getBranchIndicatorProps: (props: NodeProps) => T["element"];
+  getBranchTriggerProps: (props: NodeProps) => T["element"];
+  getBranchControlProps: (props: NodeProps) => T["element"];
+  getBranchContentProps: (props: NodeProps) => T["element"];
+  getBranchTextProps: (props: NodeProps) => T["element"];
+  getBranchIndentGuideProps: (props: NodeProps) => T["element"];
+  getNodeRenameInputProps: (props: NodeProps) => T["input"];
+}
+//#endregion
+//#region src/machines/tree-view/tree-view.connect.d.ts
+declare function connect<T extends PropTypes, V extends TreeNode = TreeNode>(service: TreeViewService<V>, normalize: NormalizeProps<T>): TreeViewApi<T, V>;
+//#endregion
+//#region src/machines/tree-view/tree-view.machine.d.ts
+declare const machine: Machine<TreeViewSchema<any>>;
+//#endregion
+//#region src/machines/tree-view/tree-view.props.d.ts
+declare const props: (keyof TreeViewProps<any>)[];
+declare const splitProps: <Props extends Partial<TreeViewProps<any>>>(props: Props) => [Partial<TreeViewProps<any>>, Omit<Props, keyof TreeViewProps<any>>];
+declare const itemProps: (keyof NodeProps)[];
+declare const splitItemProps: <Props extends NodeProps>(props: Props) => [NodeProps, Omit<Props, keyof NodeProps>];
+//#endregion
+export { type TreeViewApi as Api, type CheckedChangeDetails, type CheckedState, type CheckedValueMap, type ElementIds, type ExpandedChangeDetails, type FocusChangeDetails, type LoadChildrenCompleteDetails, type LoadChildrenDetails, type LoadChildrenErrorDetails, type TreeViewMachine as Machine, type NodeProps, type NodeState, type NodeWithError, type TreeViewProps as Props, type RenameCompleteDetails, type RenameStartDetails, type ScrollToIndexDetails, type SelectionChangeDetails, type TreeViewService as Service, type TreeLoadingStatus, type TreeLoadingStatusMap, type TreeNode, type VisibleNode, anatomy, collection, connect, filePathCollection, itemProps, machine, props, splitItemProps, splitProps };