dsh-skill-hub 0.1.0 → 0.2.0

package/lib/types/client/SkillHubSettingsCard.d.ts

@@ -13,6 +13,11 @@ import { CardForm, type CardShell, type FieldState, type FormScope } from './set
 export interface SkillHubSettingsState extends CardShell {
     enabled: FieldState;
     announceToAgent: FieldState;
+    dotModelColor: FieldState;
+    dotUserColor: FieldState;
+    showUseCount: FieldState;
+    showUseTime: FieldState;
+    showGroupSummary: FieldState;
 }
 /** Props the slot renderer receives (locale copy + injected form actions). */
 export interface SkillHubSettingsCardProps {

package/lib/types/client/api-config-scope.d.ts

@@ -14,6 +14,12 @@
  */
 import type { SkillHubApi } from './api.ts';
 import type { FormScope } from './settings-form.ts';
+/** Model-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-model (panel.module.css). */
+export declare const DEFAULT_DOT_MODEL_COLOR = "#2f81f7";
+/** User-invocable dot color default. Single source for the TS side; the
+ *  panel's CSS mirrors it via --hub-user (panel.module.css). */
+export declare const DEFAULT_DOT_USER_COLOR = "#3fb950";
 /** FormScope-compatible reactive config handle (see module doc). */
 export declare class ApiConfigScope implements FormScope {
     private readonly api;

package/lib/types/client/api.d.ts

@@ -2,7 +2,7 @@
  * Browser-side API client for the /api/skill-hub route family. The only
  * data access path the panel uses — plain fetch, same origin.
  */
-import { type CatalogResponse, type ConfigRequest, type ConfigResponse, type CreateRequest, type CreateResponse, type SkillDetail, type StatsResponse } from '../protocol.ts';
+import { type CatalogResponse, type ConfigRequest, type ConfigResponse, type CreateRequest, type CreateResponse, type MarketCheckResponse, type MarketSourcesResponse, type MarketSyncResponse, type RepoDiscoverResponse, type RepoImportResponse, type SkillDetail, type SkillDeleteResponse, type SourceCheckResponse, type SourceDeleteResponse, type SourceRestoreResponse, type SourceTrashClearResponse, type SourcesResponse, type SourceSyncResponse, type StatsResponse, type ToggleBatchResponse, type UpdateCheckResponse } from '../protocol.ts';
 /** Error carrying the route's JSON error message. */
 export declare class SkillHubApiError extends Error {
     constructor(message: string);
@@ -11,12 +11,54 @@ export declare class SkillHubApiError extends Error {
 export declare class SkillHubApi {
     catalog(): Promise<CatalogResponse>;
     skill(name: string): Promise<SkillDetail>;
-    /** Toggle a skill; resolves with the fresh catalog from the route. */
+    /** Move one writable skill into the restorable trash. */
+    deleteSkill(name: string): Promise<SkillDeleteResponse>;
+    /** Toggle one skill; resolves with the fresh catalog from the route. */
     toggle(name: string, enabled: boolean): Promise<CatalogResponse>;
     create(payload: CreateRequest): Promise<CreateResponse>;
     stats(): Promise<StatsResponse>;
+    /** Toggle a whole group in one write; resolves with the fresh catalog + failures. */
+    toggleBatch(names: string[], enabled: boolean): Promise<ToggleBatchResponse>;
+    /** The user's added market sources (codex-style repo slugs). */
+    market(): Promise<MarketSourcesResponse>;
+    /** Add a market source repo; resolves with the fresh list. */
+    addMarketSource(repo: string): Promise<MarketSourcesResponse>;
+    /** Remove a market source repo; resolves with the fresh list. */
+    removeMarketSource(repo: string): Promise<MarketSourcesResponse>;
+    /** Check every market source for updates (throttled server-side). */
+    marketCheck(): Promise<MarketCheckResponse>;
+    /** Align a market source to its pinned ref; resolves with tracked skills. */
+    marketSync(repo: string): Promise<MarketSyncResponse>;
+    /** Pin a market source to an explicit ref (branch picker). */
+    setMarketSourceRef(repo: string, ref: string): Promise<MarketSourcesResponse>;
+    /** Check the hub's own latest GitHub release. */
+    updateCheck(): Promise<UpdateCheckResponse>;
+    /** Discover importable skills in a GitHub repo. */
+    repoDiscover(repo: string): Promise<RepoDiscoverResponse>;
+    /** Install selected repo skills into the user-dsh root (records the source). */
+    repoImport(repo: string, paths: string[], ref?: string): Promise<RepoImportResponse>;
     /** Read the hub's runtime config (effective values + saved overrides). */
     config(): Promise<ConfigResponse>;
     /** Patch the hub's runtime config (null clears a saved override). */
     saveConfig(patch: ConfigRequest): Promise<ConfigResponse>;
+    /** 用户 tag 分组 + 系统集合组 + origin 映射。 */
+    groups(): Promise<import('../protocol.ts').GroupsResponse>;
+    /** 新建（无 id）或重命名（带 id）一个 tag 分组；返回全部 tag。 */
+    saveTag(payload: import('../protocol.ts').TagSaveRequest): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 删除一个 tag 分组；返回全部 tag。 */
+    deleteTag(id: string): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 直接设置某 tag 的完整成员列表；返回全部 tag。 */
+    setTagMembers(id: string, skillNames: string[]): Promise<import('../protocol.ts').SkillTag[]>;
+    /** 来源列表 + 派生 origin 映射 + 集合组 + 回收站。 */
+    sources(): Promise<SourcesResponse>;
+    /** 检查指定（或全部）来源的上游更新。 */
+    checkSources(repo?: string): Promise<SourceCheckResponse>;
+    /** 同步一个来源的所选（或全部）技能到上游最新版本。 */
+    syncSource(repo: string, skills?: string[]): Promise<SourceSyncResponse>;
+    /** 跟进上游删除：把所选技能移入回收站。 */
+    confirmDeleteSource(repo: string, skills: string[]): Promise<SourceDeleteResponse>;
+    /** 从回收站恢复一个技能。 */
+    restoreSource(name: string): Promise<SourceRestoreResponse>;
+    /** Permanently delete every skill currently in the trash. */
+    clearTrash(): Promise<SourceTrashClearResponse>;
 }

package/lib/types/client/grouping.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pure grouping helpers for the skill-hub panel (no React/DOM deps, so the
+ * merge/classify/filter logic stays unit-testable).
+ *
+ * The "分组" view unifies two ways a skill can belong to a group:
+ *  - user tags (sidecar SkillTag)
+ *  - origin collections (sidecar sources → backend-aggregated CollectionGroup)
+ *
+ * Switch semantics: a skill's enabled state is global (the file is renamed
+ * once), so a group switch is derived from its members' actual states:
+ * all members enabled → 'on', all disabled → 'off', otherwise 'mixed'.
+ * Closing a group whose member is enabled in another group is a conflict the
+ * GUI resolves with a dialog; the helpers below compute both sides.
+ */
+import type { CatalogSkill, CollectionGroup, SkillTag } from '../protocol.ts';
+/** Grouped switch state derived from member enablement. */
+export type GroupSwitchState = 'on' | 'off' | 'mixed';
+/** The derived switch view of one group. */
+export interface GroupSwitchView {
+    state: GroupSwitchState;
+    /** Writable members currently enabled. */
+    enabled: string[];
+    /** Writable members currently disabled. */
+    disabled: string[];
+}
+/**
+ * Derive a group switch view from its member names and the set of currently
+ * enabled skill names (catalog.skills). Members not in the enabled set count
+ * as disabled (catalog.disabled or absent read-only rows).
+ */
+export declare function groupSwitchView(members: readonly string[], enabledNames: ReadonlySet<string>): GroupSwitchView;
+/** Names of every group a skill belongs to (tags + collections). */
+export declare function groupNamesOf(name: string, tags: readonly SkillTag[], collections: readonly CollectionGroup[]): string[];
+/**
+ * Members of a group that are currently enabled AND also belong to at least
+ * one other group — the set a "close" action must ask about.
+ */
+export declare function conflictsOnClose(members: readonly string[], enabledNames: ReadonlySet<string>, otherGroups: ReadonlyArray<{
+    members: readonly string[];
+}>): string[];
+/** Origin-repo filter value: skills with no source record (private skills). */
+export declare const PRIVATE_SOURCE = "private";
+/**
+ * Apply the origin filter ('all' or a specific origin repo; skills without a
+ * source record count as PRIVATE_SOURCE). The origins map is the store's
+ * skillName → repo derivation, so filtering follows the tracked source
+ * records instead of the filesystem root a skill happens to live under.
+ */
+export declare function filterBySource(skills: readonly CatalogSkill[], source: string, origins: Readonly<Record<string, string>>): CatalogSkill[];
+/** Catalog sort keys offered by the filter bar. */
+export type SortKey = 'name' | 'added' | 'uses';
+/**
+ * Sort a skill list in place-safe copy order: name ascending, added
+ * descending (newest first, unknown addedAt last), or uses descending
+ * (most-called first). Unknown values always trail.
+ */
+export declare function sortSkills(skills: readonly CatalogSkill[], key: SortKey, getUses?: (name: string) => number | undefined): CatalogSkill[];
+/** Localized relative-time tuple; the caller resolves it via tt(). */
+export interface RelativeTime {
+    key: 'time.justNow' | 'time.minutesAgo' | 'time.hoursAgo' | 'time.daysAgo' | 'time.weeksAgo';
+    value?: number;
+}
+/** Format an epoch-ms timestamp as a short relative time bucket. */
+export declare function formatRelativeTime(ms: number, now?: number): RelativeTime;

package/lib/types/client/locales.d.ts

@@ -5,13 +5,20 @@
  */
 export declare const zh: {
     readonly 'entry.label': "技能";
-    readonly 'entry.tooltip': "技能中枢：浏览与管理本地技能";
-    readonly 'view.source': "按来源";
-    readonly 'view.sets': "按 Sets";
+    readonly 'entry.tooltip': "技能中枢：浏览、分组与同步管理本地技能";
+    readonly 'view.sources': "来源";
+    readonly 'view.scenes': "场景";
+    readonly 'view.market': "市场";
+    readonly 'view.flat': "平铺";
+    readonly 'view.grouped': "分组";
     readonly 'panel.title': "技能中枢";
-    readonly 'panel.refresh': "刷新";
+    readonly 'panel.count': "共 {count} 个技能";
+    readonly 'panel.disabledCount': "已禁用 {count}";
     readonly 'panel.new': "新建技能";
     readonly 'panel.search': "搜索技能…";
+    readonly 'legend.model': "模型可调 — Agent 可自动调用";
+    readonly 'legend.user': "用户可调 — 仅显式点名时触发";
+    readonly 'legend.hint': "圆点标在技能名旁；无圆点表示该技能不可被调用。";
     readonly 'panel.enabled': "已启用";
     readonly 'panel.disabled': "已禁用";
     readonly 'panel.diagnostics': "发现诊断";
@@ -19,6 +26,65 @@ export declare const zh: {
     readonly 'panel.emptyAll': "本地还没有技能。点击「新建技能」创建第一个。";
     readonly 'panel.loading': "读取中…";
     readonly 'panel.incomplete': "（目录可能不完整）";
+    readonly 'market.addHint': "像 codex 一样添加仓库源：输入 owner/repo 或 GitHub 链接，扫描其中的技能并一键导入；导入后自动跟踪上游更新。";
+    readonly 'market.addPlaceholder': "owner/repo 或 https://github.com/…";
+    readonly 'market.addSource': "添加源";
+    readonly 'market.noSources': "还没有市场源。从下方内置市场添加，或输入一个 GitHub 仓库。";
+    readonly 'market.catalogTitle': "内置市场";
+    readonly 'market.catalogHint': "精选技能仓库，添加后即可扫描安装，并持续检查更新。";
+    readonly 'market.catalog.anthropics': "Anthropic 官方技能合集（Claude Skills）";
+    readonly 'market.catalog.superpowers': "Superpowers 社区技能合集";
+    readonly 'market.catalog.mattpocock': "Matt Pocock 技能集";
+    readonly 'market.catalog.openDesign': "设计技能合集（design-templates）";
+    readonly 'market.added': "已添加";
+    readonly 'market.add': "添加";
+    readonly 'market.mySources': "我的市场源";
+    readonly 'market.installed': "已装 {count}";
+    readonly 'market.updatable': "可更新 {count}";
+    readonly 'market.deletedUpstream': "上游已删 {count}";
+    readonly 'market.checkAll': "检查全部";
+    readonly 'market.updateAll': "全部更新";
+    readonly 'market.updateAllConfirmTitle': "批量更新全部技能？";
+    readonly 'market.updateAllConfirmText': "将把以下来源的可更新技能更新到上游最新版本（覆盖本地修改）：";
+    readonly 'market.updateAllItem': "{repo}（{count} 个技能）";
+    readonly 'market.updateAllDone': "已更新 {count} 个来源";
+    readonly 'market.deleteSource': "移除源";
+    readonly 'market.scan': "扫描";
+    readonly 'market.scanning': "扫描中…";
+    readonly 'market.check': "检查";
+    readonly 'market.sync': "同步";
+    readonly 'market.syncing': "同步中…";
+    readonly 'market.updated': "有更新";
+    readonly 'market.newRelease': "新版本 v{version}";
+    readonly 'market.branchTitle': "选择分支";
+    readonly 'market.branchHint': "该仓库没有正式发布，选择要跟踪的分支（默认为 main）：";
+    readonly 'market.branchConfirm': "确定";
+    readonly 'market.syncTitle': "同步本地技能";
+    readonly 'market.syncText': "市场源已对齐到 {ref}，要同步更新以下本地技能吗？";
+    readonly 'market.syncNone': "该来源还没有导入本地技能。";
+    readonly 'market.syncCancel': "跳过";
+    readonly 'market.removeHint': "移除源不影响已安装的技能。";
+    readonly 'repo.ready': "发现 {count} 个可导入技能";
+    readonly 'repo.empty': "没有找到可导入技能。";
+    readonly 'repo.selectAll': "全选";
+    readonly 'repo.clearAll': "清空";
+    readonly 'repo.import': "导入所选 ({count})";
+    readonly 'repo.importing': "导入中…";
+    readonly 'repo.existing': "已存在";
+    readonly 'repo.files': "{count} 个文件 · {size}";
+    readonly 'repo.imported': "导入成功 {count} 个";
+    readonly 'repo.skippedExisting': "跳过已存在 {count} 个";
+    readonly 'repo.failed': "失败 {count} 个";
+    readonly 'repo.root.skills': "技能 skills";
+    readonly 'repo.root.designTemplates': "模板 design-templates";
+    readonly 'update.check': "检查更新";
+    readonly 'update.checking': "检查中…";
+    readonly 'update.upToDate': "已是最新版本 v{version}";
+    readonly 'update.available': "发现新版本 v{version}（当前 v{current}）";
+    readonly 'update.newVersion': "新版本 v{version}";
+    readonly 'update.viewRelease': "查看发布";
+    readonly 'update.error': "检查更新失败：{error}";
+    readonly 'update.unavailable': "暂无可用的发布版本";
     readonly 'group.project-dsh': "项目 .dsh/skills";
     readonly 'group.project-agents': "项目 .agents/skills";
     readonly 'group.custom': "自定义目录";
@@ -27,19 +93,80 @@ export declare const zh: {
     readonly 'group.user-agents': "用户 ~/.agents/skills";
     readonly 'group.bundled': "内置";
     readonly 'group.other': "其他来源";
-    readonly 'group.uncategorized': "未归类";
-    readonly 'badge.model': "模型可调";
-    readonly 'badge.user': "用户可调";
-    readonly 'badge.uses': "{count} 次调用";
+    readonly 'groups.new': "新建场景";
+    readonly 'groups.namePlaceholder': "场景名";
+    readonly 'groups.edit': "编辑";
+    readonly 'groups.rename': "保存名称";
+    readonly 'groups.delete': "删除场景";
+    readonly 'groups.saveMembers': "保存成员";
+    readonly 'groups.membersHint': "勾选技能加入此场景（含已禁用）。";
+    readonly 'groups.empty': "还没有场景。先新建一个，再把技能归类。";
+    readonly 'groups.noCollections': "暂无来源组。从市场导入技能后自动按来源聚合。";
+    readonly 'groups.personal': "个人";
+    readonly 'groups.noWritable': "该组没有可写技能（只读技能无法由中枢开关）";
+    readonly 'groups.closeAll': "全部关闭";
+    readonly 'groups.keepOn': "保留开启";
+    readonly 'groups.conflictTitle': "关闭此组？";
+    readonly 'groups.conflictText': "以下技能也在其他组中开启，关闭它们会影响那些组：";
+    readonly 'filter.allSources': "全部来源";
+    readonly 'filter.private': "个人";
+    readonly 'sort.name': "按名称";
+    readonly 'sort.added': "按添加时间";
+    readonly 'sort.uses': "按调用次数";
+    readonly 'time.justNow': "刚刚";
+    readonly 'time.minutesAgo': "{value} 分钟前";
+    readonly 'time.hoursAgo': "{value} 小时前";
+    readonly 'time.daysAgo': "{value} 天前";
+    readonly 'time.weeksAgo': "{value} 周前";
+    readonly 'badge.source.project-dsh': "项目 .dsh";
+    readonly 'badge.source.project-agents': "项目 .agents";
+    readonly 'badge.source.custom': "自定义";
+    readonly 'badge.source.runtime': "运行时";
+    readonly 'badge.source.user-dsh': "用户 .dsh";
+    readonly 'badge.source.user-agents': "用户 .agents";
+    readonly 'badge.source.bundled': "内置";
     readonly 'row.readonly': "只读";
     readonly 'row.disable': "禁用";
     readonly 'row.enable': "启用";
+    readonly 'row.delete': "移入回收站";
+    readonly 'delete.confirmTitle': "移入回收站？";
+    readonly 'delete.confirmText': "确定把「{name}」移入回收站吗？可随时恢复。";
+    readonly 'delete.confirm': "移入回收站";
     readonly 'detail.back': "返回列表";
     readonly 'detail.provider': "提供者";
-    readonly 'detail.source': "来源";
+    readonly 'detail.addedAt': "添加时间";
+    readonly 'detail.updatedAt': "更新时间";
     readonly 'detail.path': "路径";
+    readonly 'detail.whenToUse': "适用场景";
+    readonly 'detail.uses': "调用次数";
+    readonly 'detail.groups': "所属场景";
     readonly 'detail.loading': "读取技能正文…";
-    readonly 'form.title': "新建技能";
+    readonly 'source.private': "个人技能（未绑定上游，不检查更新）";
+    readonly 'source.commit': "已同步版本";
+    readonly 'source.unverified': "尚未核对上游";
+    readonly 'source.check': "检查更新";
+    readonly 'source.checkHint': "点击检查上游更新";
+    readonly 'source.checking': "检查中…";
+    readonly 'source.upToDate': "已是最新";
+    readonly 'source.updated': "有更新 {count} 个";
+    readonly 'source.deleted': "上游已删除 {count} 个";
+    readonly 'source.error': "检查失败";
+    readonly 'source.throttled': "刚刚检查过";
+    readonly 'source.sync': "同步";
+    readonly 'source.syncing': "同步中…";
+    readonly 'source.syncConfirmTitle': "同步技能？";
+    readonly 'source.syncConfirmText': "将用上游最新版本覆盖本地对以下技能的所有修改：";
+    readonly 'source.followDelete': "跟进删除";
+    readonly 'source.deleteConfirmTitle': "跟进上游删除？";
+    readonly 'source.deleteConfirmText': "以下技能已从上游仓库移除，本地目录将移入回收站（可恢复）：";
+    readonly 'source.trash': "回收站";
+    readonly 'source.restore': "恢复";
+    readonly 'source.clearTrash': "清空回收站";
+    readonly 'source.clearTrashConfirmTitle': "清空回收站？";
+    readonly 'source.clearTrashConfirmText': "回收站里的技能会被永久删除，无法恢复。此操作不可撤销。";
+    readonly 'source.clearTrashConfirm': "永久删除";
+    readonly 'form.capabilityHint': "能力怎么选：重复方法 → 技能；外部系统 → MCP；长期资料 → 知识库。";
+    readonly 'form.descPlaceholder': "一句话说明用途（含触发词），Agent 靠它自动激活技能";
     readonly 'form.name': "技能名（kebab-case，如 code-review）";
     readonly 'form.desc': "描述（一句话路由说明）";
     readonly 'form.root': "目标目录";
@@ -50,25 +177,35 @@ export declare const zh: {
     readonly 'form.error': "创建失败：";
     readonly 'err.dismiss': "知道了";
     readonly 'settings.title': "Skill Hub";
-    readonly 'settings.description': "管理 dsh 本地技能目录：浏览、启用/禁用、诊断与新建。";
+    readonly 'settings.description': "管理 dsh 本地技能目录：浏览、分组、来源同步与新建。";
     readonly 'settings.enabled': "启用插件";
     readonly 'settings.enabledHint': "关闭后技能中枢的路由、入口与公告全部下线。";
     readonly 'settings.announceToAgent': "向 Agent 公告";
     readonly 'settings.announceToAgentHint': "在系统提示中加入本插件说明，用户提到技能管理时 Agent 知道如何协作。";
+    readonly 'settings.dotModelColor': "模型可调圆点颜色";
+    readonly 'settings.dotModelColorHint': "技能名旁蓝色圆点的颜色（#rrggbb）。";
+    readonly 'settings.dotUserColor': "用户可调圆点颜色";
+    readonly 'settings.dotUserColorHint': "技能名旁绿色圆点的颜色（#rrggbb）。";
+    readonly 'settings.showUseCount': "显示调用次数";
+    readonly 'settings.showUseCountHint': "在技能名旁显示琥珀色调用次数。";
+    readonly 'settings.showUseTime': "显示最近调用时间";
+    readonly 'settings.showUseTimeHint': "在技能名行右侧显示相对时间（如「3 天前」）。";
+    readonly 'settings.showGroupSummary': "显示分组汇总";
+    readonly 'settings.showGroupSummaryHint': "在分组标题后汇总调用次数与最近调用时间。";
     readonly 'settings.inherit': "继承";
     readonly 'settings.on': "开";
     readonly 'settings.off': "关";
     readonly 'settings.overridden': "已覆盖";
-    readonly 'settings.reset': "重置";
+    readonly 'settings.reset': "恢复默认";
     readonly 'settings.unsaved': "未保存";
     readonly 'settings.save': "保存";
     readonly 'settings.saving': "保存中…";
-    readonly 'settings.discard': "放弃更改";
-    readonly 'settings.saveFailed': "保存失败";
-    readonly 'settings.readOnly': "当前部署只读，无法编辑。";
-    readonly 'settings.notExposed': "命名空间未挂载。";
-    readonly 'settings.collapse': "折叠";
-    readonly 'settings.expand': "展开";
+    readonly 'settings.discard': "放弃修改";
+    readonly 'settings.saveFailed': "本部署没有接受这些值，已保留供你修改。";
+    readonly 'settings.readOnly': "本部署的设置为只读。";
+    readonly 'settings.notExposed': "本部署没有挂载该设置命名空间。";
+    readonly 'settings.collapse': "收起设置";
+    readonly 'settings.expand': "展开设置";
 };
 export declare const en: Record<HubKey, string>;
 /** Union of every translatable key (the namespace's registered dictionary type). */

package/lib/types/client/market-catalog.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Built-in market catalog: well-known skill repos shown on the market tab so
+ * users can browse and install without knowing repo URLs (cc-switch-style).
+ * Only the repo slug lives here; adding goes through the normal
+ * market-source route and records upstream tracking like any manual source.
+ */
+import type { HubKey } from './locales.ts';
+export interface MarketCatalogEntry {
+    repo: string;
+    /** locales.ts key for the one-line description. */
+    descriptionKey: HubKey;
+}
+/** 默认市场目录：精选技能仓库（顺序即展示顺序）。 */
+export declare const MARKET_CATALOG: readonly MarketCatalogEntry[];

package/lib/types/client/panel/DisabledRow.d.ts

@@ -0,0 +1,12 @@
+/**
+ * One disabled skill row (name + description + root badge + enable switch).
+ * Shared by the source-group lists, the scene-group lists, and the bottom
+ * disabled section.
+ */
+import type { JSX } from 'react';
+import type { DisabledSkill } from '../../protocol.ts';
+export declare function DisabledRow(props: {
+    record: DisabledSkill;
+    busy: boolean;
+    onEnable: () => void;
+}): JSX.Element;

package/lib/types/client/panel/GroupSummary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Group-header usage summary: total invocation count chip + the group's most
+ * recent last-used time. Honours the showGroupSummary config switch.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function GroupSummary(props: {
+    members: readonly string[];
+    hub: SkillHubState;
+}): JSX.Element;

package/lib/types/client/panel/MarketView.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Market tab: the built-in market catalog (one-click add), the user's market
+ * sources with aggregated per-repo state (installed / updatable / deleted
+ * upstream), check-all and update-all actions, and the repo scan result with
+ * the importable skill checklist.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function MarketView(props: {
+    hub: SkillHubState;
+}): JSX.Element;

package/lib/types/client/panel/ScenesView.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scenes tab: user tag groups (one card per scene with the tri-state switch
+ * and edit entry) plus the new-scene form. Scenes are the user's own
+ * enable/disable units (e.g. a Godot scene vs a Java scene); upstream repos
+ * are managed in the sources tab.
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function ScenesView(props: {
+    hub: SkillHubState;
+}): JSX.Element;

package/lib/types/client/panel/SkillDetailView.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Full-page skill detail view: metadata, upstream source card with
+ * check/sync/follow-delete actions, and the raw SKILL.md body. Pure
+ * presentation — every state value and action arrives as a prop, so the
+ * panel stays the single owner of state.
+ */
+import type { JSX } from 'react';
+import type { GroupsResponse, HubConfig, SkillDetail, SourceCheckResult, SourcesResponse } from '../../protocol.ts';
+export interface SkillDetailViewProps {
+    detail: SkillDetail;
+    hubConfig: HubConfig | null;
+    /** skillName → usage stat (count + last used). */
+    uses: ReadonlyMap<string, {
+        count: number;
+        lastUsed?: number;
+    }>;
+    groupsState: GroupsResponse | null;
+    sourcesState: SourcesResponse | null;
+    sourceCheck: Readonly<Record<string, SourceCheckResult>>;
+    checkingSource: string | null;
+    syncingSource: string | null;
+    loading: boolean;
+    onBack: () => void;
+    /** Check one source repo for upstream updates. */
+    onCheck: (repo: string) => void;
+    /** Request syncing the skill (overwrites local edits; opens a confirm). */
+    onSync: (repo: string, skills: string[]) => void;
+    /** Request following the upstream deletion (moves into the trash). */
+    onFollowDelete: (repo: string, skills: string[]) => void;
+}
+export declare function SkillDetailView(props: SkillDetailViewProps): JSX.Element;

package/lib/types/client/panel/SkillHubPanel.d.ts

@@ -1,7 +1,15 @@
 /**
- * The skill hub panel: full catalog grouped by source, search, enable/
- * disable toggles, discovery diagnostics, disabled-skill re-enable, skill
- * body inspection, and the new-skill scaffold form.
+ * The skill hub panel: catalog grouped by tags + source collections, search
+ * and filter in one row, per-group tri-state switches with conflict dialogs,
+ * upstream source tracking (check / sync / follow upstream deletion into a
+ * restorable trash), codex-style market sources, disabled re-enable,
+ * detail inspection, and the new-skill scaffold form.
+ *
+ * Thin shell: state and flows live in useSkillHub, the tab contents live in
+ * SourcesView / ScenesView / MarketView, and the dialog family lives in
+ * dialogs.tsx. This component owns only the shared chrome (header, banners,
+ * filter bar, shared sections) and the view routing — and holds no hooks,
+ * so the detail / tag-editor early returns are safe.
  */
 import type { SkillHubApi } from '../api.ts';
 export interface SkillHubPanelProps {

package/lib/types/client/panel/SkillRow.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One enabled skill row: name + invocation dots + usage meta, delete and
+ * disable actions. Shared by the flat list and both grouped views.
+ */
+import type { JSX } from 'react';
+import type { CatalogSkill } from '../../protocol.ts';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function SkillRow(props: {
+    skill: CatalogSkill;
+    hub: SkillHubState;
+}): JSX.Element;

package/lib/types/client/panel/SourceStatusBadge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Source check-status badges (up-to-date / updated / deleted / error /
+ * throttled / unverified). Shared by the panel's source-group headers and
+ * the skill detail view.
+ *
+ * In the group headers the badge doubles as the re-check affordance: it
+ * shows a clickable "检查更新" badge before the first check, "检查中…" while
+ * checking, and the status badge (clickable again to re-check) afterwards.
+ */
+import type { JSX } from 'react';
+import type { SourceCheckResult } from '../../protocol.ts';
+export declare function SourceStatusBadge(props: {
+    check: SourceCheckResult | undefined;
+    /** 正在检查该来源（显示「检查中…」）。 */
+    checking?: boolean;
+    /** 提供后徽章区域可点击触发检查（组头用；详情页有自己的检查按钮）。 */
+    onCheck?: () => void;
+}): JSX.Element | null;

package/lib/types/client/panel/SourcesView.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Sources tab: the flat skill list or the grouped view (one card per
+ * upstream collection with check/sync/follow-delete actions and the
+ * tri-state switch, plus the uncategorized "personal" card).
+ */
+import type { JSX } from 'react';
+import type { SkillHubState } from './useSkillHub.ts';
+export declare function SourcesView(props: {
+    hub: SkillHubState;
+}): JSX.Element;

package/lib/types/client/panel/TagEditorView.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Full-page tag (scene) editor: rename / delete header, member checkbox
+ * lists (enabled + disabled skills), and the save-members action. Pure
+ * presentation — the draft state lives in the panel and arrives as props.
+ */
+import type { JSX } from 'react';
+import type { CatalogResponse, SkillTag } from '../../protocol.ts';
+export interface TagEditorViewProps {
+    tag: SkillTag;
+    /** Current name draft (panel-owned). */
+    editName: string;
+    /** Current member-checkbox draft (panel-owned). */
+    membersDraft: ReadonlySet<string>;
+    /** Current member-list search text (panel-owned). */
+    editSearch: string;
+    catalog: CatalogResponse | null;
+    tagBusy: boolean;
+    onBack: () => void;
+    onEditName: (value: string) => void;
+    onEditSearch: (value: string) => void;
+    onToggleMember: (name: string, checked: boolean) => void;
+    /** Rename with the current draft (disabled while blank). */
+    onRename: () => void;
+    /** Delete this tag (hidden for the default scene). */
+    onDelete: () => void;
+    /** Persist the current member draft and leave the editor. */
+    onSaveMembers: () => void;
+}
+export declare function TagEditorView(props: TagEditorViewProps): JSX.Element;