dsh-plugin-shop 0.4.0 → 0.4.2

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

@@ -6,8 +6,10 @@ export declare const zh: {
     error: string;
     retry: string;
     search: string;
+    all: string;
     catalog: string;
     catalogStats: string;
+    stars: string;
     categoryTool: string;
     categoryProvider: string;
     categoryUi: string;
@@ -46,6 +48,12 @@ export declare const zh: {
     installedVersion: string;
     latestVersion: string;
     update: string;
+    installed: string;
+    uninstall: string;
+    uninstalling: string;
+    uninstallFailed: string;
+    uninstallTransportFailed: string;
+    uninstalledRestartNotice: string;
     enabledSwitch: string;
     toggleFailed: string;
     hotApplyNote: string;
@@ -59,8 +67,10 @@ export declare const en: {
     error: string;
     retry: string;
     search: string;
+    all: string;
     catalog: string;
     catalogStats: string;
+    stars: string;
     categoryTool: string;
     categoryProvider: string;
     categoryUi: string;
@@ -99,6 +109,12 @@ export declare const en: {
     installedVersion: string;
     latestVersion: string;
     update: string;
+    installed: string;
+    uninstall: string;
+    uninstalling: string;
+    uninstallFailed: string;
+    uninstallTransportFailed: string;
+    uninstalledRestartNotice: string;
     enabledSwitch: string;
     toggleFailed: string;
     hotApplyNote: string;

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

@@ -81,6 +81,28 @@ export declare function reduceInstall(state: InstallView, event: InstallEvent):
  * it matches other people's package names, not ours.
  */
 export declare function isShopLike(name: string): boolean;
+declare const CATEGORY_KEYS: {
+    readonly tool: "categoryTool";
+    readonly provider: "categoryProvider";
+    readonly ui: "categoryUi";
+    readonly workflow: "categoryWorkflow";
+    readonly integration: "categoryIntegration";
+    readonly other: "categoryOther";
+};
 /** The locale key for one entry's category — derived entries read as `other`
  * (§6.1: a derived listing has no declared category). */
 export declare function categoryKey(entry: CatalogEntry): ShopLocaleKey;
+/** The category vocabulary as a type, derived from the map above so the
+ * client never repeats the six literals. */
+export type Category = keyof typeof CATEGORY_KEYS;
+/** The six categories in display order (map insertion order). */
+export declare const CATEGORY_ORDER: Category[];
+/** The locale key for one bare category value (the filter buttons). */
+export declare function categoryLocaleKey(category: Category): ShopLocaleKey;
+/** Sort the shelf: stars descending, un-starred entries last, name ascending
+ * (case-insensitive) on ties (spec 2026-08-26-github-stars-design.md D1).
+ * Display-time only — the catalog's own name sort is untouched. */
+export declare function sortByStars(entries: CatalogEntry[], stars: Record<string, number>): CatalogEntry[];
+/** 999 → "999"; 1000 → "1k"; 1234 → "1.2k"; 1500 → "1.5k"; 99999 → "100k". */
+export declare function formatStars(n: number): string;
+export {};

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

@@ -1,4 +1,5 @@
 /** Install driving hook for one entry: start, poll to terminal, reset. */
+import { type Dispatch, type SetStateAction } from 'react';
 import { type InstallView } from './present.ts';
 import type { InstallArgs, ShopInstallResult, ShopInstallStatusResult } from '../host/index.ts';
 export interface UseInstallResult {
@@ -6,6 +7,14 @@ export interface UseInstallResult {
     start: (args: InstallArgs) => Promise<void>;
     reset: () => void;
 }
+/** The poll loop shared by the install and uninstall drivers: while the view
+ * is `running`, poll once per second and fold each status through the
+ * reducer. A poll failure is transient — the host retains the record, so the
+ * next tick finds it. The rejection handler must be present: an unhandled
+ * rejection here would escape the poll loop. */
+export declare function usePollStatus(view: InstallView, setView: Dispatch<SetStateAction<InstallView>>, installStatus: (args: {
+    installId: string;
+}) => Promise<ShopInstallStatusResult>): void;
 /** Drive one install: rejections, the polling loop at INSTALL_POLL_MS, and
  * terminal states. The interval is cleared on unmount and whenever the view
  * leaves `running`, so a done/failed/rejected install never polls again. */

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

@@ -0,0 +1,21 @@
+/** Uninstall driving hook for one entry: start, poll to terminal. Shares the
+ * install view machine and poll loop; the only difference is the start
+ * mapping — an uninstall business failure (not in the catalog / not
+ * installed) lands in the `failed` view with the host's published detail,
+ * never in the install `rejected` codes, which belong to the install gate
+ * (§7.2). */
+import type { ShopInstallStatusResult, ShopUninstallResult } from '../host/index.ts';
+import type { InstallView } from './present.ts';
+export interface UseUninstallResult {
+    view: InstallView;
+    start: (args: {
+        name: string;
+    }) => Promise<void>;
+}
+/** Drive one uninstall: the host's business union, the shared polling loop,
+ * and terminal states. The `rejected` install state never occurs here. */
+export declare function useUninstall(uninstall: (args: {
+    name: string;
+}) => Promise<ShopUninstallResult>, installStatus: (args: {
+    installId: string;
+}) => Promise<ShopInstallStatusResult>): UseUninstallResult;

package/lib/types/host/catalog.d.ts

@@ -7,6 +7,9 @@ export interface CatalogSnapshot {
     builtAt: string;
     entries: CatalogEntry[];
     denied: DeniedEntry[];
+    /** GitHub star counts by package name; {} when the pointer names no
+     * sidecar or the sidecar could not be fetched/verified (spec §5). */
+    stars: Record<string, number>;
 }
 export interface CatalogResult {
     snapshot: CatalogSnapshot;
@@ -32,6 +35,8 @@ export interface LoadCatalogOptions {
  * only when the transport itself failed — the fetch threw or returned a
  * non-2xx (§10). A schemaVersion higher than this build supports, a malformed
  * pointer or data file, an absolute data URL, or a sha256 mismatch — fresh or
- * cached — throws even when a cache exists; never silently degraded.
+ * cached — throws even when a cache exists; never silently degraded. The stars
+ * sidecar is the sole exception: any irregularity there, a refused url
+ * included, degrades to no stars (spec §5).
  */
 export declare function loadCatalog(options: LoadCatalogOptions): Promise<CatalogResult>;

package/lib/types/host/executor.d.ts

@@ -1,4 +1,7 @@
-/** Install executor: spawn the dsh CLI, stream its output, serialize per profile. */
+/** Plugin-command executor: spawn the dsh CLI, stream its output, serialize
+ * per profile. One implementation drives both `dsh plugin add` (install) and
+ * `dsh plugin remove` (uninstall); the only differences are the verb and the
+ * post-exit manifest confirmation. */
 export type InstallState = 'running' | 'done' | 'failed';
 export interface InstallStatus {
     state: InstallState;
@@ -13,11 +16,6 @@ interface RunningInstall {
 }
 /**
  * Run one `dsh plugin --profile <profile> add <spec>` and track it.
- * Never rolls back; a failure surfaces stderr verbatim plus the recovery hint
- * (§10). The shop never passes build-script flags: `allowBuilds` stays the
- * user's explicit decision in the CLI (§7.2).
- * The child inherits the current environment unless `env` is given — the
- * real-install test pins DSH_HOME to a temporary directory this way.
  * When `expectedName` is given, a zero exit is confirmed against the profile
  * manifest (§7.2 step 6) before the install reports `done`.
  */
@@ -29,4 +27,18 @@ export declare function startInstall(options: {
     expectedName?: string;
     onStatus?: (status: InstallStatus) => void;
 }): RunningInstall;
+/**
+ * Run one `dsh plugin --profile <profile> remove <name>` and track it.
+ * When `expectedName` is given, a zero exit is confirmed against the profile
+ * manifest — the bundle must actually have LEFT `dsh.profile.bundles` — before
+ * the uninstall reports `done`.
+ */
+export declare function startUninstall(options: {
+    profile: string;
+    name: string;
+    dshBin?: string;
+    env?: NodeJS.ProcessEnv;
+    expectedName?: string;
+    onStatus?: (status: InstallStatus) => void;
+}): RunningInstall;
 export {};

package/lib/types/host/index.d.ts

@@ -49,11 +49,25 @@ export interface ShopSetEnabledResult {
     ok: boolean;
     detail?: string;
 }
-/** `shop/outdated` entry (§7.3): one installed plugin behind the catalog. */
-export interface ShopOutdatedEntry {
+/** `shop/uninstallStart` result (§7.3): a name outside the catalog or not
+ * installed is a typed wire value with an author-readable `detail`, not a
+ * thrown RPC error. */
+export type ShopUninstallResult = {
+    ok: true;
+    installId: string;
+} | {
+    ok: false;
+    detail: string;
+};
+/** `shop/installed` entry (§7.3): one installed catalog plugin. `installed`
+ * is the profile manifest's dependency spec verbatim (a range, a tag, or
+ * `workspace:*`); `outdated` is the Host's verdict that the installed version
+ * sits behind the catalog's — the client never does version math. */
+export interface ShopInstalledEntry {
     name: string;
     installed: string;
     latest: string;
+    outdated: boolean;
 }
 /** `shop/catalog` result (§7.3), plus the denied list for the install gate's UI. */
 export interface ShopCatalogResult {
@@ -62,6 +76,9 @@ export interface ShopCatalogResult {
     stale: boolean;
     plugins: CatalogEntry[];
     denied: DeniedEntry[];
+    /** GitHub star counts by package name; {} when the pointer names no sidecar
+     * or the sidecar could not be fetched/verified (§5). */
+    stars: Record<string, number>;
 }
 /** Remote-only service exposing the shop Remote methods of §7.3.
  *
@@ -124,7 +141,24 @@ export declare class ShopGateway extends TypertRemoteService {
     installStatus(args: {
         installId: string;
     }): ShopInstallStatusResult;
-    /** Installed plugins whose installed version is older than the catalog's (§7.3). */
-    outdated(): Promise<ShopOutdatedEntry[]>;
+    /** Installed catalog plugins (§7.3): every entry of the snapshot the profile
+     * manifest declares as a dependency, with the Host's `outdated` verdict
+     * attached. The tab's shelf cards and its installed section both derive
+     * from this one list. */
+    installed(): Promise<ShopInstalledEntry[]>;
+    /** Whether an installed dependency spec sits behind the catalog's version.
+     * A spec identical to the catalog version is current by definition; a
+     * pnpm-written non-semver spec like `workspace:*` is not reportable and
+     * reads as current rather than killing the RPC. */
+    private isBehind;
+    /** Uninstall one installed catalog plugin from the profile (§7.3 follow-up
+     * amendment). Removing revokes privilege rather than granting it, so there
+     * is no acknowledgement gate. The name must be a catalog entry the profile
+     * manifest declares as a dependency — the RPC cannot remove profile
+     * dependencies the shop does not manage (the base bundle, the shop
+     * itself). The same install records/polling serve the client. */
+    uninstall(args: {
+        name: string;
+    }): Promise<ShopUninstallResult>;
 }
 export default ShopGateway;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-shop",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "The DeepSeek Harness plugin shop: browse, install, enable, and update dsh plugins from a git-auditable catalog.",
   "repository": {
     "type": "git",