Import src/core/types.ts
This commit is contained in:
parent
75d6539ec0
commit
b189c59fe8
|
|
@ -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(/[/\\]+$/, '')
|
||||
}
|
||||
Loading…
Reference in New Issue