@dickpy/dsh-imagegen 1.5.1 → 1.5.3

package/src/client/api.ts

@@ -3,7 +3,7 @@
  * data access path the panel uses — plain fetch, same origin.
  */
 
-import { CONVERSATION_IMAGE_API, GALLERY_API, GENERATE_API, HISTORY_API, PROMPT_ENHANCE_API, TASK_API, TEMPLATES_API, UPDATE_API, type GenerateRequest, type GenerateResult, type GenerationTask, type HistoryEntry, type HistoryEntryInput, type TemplateListResult, type TemplateRefreshResult, type UpdateInfo } from '../protocol.ts'
+import { CONVERSATION_IMAGE_API, GALLERY_API, GENERATE_API, HISTORY_API, PROMPT_ENHANCE_API, TASK_API, TEMPLATE_FAVORITES_API, TEMPLATES_API, UPDATE_API, type GenerateRequest, type GenerateResult, type GenerationTask, type HistoryEntry, type HistoryEntryInput, type TemplateCase, type TemplateFavorite, type TemplateListResult, type TemplateRefreshResult, type TemplateSample, type UpdateInfo } from '../protocol.ts'
 
 /** Error carrying the route's JSON error message. */
 export class ImageGenApiError extends Error {
@@ -181,11 +181,12 @@ export class ImageGenApi {
     return (await readEnvelope<{ ok: true; entries: HistoryEntry[] }>(response)).entries
   }
 
-  /** Fetch the prompt-template library (bundled snapshot or refreshed copy). */
-  async templatesList(): Promise<TemplateListResult> {
-    const response = await fetch(TEMPLATES_API.list, { method: 'POST' })
+  /** Fetch one template source's list (bundled snapshot or refreshed copy). */
+  async templatesList(sourceId: string): Promise<TemplateListResult> {
+    const response = await fetch(TEMPLATES_API.list, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ source: sourceId }) })
     const body = await readEnvelope<TemplateListResult & { ok: true }>(response)
     return {
+      sourceId: body.sourceId,
       cases: body.cases,
       total: body.total,
       origin: body.origin,
@@ -194,10 +195,42 @@ export class ImageGenApi {
     }
   }
 
-  /** Re-download the template library from the upstream mirror (host-side). */
-  async templatesRefresh(): Promise<TemplateRefreshResult> {
-    const response = await fetch(TEMPLATES_API.refresh, { method: 'POST' })
+  /** Re-download one template source's list from its upstream mirror (host-side). */
+  async templatesRefresh(sourceId: string): Promise<TemplateRefreshResult> {
+    const response = await fetch(TEMPLATES_API.refresh, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ source: sourceId }) })
     const body = await readEnvelope<TemplateRefreshResult & { ok: true }>(response)
-    return { total: body.total, fetchedAt: body.fetchedAt }
+    return { sourceId: body.sourceId, total: body.total, fetchedAt: body.fetchedAt }
+  }
+
+  /** Draw random cases across every source (studio inspiration wall). */
+  async templatesSample(count: number): Promise<TemplateSample[]> {
+    const response = await fetch(TEMPLATES_API.sample, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ count }) })
+    return (await readEnvelope<{ ok: true; samples: TemplateSample[] }>(response)).samples
+  }
+
+  /** List the host-persisted template favorites. */
+  async favoritesList(): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.list, { method: 'POST' })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
+  }
+
+  /** Star one template (the host keeps a full case snapshot). */
+  async favoritesAdd(sourceId: string, item: TemplateCase): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.add, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ source: sourceId, case: item }),
+    })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
+  }
+
+  /** Unstar one template by its favorites key. */
+  async favoritesRemove(key: string): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.remove, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ key }),
+    })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
   }
 }

package/src/client/helpers.ts

