@rokkit/ui 1.3.3 → 1.3.5

package/src/types/tree-table.ts

@@ -1,103 +0,0 @@
-/**
- * TreeTable Component Types
- *
- * Hierarchical analog of Table — accepts nested rows (each row may
- * carry a `children: []` array) and renders the hierarchy in one
- * designated column with chevron + indent + tree connectors.
- *
- * Reuses the column / sort / cell types from Table.
- */
-
-import type { Snippet } from 'svelte'
-import type { TableColumn, TableSortIcons, SortState, TableFields } from './table.js'
-
-// =============================================================================
-// Column extension
-// =============================================================================
-
-/**
- * Column definition for TreeTable — adds an optional `hierarchy` flag
- * to mark which column renders the chevron + indent connectors. When
- * no column is flagged, the first column is treated as the hierarchy
- * column by default.
- */
-export interface TreeTableColumn extends TableColumn {
-	/** Render chevron + tree connectors in this column. Defaults to the first column. */
-	hierarchy?: boolean
-}
-
-// =============================================================================
-// Snippets
-// =============================================================================
-
-export type TreeTableHeaderSnippet = Snippet<[TreeTableColumn[], SortState[]]>
-export type TreeTableRowSnippet = Snippet<
-	[Record<string, unknown>, TreeTableColumn[], number, boolean]
->
-export type TreeTableCellSnippet = Snippet<
-	[unknown, TreeTableColumn, Record<string, unknown>]
->
-export type TreeTableEmptySnippet = Snippet<[]>
-
-// =============================================================================
-// Component Props
-// =============================================================================
-
-export interface TreeTableProps {
-	/** Nested row data — each row may carry a `children: []` array. */
-	data?: Record<string, unknown>[]
-
-	/** Column definitions (auto-derived from the first row if not provided). */
-	columns?: TreeTableColumn[]
-
-	/** Currently selected row value (single-select) */
-	value?: unknown
-
-	/** Currently selected row values (multi-select, bindable) */
-	values?: unknown[]
-
-	/** Selection mode: 'single' (default), 'multi', or false (no selection) */
-	selectable?: 'single' | 'multi' | false
-
-	/** Table caption for accessibility */
-	caption?: string
-
-	/** Size variant */
-	size?: 'sm' | 'md' | 'lg'
-
-	/** Enable alternating row colors */
-	striped?: boolean
-
-	/** Whether the entire table is disabled */
-	disabled?: boolean
-
-	/** Tree connector line style — same options as the Tree component */
-	lineStyle?: 'none' | 'solid' | 'dashed' | 'dotted'
-
-	/** Row-level field mapping (incl. the `children` field name). */
-	fields?: TableFields & { children?: string }
-
-	/** Called when a row is selected */
-	onselect?: (value: unknown, row: Record<string, unknown>) => void
-
-	/** Called when sort state changes */
-	onsort?: (sortState: SortState[]) => void
-
-	/** Additional CSS classes */
-	class?: string
-
-	/** Sort indicator icons */
-	icons?: TableSortIcons & { opened?: string; closed?: string }
-
-	/** Custom header snippet */
-	header?: TreeTableHeaderSnippet
-
-	/** Custom row snippet */
-	row?: TreeTableRowSnippet
-
-	/** Custom cell snippet */
-	cell?: TreeTableCellSnippet
-
-	/** Empty state snippet */
-	empty?: TreeTableEmptySnippet
-}

package/src/types/tree.ts

