@danielng23/dsh-client-ui-theme-store 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,29 @@
 # @danielng23/dsh-client-ui-theme-store
 
-**Theme store plugin for the DeepSeek Harness Web GUI.** Ships a new **Theme Store** settings page where users browse a flat catalog of curated color themes, preview them via screenshots, and apply them with one click. The catalog is a plain JSON file in this repository (`catalog/themes.json`) — push the repo to GitHub and the plugin fetches the catalog from the raw URL at runtime.
+**Theme store plugin for the DeepSeek Harness Web GUI.** Ships a new **Theme Store** settings page where users browse a flat catalog of curated color themes, preview them via screenshots, and apply them with one click. The catalog is a plain JSON file in this repository (`catalog/edex-themes.json`) — push the repo to GitHub and the plugin fetches the catalog from the raw URL at runtime.
 
-> "No category, just read a json file from this repo(push to github), theme contains name, author, screenshot."
+![Theme Store screenshot](screenshot.png)
+
+## Installation
+
+### Install from npm
+
+```bash
+pnpm add @danielng23/dsh-client-ui-theme-store
+```
+
+### Add to the harness
+
+After installing the package, add the plugin to your harness instance's `cordis.patch.yml`:
+
+```yaml
+- id: ui-theme-store
+  name: '@danielng23/dsh-client-ui-theme-store'
+```
+
+The client bundle is automatically served at `/plugins/@danielng23/dsh-client-ui-theme-store/client.js`.
+
+> "No category, just read a json file from this repo (push to github), theme contains name, author, screenshot."
 
 ## What it looks like
 
@@ -22,7 +43,7 @@ Clicking **Apply**:
 
 ## Catalog
 
-The catalog is a JSON document at `catalog/themes.json` in this repository. Its structure:
+The catalog is a JSON document at `catalog/edex-themes.json` in this repository. Its structure:
 
 ```json
 {
@@ -63,7 +84,7 @@ The catalog is a JSON document at `catalog/themes.json` in this repository. Its
 
 ### Adding a theme
 
-1. Add an entry to `catalog/themes.json`.
+1. Add an entry to `catalog/edex-themes.json`.
 2. Add a screenshot image to `catalog/screenshots/` (or reference an external URL in `screenshot`).
 3. Push the repo to GitHub — the plugin will pick up the new theme on next load.
 
@@ -119,7 +140,7 @@ Two ways to compose this plugin into a running DeepSeek Harness GUI:
 
 #### B. External dependency
 
-1. Install the package from GitHub or npm:
+1. Install the package from npm:
    ```bash
    pnpm add @danielng23/dsh-client-ui-theme-store
    ```
@@ -128,16 +149,18 @@ Two ways to compose this plugin into a running DeepSeek Harness GUI:
 
 ### Catalog URL
 
-The plugin fetches the catalog from a configurable URL. The default is:
+The theme store loads its catalog live from this repository on GitHub, so you can add or change themes by pushing to the repo — no plugin release needed. The default catalog URL is:
 
 ```
-https://raw.githubusercontent.com/dsh-edex/dsh-edex-themes/main/catalog/themes.json
+https://raw.githubusercontent.com/ph4310822/dsh-edex-themes/main/catalog/edex-themes.json
 ```
 
-Override at build time by setting the environment variable:
+If GitHub is unreachable, the store falls back to the bundled catalog served by the plugin's node half at `/catalog/edex-themes.json`.
+
+Override the default at build time by setting the environment variable:
 
 ```bash
