@monkey-mini-app/dsh-mini-app 0.1.0

package/skills/monkey-mini-app/references/contracts/data-grid.md

@@ -0,0 +1,87 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DataGrid
+
+Product table: sort, column filter popover, global search, pagination.
+
+**when** Any list/table of rows — prefer over raw Table*
+
+`import { DataGrid, SearchVariant, DataGridColumnMeta, DataGridFeatures } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/data-grid.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `columns` | `ColumnDef<TData, unknown>[]` | ✓ |  |
+| `data` | `TData[]` | ✓ |  |
+| `features` | `DataGridFeatures \| undefined` |  |  |
+| `getRowId` | `((row: TData) => string) \| undefined` |  |  |
+| `onPageIndexChange` | `((pageIndex: number) => void) \| undefined` |  | Fired on every page change (also when the user flips pages). |
+| `onRowClick` | `((row: TData) => void) \| undefined` |  | Fired when a row is clicked, with the row's data. |
+| `onStateChange` | `((state: { sorting: SortingState; columnFilters: ColumnFiltersState; globalFilter: string; pagination: { pageIndex: number; pageSize: number; }; }) => void) \| undefined` |  |  |
+| `pageIndex` | `number \| undefined` |  | Controlled current page (0-based). Omit for internal state. |
+| `pageSize` | `number \| undefined` |  |  |
+| `renderExpanded` | `((row: TData) => React.ReactNode) \| undefined` |  |  |
+| `searchPlaceholder` | `string \| undefined` |  |  |
+| `toolbar` | `React.ReactNode` |  |  |
+
+## Types
+
+### `SearchVariant`
+
+```ts
+"text" | "number" | "select" | "none"
+```
+
+### `DataGridColumnMeta`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `label` | `string \| undefined` |  |  |
+| `search` | `SearchVariant \| undefined` |  |  |
+| `sort` | `boolean \| undefined` |  |  |
+
+### `DataGridFeatures`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `autoResetPageIndex` | `boolean \| undefined` |  | TanStack `autoResetPageIndex` — reset to page 1 when the `data` array
+reference changes (default true). Turn off for inline edits / appends that
+must keep the current page; pair with a `key` remount for structural loads. |
+| `columnResize` | `boolean \| undefined` |  |  |
+| `columnSearch` | `boolean \| undefined` |  |  |
+| `columnVisibility` | `boolean \| undefined` |  |  |
+| `csvExport` | `boolean \| undefined` |  |  |
+| `globalSearch` | `boolean \| undefined` |  |  |
+| `pagination` | `boolean \| undefined` |  |  |
+| `rowSelection` | `boolean \| undefined` |  |  |
+| `sorting` | `boolean \| undefined` |  |  |
+
+## Example
+
+```tsx
+const columns: ColumnDef<Row>[] = [
+  { accessorKey: "name", header: "Name", meta: { sort: true, search: "text" } },
+]
+<DataGrid columns={columns} data={rows} pageSize={20} />
+
+Pagination resets to page 1 whenever the `data` reference changes
+(TanStack `autoResetPageIndex`, default true) — right for filter/refresh
+flows. For inline edits / streaming appends that must keep the current page,
+set `features={{ autoResetPageIndex: false }}` and drive page resets with
+the controlled `pageIndex` prop:
+```
+
+```tsx
+const [page, setPage] = useState(0)
+<DataGrid
+  columns={columns}
+  data={rows}
+  features={{ autoResetPageIndex: false }}
+  pageIndex={page}
+  onPageIndexChange={setPage}
+/>
+// “回到第 1 页”按钮：setPage(0)；结构性重载也可用 key 重挂
+```

package/skills/monkey-mini-app/references/contracts/date-picker.md

@@ -0,0 +1,17 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DatePicker
+
+`import { DatePicker } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/composites/date-picker.tsx` · composites
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `disabled` | `boolean \| undefined` |  |  |
+| `onChange` | `((date: Date \| undefined) => void) \| undefined` |  |  |
+| `placeholder` | `string \| undefined` |  |  |
+| `value` | `Date \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/date-range-picker.md

@@ -0,0 +1,26 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DateRangePicker
+
+Popover date range with month/year chrome.
+
+**when** Filters needing from/to calendar days
+
+`import { DateRangePicker } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/composites/date-range-picker.tsx` · composites
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `onChange` | `((range: DateRange \| undefined) => void) \| undefined` |  |  |
+| `placeholder` | `string \| undefined` |  |  |
+| `value` | `DateRange \| undefined` |  |  |
+
+## Example
+
+```tsx
+<DateRangePicker value={range} onChange={setRange} />
+```

