@cosmicdrift/kumiko-samples 0.391.1 → 0.392.1

package/samples/apps/cap-billing-demo/bin/server.ts

@@ -1,12 +1,12 @@
-// Local dev-server für das cap-billing-demo Sample.
+// Local dev server for the cap-billing-demo sample.
 //
-// Demo-Story: Newsletter-Send mit per-Tier-Cap (free=10/month, pro=
-// 100/month). Mails landen im in-memory-transport, abrufbar über die
-// Helper aus @cosmicdrift/kumiko-bundled-features/mail-transport-inmemory.
+// Demo story: newsletter send with a per-tier cap (free=10/month, pro=
+// 100/month). Mails land in the in-memory transport, retrievable via the
+// helpers from @cosmicdrift/kumiko-bundled-features/mail-transport-inmemory.
 //
-// Vorbedingungen (siehe README): Postgres + Redis via `bun kumiko dev`;
-// Migrations via `bun kumiko migrate apply` (aktuell nur die Default-
-// Tabellen — das Demo nutzt keine eigene Entity-Projektion).
+// Prerequisites (see README): Postgres + Redis via `bun kumiko dev`;
+// migrations via `bun kumiko migrate apply` (currently only the default
+// tables — the demo has no entity projection of its own).
 
 import { runDevApp } from "@cosmicdrift/kumiko-dev-server";
 import type { TenantId } from "@cosmicdrift/kumiko-framework/engine";

package/samples/apps/cap-billing-demo/src/feature.ts

@@ -1,29 +1,29 @@
 // kumiko-feature-version: 1
 //
-// newsletter — Demo-Feature, das tier-engine + cap-counter + die
-// mail-foundation Plugin-API zusammenbringt.
+// newsletter — demo feature that brings together tier-engine + cap-counter + the
+// mail-foundation plugin API.
 //
-// **Was passiert beim send-Handler:**
-//   1. Pre-Call (via withCapEnforcement-Wrapper):
-//      a) Tenant-Tier aus ctx.config lesen
-//      b) Tier → cap-limit aus DEMO_TIER_MAP mappen
-//      c) enforceCapAndMaybeNotify ruft enforceCap → bei
-//         soft-hit-crossing den Notifier (sendet Warning-Mail über
-//         dieselbe mail-foundation, an den Admin) UND dispatched
+// **What happens in the send handler:**
+//   1. Pre-call (via the withCapEnforcement wrapper):
+//      a) Read the tenant tier from ctx.config
+//      b) Map tier → cap limit from DEMO_TIER_MAP
+//      c) enforceCapAndMaybeNotify calls enforceCap → on a
+//         soft-hit crossing the notifier (sends a warning mail via
+//         the same mail-foundation, to the admin) AND dispatches
 //         mark-soft-warned
-//   2. Inner Handler: createTransportForTenant → transport.send
-//   3. Post-Success: increment-cap-Counter um 1
+//   2. Inner handler: createTransportForTenant → transport.send
+//   3. Post-success: increment the cap counter by 1
 //
-// **Beobachtbar im InMemory-Inbox** (mail-transport-inmemory):
-//   - Die "echten" Newsletter-Mails (an event.payload.to)
-//   - Die Soft-Hit-Warning-Mails (an admin@tenant.demo, beim ersten
-//     überschreiten)
+// **Observable in the in-memory inbox** (mail-transport-inmemory):
+//   - The "real" newsletter mails (to event.payload.to)
+//   - The soft-hit warning mails (to admin@tenant.demo, on the first
+//     crossing)
 //
-// **Tier-Switching:** primary-source ist die `subscription`-row aus
-// billing-foundation (= produktiver Pfad: Stripe/Mollie webhook
-// schreibt → tier ändert sich). Fallback ist der config-key
-// "newsletter:config:tier" — den nutzt die Demo-README für manuelles
-// Switchen ohne Provider, plus tier-engine-only-Tests behalten so ihren
+// **Tier switching:** the primary source is the `subscription` row from
+// billing-foundation (= productive path: a Stripe/Mollie webhook
+// writes → the tier changes). The fallback is the config key
+// "newsletter:config:tier" — the demo README uses it for manual
+// switching without a provider, and tier-engine-only tests keep their
 // existing flow.
 
 import {
@@ -103,20 +103,20 @@ const innerSendHandler: WriteHandlerDef = {
 // =============================================================================
 
 /**
- * Tenant-Tier auflösen.
+ * Resolve the tenant tier.
  *
- * **Reihenfolge:**
- *   1. subscription-row aus billing-foundation (= produktiver
- *      Pfad). Wenn die row existiert, trumpft sie den config-fallback —
- *      auch im canceled-Status (= Tenant fällt auf free zurück, NICHT
- *      auf einen verwaisten config="pro"-override).
- *   2. config-key "newsletter:config:tier" (= Demo-README-Pfad ohne
- *      Provider; auch der tier-engine-only-Pfad der ursprünglichen
- *      Tests bleibt so grün).
+ * **Order:**
+ *   1. subscription row from billing-foundation (= productive
+ *      path). If the row exists, it beats the config fallback —
+ *      even in canceled status (= the tenant falls back to free, NOT
+ *      to an orphaned config="pro" override).
+ *   2. config key "newsletter:config:tier" (= demo README path without
+ *      a provider; the tier-engine-only path of the original
+ *      tests stays green too).
  *   3. Default "free".
  *
- * Whitelist-Filter via TIER_NAMES verhindert Tippos ("Pro" / "Premium"),
- * die sonst silent zu free fallen würden.
+ * The whitelist filter via TIER_NAMES prevents typos ("Pro" / "Premium")
+ * that would otherwise silently fall back to free.
  */
 function isValidTierName(value: string): value is TierName {
   return (TIER_NAMES as readonly string[]).includes(value);
@@ -143,8 +143,8 @@ async function resolveTier(ctx: ReservationContext): Promise<TierName> {
   return "free";
 }
 
-/** Notifier-Factory: bauen einen SoftHitNotifier der die Warnung über
- *  dieselbe mail-foundation an den Tenant-Admin schickt. */
+/** Notifier factory: builds a SoftHitNotifier that sends the warning via
+ *  the same mail-foundation to the tenant admin. */
 function buildSoftHitNotifier(ctx: ReservationContext): SoftHitNotifier {
   return async (info) => {
     const transport = await createTransportForTenant(
@@ -194,9 +194,9 @@ const wrappedSendHandler = withCapEnforcement(innerSendHandler, async (_event, c
 // =============================================================================
 
 export const newsletterFeature = defineFeature(FEATURE_NAME, (r) => {
-  // Hard-deps: mail-foundation für Plugin-API + config für tier-Wahl +
-  // cap-counter (transitiv via withCapEnforcement, aber explicit ist
-  // klarer für boot-Validator-Errors).
+  // Hard deps: mail-foundation for the plugin API + config for the tier choice +
+  // cap-counter (transitive via withCapEnforcement, but explicit is
+  // clearer for boot-validator errors).
   r.requires({ features: ["config"] });
   r.requires({ features: ["cap-counter"] });
   r.requires({ features: [createMailFoundationFeature().name] });
@@ -216,7 +216,7 @@ export const newsletterFeature = defineFeature(FEATURE_NAME, (r) => {
   r.writeHandler(wrappedSendHandler);
 });
 
-/** QN für den send-Handler — exportiert damit Tests + Clients ohne
- *  Hand-Ableitung zugreifen. */
+/** QN for the send handler — exported so tests + clients can access it
+ *  without deriving it by hand. */
 export const NEWSLETTER_SEND_QN = "newsletter:write:send";
 export const NEWSLETTER_TIER_CONFIG_KEY = "newsletter:config:tier";

package/samples/apps/cap-billing-demo/src/run-config.ts

@@ -1,22 +1,22 @@
-// Single source of truth für die Feature-Komposition der Demo-App.
+// Single source of truth for the feature composition of the demo app.
 //
-// **Mount-Order matters:** mail-foundation MUSS vor mail-transport-
-// inmemory stehen (`r.requires({ features: ["mail-foundation"] })` im Plugin); das
-// newsletter-feature kommt danach (es nutzt mail-foundation +
-// cap-counter). composeFeatures (auth-mode) ergänzt config + secrets +
-// auth-email-password automatisch.
+// **Mount order matters:** mail-foundation MUST come before mail-transport-
+// inmemory (`r.requires({ features: ["mail-foundation"] })` in the plugin); the
+// newsletter feature comes after (it uses mail-foundation +
+// cap-counter). composeFeatures (auth mode) adds config + secrets +
+// auth-email-password automatically.
 //
-// **Was hier gemountet wird:**
-//   - cap-counter            — Counter-Storage + Helpers
-//   - mail-foundation        — Plugin-Host für Transports
-//   - mail-transport-inmemory — Demo-Transport (kein SMTP nötig)
-//   - billing-foundation — Plugin-Host für Subscription-Provider
-//                               (Stripe/Mollie). Demo mountet Provider
-//                               nicht selbst — App-Owner ergänzt
+// **What is mounted here:**
+//   - cap-counter            — counter storage + helpers
+//   - mail-foundation        — plugin host for transports
+//   - mail-transport-inmemory — demo transport (no SMTP needed)
+//   - billing-foundation — plugin host for subscription providers
+//                               (Stripe/Mollie). The demo does not mount a provider
+//                               itself — the app owner adds
 //                               createSubscriptionStripeFeature(...) /
 //                               createSubscriptionMollieFeature(...) in
-//                               der eigenen run-config.
-//   - newsletter             — die Demo-Domain mit cap-aware send
+//                               their own run-config.
+//   - newsletter             — the demo domain with cap-aware send
 
 import { createBillingFoundationFeature } from "@cosmicdrift/kumiko-bundled-features/billing-foundation";
 import { createCapCounterFeature } from "@cosmicdrift/kumiko-bundled-features/cap-counter";
@@ -29,12 +29,12 @@ import { localeDe } from "@cosmicdrift/kumiko-locale-de";
 import { newsletterFeature } from "./feature";
 
 /**
- * Demo-App-Features.
+ * Demo app features.
  *
- * **createSecretsFeature() Single-Instance:** wird EINMAL beim
- * Module-Load aufgerufen. Konsumenten die `run-config.ts` mehrfach
- * importieren (bin/server.ts + Tests) kriegen via ESM-Module-Cache
- * dasselbe Feature-Objekt zurück.
+ * **createSecretsFeature() single instance:** is called ONCE at
+ * module load. Consumers that import `run-config.ts` several times
+ * (bin/server.ts + tests) get the same feature object back via the
+ * ESM module cache.
  */
 export const APP_FEATURES = [
   localeDe(),

package/samples/apps/cap-billing-demo/src/tier-map.ts

@@ -1,20 +1,20 @@
-// Tier-Map fuer das cap-billing-demo. Source-of-Truth fuer welcher
-// Tier wieviel darf — die feature.ts liest das hier zur Cap-Auflösung.
+// Tier map for the cap-billing-demo. Source of truth for which
+// tier may do how much — feature.ts reads it here for cap resolution.
 //
-// **Design-Wahl:** alle Tiers mounten dieselben Features (mail-
-// foundation + cap-counter + newsletter). Der Tier-Unterschied steckt
-// AUSSCHLIESSLICH in den Caps. So sehen Demo-User: gleicher Code-Pfad,
-// unterschiedliche Limits — exakt das Pattern, das eine echte Plattform
-// zwischen Free und Pro fährt.
+// **Design choice:** all tiers mount the same features (mail-
+// foundation + cap-counter + newsletter). The tier difference lives
+// EXCLUSIVELY in the caps. So demo users see: same code path,
+// different limits — exactly the pattern a real platform
+// runs between Free and Pro.
 
 import type { TierMap } from "@cosmicdrift/kumiko-bundled-features/tier-engine";
 
 /**
- * Cap-Shape der Demo-App. Zwei Caps:
- *   - newslettersPerMonth: Calendar-Period-Cap (1.-eines-Monats Reset)
- *   - aiSummariesPer7Days: Rolling-Window-Cap (Drift-pin: zeigt dass
- *     beide Cap-Profile parallel funktionieren — auch wenn der
- *     Demo-Code aiSummaries gerade nicht implementiert)
+ * Cap shape of the demo app. Two caps:
+ *   - newslettersPerMonth: calendar-period cap (reset on the 1st of the month)
+ *   - aiSummariesPer7Days: rolling-window cap (drift pin: shows that
+ *     both cap profiles work in parallel — even though the
+ *     demo code does not implement aiSummaries yet)
  */
 export type DemoCaps = {
   readonly newslettersPerMonth: number;
@@ -25,8 +25,8 @@ export const DEMO_TIER_MAP: TierMap<DemoCaps> = {
   free: {
     features: [],
     caps: {
-      // Bei limit=10: soft@11 (1.1×), hard@12 (1.2×). Demo-Test feuert
-      // 11× → soft-hit, 12× → hard-block. Saubere Bands für die Story.
+      // At limit=10: soft@11 (1.1×), hard@12 (1.2×). The demo test fires
+      // 11× → soft-hit, 12× → hard-block. Clean bands for the story.
       newslettersPerMonth: 10,
       aiSummariesPer7Days: 0,
     },

package/samples/apps/config-demo/src/app/server.ts

@@ -1,9 +1,9 @@
 // @runtime dev
 //
-// Sample-Server für config-demo. Importiert runDevApp aus dev-server
-// → muss explizit als [dev]-File markiert sein, weil das Default
-// (samples/apps/<x>/src/app/server.ts) ohne directive als [runtime]
-// klassifiziert wird und [runtime]→[dev] vom Isolation-Guard blockt.
+// Sample server for config-demo. Imports runDevApp from dev-server
+// → must be explicitly marked as a [dev] file, because the default
+// (samples/apps/<x>/src/app/server.ts) without a directive is classified as [runtime]
+// and [runtime]→[dev] is blocked by the isolation guard.
 
 import {
   createConfigAccessorFactory,

package/samples/apps/config-demo/src/features/demo/feature.ts

@@ -31,10 +31,10 @@ const REQUIRED_I18N = {
   "screen:config-demo-user.title": { de: "Persönlich", en: "Personal" },
 } as const;
 
-// Self-Populating Settings-Hub: jeder Key mit `mask` erscheint automatisch im
-// Hub — kein r.screen/r.nav mehr. buildConfigFeatureSchema gruppiert nach Scope
-// (Plattform/Organisation/Persönlich) und leitet Felder aus dem Key-Typ ab.
-// mask.title ist der i18n-Key des Feld-Labels, mask.order die Reihenfolge.
+// Self-populating settings hub: every key with `mask` appears automatically in the
+// hub — no more r.screen/r.nav. buildConfigFeatureSchema groups by scope
+// (platform/organization/personal) and derives fields from the key type.
+// mask.title is the i18n key of the field label, mask.order the order.
 export const configDemoFeature = defineFeature("config-demo", (r) => {
   r.translations({ keys: REQUIRED_I18N });
   r.requires({ features: ["config"] });

package/samples/apps/marketing-demo/playwright.config.ts

@@ -1,7 +1,7 @@
 // @runtime test
-// Playwright-Config für Marketing-Demo. Generiert Screenshots aus den
-// echten gerenderten Pages (Asset-Tracker + Helpdesk) in das konfigurierte
-// Screenshot-Verzeichnis.
+// Playwright config for the marketing demo. Generates screenshots from the
+// actually rendered pages (asset tracker + helpdesk) into the configured
+// screenshot directory.
 
 import { defineAppE2eConfig, PLAYWRIGHT_DEMO_ENV } from "@cosmicdrift/kumiko-testing/e2e";
 import { E2E_PORTS } from "../../e2e/e2e-ports";

package/samples/apps/marketing-demo/src/app/client.tsx

@@ -1,5 +1,5 @@
-// Browser-Entry für Marketing-Demo. Zwei Features (assets, helpdesk),
-// shared shell, alles aus dem Framework-Default.
+// Browser entry for the marketing demo. Two features (assets, helpdesk),
+// shared shell, everything from the framework defaults.
 
 import { localeDeClient } from "@cosmicdrift/kumiko-locale-de/web";
 import { createKumikoApp } from "@cosmicdrift/kumiko-renderer/web";

package/samples/apps/marketing-demo/src/app/seed-data.ts

@@ -1,11 +1,11 @@
-// Reine Daten für den Marketing-Seed — Templates + Personen-Listen.
-// Logik und Random-Erzeugung leben in seed.ts. Trennung weil sich
-// Daten häufiger ändern als Logik (mehr Items, andere Namen) und der
-// Diff-Lärm den Seed-Algorithmus nicht überlagern soll.
+// Pure data for the marketing seed — templates + people lists.
+// Logic and random generation live in seed.ts. Split because
+// data changes more often than logic (more items, different names) and the
+// diff noise should not drown out the seed algorithm.
 //
-// Type-Felder leiten direkt aus den Schema-Konstanten ab (AssetType,
-// AssetDepartment, etc.) — Schema-Änderung an den `options` macht hier
-// sofort einen Compile-Error, kein silent drift.
+// Type fields derive directly from the schema constants (AssetType,
+// AssetDepartment, etc.) — a schema change to the `options` causes
+// an immediate compile error here, no silent drift.
 
 import type { AssetDepartment, AssetType } from "../features/assets/schema";
 import type { TicketCategory, TicketDepartment } from "../features/helpdesk/schema";
@@ -302,8 +302,8 @@ export const ASSET_TEMPLATES: ReadonlyArray<AssetTemplate> = [
   },
 ];
 
-// Erste Position leer → Math.floor(r() * length) kann „nicht ausgeliehen"
-// treffen ohne Sonderfall. Wird nur für status==="lent" konsultiert.
+// First position empty → Math.floor(r() * length) can hit "not lent"
+// without a special case. Only consulted for status==="lent".
 export const OWNERS: ReadonlyArray<string> = [
   "",
   "Alex Morgan",

package/samples/apps/marketing-demo/src/app/seed.ts

@@ -1,12 +1,12 @@
-// Seed für Marketing-Demo. Plausible Daten — Asset-Tracker mit ~30
-// realistischen Items (Laptops, Drucker, Werkzeuge), Helpdesk mit ~20
-// echten-aussehenden Tickets. Geht durch den normalen Dispatcher
-// (assets:write:asset:create, helpdesk:write:ticket:create) damit alle
-// Pipeline-Stufen (Validation, Audit, Search-Index) wie bei echten
-// Requests laufen.
+// Seed for the marketing demo. Plausible data — asset tracker with ~30
+// realistic items (laptops, printers, tools), helpdesk with ~20
+// real-looking tickets. Goes through the normal dispatcher
+// (assets:write:asset:create, helpdesk:write:ticket:create) so all
+// pipeline stages (validation, audit, search index) run as with real
+// requests.
 //
-// Daten leben in seed-data.ts (Templates + Personen-Listen). Hier bleibt
-// nur Logik: Random-Generator, Datums-Helper, der eigentliche Seed.
+// Data lives in seed-data.ts (templates + people lists). Only logic
+// stays here: random generator, date helper, the actual seed.
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
@@ -23,8 +23,8 @@ import {
   TICKET_TEMPLATES,
 } from "./seed-data";
 
-// YYYY-MM-DD-Helper über Temporal.PlainDate — Date-API ist im Repo per
-// No-Date-API-Guard verboten.
+// YYYY-MM-DD helper via Temporal.PlainDate — the Date API is banned in the repo by the
+// no-Date-API guard.
 function formatPlainDate(year: number, month: number, day: number): string {
   return Temporal.PlainDate.from({ year, month, day }).toString();
 }
@@ -103,17 +103,17 @@ export const seedMarketingDemo: SeedFn = async (stack) => {
   const existingTickets = await countTicketsForTenant(stack.db, tenantId);
   if (existingTickets < 10) {
     const r = rng(7);
-    // Anker für dueDate: 2026-05-01 — bewusst konstant, damit Screenshots
-    // reproduzierbar bleiben (auch wenn der Seed später läuft).
+    // Anchor for dueDate: 2026-05-01 — deliberately constant so screenshots
+    // stay reproducible (even if the seed runs later).
     const today = Temporal.PlainDate.from({ year: 2026, month: 5, day: 1 });
     for (const tpl of TICKET_TEMPLATES) {
       const severity = pick(TICKET_SEVERITIES, r, "medium");
       const status = pick(TICKET_STATUSES, r, "open");
       const reporter = pick(REPORTERS, r, "Anna Weber");
       const assignee = pick(ASSIGNEES, r, "");
-      // dueDate: -3 bis +14 Tage — Mix aus überfällig + bald.
+      // dueDate: -3 to +14 days — mix of overdue + soon.
       const dueDate = today.add({ days: Math.floor(r() * 18) - 3 }).toString();
-      // spentMinutes: 0 für offene, mehr für bearbeitete/gelöste.
+      // spentMinutes: 0 for open, more for in-progress/resolved.
       const spentMinutes =
         status === "open"
           ? Math.floor(r() * 15)

package/samples/apps/marketing-demo/src/app/server.ts

@@ -1,11 +1,11 @@
 // @runtime dev
 //
-// Dev-Server für Marketing-Demo. KEIN Auth — wie showcase, Auto-Mint-
-// JWT (TestUsers.admin) damit Marketing-Screenshots ohne Login-Reibung
-// gemacht werden können. Cream/Light Theme via styles.css.
+// Dev server for the marketing demo. NO auth — like showcase, auto-mint
+// JWT (TestUsers.admin) so marketing screenshots can be made
+// without login friction. Cream/light theme via styles.css.
 //
-// Zwei Features (Assets + Helpdesk) auf einer Instanz — beweist
-// Marketing-Story „mehrere kleine Apps, eine Plattform".
+// Two features (assets + helpdesk) on one instance — proves the
+// marketing story "several small apps, one platform".
 
 import { runDevApp } from "@cosmicdrift/kumiko-dev-server";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
@@ -15,8 +15,8 @@ import { seedMarketingDemo } from "./seed";
 
 await runDevApp({
   features: [localeDe(), assetsFeature, helpdeskFeature],
-  // PORT-env überschreibbar — Playwright e2e nutzt eigenen Port (4179)
-  // damit dev-mode (4178) parallel laufen kann.
+  // PORT env overridable — Playwright e2e uses its own port (4179)
+  // so dev mode (4178) can run in parallel.
   port: Number.parseInt(process.env["PORT"] ?? "4178", 10),
   clientEntry: "./src/app/client.tsx",
   htmlPath: "./public/index.html",

package/samples/apps/marketing-demo/src/app/shell.tsx

@@ -1,6 +1,6 @@
-// AppShell für Marketing-Demo. DefaultAppShell mit Brand-Wortmarke
-// „Kumiko Demo", Light-Mode-default (kein Theme-Toggle für screenshots
-// damit immer der gleiche Look).
+// AppShell for the marketing demo. DefaultAppShell with brand wordmark
+// "Kumiko Demo", light mode default (no theme toggle for screenshots
+// so the look is always the same).
 
 import { type AppSchema, DefaultAppShell } from "@cosmicdrift/kumiko-renderer/web";
 import type { ReactNode } from "react";

package/samples/apps/marketing-demo/src/features/assets/feature.ts

@@ -1,6 +1,6 @@
-// Assets-Feature — Server-Side. Schema-driven Asset-Tracker für die
-// Marketing-Demo. defineFeature registriert Entity + CRUD-Handler +
-// Screens. Audit + Multi-Tenant kommen aus dem Framework-Default.
+// Assets feature — server side. Schema-driven asset tracker for the
+// marketing demo. defineFeature registers entity + CRUD handlers +
+// screens. Audit + multi-tenancy come from the framework defaults.
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import type { TranslationValue } from "@cosmicdrift/kumiko-framework/ui-types";

package/samples/apps/marketing-demo/src/features/assets/i18n.ts

@@ -1,11 +1,11 @@
-// Assets-Feature i18n-Bundle. Convention: feature-prefix `assets:`
-// + `entity:asset:field:<name>` für Field-Labels (Spalten + Form),
-// `screen:<id>.title` für Page-Titles, `assets:nav.<id>` für
-// Sidebar-Labels.
+// Assets feature i18n bundle. Convention: feature prefix `assets:`
+// + `entity:asset:field:<name>` for field labels (columns + form),
+// `screen:<id>.title` for page titles, `assets:nav.<id>` for
+// sidebar labels.
 //
-// Plus: Select-Options bekommen lesbare Labels via
-// `assets:entity:asset:field:<field>:option:<value>` damit „lent"
-// nicht raw als „lent" im Screenshot landet.
+// Plus: select options get readable labels via
+// `assets:entity:asset:field:<field>:option:<value>` so "lent"
+// does not land raw as "lent" in the screenshot.
 
 import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
 

package/samples/apps/marketing-demo/src/features/assets/web/index.ts

@@ -1,5 +1,5 @@
-// Assets — ClientFeatureDefinition. Pure Schema-driven, keine Custom-
-// Components. Render läuft über Standard-RenderList + RenderEdit.
+// Assets — ClientFeatureDefinition. Purely schema-driven, no custom
+// components. Rendering goes through the standard RenderList + RenderEdit.
 
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { assetsTranslations } from "../i18n";

package/samples/apps/showcase/src/app/client.tsx

@@ -1,6 +1,6 @@
-// Browser-Entry. Dünn — sammelt nur die ClientFeatureDefinitions aus
-// den App-Features und übergibt Shell + clientFeatures an
-// createKumikoApp. Custom-Screen-Routing macht das Framework selbst
+// Browser entry. Thin — only collects the ClientFeatureDefinitions from
+// the app features and hands shell + clientFeatures to
+// createKumikoApp. The framework does custom-screen routing itself
 // via clientFeatures.components.
 
 import { localeDeClient } from "@cosmicdrift/kumiko-locale-de/web";

package/samples/apps/showcase/src/app/seed-items.ts

@@ -1,20 +1,20 @@
-// Seed für die Showcase-Item-Liste — ~200 items damit der Pager 4
-// Seiten hat zum Durchklicken (pageSize: 50). Geht durch den normalen
-// Dispatcher (showcase:write:item:create) — das hängt sich an alle
-// Pipeline-Stufen (Validation, Field-Defaults, Read-Side-Update,
-// Search-Index, Audit) genau wie ein echter HTTP-Request, also bricht
-// auch nicht wenn das Schema sich ändert (softDelete, neue Felder).
+// Seed for the showcase item list — ~200 items so the pager has 4
+// pages to click through (pageSize: 50). Goes through the normal
+// dispatcher (showcase:write:item:create) — that hooks into all
+// pipeline stages (validation, field defaults, read-side update,
+// search index, audit) just like a real HTTP request, so it does not
+// break when the schema changes (softDelete, new fields).
 //
-// Idempotent: wenn schon ≥100 items existieren, skip — der Server wird
-// bei jedem Restart neu geseeded sonst.
+// Idempotent: if ≥100 items already exist, skip — otherwise the server is
+// re-seeded on every restart.
 
 import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
 import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 const STATUSES = ["draft", "active", "blocked", "done"] as const;
 
-// Determinist-Pseudo-Random damit Seeds reproduzierbar sind. Mulberry32
-// reicht für Demo-Distribution; kein Crypto, kein "echter" Zufall.
+// Deterministic pseudo-random so seeds are reproducible. Mulberry32
+// is enough for demo distribution; no crypto, no "real" randomness.
 function mulberry32(seed: number): () => number {
   let s = seed;
   return () => {
@@ -83,10 +83,10 @@ export const seedShowcaseItems: SeedFn = async (stack) => {
     const priority = Math.min(5, Math.floor(rng() * rng() * 6) + 1);
     const dueOffsetDays = Math.floor(rng() * 90) - 30;
     const due = now.add({ hours: dueOffsetDays * 24 });
-    // Zod-Validation für type:"date" verlangt YYYY-MM-DD (siehe
-    // schema-builder buildInsertSchema). dialect.toDriver() coercd das
-    // zu start-of-day UTC bevor die DB es sieht — Caller-API bleibt
-    // wie der Author sie erwartet.
+    // Zod validation for type:"date" requires YYYY-MM-DD (see
+    // schema-builder buildInsertSchema). dialect.toDriver() coerces that
+    // to start-of-day UTC before the DB sees it — the caller API stays
+    // as the author expects it.
     const dueDate = due.toString().slice(0, 10);
 
     const res = await stack.http.write(

package/samples/apps/showcase/src/app/server.ts

@@ -1,9 +1,9 @@
 // @runtime dev
 //
-// Dev-Server für den Showcase. KEIN Auth — der Showcase ist eine UI-
-// Primitive-Spielwiese, Login-Reibung ist hier kontraproduktiv. Auto-
-// Mint-JWT-Mode aktiv (TestUsers.admin) → direkt im Edit-Screen.
-// Wer Auth-Pfade testen will: ui-walkthrough oder workspaces.
+// Dev server for the showcase. NO auth — the showcase is a UI
+// primitive playground, login friction is counterproductive here. Auto-
+// mint JWT mode active (TestUsers.admin) → straight into the edit screen.
+// To test auth paths: ui-walkthrough or workspaces.
 
 import { runDevApp } from "@cosmicdrift/kumiko-dev-server";
 import { localeDe } from "@cosmicdrift/kumiko-locale-de";
@@ -14,7 +14,7 @@ import { seedShowcaseItems } from "./seed-items";
 
 await runDevApp({
   features: [localeDe(), itemsFeature, demosFeature],
-  // PORT-env überschreibbar — konsistent zu publicstatus / ui-walkthrough.
+  // PORT env overridable — consistent with publicstatus / ui-walkthrough.
   port: Number.parseInt(process.env["PORT"] ?? "4175", 10),
   clientEntry: "./src/app/client.tsx",
   htmlPath: "./public/index.html",
@@ -24,7 +24,7 @@ await runDevApp({
   // existierenden packages/*/src — bei neuen Packages muss man nichts
   // anpassen.
   watchDirs: ["./src", "../../../packages/*/src"],
-  // ~200 Items damit der Pager (pageSize 50) was zum Blättern hat.
-  // Idempotent — re-running den dev-server seedet nicht doppelt.
+  // ~200 items so the pager (pageSize 50) has something to page through.
+  // Idempotent — re-running the dev server does not seed twice.
   seeds: [seedShowcaseItems],
 });