-DSH_CLIENT_THEME_STORE_CATALOG_URL=https://your-raw-url/catalog/themes.json pnpm run build
+DSH_CLIENT_THEME_STORE_CATALOG_URL=https://your-raw-url/catalog/edex-themes.json pnpm run build
 ```
 
 Or edit the constant in `src/client/catalog.ts`.

package/lib/client.js

@@ -341,12 +341,18 @@ window.__ModuleLoader__.load({
 		* service (`id`, `colorScheme`, `tokens`).
 		*/
 		/**
-		* Default catalog URL. Served locally by this plugin's node half at the
-		* webserver route `/catalog/edex-themes.json` (same origin as the GUI), so
-		* themes load without any GitHub push. Overridable at build time via
-		* DSH_CLIENT_THEME_STORE_CATALOG_URL.
+		* Default catalog URL: the live catalog in this repository, fetched from
+		* GitHub raw so themes update by pushing to the repo — no plugin release
+		* required. Overridable at build time via DSH_CLIENT_THEME_STORE_CATALOG_URL.
 		*/
-		const DEFAULT_CATALOG_URL = "/catalog/edex-themes.json";
+		const DEFAULT_CATALOG_URL = "https://raw.githubusercontent.com/ph4310822/dsh-edex-themes/main/catalog/edex-themes.json";
+		/**
+		* Bundled fallback: the catalog shipped with the plugin, served by the node
+		* half at the same-origin webserver route. Used when the live GitHub fetch
+		* fails (offline / GitHub unreachable), so the store still shows the shipped
+		* themes rather than an empty error state.
+		*/
+		const LOCAL_CATALOG_URL = "/catalog/edex-themes.json";
 		/** Resolve the effective catalog URL (build-time override, else default). */
 		function catalogUrl() {
 			const override = typeof process !== "undefined" ? process.env.DSH_CLIENT_THEME_STORE_CATALOG_URL : void 0;
@@ -497,8 +503,10 @@ window.__ModuleLoader__.load({
 			}
 			/**
 			* Load the catalog from the configured URL and reconcile the persisted
-			* applied theme. Safe to call repeatedly (retry); a failed fetch leaves
-			* the previous ready state intact and reports an error snapshot.
+			* applied theme. If the live (GitHub) source is unreachable, falls back to
+			* the bundled catalog served by the node half. Safe to call repeatedly
+			* (retry); a total failure leaves the previous ready state intact and
+			* reports an error snapshot.
 			* @returns completion of the load.
 			*/
 			async load() {
@@ -508,7 +516,7 @@ window.__ModuleLoader__.load({
 					error: void 0
 				});
 				try {
-					const catalog = await fetchCatalog(this.href);
+					const catalog = await this.fetchCatalogWithFallback();
 					if (this.disposed) return;
 					this.publish({
 						status: "ready",
@@ -525,6 +533,24 @@ window.__ModuleLoader__.load({
 				}
 			}
 			/**
+			* Fetch the catalog, falling back to the bundled local route when the
+			* configured (GitHub) source fails. A non-GitHub href is tried as-is; when
+			* it and the local fallback both fail, the original error surfaces.
+			* @returns the fetched catalog.
+			*/
+			async fetchCatalogWithFallback() {
+				try {
+					return await fetchCatalog(this.href);
+				} catch (primaryError) {
+					if (this.href === "/catalog/edex-themes.json") throw primaryError;
+					try {
+						return await fetchCatalog(LOCAL_CATALOG_URL);
+					} catch {
+						throw primaryError;
+					}
+				}
+			}
+			/**
 			* Apply a catalog theme: register it with the harness theme service if
 			* needed, switch the active preference to it, and persist the id.
 			* @param id - a catalog theme id.

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

@@ -10,12 +10,18 @@
  */
 import type { ThemeDefinition } from '@deepseek-ai/dsh-client-ui-theme/client';
 /**
- * Default catalog URL. Served locally by this plugin's node half at the
- * webserver route `/catalog/edex-themes.json` (same origin as the GUI), so
- * themes load without any GitHub push. Overridable at build time via
- * DSH_CLIENT_THEME_STORE_CATALOG_URL.
+ * Default catalog URL: the live catalog in this repository, fetched from
+ * GitHub raw so themes update by pushing to the repo — no plugin release
+ * required. Overridable at build time via DSH_CLIENT_THEME_STORE_CATALOG_URL.
  */
-export declare const DEFAULT_CATALOG_URL = "/catalog/edex-themes.json";
+export declare const DEFAULT_CATALOG_URL = "https://raw.githubusercontent.com/ph4310822/dsh-edex-themes/main/catalog/edex-themes.json";
+/**
+ * Bundled fallback: the catalog shipped with the plugin, served by the node
+ * half at the same-origin webserver route. Used when the live GitHub fetch
+ * fails (offline / GitHub unreachable), so the store still shows the shipped
+ * themes rather than an empty error state.
+ */
+export declare const LOCAL_CATALOG_URL = "/catalog/edex-themes.json";
 /** Resolve the effective catalog URL (build-time override, else default). */
 export declare function catalogUrl(): string;
 /**

package/lib/types/client/theme-store.d.ts

@@ -61,11 +61,20 @@ export declare class ThemeStoreRuntime {
     subscribe(listener: () => void): () => void;
     /**
      * Load the catalog from the configured URL and reconcile the persisted
-     * applied theme. Safe to call repeatedly (retry); a failed fetch leaves
-     * the previous ready state intact and reports an error snapshot.
+     * applied theme. If the live (GitHub) source is unreachable, falls back to
+     * the bundled catalog served by the node half. Safe to call repeatedly
+     * (retry); a total failure leaves the previous ready state intact and
+     * reports an error snapshot.
      * @returns completion of the load.
      */
     load(): Promise<void>;
+    /**
+     * Fetch the catalog, falling back to the bundled local route when the
+     * configured (GitHub) source fails. A non-GitHub href is tried as-is; when
+     * it and the local fallback both fail, the original error surfaces.
+     * @returns the fetched catalog.
+     */
+    private fetchCatalogWithFallback;
     /**
      * Apply a catalog theme: register it with the harness theme service if
      * needed, switch the active preference to it, and persist the id.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@danielng23/dsh-client-ui-theme-store",
   "description": "Theme store plugin for the DeepSeek Harness web GUI: a settings Theme Store page that reads a JSON theme catalog from this repository (GitHub), shows name/author/screenshot cards, and applies selected --dsw-* token themes through the harness theme service",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "publishConfig": {
     "access": "public"
   },