dsh-cool-theme 0.3.1 → 0.5.0

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.3.1",
+  "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",