package/skills/monkey-mini-app/references/contracts/date-time-picker.md

@@ -0,0 +1,18 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DateTimePicker
+
+`import { DateTimePicker } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/composites/date-time-picker.tsx` · composites
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `onChange` | `((date: Date \| undefined) => void) \| undefined` |  |  |
+| `onTimezoneChange` | `((zone: string) => void) \| undefined` |  |  |
+| `placeholder` | `string \| undefined` |  |  |
+| `timezone` | `string \| undefined` |  |  |
+| `value` | `Date \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/date-time-range-picker.md

@@ -0,0 +1,24 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DateTimeRangePicker
+
+`import { DateTimeRangePicker, DateTimeRange } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/composites/date-time-range-picker.tsx` · composites
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `allDay` | `boolean \| undefined` |  |  |
+| `onChange` | `((value: DateTimeRange) => void) \| undefined` |  |  |
+| `value` | `DateTimeRange \| undefined` |  |  |
+
+## Types
+
+### `DateTimeRange`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `end` | `Date \| undefined` |  |  |
+| `start` | `Date \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/description-list.md

@@ -0,0 +1,13 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DescriptionList
+
+`import { DescriptionList } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/description-list.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `items` | `{ label: string; value: string; }[]` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/detail-panel.md

@@ -0,0 +1,27 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DetailPanel
+
+Right-side inspector Sheet for a selected row/entity.
+
+**when** Master-detail after row/card click
+
+`import { DetailPanel } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/detail-panel.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `children` | `ReactNode` |  |  |
+| `description` | `string \| undefined` |  |  |
+| `onOpenChange` | `(open: boolean) => void` | ✓ |  |
+| `open` | `boolean` | ✓ |  |
+| `title` | `string` | ✓ |  |
+
+## Example
+
+```tsx
+<DetailPanel open={!!id} onOpenChange={() => setId(null)} title="Run #12">{body}</DetailPanel>
+```

package/skills/monkey-mini-app/references/contracts/diff-viewer.md

@@ -0,0 +1,16 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DiffViewer
+
+`import { DiffViewer } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/diff-viewer.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `fileName` | `string \| undefined` |  |  |
+| `mode` | `"unified" \| "split" \| undefined` |  |  |
+| `modified` | `string` | ✓ |  |
+| `original` | `string` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/donut-chart.md

@@ -0,0 +1,31 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DonutChart
+
+`import { DonutChart, ChartConfig, Slice } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/donut-chart.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `center` | `string \| undefined` |  |  |
+| `config` | `ChartConfig` | ✓ |  |
+| `data` | `Slice[]` | ✓ |  |
+
+## Types
+
+### `ChartConfig`
+
+```ts
+Record< string, { label?: React.ReactNode icon?: React.ComponentType } & ( | { color?: string; theme?: never } | { color?: never; theme: Record<keyof typeof THEMES, string> } ) >
+```
+
+### `Slice`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `fill` | `string` | ✓ |  |
+| `name` | `string` | ✓ |  |
+| `value` | `number` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/duration-input.md

@@ -0,0 +1,14 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# DurationInput
+
+`import { DurationInput } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/composites/duration-input.tsx` · composites
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `onChange` | `((value: string, minutes: number) => void) \| undefined` |  |  |
+| `value` | `string \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/env-badge.md

@@ -0,0 +1,13 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# EnvBadge
+
+`import { EnvBadge } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/env-badge.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `env` | `string` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/event-calendar.md

