Import src/core/types.ts

This commit is contained in:
QQ 2026-11-11 22:33:43 +08:00
parent 75d6539ec0
commit b189c59fe8
1 changed files with 178 additions and 0 deletions

178
src/core/types.ts Normal file
View File

@ -0,0 +1,178 @@
/**
* Shared config types for @dsh-xhl/workspace-groups. Pure types (zero runtime
* deps) so both halves — the node half (sidecar YAML reading) and the
* browser half (tree derivation) — compile against the same contract.
*/
/** One classification rule: any rule that matches places the workspace in the category. */
export interface GroupRule {
/** Absolute path prefix match (normalized, case-sensitive). */
pathPrefix?: string
/** Case-insensitive substring match against the workspace display title. */
nameContains?: string
/** Case-insensitive substring match against the workspace directory basename. */
basenameContains?: string
/** Exact absolute path match (normalized). */
pathExact?: string
}
/** One category folder in the sidebar tree. */
export interface GroupCategory {
/** Display label of the category folder. */
name: string
/** Rules; a workspace is classified here when ANY rule matches. */
rules: GroupRule[]
}
/** Theme-safe palette id for a group's accent. */
export type GroupColor =
| 'red' | 'orange' | 'amber' | 'green' | 'teal'
| 'blue' | 'indigo' | 'purple' | 'pink' | 'gray'
/** Whitelist shared by the host write-validation and the client picker. */
export const GROUP_COLORS: readonly GroupColor[] = [
'red', 'orange', 'amber', 'green', 'teal',
'blue', 'indigo', 'purple', 'pink', 'gray',
]
/** Curated icon ids (rendered from @deepseek-ai/dsh-client-ui-primitives). */
export const GROUP_ICON_IDS = [
'folder', 'workspace', 'code', 'plugin', 'skill', 'data',
'database', 'api', 'plan', 'goal', 'light', 'globe',
'archive', 'branch', 'users', 'clock', 'shield', 'checklist',
'sparkle', 'tree',
'chat', 'search', 'settings', 'document', 'edit', 'think',
'agent', 'browse', 'context', 'link', 'share', 'user',
'send', 'attachment', 'download', 'play', 'design', 'moon',
'monitor', 'gauge', 'queue', 'notes', 'inspect', 'help',
'info', 'alarm', 'compare', 'done', 'pin', 'microphone',
// Materials & Lab family (appended: the first 50 ids keep their order because
// saved configs address icons by id, never by position).
// Lab operations
'test-tube', 'flask', 'pipette', 'dropper', 'stirrer', 'hotplate', 'centrifuge', 'balance',
// Material structures
'atom', 'molecule', 'lattice', 'layered', 'framework', 'thin-film', 'fiber', 'hydrogel',
// Characterization
'microscope', 'xrd', 'spectrum', 'tensile', 'electrode', 'iv-curve',
// Functional devices
'illumination', 'temperature', 'humidity', 'actuator', 'flex-sensor', 'battery',
] as const
/** Derived from the shared registry so host validation and UI cannot drift. */
export type GroupIconId = (typeof GROUP_ICON_IDS)[number]
/**
* Presentation metadata for one group. Every field optional.
*
* The explicit `| undefined` on each field is what lets a UI patch clear a
* value (`pruneAppearance` then drops it): under `exactOptionalPropertyTypes`
* a bare `color?: GroupColor` would reject `{ color: undefined }`.
*/
export interface CategoryAppearance {
/** Palette id; the CSS palette lives in styles.css `[data-wg-color]`. */
color?: GroupColor | undefined
/** `GroupIconId` preset id, or a short glyph (1–4 Unicode code points, emoji/latin). */
icon?: string | undefined
/** Pinned groups sort before unpinned ones (within the manual order). */
pinned?: boolean | undefined
}
/** The full sidecar configuration (mirrors workspace-groups.yaml). */
export interface GroupsConfig {
/** Category folders, in render order. First match wins. */
categories: GroupCategory[]
/**
* Runtime grouping overlay (manual groups + per-workspace overrides).
* Optional: the YAML file itself never carries it — the host GET route
* merges it from `workspace-groups.manual.json`, and the browser PUT route
* replaces it whole.
*/
manual?: ManualGroups
}
/**
* Runtime-managed grouping overlay: groups created in the sidebar UI plus
* per-workspace category overrides and user-controlled ordering. Owned by the
* plugin (JSON sidecar, `$DSH_HOME/workspace-groups.manual.json`), never
* written back into the operator YAML.
*
* All new fields are optional for backward compatibility (files written by
* older plugin versions keep working); rendering falls back to sensible
* defaults when they are absent. Note that an older plugin version writes the
* whole file back, which silently drops fields it does not know about — e.g.
* `appearance` (group color / icon / pin) is lost after a downgrade.
*/
export interface ManualGroups {
/**
* Monotonic write counter, owned by the host (same contract as the folder
* overlay): a PUT whose revision does not match the stored one is
* rejected with 409 instead of silently overwriting another window's
* edits. Absent in files written before revisions existed — read as 0.
*/
revision?: number
/**
* Manually created category folder names. These have no rules — they render
* even while empty (a new group appears before anything is dragged into
* it) and hold only workspaces assigned to them.
*/
categories: string[]
/**
* Per-workspace category override, keyed by workspace id. Value is a
* category display name (rule or manual), or `null` to force the workspace
* into the uncategorized bucket even when a rule would match. An absent
* key means "classify by rules".
*/
assignments: Record<string, string | null>
/**
* Display order of all category keys (rule display names + manual names).
* The uncategorized bucket is never listed — it always renders last.
* Absent = rule categories first (YAML order), manual groups appended in
* creation order.
*/
categoryOrder?: string[]
/**
* Per-category ordered workspace ids (user drag-reorder within a group).
* Keyed by category display name; absent key = host registration order.
*/
workspaceOrder?: Record<string, string[]>
/**
* Rule category rename overrides: original YAML rule category name →
* display name (UI rename of a rule group). Rules still classify by the
* original name; only the rendered label/keys change.
*/
renamed?: Record<string, string>
/**
* Rule category original names hidden by a UI delete. Hidden rules are
* inert: workspaces matching them become top-level (ungrouped).
*/
hidden?: string[]
/**
* Per-group presentation, keyed by category DISPLAY name (same key space as
* `categoryOrder`). Optional per field; an absent group has no presentation.
* Dangling keys (a YAML category that no longer exists) are tolerated on read
* and on write — see validateManualGroups.
*/
appearance?: Record<string, CategoryAppearance>
}
/**
* Legacy label of the fallback bucket. The top-level (ungrouped) concept
* replaced the rendered "未分类" bucket: workspaces in no group render as
* top-level rows beside the group folders. The constant survives for data
* compatibility (reserved name, assignment null marker).
*/
export const UNCATEGORIZED_LABEL = '未分类'
/**
* Reserved key under `workspaceOrder` holding the manual order of TOP-LEVEL
* (ungrouped) project rows. Distinct from any real group display name (a group
* may not be named this), so it can never collide; the top-level list's order
* is preserved exactly like a group's, and top-level rows can be reordered by
* dragging.
*/
export const TOP_LEVEL_ORDER_KEY = '__topLevel__'
/** Normalize a path for prefix matching: trailing slashes stripped. */
export function normalizePath(path: string): string {
return path.replace(/[/\\]+$/, '')
}