dsh-cool-theme 0.4.0 → 0.5.0

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

@@ -0,0 +1,37 @@
+/**
+ * Browser half of the theme-file transport.
+ *
+ * The Host owns the files; this module is the only place that knows the wire
+ * shape, so the rest of the client keeps working with plain `SavedTheme`
+ * records. Every call is same-origin against the Host's own prefix route.
+ */
+import type { ThemeDocument } from '../contract.js';
+import { type CustomTheme, type SavedTheme } from './custom.js';
+/** Repair one stored document against the preset its seeds derive from. */
+export declare function documentToSaved(doc: ThemeDocument, fallbackFor: (base: string) => CustomTheme): SavedTheme;
+/** The document payload for one entry; timestamps stay the Host's business. */
+export declare function savedToDocument(entry: SavedTheme): Record<string, unknown>;
+/**
+ * The Host answered as something other than this API — its route half is not
+ * mounted (the usual cause is a DSH process started before this plugin's host
+ * half existed). Distinguished from a write failure because only this one tells
+ * the user to restart, and the browser copy is still intact meanwhile.
+ */
+export declare class ThemeApiUnavailableError extends Error {
+}
+/** Every stored theme, in the Host's creation-time order (oldest first). */
+export declare function fetchThemes(fallbackFor: (base: string) => CustomTheme): Promise<SavedTheme[]>;
+/** Insert or replace the given entries; resolves with what the Host stored. */
+export declare function pushThemes(entries: SavedTheme[], fallbackFor: (base: string) => CustomTheme): Promise<SavedTheme[]>;
+/** Remove one theme's directory. */
+export declare function removeTheme(id: string): Promise<void>;
+/**
+ * The themes a browser saved before files became the store, minus those the
+ * Host already has.
+ *
+ * Ids are the join key: a theme another browser already migrated must not be
+ * written twice, while one this roster lacks would otherwise disappear from the
+ * UI. Callers adopt the result, then stop reading the browser copy.
+ */
+export declare function legacyThemesToAdopt(legacy: SavedTheme[], hostThemes: SavedTheme[]): SavedTheme[];
+//# sourceMappingURL=theme-files.d.ts.map

package/lib/types/client/theme-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-files.d.ts","sourceRoot":"","sources":["../../../src/client/theme-files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAEhF,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GACzC,UAAU,CAQZ;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS1E;AAMD;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;CAAG;AA4DtD,4EAA4E;AAC5E,wBAAsB,WAAW,CAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GACzC,OAAO,CAAC,UAAU,EAAE,CAAC,CAEvB;AAED,+EAA+E;AAC/E,wBAAsB,UAAU,CAC9B,OAAO,EAAE,UAAU,EAAE,EACrB,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GACzC,OAAO,CAAC,UAAU,EAAE,CAAC,CAMvB;AAED,oCAAoC;AACpC,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAAE,EACpB,UAAU,EAAE,UAAU,EAAE,GACvB,UAAU,EAAE,CAGd"}

package/lib/types/client/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/client/theme.tsx"],"names":[],"mappings":"AAyCA,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,QAsQrC"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/client/theme.tsx"],"names":[],"mappings":"AA2KA,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,QAqcrC"}

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

@@ -1,8 +1,21 @@
-import { type PresetId } from './presets.js';
+import { type PresetId, type PresetDef } from './presets.js';
 export declare function buildBaseCss(): string;
-export declare function buildOverrides(id: PresetId): Record<string, {
+/**
+ * Accepts either a preset id or an already-built `PresetDef` (what a custom
+ * theme produces). Both go through the identical merge, so a custom theme is
+ * not a special case anywhere downstream.
+ */
+export declare function resolvePreset(src: PresetId | PresetDef): {
+    light: {
+        [x: string]: string;
+    };
+    dark: {
+        [x: string]: string;
+    };
+} | null;
+export declare function buildOverrides(src: PresetId | PresetDef): Record<string, {
     light: string;
     dark: string;
 }>;
-export declare function buildFullCssFallback(id: PresetId): string;
+export declare function buildFullCssFallback(src: PresetId | PresetDef): string;
 //# sourceMappingURL=tokens.d.ts.map

package/lib/types/client/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/client/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAIrD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAcD,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5F;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAQzD"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/client/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAItF,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS;;;;;;;SAatD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAIzG;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAItE"}

package/lib/types/contract.d.ts

@@ -3,4 +3,47 @@
  */
 export declare const THEME_STORAGE_KEY = "cool-theme-preset";
 export declare const THEME_STORAGE_KEY_LEGACY = "cooltea-theme-preset";
