@pstdio/ui 0.21.0 → 0.23.0

package/dist/components/tag-editor/tag-editor.types.d.ts

@@ -13,6 +13,8 @@ export interface TagEditorValue {
 export interface TagEditorAction {
     value: string;
     label: string;
+    /** Rendered before the label in the trigger and the menu row. */
+    icon?: ReactNode;
 }
 export interface TagEditorProps {
     values: TagEditorValue[];
@@ -33,6 +35,10 @@ export interface TagEditorProps {
     /** Name given to a freshly added option before it is renamed inline. */
     addName?: string;
     actionOptions?: TagEditorAction[];
+    /** Names the per-row action control, e.g. "Commands". Used in its label and aria-label. */
+    actionsLabel?: string;
+    /** Names the default-value control shown under the list when showDefault is set. */
+    defaultValueLabel?: string;
     defaultAddColor?: string;
     defaultAddIcon?: string | null;
     deleteButtonText?: string;
@@ -42,4 +48,10 @@ export interface TagEditorProps {
     iconOptions?: readonly IconColorPickerIconOption[];
     showDefault?: boolean;
     showIcons?: boolean;
+    /** Draws the list as a bordered card, so the header and footer bands read as one panel. */
+    framed?: boolean;
+    /** Renders a column header band above the rows. Needs `framed` to look right. */
+    showColumnHeaders?: boolean;
+    /** Header label above the option names, e.g. "State". */
+    valueColumnLabel?: string;
 }

package/dist/components/tag-editor/tag-settings-panel.d.ts

@@ -4,7 +4,7 @@ export interface SaveTagSettingsInput<TValue> {
     drafts: TagEditorValue[];
     values: TValue[];
 }
-type EditorLabels = Pick<TagEditorProps, "actionOptions" | "addLabel" | "addName" | "colorOptions" | "deleteButtonText" | "deleteHeadline" | "deleteNotificationText" | "description" | "iconOptions" | "readOnly" | "showDefault" | "onSetDefault" | "showIcons" | "title">;
+type EditorLabels = Pick<TagEditorProps, "actionOptions" | "actionsLabel" | "addLabel" | "addName" | "colorOptions" | "deleteButtonText" | "deleteHeadline" | "defaultValueLabel" | "deleteNotificationText" | "description" | "framed" | "iconOptions" | "readOnly" | "showDefault" | "onSetDefault" | "showColumnHeaders" | "showIcons" | "title" | "valueColumnLabel">;
 type SortableValue = {
     id: string;
     sortOrder: number;

package/dist/components/tree-list/tree-list-drag-provider.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+import { TreeListSection } from './tree-list.types';
+import { TreeListMovePolicy } from './tree-list-reorder';
+export declare const SharedTreeListDragContext: import('react').Context<boolean>;
+interface TreeListDragProviderProps {
+    sections: TreeListSection[];
+    canMove?: TreeListMovePolicy;
+    onReorderSections?: (nextSectionIds: string[], sourceSectionId: string, destinationSectionId: string) => void;
+    onReorderNodes?: (sectionId: string, nextNodeIds: string[]) => void;
+    children: ReactNode;
+}
+export declare const TreeListDragProvider: (props: TreeListDragProviderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/tree-list/tree-list-order.store.d.ts

@@ -1,10 +1,13 @@
 interface TreeListOrderSnapshot {
     sectionOrder: string[];
     nodeOrderBySection: Record<string, string[]>;
+    sectionSlotById: Record<string, TreeListOrderSlot>;
 }
+type TreeListOrderSlot = "header" | "content" | "footer";
 interface TreeListOrderState extends TreeListOrderSnapshot {
     setSectionOrder: (nextSectionIds: string[]) => void;
     setNodeOrder: (sectionId: string, nextNodeIds: string[]) => void;
+    setSectionSlot: (sectionId: string, slot: TreeListOrderSlot) => void;
     resetSectionOrder: () => void;
     resetNodeOrder: (sectionId: string) => void;
     reset: () => void;
@@ -39,4 +42,4 @@ export declare const getTreeListOrderStore: (storageKey: string) => Omit<import(
     };
 };
 export declare const useTreeListOrderStore: <T>(storageKey: string, selector: (state: TreeListOrderState) => T) => T;
-export type { TreeListOrderSnapshot, TreeListOrderState };
+export type { TreeListOrderSlot, TreeListOrderSnapshot, TreeListOrderState };

package/dist/components/tree-list/tree-list-reorder.d.ts

@@ -7,7 +7,18 @@ export type ReorderResult = {
     nextSectionIds: string[];
 } | {
     kind: "node";
-    sectionId: string;
-    nextNodeIds: string[];
+    orders: Record<string, string[]>;
 };
-export declare const computeReorderResult: (sections: TreeListSection[], activeId: string, overId: string) => ReorderResult | null;
+export interface TreeListMoveEndpoint {
+    kind: "section" | "node";
+    sectionId: string;
+    id: string;
+    moveScope?: string;
+}
+export interface TreeListMove {
+    source: TreeListMoveEndpoint;
+    destination: TreeListMoveEndpoint;
+}
+export type TreeListMovePolicy = (move: TreeListMove) => boolean;
+export declare const canDropOnTreeListTarget: (sections: TreeListSection[], activeId: string, overId: string, canMove?: TreeListMovePolicy) => boolean;
+export declare const computeReorderResult: (sections: TreeListSection[], activeId: string, overId: string, canMove?: TreeListMovePolicy) => ReorderResult | null;

package/dist/components/tree-list/tree-list-sortable.d.ts

@@ -1,6 +1,7 @@
 import { StackProps } from '@chakra-ui/react';
 import { MouseEvent as ReactMouseEvent } from 'react';
 import { TreeListLinkComponent, TreeListNavigateEvent, TreeListSection } from './tree-list.types';
+import { TreeListMovePolicy } from './tree-list-reorder';
 type TreeListRowVariant = "compact" | "tree";
 interface TreeListSortableProps {
     sections: TreeListSection[];
@@ -17,6 +18,7 @@ interface TreeListSortableProps {
     onSectionContextMenu?: (event: ReactMouseEvent<HTMLElement>, sectionId: string) => void;
     onReorderSections?: (nextSectionIds: string[]) => void;
     onReorderNodes?: (sectionId: string, nextNodeIds: string[]) => void;
+    canMove?: TreeListMovePolicy;
 }
 export declare const TreeListSortable: (props: TreeListSortableProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/tree-list/tree-list-visibility-filter.d.ts

@@ -16,9 +16,9 @@ interface BuildMenuOptions {
     resetIcon?: ReactNode;
 }
 export interface TreeVisibilityMenuItems {
-    headerNodes?: TreeListNode[];
+    headerSections?: TreeListSection[];
     sections: TreeListSection[];
-    footerNodes?: TreeListNode[];
+    footerSections?: TreeListSection[];
 }
 export declare const buildTreeVisibilityMenuActions: (items: TreeVisibilityMenuItems, sectionOverrides: Record<string, VisibilityOverride>, nodeOverrides: Record<string, VisibilityOverride>, actions: TreeVisibilityMenuActions, options: BuildMenuOptions) => ResourceContextAction[];
 export {};

package/dist/components/tree-list/tree-list.d.ts

@@ -2,6 +2,7 @@ import { StackProps } from '@chakra-ui/react';
 import { MouseEvent as ReactMouseEvent, RefObject } from 'react';
 import { ResourceContextAction } from '../overlays/resource-context-menu';
 import { TreeListLinkComponent, TreeListNavigateEvent, TreeListSection } from './tree-list.types';
+import { TreeListMovePolicy } from './tree-list-reorder';
 export { buildVirtualRows } from './tree-list-model';
 type TreeListRowVariant = "compact" | "tree";
 /** Sectioned hierarchical list for files, resources, navigation, and customizable sidenavs. */
@@ -31,6 +32,8 @@ interface TreeListProps {
     draggable?: boolean;
     onReorderSections?: (nextSectionIds: string[]) => void;
     onReorderNodes?: (sectionId: string, nextNodeIds: string[]) => void;
+    /** Decide whether a proposed customization move is valid. */
+    canMove?: TreeListMovePolicy;
     /** Move a node onto another node, or onto the tree root when the target is omitted. */
     onMoveNode?: (sourceNodeId: string, targetNodeId?: string) => void;
     backgroundContextActions?: ResourceContextAction[];

package/dist/components/tree-list/tree-list.types.d.ts

@@ -15,6 +15,8 @@ export interface TreeListInlineInput {
 /** Tree node data rendered by `TreeList`; extends the row API used by `ListRow`. */
 export type TreeListNode = ListRowItem & {
     id: string;
+    /** Opaque host scope passed to a configurable move policy. */
+    moveScope?: string;
     children?: TreeListNode[];
     /** Per-node visual row variant. Used for non-interactive placeholder rows. */
     rowVariant?: TreeListNodeRowVariant;
@@ -33,6 +35,8 @@ export type TreeListNode = ListRowItem & {
 /** Top-level tree section with optional header, actions, empty state, and child nodes. */
 export interface TreeListSection {
     id: string;
+    /** Opaque host scope passed to a configurable move policy. */
+    moveScope?: string;
     label?: string;
     collapsible?: boolean;
     actions?: TreeListAction[];

package/dist/data-table.d.ts

@@ -0,0 +1,2 @@
+export * from './components/data-table/index'
+export {}