@raclettejs/workbench 0.1.40 → 0.1.41

package/CHANGELOG.md

@@ -7,8 +7,55 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.1.40] - 2026-06-30 <a href="https://gitlab.com/raclettejs/core-dev/-/compare/v0.1.39...v0.1.40" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+## [0.1.41] - 2026-07-07 <a href="https://gitlab.com/raclettejs/core-dev/-/compare/v0.1.40...v0.1.41" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
+
+
+### Changed
+
+- Share Valkey default DB across app, workbench, and core containers, with per-role overrides and improved widget loading coordination.
+
+  **Cache / Valkey**
+  - Add `services.cache.db` (shared default) and `services.cache.dbs` (`app`, `workbench`, `core`) to `raclette.config.js`; workbench reads cache settings from the starting app via `RACLETTE_APP_PATH`.
+  - Add `cacheUrl` helpers and Docker Compose `CACHE_URL` generation with correct DB suffix resolution; `RACLETTE_CACHE_URL` remains a full override.
+  - Default all stacks to DB `0` so app and workbench share the same Valkey namespace unless configured otherwise.
+  - Remove workbench's hardcoded `services.cache.db: 1`.
 
+  **Frontend orchestrator**
+  - Gate global page loading on socket bootstrap plus page widget slot readiness (`useAppLoadingCoordinator`); remove the router `afterEach` loading timeout.
+  - Track widget readiness at slot-container level; inject `onAllWidgetsReady` via `wrapWidgetWithLifecycle`.
+  - Show modal loading overlays until modal composition slots are ready (`trackReadiness` / `revealWhenReady`).
+  - Render `ErrorWidgetState` for failed widgets without blocking page or modal loading.
+  - Reverse `interactionLinks` `sortOrder` semantics — higher values appear first.
+
+  **BaseDataTable**
+  - Forward `#group-header` slot with `selectionActive`; add `BaseDataTableGroupSelectCheckbox` for custom group headers.
+  - Fix scoped slot content detection when probing for slot content.
+
+  **Workbench**
+  - Localize cache list TTL labels and truncation notices (en, de, sk).
+  - Move Cache interaction link to footer navigation.
+
+  **Docs**
+  - Document `services.cache` configuration, DB resolution order, and examples.
+  - Add BaseDataTable FAQ, widget loading behavior guide, and interactionLinks `sortOrder` notes.
+
+### Updated
+
+- Updated dependencies
+  - @raclettejs/core@0.1.41
+
+### Added
+
+- German and Slovak `cacheList` i18n strings; localized TTL labels and truncation notices via `formatTtlLabel`
+
+### Updated
+
+- interactionLinks `sortOrder` reversed: higher values appear first (see workbench docs)
+- Cache interaction link moved to footer navigation
+- removed hardcoded `services.cache.db: 1` from workbench defaults (inherits starting app's cache DB config)
+- cache list widget uses i18n for truncation notice text
+
+## [0.1.40] - 2026-06-30 <a href="https://gitlab.com/raclettejs/core-dev/-/compare/v0.1.39...v0.1.40" target="_blank" rel="noopener"><b>Overview of all changes</b></a>
 
 ### Patch Changes
 

package/config/interactionLinks.js

@@ -15,7 +15,7 @@ export default [
             default: "Compositions",
             de: "Kompositionen",
           },
-          sortOrder: 0,
+          sortOrder: 4,
           navigationBarType: "navItem",
         },
       },
@@ -48,7 +48,7 @@ export default [
             default: "Interaction Links",
             de: "Interaktionslinks",
           },
-          sortOrder: 1,
+          sortOrder: 3,
           navigationBarType: "navItem",
         },
       },
@@ -114,7 +114,7 @@ export default [
             default: "Tags",
             de: "Tags",
           },
-          sortOrder: 3,
+          sortOrder: 1,
           navigationBarType: "navItem",
         },
       },
@@ -148,7 +148,7 @@ export default [
             default: "Plugins",
             de: "Plugins",
           },
-          sortOrder: 4,
+          sortOrder: 0,
           navigationBarType: "navItem",
         },
       },
@@ -175,7 +175,7 @@ export default [
             default: "Project",
             de: "Projekt",
           },
-          sortOrder: 0,
+          sortOrder: 1,
           navigationBarType: "footerItem",
         },
       },
@@ -194,8 +194,8 @@ export default [
             default: "Cache",
             de: "Cache",
           },