@@ -0,0 +1,50 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# EventCalendar
+
+Month / week / day calendar. Event shape: { id, title, start, end, allDay? }.
+Drag empty slots to create; click event to edit. Week/day have all-day row.
+
+**when** Scheduling, on-call, release windows
+
+`import { EventCalendar, CalendarView, CalendarEvent } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/event-calendar.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `events` | `CalendarEvent[]` | ✓ |  |
+| `onDayClick` | `((date: Date) => void) \| undefined` |  |  |
+| `onEventClick` | `((event: CalendarEvent) => void) \| undefined` |  |  |
+| `onEventsChange` | `((events: CalendarEvent[]) => void) \| undefined` |  |  |
+| `onValueChange` | `((date: Date) => void) \| undefined` |  |  |
+| `onViewChange` | `((view: CalendarView) => void) \| undefined` |  |  |
+| `value` | `Date \| undefined` |  |  |
+| `view` | `CalendarView \| undefined` |  |  |
+
+## Types
+
+### `CalendarView`
+
+```ts
+"month" | "week" | "day"
+```
+
+### `CalendarEvent`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `allDay` | `boolean \| undefined` |  |  |
+| `end` | `Date` | ✓ |  |
+| `id` | `string` | ✓ |  |
+| `start` | `Date` | ✓ |  |
+| `title` | `string` | ✓ |  |
+
+## Example
+
+```tsx
+<EventCalendar events={events} onEventsChange={setEvents} view="week" />
+```

package/skills/monkey-mini-app/references/contracts/file-dropzone.md

@@ -0,0 +1,14 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# FileDropzone
+
+`import { FileDropzone } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/file-dropzone.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `files` | `File[] \| undefined` |  |  |
+| `onFiles` | `((files: File[]) => void) \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/file-tree.md

@@ -0,0 +1,23 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# FileTree
+
+`import { FileTree, TreeNode } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/file-tree.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `nodes` | `TreeNode[]` | ✓ |  |
+
+## Types
+
+### `TreeNode`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `children` | `TreeNode[] \| undefined` |  |  |
+| `id` | `string` | ✓ |  |
+| `label` | `string` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/filter-bar.md

@@ -0,0 +1,26 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# FilterBar
+
+Horizontal wrap row for filters and toolbar controls.
+
+**when** Above DataGrid or any filtered list
+
+`import { FilterBar } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/filter-bar.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `children` | `ReactNode` | ✓ |  |
+
+## Example
+
+```tsx
+<FilterBar>
+  <DateRangePicker value={range} onChange={setRange} />
+  <SearchInput value={q} onChange={setQ} />
+</FilterBar>
+```

package/skills/monkey-mini-app/references/contracts/gantt.md

@@ -0,0 +1,24 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# Gantt
+
+`import { Gantt, GanttTask } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/gantt.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `tasks` | `GanttTask[]` | ✓ |  |
+
+## Types
+
+### `GanttTask`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `end` | `Date` | ✓ |  |
+| `id` | `string` | ✓ |  |
+| `start` | `Date` | ✓ |  |
+| `title` | `string` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/gauge.md

@@ -0,0 +1,14 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# Gauge
+
+`import { Gauge } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/blocks/gauge.tsx` · blocks
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `label` | `string \| undefined` |  |  |
+| `value` | `number` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/jira-wiki.md

@@ -0,0 +1,53 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# JiraWiki
+
+Render Jira wiki markup to tokens (headings, lists, tables, [^file], -strike-).
+Style via className / classNames; full control via parseJiraWiki().
+
+**when** Jira description / comment body
+
+`import { JiraWiki, JiraWikiClassNames } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/jira-wiki.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `children` | `string` | ✓ |  |
+| `className` | `string \| undefined` |  |  |
+| `classNames` | `JiraWikiClassNames \| undefined` |  |  |
+| `onAttachmentClick` | `((name: string) => void) \| undefined` |  |  |
+
+## Types
+
+### `JiraWikiClassNames`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `attachment` | `string \| undefined` |  |  |
+| `bold` | `string \| undefined` |  |  |
+| `code` | `string \| undefined` |  |  |
+| `heading` | `string \| undefined` |  |  |
+| `hr` | `string \| undefined` |  |  |
+| `inlineCode` | `string \| undefined` |  |  |
+| `italic` | `string \| undefined` |  |  |
+| `link` | `string \| undefined` |  |  |
+| `list` | `string \| undefined` |  |  |
+| `listItem` | `string \| undefined` |  |  |
+| `panel` | `string \| undefined` |  |  |
+| `panelTitle` | `string \| undefined` |  |  |
+| `paragraph` | `string \| undefined` |  |  |
+| `quote` | `string \| undefined` |  |  |
+| `root` | `string \| undefined` |  |  |
+| `strike` | `string \| undefined` |  |  |
+| `table` | `string \| undefined` |  |  |
+| `td` | `string \| undefined` |  |  |
+| `th` | `string \| undefined` |  |  |
+
+## Example
+
+```tsx
+<JiraWiki classNames={{ heading: "text-base" }}>{`h2. Title\n* item`}</JiraWiki>
+```

package/skills/monkey-mini-app/references/contracts/jql-input.md

@@ -0,0 +1,37 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# JqlInput
+
+CodeMirror JQL editor with field/function completion (host injects fields).
+
+**when** Issue search / saved filters
+
+`import { JqlInput, JqlSuggestItem } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/jql-input.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `className` | `string \| undefined` |  |  |
+| `fields` | `JqlSuggestItem[] \| undefined` |  |  |
+| `functions` | `JqlSuggestItem[] \| undefined` |  |  |
+| `height` | `string \| undefined` |  |  |
+| `onChange` | `((value: string) => void) \| undefined` |  |  |
+| `value` | `string` | ✓ |  |
+
+## Types
+
+### `JqlSuggestItem`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `detail` | `string \| undefined` |  |  |
+| `name` | `string` | ✓ |  |
+
+## Example
+
+```tsx
+<JqlInput value={jql} onChange={setJql} fields={[{ name: "status" }]} />
+```

