dsh-skill-hub 0.1.0 → 0.2.0

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

@@ -0,0 +1,73 @@
+/**
+ * Shared dialog family for the panel: one overlay shell plus the specific
+ * dialogs (group-close conflict, sync/delete confirm, branch picker, and
+ * market sync selection). Every dialog closes on outside click and keeps
+ * the same role/aria shell; the panel owns all dialog state.
+ */
+import { type JSX } from 'react';
+import type { CollectionGroup, SkillTag } from '../../protocol.ts';
+/** A group-close conflict waiting for the user's decision. */
+export interface ConflictDialogState {
+    /** Group key: 'tag:<id>' or 'col:<name>'. */
+    key: string;
+    name: string;
+    /** Conflicting skill names (enabled here and in other groups). */
+    conflicts: string[];
+}
+/** A destructive/sync confirmation waiting for the user's decision. */
+export interface ConfirmDialogState {
+    kind: 'sync' | 'delete';
+    repo: string;
+    /** Skills the action applies to. */
+    skills: string[];
+}
+/** Branch picker shown when a repo has no release and no pinned ref. */
+export interface BranchChoiceState {
+    repo: string;
+    branches: string[];
+    selected: string;
+}
+/** Post-sync skill update dialog: which tracked skills to refresh. */
+export interface MarketSyncDialogState {
+    repo: string;
+    ref: string;
+    skills: string[];
+    selected: ReadonlySet<string>;
+}
+/** Simple confirm dialog: title + text + optional skill list + cancel/confirm. */
+export declare function ConfirmDialog(props: {
+    title: string;
+    text: string;
+    /** Optional skill names listed between the text and the buttons. */
+    items?: readonly string[];
+    confirmLabel: string;
+    /** Danger-styled confirm button (destructive actions). */
+    danger?: boolean;
+    onCancel: () => void;
+    onConfirm: () => void;
+}): JSX.Element;
+/** Group-close conflict: which skills stay on, and which other groups also enable them. */
+export declare function ConflictDialog(props: {
+    dialog: ConflictDialogState;
+    tags: readonly SkillTag[];
+    collections: readonly CollectionGroup[];
+    onClose: () => void;
+    onKeepOn: () => void;
+    onCloseAll: () => void;
+}): JSX.Element;
+/** Branch picker for a repo without releases (pins the ref, then rescans). */
+export declare function BranchChoiceDialog(props: {
+    choice: BranchChoiceState;
+    busy: boolean;
+    onSelect: (branch: string) => void;
+    onCancel: () => void;
+    onConfirm: () => void;
+}): JSX.Element;
+/** Post-sync selection: which tracked skills to batch-update to the new version. */
+export declare function MarketSyncDialog(props: {
+    dialog: MarketSyncDialogState;
+    busy: boolean;
+    onToggle: (name: string, checked: boolean) => void;
+    onCancel: () => void;
+    onConfirm: () => void;
+}): JSX.Element;

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

@@ -0,0 +1,14 @@
+/**
+ * Shared display helpers for the panel views (skill rows, detail view, and
+ * dialogs): dot color styling, relative/absolute time text, and commit-SHA
+ * shortening. Kept in one place so the views render identically.
+ */
+import type { CSSProperties } from 'react';
+/** Dot inline style from the user-chosen color (undefined keeps the CSS default). */
+export declare function dotStyle(color: string | undefined): CSSProperties | undefined;
+/** Localized relative-time text for a Unix-ms timestamp. */
+export declare function relativeTimeText(ms: number): string;
+/** Localized absolute time for the detail meta (e.g. "2026/8/16 11:00:00"). */
+export declare function formatDateTime(ms: number): string;
+/** Short form of a commit SHA for display. */
+export declare function shortSha(sha: string): string;

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