-          sortOrder: 5,
-          navigationBarType: "navItem",
+          sortOrder: 1,
+          navigationBarType: "footerItem",
         },
       },
     ],

package/i18n/de-DE.json

@@ -232,6 +232,46 @@
     "tagEdit": {
       "title": "Tag bearbeiten"
     },
+    "cacheList": {
+      "dataName": "Cache-Eintrag",
+      "dbLabel": "DB",
+      "batchSizeLabel": "Abruf-Batch",
+      "dbActive": "DB {db}",
+      "patternLabel": "Schlüsselmuster",
+      "patternPlaceholder": "leer = alle Schlüssel, gruppiert",
+      "refresh": "Aktualisieren",
+      "loadMore": "Mehr laden",
+      "truncated": "Gekürzt",
+      "truncatedDetailHint": "Wert wurde zur Anzeige gekürzt. Export enthält möglicherweise nicht den vollständigen gespeicherten Wert.",
+      "truncationNotice": "Wert wurde für den Transport gekürzt; Rest ausgelassen. Nicht als vollständige Quelle verwenden.",
+      "detailTtl": "TTL",
+      "showingCount": "{shown} von {total}",
+      "keyPickerLabel": "Schlüssel",
+      "backToList": "Zurück zur Liste",
+      "customizeTable": "Tabelle konfigurieren",
+      "configureColumns": "Spalten konfigurieren",
+      "deselectAll": "Alle abwählen",
+      "done": "Fertig",
+      "valueTableTitle": "Cache-Wert",
+      "openValueTable": "Wertetabelle öffnen",
+      "openValueTableFor": "Wertetabelle für {key} öffnen",
+      "ttlNoExpiry": "kein Ablauf",
+      "ttlMissing": "fehlend",
+      "ttlSeconds": "{seconds}s",
+      "tableHeaders": {
+        "keyGroup": "Gruppe",
+        "key": "Schlüssel",
+        "ttl": "TTL",
+        "value": "Wert"
+      },
+      "valueTableHeaders": {
+        "field": "Feld",
+        "entryKey": "Eintragsschlüssel",
+        "value": "Wert",
+        "index": "Index",
+        "raw": "Roh"
+      }
+    },
     "tagConfiguration": {
       "dividers": {
         "general": "Allgemein"

package/i18n/en-EU.json

@@ -243,6 +243,7 @@
       "loadMore": "Load more",
       "truncated": "Truncated",
       "truncatedDetailHint": "Value was truncated for display. Export may not include the full stored value.",
+      "truncationNotice": "Value was cut for transport; remainder omitted. Do not treat as complete source of truth.",
       "detailTtl": "TTL",
       "showingCount": "{shown} of {total}",
       "keyPickerLabel": "Key",
@@ -254,6 +255,9 @@
       "valueTableTitle": "Cache value",
       "openValueTable": "Open value table",
       "openValueTableFor": "Open value table for {key}",
+      "ttlNoExpiry": "no expiry",
+      "ttlMissing": "missing",
+      "ttlSeconds": "{seconds}s",
       "tableHeaders": {
         "keyGroup": "Group",
         "key": "Key",

package/i18n/sk-SK.json

@@ -227,6 +227,46 @@
     "tagEdit": {
       "title": "Upraviť značku"
     },
+    "cacheList": {
+      "dataName": "Položka cache",
+      "dbLabel": "DB",
+      "batchSizeLabel": "Veľkosť dávky",
+      "dbActive": "DB {db}",
+      "patternLabel": "Vzor kľúča",
+      "patternPlaceholder": "prázdne = všetky kľúče, zoskupené",
+      "refresh": "Obnoviť",
+      "loadMore": "Načítať viac",
+      "truncated": "Skrátené",
+      "truncatedDetailHint": "Hodnota bola skrátená na zobrazenie. Export nemusí obsahovať úplnú uloženú hodnotu.",
+      "truncationNotice": "Hodnota bola skrátená pri prenose; zvyšok vynechaný. Nepoužívajte ako úplný zdroj pravdy.",
+      "detailTtl": "TTL",
+      "showingCount": "{shown} z {total}",
+      "keyPickerLabel": "Kľúč",
+      "backToList": "Späť na zoznam",
+      "customizeTable": "Konfigurovať tabuľku",
+      "configureColumns": "Konfigurovať stĺpce",
+      "deselectAll": "Zrušiť výber všetkých",
+      "done": "Hotovo",
+      "valueTableTitle": "Hodnota cache",
+      "openValueTable": "Otvoriť tabuľku hodnôt",
+      "openValueTableFor": "Otvoriť tabuľku hodnôt pre {key}",
+      "ttlNoExpiry": "bez expirácie",
+      "ttlMissing": "chýba",
+      "ttlSeconds": "{seconds}s",
+      "tableHeaders": {
+        "keyGroup": "Skupina",
+        "key": "Kľúč",
+        "ttl": "TTL",
+        "value": "Hodnota"
+      },
+      "valueTableHeaders": {
+        "field": "Pole",
+        "entryKey": "Kľúč záznamu",
+        "value": "Hodnota",
+        "index": "Index",
+        "raw": "Surové"
+      }
+    },
     "tagConfiguration": {
       "dividers": {
         "general": "Všeobecné"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raclettejs/workbench",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "license": "MIT",
   "description": "racletteJS Workbench - used to configure your application, for dev and prod",
   "repository": "https://gitlab.com/raclettejs/workbench",
@@ -33,7 +33,7 @@
     ".": "./index.ts"
   },
   "dependencies": {
-    "@raclettejs/core": "0.1.40",
+    "@raclettejs/core": "0.1.41",
     "@vueuse/integrations": "14.2.1",
     "fuse.js": "7.1.0",
     "three": "0.183.2",
@@ -43,7 +43,7 @@
     "@emnapi/core": "1.9.2",
     "@emnapi/runtime": "1.9.2",
     "@eslint/js": "9.35.0",
-    "@raclettejs/types": "0.1.40",
+    "@raclettejs/types": "0.1.41",
     "@sinclair/typebox": "0.34.48",
     "@types/ramda": "0.31.1",
     "@vueuse/core": "14.2.1",

package/plugins/raclette__cache/backend/helpers/valkeyExplorer.ts

@@ -5,7 +5,7 @@ export type NormalizedPattern = {
   listAll: boolean
 }
 
-/** Explorer defaults to DB 0; raclette.config often sets cache db 1 for the app client. */
+/** Explorer defaults to DB 0; per-role DB is configured on the starting app via services.cache.db / services.cache.dbs. */
 export const DEFAULT_EXPLORER_DB = 0
 
 export const parseExplorerDb = (queryDb?: number): number => {

package/plugins/raclette__cache/frontend/utils/formatCacheEntryDisplay.ts

@@ -1,7 +1,7 @@
 /** Injected into repaired JSON so viewers know the payload is incomplete. */
 export const TRUNCATION_MARKER = "__raclette_truncated__"
 
-const TRUNCATION_NOTICE =
+const DEFAULT_TRUNCATION_NOTICE =
   "Value was cut for transport; remainder omitted. Do not treat as complete source of truth."
 
 type CacheEntryDisplaySource = {
@@ -11,10 +11,14 @@ type CacheEntryDisplaySource = {
   valueParsedFromFullValue?: boolean
 }
 
+export type FormatCacheEntryDisplayOptions = {
+  truncationNotice?: string
+}
+
 const prettyJson = (value: unknown): string => JSON.stringify(value, null, 2)
 
-const appendTruncationNotice = (body: string): string =>
-  `${body}\n\n/* ${TRUNCATION_NOTICE} */`
+const appendTruncationNotice = (body: string, truncationNotice: string): string =>
+  `${body}\n\n/* ${truncationNotice} */`
 
 /**
  * Close open strings/arrays/objects after an abrupt cut so JSON.parse may succeed
@@ -135,16 +139,19 @@ export const repairTruncatedJson = (raw: string): string => {
   return candidate
 }
 
-const withTruncationMarker = (parsed: unknown): unknown => {
+const withTruncationMarker = (
+  parsed: unknown,
+  truncationNotice: string,
+): unknown => {
   if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
     return {
       ...parsed,
-      [TRUNCATION_MARKER]: TRUNCATION_NOTICE,
+      [TRUNCATION_MARKER]: truncationNotice,
     }
   }
 
   return {
-    [TRUNCATION_MARKER]: TRUNCATION_NOTICE,
+    [TRUNCATION_MARKER]: truncationNotice,
     value: parsed,
   }
 }
@@ -153,7 +160,13 @@ const withTruncationMarker = (parsed: unknown): unknown => {
  * Pretty-print a cache entry for <pre> display.
  * Recovers structure from truncated JSON when possible and always signals truncation.
  */
-export const formatCacheEntryDisplay = (entry: CacheEntryDisplaySource): string => {
+export const formatCacheEntryDisplay = (
+  entry: CacheEntryDisplaySource,
+  options: FormatCacheEntryDisplayOptions = {},
+): string => {
+  const truncationNotice =
+    options.truncationNotice ?? DEFAULT_TRUNCATION_NOTICE
+
   if (!entry.truncated) {
     if (entry.valueParsed !== undefined) {
       return prettyJson(entry.valueParsed)
@@ -173,19 +186,28 @@ export const formatCacheEntryDisplay = (entry: CacheEntryDisplaySource): string
   }
 
   if (entry.valueParsed !== undefined) {
-    return appendTruncationNotice(prettyJson(entry.valueParsed))
+    return appendTruncationNotice(
+      prettyJson(entry.valueParsed),
+      truncationNotice,
+    )
   }
 
   try {
-    return appendTruncationNotice(prettyJson(JSON.parse(entry.value)))
+    return appendTruncationNotice(
+      prettyJson(JSON.parse(entry.value)),
+      truncationNotice,
+    )
   } catch {
     const repaired = repairTruncatedJson(entry.value)
     try {
       return appendTruncationNotice(
-        prettyJson(withTruncationMarker(JSON.parse(repaired))),
+        prettyJson(
+          withTruncationMarker(JSON.parse(repaired), truncationNotice),
+        ),
+        truncationNotice,
       )
     } catch {
-      return `${entry.value}\n\n… [${TRUNCATION_NOTICE}]`
+      return `${entry.value}\n\n… [${truncationNotice}]`
     }
   }
 }

package/plugins/raclette__cache/frontend/utils/formatTtlLabel.ts

@@ -0,0 +1,15 @@
+type TtlTranslate = (
+  key: string,
+  values?: Record<string, unknown>,
+) => string
+
+/** Format Valkey TTL for display using workbench.cacheList i18n keys. */
+export const formatTtlLabel = (ttl: number, t: TtlTranslate): string => {
+  if (ttl === -1) {
+    return t("workbench.cacheList.ttlNoExpiry")
+  }
+  if (ttl === -2) {
+    return t("workbench.cacheList.ttlMissing")
+  }
+  return t("workbench.cacheList.ttlSeconds", { seconds: ttl })
+}

package/plugins/raclette__cache/frontend/widgets/CacheListWidget.vue

@@ -96,6 +96,9 @@
           {{ $t("workbench.cacheList.dbActive", { db: activeDb }) }}
         </span>
       </template>
+      <template #item.ttlLabel="{ item }">
+        {{ formatTtlLabel(item.ttl, t) }}
+      </template>
       <template #item.value="{ item }">
         <code class="tw:text-xs tw:break-all tw:line-clamp-2">
           {{ displayValue(item) }}
@@ -180,7 +183,7 @@
         class="tw:text-sm tw:text-medium-emphasis tw:whitespace-nowrap"
       >
         {{ $t("workbench.cacheList.detailTtl") }}:
-        {{ valueTableEntry.ttlLabel }}
+        {{ formatTtlLabel(valueTableEntry.ttl, t) }}
         ·
         {{ $t("workbench.cacheList.dbActive", { db: activeDb }) }}
       </span>
@@ -252,7 +255,7 @@
         </v-card-title>
         <v-card-subtitle>
           {{ $t("workbench.cacheList.detailTtl") }}:
-          {{ selectedEntry.ttlLabel }}
+          {{ formatTtlLabel(selectedEntry.ttl, t) }}
         </v-card-subtitle>
         <v-card-text>
           <v-alert
@@ -298,6 +301,7 @@ import {
   type ValueTableHeader,
 } from "../utils/cacheValueTableRows"
 import { formatCacheEntryDisplay } from "../utils/formatCacheEntryDisplay"
+import { formatTtlLabel } from "../utils/formatTtlLabel"
 import { computed, onMounted, ref } from "vue"
 import { useI18n } from "vue-i18n"
 
@@ -644,7 +648,10 @@ const displayValue = (item: CacheEntry) => {
   return item.value
 }
 
-const formatDetailValue = (item: CacheEntry) => formatCacheEntryDisplay(item)
+const formatDetailValue = (item: CacheEntry) =>
+  formatCacheEntryDisplay(item, {
+    truncationNotice: t("workbench.cacheList.truncationNotice"),
+  })
 
 const formatValueTableCell = (value: string | undefined) => value ?? ""
 

package/raclette.config.js

@@ -51,7 +51,6 @@ export default defineRacletteConfig({
       volume: "raclette-cache",
       enabled: true,
       port: 6379,
-      db: 1,
     },
   },