package/skills/monkey-mini-app/references/contracts/json-viewer.md

@@ -0,0 +1,13 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# JsonViewer
+
+`import { JsonViewer } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/json-viewer.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `value` | `unknown` | ✓ |  |

package/skills/monkey-mini-app/references/contracts/kanban-issue-panel.md

@@ -0,0 +1,45 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# KanbanIssuePanel
+
+`import { KanbanIssuePanel, KanbanCard, KanbanComment } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/kanban-issue-panel.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `card` | `KanbanCard \| null` | ✓ |  |
+| `columnTitle` | `string \| undefined` |  |  |
+| `onOpenChange` | `(open: boolean) => void` | ✓ |  |
+| `open` | `boolean` | ✓ |  |
+
+## Types
+
+### `KanbanCard`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `assignee` | `string \| undefined` |  |  |
+| `columnId` | `string` | ✓ |  |
+| `comments` | `KanbanComment[] \| undefined` |  |  |
+| `description` | `string \| undefined` |  |  |
+| `id` | `string` | ✓ |  |
+| `key` | `string \| undefined` |  |  |
+| `priority` | `string \| undefined` |  |  |
+| `reporter` | `string \| undefined` |  |  |
+| `status` | `string \| undefined` |  |  |
+| `tags` | `string[] \| undefined` |  |  |
+| `title` | `string` | ✓ |  |
+| `type` | `string \| undefined` |  |  |
+| `updated` | `string \| undefined` |  |  |
+
+### `KanbanComment`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `author` | `string` | ✓ |  |
+| `body` | `string` | ✓ |  |
+| `id` | `string` | ✓ |  |
+| `time` | `string \| undefined` |  |  |

package/skills/monkey-mini-app/references/contracts/kanban.md

@@ -0,0 +1,64 @@
+<!-- generated by scripts/generate-skill.mjs — do not edit -->
+
+# Kanban
+
+DnD board: columns + cards. Move cards across columns via drag.
+
+**when** Issue/workflow boards
+
+`import { Kanban, KanbanComment, KanbanCard, KanbanColumn } from "@monkey-mini-app/ui"`
+
+`packages/ui/src/products/kanban.tsx` · products
+
+## Props
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `cards` | `KanbanCard[]` | ✓ |  |
+| `columns` | `KanbanColumn[]` | ✓ |  |
+| `onCardClick` | `((card: KanbanCard) => void) \| undefined` |  |  |
+| `onCardsChange` | `((cards: KanbanCard[]) => void) \| undefined` |  |  |
+| `renderCard` | `((card: KanbanCard) => ReactNode) \| undefined` |  |  |
+
+## Types
+
+### `KanbanComment`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `author` | `string` | ✓ |  |
+| `body` | `string` | ✓ |  |
+| `id` | `string` | ✓ |  |
+| `time` | `string \| undefined` |  |  |
+
+### `KanbanCard`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `assignee` | `string \| undefined` |  |  |
+| `columnId` | `string` | ✓ |  |
+| `comments` | `KanbanComment[] \| undefined` |  |  |
+| `description` | `string \| undefined` |  |  |
+| `id` | `string` | ✓ |  |
+| `key` | `string \| undefined` |  |  |
+| `priority` | `string \| undefined` |  |  |
+| `reporter` | `string \| undefined` |  |  |
+| `status` | `string \| undefined` |  |  |
+| `tags` | `string[] \| undefined` |  |  |
+| `title` | `string` | ✓ |  |
+| `type` | `string \| undefined` |  |  |
+| `updated` | `string \| undefined` |  |  |
+
+### `KanbanColumn`
+
+| field | type | required | note |
+|---|---|:---:|---|
+| `id` | `string` | ✓ |  |
+| `limit` | `number \| undefined` |  |  |
+| `title` | `string` | ✓ |  |
+
+## Example
+
+```tsx
+<Kanban columns={cols} cards={cards} onCardsChange={setCards} onCardClick={open} />
+```