@@ -1,33 +1,71 @@
-/**
- * Shared panel helpers: the active-dictionary pick (document-language based,
- * dsh-ssh precedent) bound to the dsh-imagegen interpolator, plus a small
- * error-message extractor. All copy stays in the locale dictionaries.
- */
-
-import { en, zh, type ImageGenKey } from './locales.ts'
-
-/** Template values accepted by the interpolator. */
-export type TranslateValues = Record<string, string | number>
-
-/** Active dictionary, picked by the document language at call time. */
-export function dictionary(): Record<string, string> {
-  const lang = typeof document !== 'undefined' ? document.documentElement.lang : 'zh'
-  return lang.toLowerCase().startsWith('en') ? { ...en } : { ...zh }
-}
-
-/** Translate a key with optional {name} template params (current language). */
-export function tt(key: ImageGenKey, values?: TranslateValues): string {
-  const text = dictionary()[key] ?? key
-  if (values === undefined) return text
-  let rendered = text
-  for (const [name, value] of Object.entries(values)) {
-    rendered = rendered.replaceAll(`{${name}}`, String(value))
-  }
-  return rendered
-}
-
-/** Human-readable error text from an unknown thrown value. */
-export function errorMessage(error: unknown): string {
-  if (error instanceof Error) return error.message
-  return String(error)
-}
+/**
+ * Shared panel helpers: the active-dictionary pick bound to the dsh-imagegen
+ * interpolator, the plugin locale that follows the DSH interface language
+ * (bridged in client/index.ts from ctx.locale — the plugin ships zh / en / ru
+ * and registers itself as a DSH language pack for Русский), plus a small
+ * error-message extractor. All copy stays in the locale dictionaries.
+ */
+
+import { en, ru, zh, type ImageGenKey } from './locales.ts'
+
+/** Template values accepted by the interpolator. */
+export type TranslateValues = Record<string, string | number>
+
+/** Languages with a shipped dictionary. */
+export type ImageGenLanguage = 'zh' | 'en' | 'ru'
+
+const DICTIONARIES: Record<ImageGenLanguage, Record<string, string>> = { zh, en, ru }
+
+/** The active DSH locale mapped onto our dictionary (module-level, one value per app). */
+let activeLocale: ImageGenLanguage = 'zh'
+
+/** Bumped on every locale change; useSyncExternalStore version. */
+let languageVersion = 0
+
+const languageListeners = new Set<() => void>()
+
+/**
+ * Adopt the DSH interface language. Unknown ids (future language packs)
+ * resolve to English — the same per-key fallback convention the host locale
+ * chain uses.
+ */
+export function applyHostLocale(id: unknown): void {
+  const next: ImageGenLanguage = id === 'zh' || id === 'ru' ? id : 'en'
+  if (next === activeLocale) return
+  activeLocale = next
+  languageVersion += 1
+  for (const listener of [...languageListeners]) listener()
+}
+
+/** Monotonic version of the active locale (external-store snapshot). */
+export function getImageGenLanguageVersion(): number {
+  return languageVersion
+}
+
+/** Observe locale changes; returns the unsubscriber. */
+export function subscribeImageGenLanguage(listener: () => void): () => void {
+  languageListeners.add(listener)
+  return () => { languageListeners.delete(listener) }
+}
+
+/** Active dictionary for the current DSH language. */
+export function dictionary(): Record<string, string> {
+  return DICTIONARIES[activeLocale]
+}
+
+/** Translate a key with optional {name} template params (current language). */
+export function tt(key: ImageGenKey, values?: TranslateValues): string {
+  const text = dictionary()[key] ?? key
+  if (values === undefined) return text
+  let rendered = text
+  for (const [name, value] of Object.entries(values)) {
+    rendered = rendered.replaceAll(`{${name}}`, String(value))
+  }
+  return rendered
+}
+
+/** Human-readable error text from an unknown thrown value. */
+export function errorMessage(error: unknown): string {
+  if (error instanceof Error) return error.message
+  return String(error)
+}

package/src/client/index.ts

@@ -11,18 +11,18 @@
  * whole boot when a plugin apply throws, and an external plugin must not take
  * the GUI down.
  */
-import type { Context as ClientContext } from '@deepseek-ai/cordis'
-import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'
 import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client'
 // Type-only: pulls the locale plugin's Context merge (ctx.locale).
-import type {} from '@deepseek-ai/dsh-client-locale/client'
-import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
-// Type-only: pulls the LocaleNamespaceMap merge table.
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+// Type-only: pulls the LocaleNamespaceMap merge table.
 import type {} from '@deepseek-ai/dsh-client-ui-slots'
 import { ImageGenApi } from './api.ts'
 import { ImageGenController } from './controller.ts'
-import { tt } from './helpers.ts'
-import { en, zh, type ImageGenKey } from './locales.ts'
+import { tt, applyHostLocale } from './helpers.ts'
+import { en, ru, zh, type ImageGenKey } from './locales.ts'
 import { mountPanel } from './mount.tsx'
 import { mountSidebarEntry } from './sidebar-entry.ts'
 import { ImageGenSettingsCard, ImageGenSettingsCardController } from './SettingsCard.tsx'