@@ -1,302 +0,0 @@
-/**
- * Tree Component Types
- *
- * Provides types for the data-driven Tree component.
- * Supports hierarchical data with expand/collapse, tree lines, and custom icons.
- * Field mapping and data access is handled by ProxyItem from @rokkit/states.
- */
-
-import type { Snippet } from 'svelte'
-import { DEFAULT_STATE_ICONS } from '@rokkit/core'
-
-// =============================================================================
-// Field Mapping Types
-// =============================================================================
-
-/**
- * Field mapping configuration for tree data — what the consumer passes
- * to the Tree component. Both `expanded` and `level` are optional here
- * because Tree falls back to `defaultTreeFields` for any field the
- * consumer omits.
- *
- * Inside Tree the fields are merged with `defaultTreeFields` to produce
- * a `ResolvedTreeFields` value where every key is guaranteed present.
- * Downstream code that needs string field names without null-guards
- * should use `ResolvedTreeFields` rather than `TreeFields`.
- */
-export interface TreeFields {
-	// Index signature must allow `undefined` so the optional keys below
-	// (typed as `string | undefined`) are assignable. Extending
-	// `Record<string, string>` here would conflict with the optionals
-	// and produce TS2411 in any strict downstream consumer.
-	[field: string]: string | undefined
-
-	/**
-	 * Name of the field on each tree item that holds its expanded state.
-	 * The value at that field is expected to be a `boolean`.
-	 *
-	 * Optional — falls back to the default field name `'expanded'`. After
-	 * `resolveTreeFields` is applied the resolved key is guaranteed present
-	 * (see {@link ResolvedTreeFields}).
-	 */
-	expanded?: string
-
-	/**
-	 * Name of the field on each tree item that holds its depth in the tree.
-	 * The value at that field is expected to be a `number`.
-	 *
-	 * Optional — falls back to the default field name `'level'`. After
-	 * `resolveTreeFields` is applied the resolved key is guaranteed present
-	 * (see {@link ResolvedTreeFields}).
-	 */
-	level?: string
-}
-
-/**
- * Tree fields after defaults have been applied — every field name is a
- * non-null string. Use this type for any function or store that needs
- * to read a field name without re-applying defaults.
- *
- * Construct from a `TreeFields` via `resolveTreeFields(fields)` (or by
- * spreading `defaultTreeFields` first, e.g.
- * `{ ...defaultTreeFields, ...userFields }`).
- */
-export type ResolvedTreeFields = Required<TreeFields>
-
-/**
- * Default field mapping values for tree
- */
-export const defaultTreeFields: Required<Omit<TreeFields, 'fields'>> = {
-	text: 'text',
-	value: 'value',
-	icon: 'icon',
-	description: 'description',
-	shortcut: 'shortcut',
-	label: 'label',
-	disabled: 'disabled',
-	active: 'active',
-	type: 'type',
-	children: 'children',
-	snippet: 'snippet',
-	href: 'href',
-	badge: 'badge',
-	expanded: 'expanded',
-	level: 'level'
-}
-
-/**
- * Merge consumer-provided field overrides with the default field
- * mapping so every key resolves to a string. Tree calls this once on
- * its `fields` prop before passing the result to ProxyTree / line
- * builders.
- */
-export function resolveTreeFields(fields: TreeFields = {}): ResolvedTreeFields {
-	// `Required<TreeFields>` cannot strip `undefined` from the index
-	// signature on its own, so spread-inference fails the contract even
-	// though `defaultTreeFields` provides every key. Cast through unknown
-	// to assert the post-merge shape.
-	return { ...defaultTreeFields, ...fields } as unknown as ResolvedTreeFields
-}
-
-// =============================================================================
-// Tree Item Types
-// =============================================================================
-
-/**
- * Generic tree item - can be any object with mapped fields
- */
-export type TreeItem = Record<string, unknown>
-
-// =============================================================================
-// Tree Line/Connector Types
-// =============================================================================
-
-/**
- * Types of tree line connectors
- */
-export type TreeLineType = 'child' | 'last' | 'sibling' | 'empty' | 'icon'
-
-/**
- * Connector types (without 'icon' which is handled separately)
- */
-export type ConnectorType = 'child' | 'last' | 'sibling' | 'empty'
-
-/**
- * Icons configuration for tree expand/collapse states.
- * Keys match the naming convention in @rokkit/core DEFAULT_STATE_ICONS.
- */
-export interface TreeStateIcons {
-	/** Icon class for expanded/opened state */
-	opened?: string
-	/** Icon class for collapsed/closed state */
-	closed?: string
-}
-
-/**
- * Default state icons — uses semantic names from @rokkit/core
- * that get resolved to actual icon classes via UnoCSS shortcuts.
- */
-export const defaultTreeStateIcons: TreeStateIcons = {
-	opened: DEFAULT_STATE_ICONS.node.opened,
-	closed: DEFAULT_STATE_ICONS.node.closed
-}
-
-// =============================================================================
-// Snippet Types
-// =============================================================================
-
-/**
- * Handlers passed to custom item snippets
- */
-export interface TreeItemHandlers {
-	/** Call to trigger item selection */
-	onclick: () => void
-	/** Call to toggle expand/collapse */
-	ontoggle: () => void
-	/** Forward keyboard events for accessibility */
-	onkeydown: (event: KeyboardEvent) => void
-}
-
-/**
- * Snippet type for rendering tree nodes.
- * Parameters: item, fields, handlers, isActive, isExpanded, level
- */
-export type TreeItemSnippet = Snippet<
-	[TreeItem, TreeFields, TreeItemHandlers, boolean, boolean, number]
->
-
-/**
- * Snippet type for rendering the expand/collapse icon
- * Parameters: isExpanded, hasChildren, icons
- */
-export type TreeToggleSnippet = Snippet<[boolean, boolean, TreeStateIcons]>
-
-/**
- * Snippet type for rendering tree line connectors
- * Parameters: lineType
- */
-export type TreeConnectorSnippet = Snippet<[TreeLineType]>
-
-// =============================================================================
-// Component Props Types
-// =============================================================================
-
-/**
- * Props for the Tree component
- */
-export interface TreeProps {
-	/** Array of tree items (hierarchical) */
-	items?: TreeItem[]
-
-	/** Field mapping configuration */
-	fields?: TreeFields
-
-	/** Currently selected value */
-	value?: unknown
-
-	/** Size variant */
-	size?: 'sm' | 'md' | 'lg'
-
-	/** Tree line connector style — 'none' hides lines, 'solid'|'dashed'|'dotted' set the line style */
-	lineStyle?: 'none' | 'solid' | 'dashed' | 'dotted'
-
-	/** Enable multiple item selection (Ctrl+click toggle, Shift+click range) */
-	multiselect?: boolean
-
-	/** Which nodes are expanded (bindable) - keyed by node value */
-	expanded?: Record<string, boolean>
-
-	/** Selected items array (bindable) - populated in multiselect mode */
-	selected?: unknown[]
-
-	/** Expand all nodes by default */
-	expandAll?: boolean
-
-	/** Active item value - Tree looks up item by this value to highlight it */
-	active?: unknown
-
-	/** Icons for expand/collapse states */
-	icons?: TreeStateIcons
-
-	/** Called when an item is selected */
-	onselect?: (value: unknown, item: TreeItem) => void
-
-	/** Called when selected items change in multiselect mode */
-	onselectedchange?: (selected: unknown[]) => void
-
-	/** Called when expanded state changes */
-	onexpandedchange?: (expanded: Record<string, boolean>) => void
-
-	/** Called when a node is toggled */
-	ontoggle?: (value: unknown, item: TreeItem, isExpanded: boolean) => void
-
-	/** Called when expanding a node with unloaded children (children: true). Returns the children array. */
-	onloadchildren?: (value: unknown, item: TreeItem) => Promise<TreeItem[]>
-
-	/** Additional CSS classes */
-	class?: string
-
-	/** Custom snippet for rendering tree items */
-	item?: TreeItemSnippet
-
-	/** Custom snippet for rendering expand/collapse toggle */
-	toggle?: TreeToggleSnippet
-
-	/** Custom snippet for rendering tree line connectors */
-	connector?: TreeConnectorSnippet
-}
-
-// =============================================================================
-// Helper Functions
-// =============================================================================
-
-/**
- * Mapping for calculating next line type based on parent type
- * Based on @rokkit/core connector implementation
- */
-const nextLineType: Record<TreeLineType, TreeLineType> = {
-	child: 'sibling',
-	last: 'empty',
-	sibling: 'sibling',
-	empty: 'empty',
-	icon: 'empty'
-}
-
-/**
- * Constructs an array of line types for tree visualization.
- * This determines what connectors to show at each depth level.
- *
- * Algorithm from @rokkit/core getLineTypes:
- * - For all but the last parent type, convert to continuation type
- * - For the last parent type, use the current node's position
- * - Append 'icon' for nodes with children, 'empty' for leaf nodes
- *
- * @param hasChildren - Whether the node has children
- * @param parentTypes - Line types from parent nodes
- * @param position - Current position type ('child' or 'last')
- * @returns Array of line types for rendering connectors
- */
-export function getLineTypes(
-	hasChildren: boolean = false,
-	parentTypes: TreeLineType[] = [],
-	position: 'child' | 'last' = 'child'
-): TreeLineType[] {
-	const result = parentTypes.reduce<TreeLineType[]>((acc, type, index) => {
-		// For all but the last parent type, convert to next type
-		// 'child' -> 'sibling' (vertical line continues)
-		// 'last' -> 'empty' (no line, branch ended)
-		if (index < parentTypes.length - 1) {
-			return [...acc, nextLineType[type]]
-		}
-		// For the last parent type, use the current node's position
-		return [...acc, position]
-	}, [])
-
-	// Append icon slot for expandable nodes, empty for leaf nodes
-	return result.concat(hasChildren ? 'icon' : 'empty')
-}
-
-// Keep old name as alias for backward compatibility
-export const getTreeLineTypes = getLineTypes
-
-export { getSnippet } from './menu.js'