@@ -0,0 +1,183 @@
+/**
+ * useSkillHub — the panel's state owner. Everything the skill hub panel
+ * knows (catalog, groups, sources, market, dialogs, drafts) plus every
+ * async flow lives here; the panel itself only renders. All hooks run
+ * unconditionally at the top, so the panel may early-return for the detail
+ * and tag-editor views without violating the rules of hooks.
+ */
+import { type FormEvent } from 'react';
+import type { CatalogResponse, CatalogSkill, DisabledSkill, GroupsResponse, HubConfig, MarketSourceRecord, RepoDiscoverResponse, RepoImportResponse, SkillDetail, SkillTag, SourceCheckResult, SourcesResponse, UpdateCheckResponse, WritableRoot } from '../../protocol.ts';
+import type { SkillHubApi } from '../api.ts';
+import { type SortKey, type GroupSwitchState } from '../grouping.ts';
+import type { BranchChoiceState, ConfirmDialogState, ConflictDialogState, MarketSyncDialogState } from './dialogs.tsx';
+/** One-shot self-update check state. */
+type UpdateState = {
+    status: 'idle';
+} | {
+    status: 'checking';
+} | {
+    status: 'ready';
+    data: UpdateCheckResponse;
+} | {
+    status: 'error';
+    message: string;
+};
+/** Repo scanner/import state (drives the market source preview). */
+type RepoDiscoverState = {
+    status: 'idle';
+} | {
+    status: 'scanning';
+} | {
+    status: 'ready';
+    data: RepoDiscoverResponse;
+} | {
+    status: 'error';
+    message: string;
+};
+/** Market sources list state. */
+type MarketState = {
+    status: 'loading' | 'ready' | 'error';
+    repos: MarketSourceRecord[];
+};
+/** The hook's result: the panel's complete state + action surface. */
+export type SkillHubState = ReturnType<typeof useSkillHub>;
+export declare function useSkillHub(api: SkillHubApi): {
+    catalog: CatalogResponse | null;
+    loading: boolean;
+    loadError: string | null;
+    successBanner: string | null;
+    updateState: UpdateState;
+    repoDiscoverState: RepoDiscoverState;
+    scanningRepo: string | null;
+    repoSelected: ReadonlySet<string>;
+    repoImporting: boolean;
+    repoResult: RepoImportResponse | null;
+    search: string;
+    detail: SkillDetail | null;
+    detailLoading: boolean;
+    busyNames: ReadonlySet<string>;
+    batchBusy: boolean;
+    showForm: boolean;
+    formName: string;
+    formDesc: string;
+    formRoot: WritableRoot;
+    formBusy: boolean;
+    formMessage: {
+        kind: "error" | "success";
+        text: string;
+    } | null;
+    uses: ReadonlyMap<string, {
+        count: number;
+        lastUsed?: number;
+    }>;
+    hubConfig: HubConfig | null;
+    tab: "sources" | "scenes" | "market";
+    skillView: "flat" | "groups";
+    sourceFilter: string;
+    sortKey: SortKey;
+    marketState: MarketState;
+    marketCheck: Readonly<Record<string, {
+        repo: string;
+        ref?: string;
+        latestTag?: string;
+        updateAvailable: boolean;
+        commitSha: string;
+        throttled?: boolean;
+        error?: string;
+    }>>;
+    branchChoice: BranchChoiceState | null;
+    branchBusy: boolean;
+    marketSyncDialog: MarketSyncDialogState | null;
+    syncingMarket: string | null;
+    syncBusy: boolean;
+    newSourceName: string;
+    groupsState: GroupsResponse | null;
+    sourcesState: SourcesResponse | null;
+    sourceCheck: Readonly<Record<string, SourceCheckResult>>;
+    checkingSource: string | null;
+    syncingSource: string | null;
+    conflictDialog: ConflictDialogState | null;
+    confirmDialog: ConfirmDialogState | null;
+    deleteSkillDialog: string | null;
+    confirmClearTrash: boolean;
+    updateAllDialog: boolean;
+    editingTag: SkillTag | null;
+    editName: string;
+    membersDraft: ReadonlySet<string>;
+    newTagName: string;
+    tagBusy: boolean;
+    editSearch: string;
+    collapsedGroups: ReadonlySet<string>;
+    showLegend: boolean;
+    actionNames: Set<string>;
+    viewNames: Set<string>;
+    normalized: string;
+    origins: Record<string, string>;
+    sourceOptions: string[];
+    filtered: CatalogSkill[];
+    sorted: CatalogSkill[];
+    setLoadError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setSuccessBanner: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setDetail: import("react").Dispatch<import("react").SetStateAction<SkillDetail | null>>;
+    setShowForm: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setFormName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setFormDesc: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setFormRoot: import("react").Dispatch<import("react").SetStateAction<WritableRoot>>;
+    setFormMessage: import("react").Dispatch<import("react").SetStateAction<{
+        kind: "error" | "success";
+        text: string;
+    } | null>>;
+    setRepoSelected: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setTab: import("react").Dispatch<import("react").SetStateAction<"sources" | "scenes" | "market">>;
+    setSkillView: import("react").Dispatch<import("react").SetStateAction<"flat" | "groups">>;
+    setSourceFilter: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setSortKey: import("react").Dispatch<import("react").SetStateAction<SortKey>>;
+    setBranchChoice: import("react").Dispatch<import("react").SetStateAction<BranchChoiceState | null>>;
+    setMarketSyncDialog: import("react").Dispatch<import("react").SetStateAction<MarketSyncDialogState | null>>;
+    setNewSourceName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setConflictDialog: import("react").Dispatch<import("react").SetStateAction<ConflictDialogState | null>>;
+    setConfirmDialog: import("react").Dispatch<import("react").SetStateAction<ConfirmDialogState | null>>;
+    setDeleteSkillDialog: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    setConfirmClearTrash: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setUpdateAllDialog: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setEditingTag: import("react").Dispatch<import("react").SetStateAction<SkillTag | null>>;
+    setEditName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setMembersDraft: import("react").Dispatch<import("react").SetStateAction<ReadonlySet<string>>>;
+    setNewTagName: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setEditSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setShowLegend: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    toggleGroupCollapse: (key: string) => void;
+    checkUpdate: () => Promise<void>;
+    loadMarket: () => Promise<void>;
+    openDetail: (name: string) => Promise<void>;
+    toggle: (skill: CatalogSkill, enabled: boolean) => Promise<void>;
+    enableDisabled: (record: DisabledSkill) => Promise<void>;
+    batchToggleNames: (names: string[], enabled: boolean) => Promise<void>;
+    toggleGroup: (key: string, name: string, view: GroupSwitchState) => void;
+    resolveConflict: (closeAll: boolean) => Promise<void>;
+    runConfirmed: () => Promise<void>;
+    checkSources: (repo?: string) => Promise<void>;
+    requestSync: (repo: string, skills: string[]) => void;
+    requestDelete: (repo: string, skills: string[]) => void;
+    restoreTrash: (name: string) => Promise<void>;
+    clearTrash: () => Promise<void>;
+    requestDeleteSkill: (name: string) => void;
+    runDeleteSkill: () => Promise<void>;
+    createTag: (event: FormEvent) => Promise<void>;
+    deleteTag: (id: string) => Promise<void>;
+    saveTag: (id: string, name: string, memberNames: string[] | null) => Promise<void>;
+    addSource: (input: string) => Promise<void>;
+    addMarketSource: () => Promise<void>;
+    removeMarketSource: (repo: string) => Promise<void>;
+    scanRepo: (input: string) => Promise<void>;
+    confirmBranchChoice: () => Promise<void>;
+    toggleRepoSelected: (path: string, checked: boolean) => void;
+    importRepo: () => Promise<void>;
+    checkMarket: () => Promise<void>;
+    syncMarketSource: (repo: string) => Promise<void>;
+    confirmMarketSync: () => Promise<void>;
+    updateAll: () => Promise<void>;
+    create: (event: FormEvent) => Promise<void>;
+};
+export {};

