@pstdio/ui 0.26.0 → 0.35.0

package/dist/kanban-renderer.d.ts

@@ -1,2 +1,337 @@
-export * from './components/kanban-renderer/index'
-export {}
+import { C as findAttribute, S as ViewMode, T as isEnumOptionsSource, _ as KanbanRendererSavedView, a as AttributesSource, b as NO_GROUPING, c as EnumOptions, d as KanbanRendererCreateFieldType, f as KanbanRendererCreateRowConfig, g as KanbanRendererRow, h as KanbanRendererOrdering, i as AttributeType, l as EnumOptionsSource, m as KanbanRendererFilterState, n as AttributeDisplayDescriptor, o as CollectionBadgeItem, p as KanbanRendererCreateSubmission, r as AttributeKind, s as EnumOption, t as AttributeDescriptor, u as KanbanRendererCreateField, v as KanbanRendererSettings, w as isAttributesSource, x as SortDirection, y as MANUAL_ORDERING } from "./types-yjKBk07w.js";
+import { n as WorkspaceBadgeProps, u as ResourceContextAction } from "./workspace-badge-CkJ_jTQw.js";
+import { ComponentProps, ComponentType, DragEventHandler, ReactNode } from "react";
+//#region src/components/kanban-renderer/kanban-renderer-badge-helpers.d.ts
+interface AttributeBadge {
+  attributeId: string;
+  attributeLabel?: string;
+  label: string;
+  color?: string;
+  icon?: string | null;
+  value?: string | string[];
+  options?: EnumOption[];
+  isEditable?: boolean;
+}
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-enum-helpers.d.ts
+/**
+ * Normalize an enum / enum-multi attribute's `options` to a plain option list.
+ * Sources resolve via `getSnapshot()` on every call, so callers naturally see
+ * the latest values.
+ */
+export declare const getEnumOptions: (type: AttributeType) => EnumOption[];
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-helpers.d.ts
+/**
+ * Read a typed attribute value out of a row. enum-multi normalizes to an array;
+ * single-valued kinds normalize to undefined when missing.
+ */
+export declare const getAttributeValue: (row: KanbanRendererRow, descriptor: AttributeDescriptor) => unknown;
+export declare const getAttributeStringValues: (row: KanbanRendererRow, descriptor: AttributeDescriptor) => string[];
+export declare const renderBadgeListDisplay: (descriptor: AttributeDescriptor, value: unknown, row: KanbanRendererRow, openResource?: (resource: NonNullable<CollectionBadgeItem["resource"]>) => void) => ReactNode;
+/**
+ * Per-type default cell summary used by the card / list end-content. Returns
+ * null when the attribute has no displayable value.
+ */
+export declare const renderAttributeBadge: (descriptor: AttributeDescriptor, row: KanbanRendererRow) => AttributeBadge | null;
+export declare const collectDisplayBadges: (row: KanbanRendererRow, attributes: AttributeDescriptor[], displayProperties: string[]) => AttributeBadge[];
+interface FilterCategoryView {
+  id: string;
+  label: string;
+  selectionMode: "multiple";
+  options: {
+    value: string;
+    label: string;
+    color?: string;
+  }[];
+}
+/**
+ * Build the filter menu's category list from the declared attributes. Enum
+ * descriptors expose their declared options first; auto-derived values from
+ * the data fill in the gaps for string / date / number / user attributes (so
+ * filter chips for free-form fields don't require declaring every option).
+ */
+export declare const buildFilterCategories: (attributes: AttributeDescriptor[], rows: KanbanRendererRow[]) => FilterCategoryView[];
+interface MenuOption {
+  value: string;
+  label: string;
+}
+export declare const buildGroupingOptions: (attributes: AttributeDescriptor[]) => MenuOption[];
+export declare const buildOrderingOptions: (attributes: AttributeDescriptor[]) => MenuOption[];
+export declare const buildDisplayPropertyOptions: (attributes: AttributeDescriptor[]) => MenuOption[];
+/**
+ * Drop persisted settings entries that reference attribute ids no longer
+ * declared by the contribution. Falls back to defaults for missing grouping
+ * and ordering attributes so a stale saved view still loads cleanly.
+ */
+export declare const sanitizeSettings: (settings: KanbanRendererSettings, attributes: AttributeDescriptor[]) => KanbanRendererSettings;
+export declare const sanitizeFilters: (filters: KanbanRendererFilterState, attributes: AttributeDescriptor[]) => KanbanRendererFilterState;
+//#endregion
+//#region src/components/kanban-renderer/display-menu.d.ts
+interface DisplayMenuProps {
+  settings: KanbanRendererSettings;
+  groupingOptions: MenuOption[];
+  orderingOptions: MenuOption[];
+  displayPropertyOptions: MenuOption[];
+  onViewModeChange: (value: KanbanRendererSettings["viewMode"]) => void;
+  onColumnGroupingChange: (value: string) => void;
+  onRowGroupingChange: (value: string) => void;
+  onOrderingAttributeIdChange: (value: string) => void;
+  onSortDirectionToggle: () => void;
+  onDisplayPropertyToggle: (property: string) => void;
+}
+export declare const DisplayMenu: (props: DisplayMenuProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/filter-menu.d.ts
+interface FilterMenuProps {
+  categories: FilterCategoryView[];
+  filters: KanbanRendererFilterState;
+  countsByCategory: Record<string, Record<string, number>>;
+  onToggleFilterValue: (attributeId: string, value: string) => void;
+  onClearFilter: (attributeId: string) => void;
+  onClearAll: () => void;
+}
+export declare const FilterMenu: (props: FilterMenuProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-card.d.ts
+interface KanbanRendererCardProps {
+  eyebrow?: string;
+  title: string;
+  badges?: AttributeBadge[];
+  customSlots?: ReactNode[];
+  workspaceBadge?: WorkspaceBadgeProps;
+  isSelected?: boolean;
+  draggable?: boolean;
+  onBadgeChange?: (attributeId: string, value: unknown) => void;
+  onDragStart?: DragEventHandler<HTMLDivElement>;
+  onDragEnd?: DragEventHandler<HTMLDivElement>;
+  onClick?: () => void;
+}
+export declare const KanbanRendererCard: (props: KanbanRendererCardProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-board.d.ts
+type KanbanRendererCardProps$1 = ComponentProps<typeof KanbanRendererCard>;
+interface KanbanRendererBoardItem {
+  id: string;
+  cardProps: Omit<KanbanRendererCardProps$1, "draggable" | "onDragStart" | "onDragEnd" | "isSelected">;
+  contextMenuActions?: ResourceContextAction[];
+}
+interface KanbanRendererBoardColumnAction {
+  id: string;
+  label: string;
+  icon: ComponentType<{
+    size?: number | string;
+  }>;
+}
+interface KanbanRendererBoardGroup {
+  key: string;
+  label: string;
+  items: KanbanRendererBoardItem[];
+}
+interface KanbanRendererBoardColumn {
+  id: string;
+  label: string;
+  createLabel?: string;
+  color?: string;
+  icon?: string | null;
+  items: KanbanRendererBoardItem[];
+  groups?: KanbanRendererBoardGroup[];
+  canDragIn: boolean;
+  canDragOut: boolean;
+  canCreate: boolean;
+  actions: KanbanRendererBoardColumnAction[];
+}
+interface KanbanRendererBoardProps {
+  columns: KanbanRendererBoardColumn[];
+  selectedItemId?: string | null;
+  onMoveItem?: (itemId: string, targetColumnId: string, context?: {
+    beforeItemId?: string;
+    targetGroupKey?: string;
+  }) => Promise<void> | void;
+  onMoveToGroup?: (itemId: string, targetGroupKey: string, context?: {
+    beforeItemId?: string;
+  }) => Promise<void> | void;
+  onCreateStart?: (columnId: string) => void;
+  onColumnAction?: (columnId: string, actionId: string) => Promise<void> | void;
+}
+export declare const KanbanRendererBoard: (props: KanbanRendererBoardProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer.d.ts
+/** Board-column behavior and menu configuration for a resolved column group. */
+interface BoardColumnConfig {
+  /** Chakra color palette used for the column header and group badges. */
+  color?: string;
+  canDragIn?: boolean;
+  canDragOut?: boolean;
+  canCreate?: boolean;
+  actions?: KanbanRendererBoardColumnAction[];
+}
+/** Switchable list/board renderer for rows with typed attributes, filtering, grouping, and ordering. */
+interface KanbanRendererProps<TRow extends KanbanRendererRow = KanbanRendererRow> {
+  /** Stable rows to render. Each row must have an id, title, and attributes map. */
+  rows: TRow[];
+  /** Persistent key used by the renderer store for view, filter, grouping, ordering, and list expansion settings. */
+  storageKey: string;
+  /** Attribute descriptors that define display, filtering, grouping, ordering, and board columns. */
+  attributes: AttributeDescriptor[];
+  selectedRowId?: string | null;
+  emptyState?: ReactNode;
+  emptyTitle?: string;
+  emptyDescription?: string;
+  defaultSettings?: Partial<KanbanRendererSettings>;
+  defaultFilters?: KanbanRendererFilterState;
+  defaultViews?: KanbanRendererSavedView[];
+  defaultActiveViewId?: string;
+  hideToolbar?: boolean;
+  toolbarLeading?: ReactNode;
+  onRowClick?: (row: TRow) => void;
+  /** Called when a row attribute changes through drag/drop, board movement, or inline controls. */
+  onAttributeChange?: (rowId: string, attributeId: string, value: unknown) => Promise<void> | void;
+  /** Called for manual row ordering when a dragged row is dropped before another row. */
+  onReorder?: (rowId: string, beforeRowId?: string) => Promise<void> | void;
+  createRow?: KanbanRendererCreateRowConfig;
+  onCreateRow?: (submission: KanbanRendererCreateSubmission) => Promise<void> | void;
+  onColumnAction?: (columnId: string, actionId: string) => Promise<void> | void;
+  getBoardColumnConfig?: (groupKey: string) => BoardColumnConfig;
+  getRowContextMenuActions?: (row: TRow) => ResourceContextAction[];
+}
+export declare const KanbanRenderer: <TRow extends KanbanRendererRow>(props: KanbanRendererProps<TRow>) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-create-dialog.d.ts
+interface KanbanRendererCreateDialogProps {
+  open: boolean;
+  columnId: string;
+  columnAttributeId?: string;
+  attributes: AttributeDescriptor[];
+  config: KanbanRendererCreateRowConfig;
+  onClose: () => void;
+  onSubmit: (submission: KanbanRendererCreateSubmission) => Promise<void> | void;
+}
+export declare const KanbanRendererCreateDialog: (props: KanbanRendererCreateDialogProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-list.d.ts
+interface KanbanRendererListItem {
+  id: string;
+  eyebrow?: string;
+  title: string;
+  isGroup?: boolean;
+  countBadge?: number;
+  countColorPalette?: string;
+  statusIcon?: ComponentType<{
+    size?: number | string;
+  }>;
+  statusColor?: string;
+  statusColorPalette?: string;
+  badges?: AttributeBadge[];
+  customSlots?: ReactNode[];
+  children?: KanbanRendererListItem[];
+  onClick?: () => void;
+  onBadgeChange?: (attributeId: string, value: unknown) => void;
+  contextMenuActions?: ResourceContextAction[];
+  draggable?: boolean;
+  onDropRow?: (rowId: string) => void;
+}
+type KanbanRendererListExpandedState = Record<string, boolean>;
+interface KanbanRendererListProps {
+  items: KanbanRendererListItem[];
+  selectedItemId?: string | null;
+  expandedGroups?: KanbanRendererListExpandedState;
+  onItemClick?: (item: KanbanRendererListItem) => void;
+  onExpandedGroupChange?: (rowId: string, isExpanded: boolean) => void;
+}
+export declare const KanbanRendererList: (props: KanbanRendererListProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-storage.d.ts
+/** Synchronous snapshot storage supplied by the host before rendering saved views. */
+interface KanbanRendererStorage {
+  getItem: (key: string) => string | null;
+  setItem: (key: string, value: string) => void;
+  removeItem?: (key: string) => void;
+}
+interface KanbanRendererStorageProviderProps {
+  storage: KanbanRendererStorage | undefined;
+  children: ReactNode;
+}
+/** Hosts can persist views outside the browser origin, such as in a desktop profile. */
+export declare const KanbanRendererStorageProvider: (props: KanbanRendererStorageProviderProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/kanban-renderer-toolbar.d.ts
+interface KanbanRendererToolbarProps<TRow extends KanbanRendererRow = KanbanRendererRow> {
+  rows: TRow[];
+  storageKey: string;
+  attributes: AttributeDescriptor[];
+  defaultSettings?: Partial<KanbanRendererSettings>;
+  defaultFilters?: KanbanRendererFilterState;
+  defaultViews?: KanbanRendererSavedView[];
+  defaultActiveViewId?: string;
+  leading?: ReactNode;
+  displayControl?: ReactNode;
+  align?: "split" | "end";
+}
+export declare const KanbanRendererToolbar: <TRow extends KanbanRendererRow>(props: KanbanRendererToolbarProps<TRow>) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+//#region src/components/kanban-renderer/use-kanban-renderer-store.d.ts
+interface KanbanRendererSnapshot {
+  settings: KanbanRendererSettings;
+  filters: KanbanRendererFilterState;
+  expandedGroups: Record<string, boolean>;
+  views: KanbanRendererSavedView[];
+  activeViewId: string;
+}
+interface KanbanRendererStoreInitialState {
+  settings?: Partial<KanbanRendererSettings>;
+  filters?: KanbanRendererFilterState;
+  expandedGroups?: Record<string, boolean>;
+  views?: KanbanRendererSavedView[];
+  activeViewId?: string;
+}
+interface KanbanRendererState extends KanbanRendererSnapshot {
+  setViewMode: (viewMode: KanbanRendererSettings["viewMode"]) => void;
+  setColumnGrouping: (columnGrouping: KanbanRendererSettings["columnGrouping"]) => void;
+  setRowGrouping: (rowGrouping: KanbanRendererSettings["rowGrouping"]) => void;
+  setOrdering: (ordering: KanbanRendererSettings["ordering"]) => void;
+  setOrderingAttributeId: (attributeId: KanbanRendererSettings["ordering"]["attributeId"]) => void;
+  setDisplayProperties: (displayProperties: string[]) => void;
+  toggleSortDirection: () => void;
+  toggleDisplayProperty: (property: string) => void;
+  setFilter: (attributeId: string, values: string[]) => void;
+  toggleFilterValue: (attributeId: string, value: string) => void;
+  clearFilter: (attributeId: string) => void;
+  clearAllFilters: () => void;
+  setExpandedGroup: (groupId: string, isExpanded: boolean) => void;
+  activateView: (viewId: string) => void;
+  createView: (view: {
+    id: string;
+    title: string;
+  }) => void;
+  saveActiveView: () => void;
+  resetActiveView: () => void;
+  renameView: (viewId: string, title: string) => void;
+  duplicateView: (viewId: string, duplicate: {
+    id: string;
+    title: string;
+  }) => void;
+  deleteView: (viewId: string) => void;
+  setDefaultView: (viewId: string) => void;
+  reset: () => void;
+}
+export declare const useKanbanRendererStore: <T>(storageKey: string, selector: (state: KanbanRendererState) => T, initialState?: KanbanRendererStoreInitialState) => T;
+export declare const isActiveKanbanRendererViewDirty: (state: Pick<KanbanRendererState, "activeViewId" | "filters" | "settings" | "views">) => boolean;
+//#endregion
+//#region src/components/kanban-renderer/use-resolved-attributes.d.ts
+/**
+ * Returns the same descriptors with every source-backed enum's options
+ * replaced by a fresh `getSnapshot()` array. Pure — call from anywhere that
+ * needs a normalized view of the schema.
+ */
+export declare const resolveAttributeOptions: (attributes: AttributeDescriptor[]) => AttributeDescriptor[];
+/**
+ * Subscribes to every source-backed enum in `attributes` and returns the
+ * resolved descriptors (options materialized to plain arrays). When any
+ * source's listener fires the component rerenders, so downstream renders see
+ * the new snapshot automatically.
+ */
+export declare const useResolvedAttributes: (attributes: AttributeDescriptor[]) => AttributeDescriptor[];
+//#endregion
+export { type AttributeBadge, type AttributeDescriptor, type AttributeDisplayDescriptor, type AttributeKind, type AttributeType, type AttributesSource, type BoardColumnConfig, type EnumOption, type EnumOptions, type EnumOptionsSource, type FilterCategoryView, type KanbanRendererBoardColumn, type KanbanRendererBoardColumnAction, type KanbanRendererBoardItem, type KanbanRendererCardProps, type KanbanRendererCreateField, type KanbanRendererCreateFieldType, type KanbanRendererCreateRowConfig, type KanbanRendererCreateSubmission, type KanbanRendererFilterState, type KanbanRendererListItem, type KanbanRendererOrdering, type KanbanRendererProps, type KanbanRendererRow, type KanbanRendererSavedView, type KanbanRendererSettings, type KanbanRendererStorage, type KanbanRendererToolbarProps, MANUAL_ORDERING, type MenuOption, NO_GROUPING, type SortDirection, type ViewMode, findAttribute, isAttributesSource, isEnumOptionsSource };
+export {};