package/src/types/upload-file-status.ts

@@ -1,45 +0,0 @@
-/**
- * UploadFileStatus Component Types
- *
- * Renders a single file's upload status with progress bar, action buttons
- * (cancel/retry/remove), and file metadata (icon, name, size, status label).
- * Action button visibility driven by cancelWhen/retryWhen/removeWhen arrays.
- */
-
-import type { ProxyItem } from '@rokkit/states'
-
-// =============================================================================
-// Component Props
-// =============================================================================
-
-/**
- * Props for the UploadFileStatus component
- */
-export interface UploadFileStatusProps {
-	/** ProxyItem wrapping the file data */
-	proxy: ProxyItem
-
-	/** Status values that show the cancel button */
-	cancelWhen?: string[]
-
-	/** Status values that show the retry button */
-	retryWhen?: string[]
-
-	/** Status values that show the remove button */
-	removeWhen?: string[]
-
-	/** Called when cancel is clicked */
-	oncancel?: (proxy: ProxyItem) => void
-
-	/** Called when retry is clicked */
-	onretry?: (proxy: ProxyItem) => void
-
-	/** Called when remove is clicked */
-	onremove?: (proxy: ProxyItem) => void
-
-	/** Label overrides merged with messages.uploadProgress */
-	labels?: Record<string, string>
-
-	/** Icon class overrides for action buttons (cancel, retry, remove) */
-	icons?: Record<string, string>
-}