+export declare const CUSTOM_PRESET_ID = "custom";
+export declare const CUSTOM_THEME_STORAGE_KEY = "cool-theme-custom";
+export declare const CUSTOM_LIST_STORAGE_KEY = "cool-theme-custom-list";
+export declare const CUSTOM_ACTIVE_STORAGE_KEY = "cool-theme-custom-active";
+export declare const CUSTOM_MIGRATED_STORAGE_KEY = "cool-theme-custom-migrated";
+/**
+ * Documents are one directory each — `<root>/<id>/theme.json` — so a theme can
+ * later carry media beside its seeds without changing this contract.
+ */
+export declare const THEME_FILE_VERSION = 1;
+/** Media kind carried with a theme; the seed payload itself is `theme`. */
+export type ThemeAssetKind = 'image' | 'video';
+/** One media file stored under the theme's `assets/` directory. */
+export type ThemeAsset = {
+    /** File name inside `assets/`; unique within the theme. */
+    name: string;
+    kind: ThemeAssetKind;
+    /** Content type the Host serves it back with. */
+    mime: string;
+    bytes: number;
+};
+/**
+ * One theme as it is stored and exchanged. `theme` stays opaque here: the
+ * Client owns the seed shape and repairs it against a preset on read, while the
+ * Host only ever moves the document in and out of a file.
+ */
+export type ThemeDocument = {
+    v: number;
+    id: string;
+    name: string;
+    /** Id of the preset the seeds derive from. */
+    base: string;
+    theme: unknown;
+    assets: ThemeAsset[];
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * The Host's theme-file API, all below one prefix route. Kept here so the two
+ * halves cannot drift on a path.
+ */
+export declare const THEME_API_PREFIX = "/cool-theme/api";
+export declare const THEME_API_PATH_THEMES = "/cool-theme/api/themes";
 //# sourceMappingURL=contract.d.ts.map

package/lib/types/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AACpD,eAAO,MAAM,wBAAwB,yBAAyB,CAAA"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,iBAAiB,sBAAsB,CAAA;AACpD,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAG9D,eAAO,MAAM,gBAAgB,WAAW,CAAA;AAKxC,eAAO,MAAM,wBAAwB,sBAAsB,CAAA;AAG3D,eAAO,MAAM,uBAAuB,2BAA2B,CAAA;AAI/D,eAAO,MAAM,yBAAyB,6BAA6B,CAAA;AAInE,eAAO,MAAM,2BAA2B,+BAA+B,CAAA;AAMvE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAA;AAE9C,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG;IACvB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,cAAc,CAAA;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AACjD,eAAO,MAAM,qBAAqB,2BAA+B,CAAA"}

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

@@ -1,9 +1,12 @@
 /**
  * Host entry for dsh-cool-theme.
- * No host routes needed — theme is purely client-side (localStorage + overrideTokens).
- * Keep a minimal apply so the cordis patch has a mount point.
+ *
+ * Owns the theme files: the browser half cannot touch the filesystem, so every
+ * roster change travels over one same-origin prefix route below
+ * {@link THEME_API_PREFIX}. The route is the whole host surface — no service is
+ * provided, and nothing here interprets the theme payload beyond moving it.
  */
 export declare const name = "dsh-cool-theme";
 export declare const inject: string[];
-export declare function apply(_ctx: any): void;
+export declare function apply(ctx: any): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC,eAAO,MAAM,MAAM,EAAE,MAAM,EAAO,CAAA;AAElC,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,QAAI"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC,eAAO,MAAM,MAAM,UAAgB,CAAA;AAwGnC,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAwCpC"}

package/lib/types/host/theme-files.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Theme files owned by the Host.
+ *
+ * One directory per theme below `$DSH_HOME/cool-theme/themes/<id>/`, holding the
+ * document at `theme.json` and — once themes carry media — the originals under
+ * `assets/`. Keeping a theme a self-contained directory is what makes the later
+ * export a copy of that directory rather than a reassembly of scattered rows.
+ */
+import type { ThemeAsset, ThemeDocument } from '../contract.js';
+export declare function isThemeId(value: unknown): value is string;
+/**
+ * The harness home, resolved the way the rest of DSH resolves it: an explicit
+ * `DSH_HOME`, else `~/.dsh`.
+ */
+export declare function harnessHome(): string;
+/** Root of every stored theme. */
+export declare function themesRoot(): string;
+/** One theme's own directory. Callers must have validated `id`. */
+export declare function themeDir(id: string): string;
+/** Every stored theme, oldest by creation time first; unreadable directories are skipped. */
+export declare function listThemes(): Promise<ThemeDocument[]>;
+/**
+ * Insert or replace one document. `createdAt` is the caller's when the theme is
+ * new and the stored value when it already exists, so a later rename or edit
+ * cannot rewrite when the theme was made.
+ */
+export declare function putTheme(input: {
+    id: string;
+    name: string;
+    base: string;
+    theme: unknown;
+    assets: ThemeAsset[];
+}): Promise<ThemeDocument>;
+/** Remove one theme directory. A missing directory is already the goal. */
+export declare function deleteTheme(id: string): Promise<void>;
+/** Absolute path of a theme's media directory; used once themes carry media. */
+export declare function assetsDir(id: string): string;
+//# sourceMappingURL=theme-files.d.ts.map

package/lib/types/host/theme-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-files.d.ts","sourceRoot":"","sources":["../../../src/host/theme-files.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAc/D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,kCAAkC;AAClC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE3C;AAgED,6FAA6F;AAC7F,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB3D;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,UAAU,EAAE,CAAA;CACrB,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB;AAED,2EAA2E;AAC3E,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cool-theme",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "A plugin for changing themes for DSH, with a number of popular default themes built in.",
   "type": "module",
   "license": "MIT",