package/lib/types/client/settings-card.d.ts

@@ -1,8 +1,7 @@
 /**
- * Shared chrome for the plugin settings card, vendored from the dsh-web-ui
- * family bucket (packages/dsh-task-board/src/client/PluginSettingsCard.tsx):
- * a disclosure header naming the plugin and what its settings govern, the
- * controls inside, and the save that writes them. Renders nothing while the
+ * Shared chrome for the plugin settings card, aligned with the official
+ * dsh-client-ui-settings-plugins PluginCard design language: the same tokens,
+ * disclosure header, field rhythm, and copy. Renders nothing while the
  * namespace is unavailable — a deployment that does not compose the owning
  * plugin should show no trace of it.
  */
@@ -62,3 +61,21 @@ export interface SwitchFieldProps {
     onReset: () => void;
 }
 export declare function SwitchField(props: SwitchFieldProps): ReactElement;
+/** One staged color field: a native color picker plus the hex draft text. */
+export interface ColorFieldProps {
+    id: string;
+    label: string;
+    hint: string;
+    inheritLabel: string;
+    overriddenLabel: string;
+    resetLabel: string;
+    disabled: boolean;
+    /** Effective hex (#rrggbb) when overridden; empty string means inherit. */
+    text: string;
+    /** The default color the picker shows while inheriting (per-field). */
+    defaultColor: string;
+    overridden: boolean;
+    onEdit: (text: string) => void;
+    onReset: () => void;
+}
+export declare function ColorField(props: ColorFieldProps): ReactElement;

package/lib/types/client/settings-form.d.ts

@@ -21,6 +21,8 @@ export interface FieldSpec {
 }
 /** A boolean field, edited through true/false draft text. */
 export declare function booleanField(field: string): FieldSpec;
+/** A #rrggbb color field, edited through hex draft text. */
+export declare function colorField(field: string): FieldSpec;
 /** Card-level state the chrome renders. */
 export interface CardShell {
     available: boolean;

package/lib/types/client/settings-nav-icon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The settings shell renders section nav icons from a hard-coded id map and
+ * exposes no registrant icon option, so the skill-hub section falls back to
+ * the generic gear. This scoped DOM patch swaps in the official skill icon
+ * whenever the settings dialog re-renders.
+ */
+/** Swap the settings nav gear for the skill icon and keep it in sync. */
+export declare function applySettingsNavIcon(): () => void;

package/lib/types/index.d.ts

@@ -18,6 +18,12 @@ export interface Config {
     announceToAgent?: boolean;
     /** Master switch for the plugin (routes, prompt section). */
     enabled?: boolean;
+    /** Show per-skill invocation count chip. Default true. */
+    showUseCount?: boolean;
+    /** Show per-skill last-used relative time. Default true. */
+    showUseTime?: boolean;
+    /** Show group-header usage summaries (count + last used). Default true. */
+    showGroupSummary?: boolean;
 }
 export declare const Config: z<Config>;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */