@cosmicdrift/kumiko-bundled-features 0.122.4 → 0.123.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.122.4",
+  "version": "0.123.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -96,11 +96,11 @@
     "./step-dispatcher": "./src/step-dispatcher/index.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-dispatcher-live": "0.122.4",
-    "@cosmicdrift/kumiko-framework": "0.122.4",
-    "@cosmicdrift/kumiko-headless": "0.122.4",
-    "@cosmicdrift/kumiko-renderer": "0.122.4",
-    "@cosmicdrift/kumiko-renderer-web": "0.122.4",
+    "@cosmicdrift/kumiko-dispatcher-live": "0.123.0",
+    "@cosmicdrift/kumiko-framework": "0.123.0",
+    "@cosmicdrift/kumiko-headless": "0.123.0",
+    "@cosmicdrift/kumiko-renderer": "0.123.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.123.0",
     "@mollie/api-client": "^4.5.0",
     "@node-rs/argon2": "^2.0.2",
     "@types/nodemailer": "^8.0.0",

package/src/managed-pages/__tests__/i18n-surface.boot.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, test } from "bun:test";
+import { validateBoot } from "@cosmicdrift/kumiko-framework/engine";
+import { createConfigFeature } from "../../config/feature";
+import { createManagedPagesFeature } from "../feature";
+
+// Completeness-Gate: managed-pages ruft jetzt r.translations → der Boot-Validator
+// erzwingt den KOMPLETTEN Required-Surface-Key-Satz (screen:*.title,
+// entity:*:field:*, Section-Header, rowAction-Labels/Confirms) in de+en. Fehlt
+// EIN Key, wirft validateBoot. Beide allowCustomCss-Varianten müssen booten —
+// bei true kommen die zwei customCss-Keys als required dazu.
+
+const resolveApexTenant = () => null;
+
+describe("managed-pages i18n surface completeness", () => {
+  test("boot-validates with allowCustomCss: false", () => {
+    const features = [
+      createConfigFeature(),
+      createManagedPagesFeature({ resolveApexTenant, allowCustomCss: false }),
+    ];
+    expect(() => validateBoot(features)).not.toThrow();
+  });
+
+  test("boot-validates with allowCustomCss: true (customCss keys required)", () => {
+    const features = [
+      createConfigFeature(),
+      createManagedPagesFeature({ resolveApexTenant, allowCustomCss: true }),
+    ];
+    expect(() => validateBoot(features)).not.toThrow();
+  });
+});

package/src/managed-pages/feature.ts

@@ -19,6 +19,7 @@ import { BRANDING_KEYS, BRANDING_QUERY_QN, CUSTOM_CSS_KEY, coerceBranding } from
 import { createBrandingQuery } from "./handlers/branding.query";
 import { bySlugQuery } from "./handlers/by-slug.query";
 import { setWrite } from "./handlers/set.write";
+import { MANAGED_PAGES_I18N } from "./i18n";
 import { createBrandingSettingsScreen } from "./screens/branding-screen";
 import { pageEditScreen, pageListScreen } from "./screens/page-screens";
 import { pageEntity } from "./table";
@@ -196,6 +197,8 @@ export function createManagedPagesFeature(opts: ManagedPagesOptions): FeatureDef
     r.screen(pageEditScreen);
     r.screen(createBrandingSettingsScreen({ allowCustomCss }));
 
+    r.translations({ keys: MANAGED_PAGES_I18N });
+
     r.httpRoute({
       method: "GET",
       path: `${basePath}/:slug`,

package/src/managed-pages/i18n.ts

@@ -0,0 +1,56 @@
+// Übersetzungs-Bundle für die managed-pages Admin-Screens. Ohne diese Keys
+// rendert die UI die Roh-i18n-Keys (screen:*.title, entity:*:field:*, Section-
+// Header). Der Boot-Validator (required-surface-keys) verlangt — sobald ein
+// Feature r.translations ruft — den KOMPLETTEN Required-Surface-Satz in de+en;
+// diese Datei deckt jeden Screen/Feld/Section-Key ab, den managed-pages
+// registriert. Die zwei customCss-Keys werden unconditional geliefert (schaden
+// bei allowCustomCss:false nicht, sind aber Pflicht für Consumer die es aktivieren).
+
+type LocalizedString = { readonly de: string; readonly en: string };
+
+export const MANAGED_PAGES_I18N: Readonly<Record<string, LocalizedString>> = {
+  // Screen-Titel (global/unpräfixiert — screenTitleKey = screen:<id>.title)
+  "screen:page-list.title": { de: "Seiten", en: "Pages" },
+  "screen:page-edit.title": { de: "Seite bearbeiten", en: "Edit page" },
+  "screen:branding-settings.title": { de: "Branding", en: "Branding" },
+
+  // Page-Entity Feld-Labels (managed-pages:entity:page:field:*)
+  "managed-pages:entity:page:field:slug": { de: "Slug", en: "Slug" },
+  "managed-pages:entity:page:field:lang": { de: "Sprache", en: "Language" },
+  "managed-pages:entity:page:field:title": { de: "Titel", en: "Title" },
+  "managed-pages:entity:page:field:published": { de: "Veröffentlicht", en: "Published" },
+  "managed-pages:entity:page:field:description": { de: "Beschreibung", en: "Description" },
+  "managed-pages:entity:page:field:ogImage": { de: "OG-Bild", en: "OG image" },
+  "managed-pages:entity:page:field:body": { de: "Inhalt", en: "Content" },
+
+  // Config-Edit Feld-Labels (managed-pages:entity:__config-edit__:field:*, camelCase Form-Keys)
+  "managed-pages:entity:__config-edit__:field:title": { de: "Website-Titel", en: "Site title" },
+  "managed-pages:entity:__config-edit__:field:description": {
+    de: "Beschreibung",
+    en: "Description",
+  },
+  "managed-pages:entity:__config-edit__:field:siteUrl": { de: "Website-URL", en: "Site URL" },
+  "managed-pages:entity:__config-edit__:field:accentColor": {
+    de: "Akzentfarbe",
+    en: "Accent color",
+  },
+  "managed-pages:entity:__config-edit__:field:logoUrl": { de: "Logo-URL", en: "Logo URL" },
+  "managed-pages:entity:__config-edit__:field:layoutPreset": { de: "Layout", en: "Layout" },
+
+  // Section-Header
+  "managed-pages:section.meta": { de: "Metadaten", en: "Metadata" },
+  "managed-pages:section.body": { de: "Inhalt", en: "Content" },
+  "managed-pages:branding.section.identity": { de: "Identität", en: "Identity" },
+
+  // Row-Actions + Confirm (pageListScreen)
+  "managed-pages:actions.edit": { de: "Bearbeiten", en: "Edit" },
+  "managed-pages:actions.delete": { de: "Löschen", en: "Delete" },
+  "managed-pages:confirms.page-delete": {
+    de: "Diese Seite wirklich löschen?",
+    en: "Delete this page?",
+  },
+
+  // Nur bei allowCustomCss:true im Screen — unconditional geliefert
+  "managed-pages:entity:__config-edit__:field:customCss": { de: "Eigenes CSS", en: "Custom CSS" },
+  "managed-pages:branding.section.custom-css": { de: "Eigenes CSS", en: "Custom CSS" },
+};

package/src/page-render/layout.ts

@@ -33,6 +33,7 @@ const TENANT_CLIP = `${TENANT_SCOPE}{overflow:hidden}`;
 export function tenantStyleBlock(customCss: string): string {
   const sanitized = sanitizeTenantCss(customCss, TENANT_SCOPE);
   if (!sanitized) return "";
+  // html-ok: sanitizeTenantCss ist die Escaping-Boundary (Allowlist, strippt `<`).
   return `\n<style data-tenant-css>${TENANT_CONTAINMENT}\n${TENANT_CLIP}\n${sanitized}</style>`;
 }
 
@@ -52,7 +53,7 @@ export function wrapInLayout(opts: {
   description?: string | null;
   branding?: BrandingTokens;
 }): string {
-  const themeStyle = opts.branding ? brandingStyleBlock(opts.branding) : "";
+  const themeStyleHtml = opts.branding ? brandingStyleBlock(opts.branding) : "";
   const header = opts.branding ? brandingHeaderHtml(opts.branding) : "";
   // Untrusted per-tenant CSS — scoped, allowlist-sanitized and host-contained
   // at the render boundary by tenantStyleBlock (same helper a custom wrapLayout
@@ -88,7 +89,7 @@ export function wrapInLayout(opts: {
   .brand-header a { display: flex; align-items: center; gap: 0.6rem; color: inherit; text-decoration: none; }
   .brand-logo { height: 2rem; width: auto; }
   .brand-title { font-weight: 600; font-size: 1.1rem; }
-</style>${themeStyle}${tenantStyle}
+</style>${themeStyleHtml}${tenantStyle}
 </head>
 <body>
 ${header}