package/src/types/upload-progress.ts

@@ -1,111 +0,0 @@
-/**
- * UploadProgress Component Types
- *
- * File upload status orchestrator. Thin composition layer that renders
- * a header + List or Grid layout. Default itemContent snippet renders
- * UploadFileStatus for each file. Consumer can override with custom snippet.
- */
-
-import type { Snippet } from 'svelte'
-import type { ProxyItem } from '@rokkit/states'
-
-// =============================================================================
-// Item Types
-// =============================================================================
-
-/**
- * Generic upload file item — any object with mapped fields
- */
-export type UploadItem = Record<string, unknown>
-
-// =============================================================================
-// Field Mapping Types
-// =============================================================================
-
-/**
- * Field mapping for upload file data.
- * Maps semantic field names to keys in the data objects.
- */
-export interface UploadFields {
-	/** Field for display text - default: 'text' */
-	label?: string
-
-	/** Field for unique value - default: 'value' */
-	value?: string
-
-	/** Field for icon class - default: 'icon' */
-	icon?: string
-
-	/** Field for upload status key - default: 'status' */
-	status?: string
-
-	/** Field for progress percentage (0-100) - default: 'progress' */
-	progress?: string
-
-	/** Field for file size in bytes - default: 'size' */
-	size?: string
-
-	/** Field for MIME type - default: 'type' */
-	type?: string
-
-	/** Field for error message - default: 'error' */
-	error?: string
-}
-
-// =============================================================================
-// Snippet Types
-// =============================================================================
-
-/**
- * Snippet for custom per-file rendering inside List/Grid.
- * Receives the ProxyItem wrapping the file data.
- */
-export type UploadItemSnippet = Snippet<[proxy: ProxyItem]>
-
-// =============================================================================
-// Component Props
-// =============================================================================
-
-/**
- * Props for the UploadProgress component
- */
-export interface UploadProgressProps {
-	/** Array of file data objects */
-	files?: UploadItem[]
-
-	/** Field mapping configuration */
-	fields?: UploadFields
-
-	/** Layout mode */
-	view?: 'list' | 'grid'
-
-	/** Status values that show the cancel button */
-	cancelWhen?: string[]
-
-	/** Status values that show the retry button */
-	retryWhen?: string[]
-
-	/** Status values that show the remove button */
-	removeWhen?: string[]
-
-	/** Called when cancel is clicked (receives raw file object) */
-	oncancel?: (file: UploadItem) => void
-
-	/** Called when retry is clicked (receives raw file object) */
-	onretry?: (file: UploadItem) => void
-
-	/** Called when remove is clicked (receives raw file object) */
-	onremove?: (file: UploadItem) => void
-
-	/** Called when clear all is clicked */
-	onclear?: () => void
-
-	/** Label overrides merged with messages.uploadProgress */
-	labels?: Record<string, string>
-
-	/** Additional CSS classes */
-	class?: string
-
-	/** Custom snippet for per-file rendering (overrides default UploadFileStatus) */
-	itemContent?: UploadItemSnippet
-}