@@ -68,7 +68,39 @@ export const inject = ['slots', 'locale', 'connection', 'sessions', 'conversatio
  * @param ctx - client root context (services: slots, locale, connection).
  */
 export function apply(ctx: ClientContext): void {
+  // The host locale service only knows zh/en dictionaries (its type is
+  // fixed); ru rides the untyped single-locale registration instead.
   ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-imagegen: dictionaries')
+  // Russian ships as a language pack: the dictionary lands in this plugin's
+  // namespace, and Русский joins the shared DSH language catalog (Settings →
+  // General → Language) with per-key fallback to English for host copy.
+  // Registration order/aggregation between register(NS, 'ru', …) and
+  // addLanguage differs across host builds and a duplicate throws — these
+  // surfaces must degrade silently, never fail the GUI boot.
+  ctx.effect(() => {
+    try {
+      return ctx.locale.register(NS, 'ru', ru)
+    } catch (error) {
+      console.warn('[dsh-imagegen] ru dictionary not registered:', error)
+      return () => {}
+    }
+  }, 'dsh-imagegen: ru dictionary')
+  ctx.effect(() => {
+    try {
+      if (ctx.locale.getLocale().locales.some(locale => locale.id === 'ru')) return () => {}
+      return ctx.locale.addLanguage({ id: 'ru', label: 'Русский', fallback: 'en' })
+    } catch (error) {
+      console.warn('[dsh-imagegen] ru language not added to the catalog:', error)
+      return () => {}
+    }
+  }, 'dsh-imagegen: ru language pack')
+  // Every plugin surface renders through tt(); bridge DSH locale switches
+  // into it so the whole plugin follows the interface language.
+  ctx.effect(() => {
+    const applyLocale = (): void => { applyHostLocale(ctx.locale.getLocale().active) }
+    applyLocale()
+    return ctx.locale.subscribe(applyLocale)
+  }, 'dsh-imagegen: follow host locale')
   registerImageToolviews(ctx)
 
   const connection = ctx.get('connection') as ConnectionHandle | undefined
@@ -119,6 +151,26 @@ export function apply(ctx: ClientContext): void {
         tt('entry.tooltip'),
       ))
       disposers.push(mountPanel(controller, api, scope, { sessions, conversation }))
+      // The imperative sidebar tabs render their labels once; relabel them on
+      // every DSH language switch so the entry follows the interface too.
+      disposers.push(ctx.locale.subscribe(() => {
+        const root = document.querySelector('[data-dsh-imagegen-sidebar-root]')
+        if (root === null) return
+        const labels: Array<[string, string, string]> = [
+          ['new-session', tt('entry.newSession'), tt('entry.newSessionTooltip')],
+          ['image', tt('entry.image'), tt('entry.tooltip')],
+        ]
+        for (const [tab, label, tooltip] of labels) {
+          const button = root.querySelector<HTMLButtonElement>(`[data-dsh-imagegen-tab="${tab}"]`)
+          if (button === null) continue
+          button.setAttribute('aria-label', label)
+          button.setAttribute('title', tooltip)
+          const labelSpan = button.querySelector('span:nth-child(2)')
+          if (labelSpan !== null) labelSpan.textContent = label
+        }
+        const tablist = root.querySelector<HTMLDivElement>('[role="tablist"][data-dsh-imagegen-session-tabs]')
+        tablist?.setAttribute('aria-label', tt('entry.tooltip'))
+      }))
     } catch (error) {
       // DOM failures degrade the studio, never the GUI.
       console.warn('[dsh-imagegen] mount failed:', error)

package/src/client/inspiration.module.css

@@ -0,0 +1,148 @@
+/**
+ * Inspiration-wall styles for the studio's empty canvas. Same conventions as
+ * panel.module.css: dsh --dsw-* tokens, scoped to this component's subtree.
+ */
+
+.wrap {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 16px;
+  width: min(880px, 100%);
+  margin: auto;
+  padding: 24px;
+  font-family: var(--dsw-font-family);
+}
+
+.title {
+  font-size: 15px;
+  font-weight: 650;
+  color: var(--dsw-alias-label-primary);
+}
+
+/* Fallback (sample failed / libraries empty): mirrors the panel's plain
+   canvas empty state so the swap is invisible. */
+.emptyIcon {
+  display: inline-flex;
+  color: var(--dsw-alias-label-dimmed);
+}
+
+.emptyTitle {
+  margin-top: -6px;
+  font-size: 15px;
+  font-weight: 650;
+  color: var(--dsw-alias-label-primary);
+}
+
+.emptyHint {
+  font-size: 12.5px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.grid {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 12px;
+  width: 100%;
+}
+
+/* Narrow canvases: fold the wall down instead of shrinking tiles into slivers. */
+@media (max-width: 900px) {
+  .grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+@media (max-width: 560px) {
+  .grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+.tile {
+  position: relative;
+  display: block;
+  width: 100%;
+  aspect-ratio: 1 / 1;
+  padding: 0;
+  overflow: hidden;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-1);
+  cursor: pointer;
+  transition: transform 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.tile:hover {
+  border-color: var(--dsw-alias-brand-primary);
+  transform: translateY(-2px);
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.12);
+}
+
+.thumbWrap {
+  position: absolute;
+  inset: 0;
+  display: block;
+}
+
+.thumb {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.thumbFallback {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+  padding: 6px;
+  overflow: hidden;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 11px;
+  line-height: 1.4;
+  text-align: center;
+}
+
+.thumbTitle {
+  position: absolute;
+  inset: auto 0 0 0;
+  padding: 14px 8px 6px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  background: linear-gradient(transparent, rgba(0, 0, 0, 0.55));
+  color: #ffffff;
+  font-size: 10.5px;
+  text-align: center;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+  pointer-events: none;
+}
+
+.tile:hover .thumbTitle {
+  opacity: 1;
+}
+
+.spinner {
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--dsw-alias-border-l2);
+  border-top-color: var(--dsw-alias-brand-primary);
+  border-radius: 50%;
+  animation: dsh-imagegen-inspiration-spin 0.9s linear infinite;
+}
+
+@keyframes dsh-imagegen-inspiration-spin {
+  to { transform: rotate(360deg); }
+}
+
+/* Touch shells have no hover: keep titles visible. */
+@media (hover: none) {
+  .thumbTitle {
+    opacity: 1;
+  }
+}