package/src/types/upload-target.ts

@@ -1,71 +0,0 @@
-/**
- * UploadTarget Component Types
- *
- * Drop zone with file validation. Accepts drag-and-drop or click-to-browse.
- * Validates files against accept (MIME/extension) and maxSize constraints.
- */
-
-import type { Snippet } from 'svelte'
-
-// =============================================================================
-// Item Types
-// =============================================================================
-
-/**
- * File validation error returned via onerror callback
- */
-export interface UploadError {
-	/** The file that failed validation */
-	file: File
-	/** Why the file was rejected */
-	reason: 'type' | 'size'
-}
-
-// =============================================================================
-// Snippet Types
-// =============================================================================
-
-/**
- * Snippet for custom drop zone content.
- * Receives the current dragging state.
- */
-export type UploadTargetContentSnippet = Snippet<[dragging: boolean]>
-
-// =============================================================================
-// Component Props
-// =============================================================================
-
-/**
- * Props for the UploadTarget component
- */
-export interface UploadTargetProps {
-	/** Accepted file types (MIME types or extensions, comma-separated) */
-	accept?: string
-
-	/** Maximum file size in bytes */
-	maxSize?: number
-
-	/** Allow multiple file selection */
-	multiple?: boolean
-
-	/** Disable the drop zone */
-	disabled?: boolean
-
-	/** Label overrides merged with messages.uploadTarget */
-	labels?: Record<string, string>
-
-	/** Called with validated files after drop or browse */
-	onfiles?: (files: File[]) => void
-
-	/** Called for each file that fails validation */
-	onerror?: (err: UploadError) => void
-
-	/** Size variant — full (default) fills available area; small shows only border + icon */
-	size?: 'full' | 'small'
-
-	/** Additional CSS classes */
-	class?: string
-
-	/** Custom content snippet (replaces default drop zone UI) */
-	content?: UploadTargetContentSnippet
-}