@cosmicdrift/kumiko-samples 0.391.1 → 0.392.0

package/samples/apps/showcase/src/features/demos/feature.ts

@@ -1,14 +1,14 @@
-// Demos-Feature — Server-Side. Registriert custom-Screens für die UI-
-// Demo-Pages (Buttons, Inputs, Banner, Text, Layout) und ihre Nav-
-// Einträge. Kein Entity, keine Handler — pure Custom-Screen-Showcase.
+// Demos feature — server side. Registers custom screens for the UI
+// demo pages (buttons, inputs, banner, text, layout) and their nav
+// entries. No entity, no handlers — pure custom-screen showcase.
 //
-// FeatureName "showcase-demos" (nicht "showcase"): zwei defineFeature-
-// Aufrufe mit gleichem Namen würden in createRegistry mit
-// `Duplicate feature` werfen. Der Trennstrich zur items-Feature ist
-// also nicht Konvention-Geschmack, sondern technische Notwendigkeit.
+// FeatureName "showcase-demos" (not "showcase"): two defineFeature
+// calls with the same name would throw `Duplicate feature` in
+// createRegistry. The hyphen separating it from the items feature is
+// therefore not a matter of convention taste but a technical necessity.
 //
-// Die React-Components für die custom-Screens leben in pages/ und
-// werden client-side via clientFeatures.components zugeordnet (siehe
+// The React components for the custom screens live in pages/ and
+// are assigned client-side via clientFeatures.components (see
 // client.ts).
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
@@ -95,11 +95,11 @@ export const demosFeature = defineFeature("showcase-demos", (r) => {
       "Shows the SidebarPanel shell slot as a mail-client inbox: a resizable message list beside the navigation over the full window height, with the selected message read in the content area.",
   });
 
-  // Section "Primitives" — clickbar-collapsible weil parent ohne screen.
+  // Section "Primitives" — click-to-collapse because the parent has no screen.
   //
-  // Jeder Eintrag traegt ein Icon: auf Icon-Breite ist es das Einzige, was
-  // von ihm uebrig bleibt. Ohne Icon steht dort nur ein Punkt, und eine Rail
-  // aus gleichen Punkten sagt nicht, wo man hinklickt.
+  // Every entry carries an icon: at icon width it is the only thing that
+  // remains of it. Without an icon only a dot shows there, and a rail
+  // of identical dots does not say where to click.
   r.nav({ id: "primitives", label: "showcase-demos:nav.primitives", icon: "layers", order: 10 });
   r.nav({
     id: "demo-layout",

package/samples/apps/showcase/src/features/demos/i18n.ts

@@ -1,5 +1,5 @@
-// Demos-Feature i18n-Bundle. Nur die Screen-Titles für die
-// Top-Action-Bars der Demo-Pages.
+// Demos feature i18n bundle. Only the screen titles for the
+// top action bars of the demo pages.
 
 import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
 

package/samples/apps/showcase/src/features/demos/web/components/page.tsx

@@ -1,6 +1,6 @@
-// Shared Page-Layout für die Demo-Custom-Screens. Kein Framework-
-// Konzept — reines Sample-Layout, das die Top-Action-Bar Convention
-// (h-12, bg-muted/30, border-b) konsistent mit Form/Liste hält.
+// Shared page layout for the demo custom screens. Not a framework
+// concept — pure sample layout that keeps the top action bar convention
+// (h-12, bg-muted/30, border-b) consistent with form/list.
 
 import { usePrimitives } from "@cosmicdrift/kumiko-renderer";
 import type { ReactNode } from "react";
@@ -32,8 +32,8 @@ export function DemoPage({
   );
 }
 
-// Section innerhalb einer Demo-Page: Card-Primitive (Standard-Chrome). Samples
-// sind Copy-Vorlage für Agenten → dieselbe Card wie überall, kein Sonder-Layout.
+// Section within a demo page: Card primitive (standard chrome). Samples
+// are a copy template for agents → the same card as everywhere, no special layout.
 export function DemoSection({
   title,
   children,

package/samples/apps/showcase/src/features/demos/web/index.ts

@@ -1,7 +1,7 @@
-// Demos-Feature — Web-Plattform-Plugin. ClientFeatureDefinition mit
-// den React-DOM-Components für die custom-Screens. createKumikoApp
-// merged das in den CustomScreens-Context, KumikoScreen schaut darin
-// nach wenn ein Schema-Screen `type: "custom"` hat.
+// Demos feature — web platform plugin. ClientFeatureDefinition with
+// the React DOM components for the custom screens. createKumikoApp
+// merges that into the CustomScreens context, KumikoScreen looks there
+// when a schema screen has `type: "custom"`.
 
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { demosTranslations } from "../i18n";

package/samples/apps/showcase/src/features/demos/web/pages/dialog.tsx

@@ -62,7 +62,7 @@ export function DialogDemo(): ReactNode {
       </DemoSection>
 
       <DemoSection title="Lightbox">
-        {/* kumiko-lint-ignore primitives-discipline clickable image thumbnail (Lightbox-Trigger) — kein Text-Button, <Button> kann kein Full-Bleed-<img> wrappen */}
+        {/* kumiko-lint-ignore primitives-discipline clickable image thumbnail (lightbox trigger) — not a text button, <Button> cannot wrap a full-bleed <img> */}
         <button
           type="button"
           onClick={() => setLightboxOpen(true)}

package/samples/apps/showcase/src/features/demos/web/pages/inputs.tsx

@@ -2,9 +2,9 @@ import { usePrimitives } from "@cosmicdrift/kumiko-renderer";
 import { type ReactNode, useMemo, useState } from "react";
 import { DemoPage, DemoSection } from "../components/page";
 
-// Combobox-Demo-Daten: 3 Items mit unterschiedlichen Anfangsbuchstaben.
-// Tippt der User "A", muss "API" als einzige übrig bleiben — Regression-
-// Surface für den Bug "Suche filtert alles weg".
+// Combobox demo data: 3 items with different initial letters.
+// If the user types "A", only "API" must remain — regression
+// surface for the bug "search filters everything away".
 const COMBOBOX_OPTIONS = [
   { value: "api", label: "API" },
   { value: "backend", label: "Backend" },
@@ -27,11 +27,11 @@ export function InputsDemo(): ReactNode {
   const [comboMultiLocal, setComboMultiLocal] = useState<readonly string[]>([]);
   const [comboSingleRemote, setComboSingleRemote] = useState("");
   const [comboMultiRemote, setComboMultiRemote] = useState<readonly string[]>([]);
-  // Remote-Mode-Simulation: Caller erhält den Suchbegriff via
-  // onSearchChange und filtert die options selbst — Combobox bekommt
-  // "shouldFilter=false"-Mode (cmdk filtert nicht client-side, Caller
-  // ist authoritative für Sichtbarkeit). Production-Setup würde den
-  // Suchbegriff an den Server schicken, hier filtern wir im Memory.
+  // Remote-mode simulation: the caller receives the search term via
+  // onSearchChange and filters the options itself — Combobox gets
+  // "shouldFilter=false" mode (cmdk does not filter client-side, the caller
+  // is authoritative for visibility). A production setup would send the
+  // search term to the server, here we filter in memory.
   const [remoteQ, setRemoteQ] = useState("");
   const remoteOptions = useMemo(() => {
     if (remoteQ === "") return COMBOBOX_OPTIONS;

package/samples/apps/showcase/src/features/demos/web/pages/layout.tsx

@@ -1,9 +1,9 @@
-// Layout-Demo: Slot-Visualisierung. Pro Primitive ein Mini-Diagramm
-// der Boxen + Slot-Namen drin, plus ein Code-Snippet darunter das
-// zeigt wie der Slot aus dem Caller heraus angesprochen wird.
+// Layout demo: slot visualization. One mini diagram per primitive
+// of the boxes + slot names inside, plus a code snippet below that
+// shows how the slot is addressed from the caller.
 //
-// Die Skizzen sind absichtlich Sample-Code mit raw <div> + Tailwind —
-// hier geht's um ein Bild, nicht um die Primitives selbst zu zeigen.
+// The sketches are deliberately sample code with raw <div> + Tailwind —
+// the point here is a picture, not showing the primitives themselves.
 
 import type { ReactNode } from "react";
 import { DemoPage, DemoSection } from "../components/page";

package/samples/apps/showcase/src/features/demos/web/pages/toast.tsx

@@ -3,9 +3,9 @@ import { useToast } from "@cosmicdrift/kumiko-renderer/web";
 import { type ReactNode, useState } from "react";
 import { DemoPage, DemoSection } from "../components/page";
 
-// Toast-Demo. useToast() ist die einzige Public-API — der ToastProvider
-// ist im createKumikoApp gemountet, jeder Component innerhalb darf
-// toasts pushen ohne sich um State/Mounting zu kümmern.
+// Toast demo. useToast() is the only public API — the ToastProvider
+// is mounted in createKumikoApp, every component inside may
+// push toasts without caring about state/mounting.
 
 export function ToastDemo(): ReactNode {
   const { toast } = useToast();

package/samples/apps/showcase/src/features/items/feature.ts

@@ -1,11 +1,11 @@
-// Items-Feature — Server-Side. defineFeature() registriert die Entity,
-// die Standard-CRUD-Handler und die Schema-Items aus schema.ts. KEIN
-// Custom-Server-Code (keine Hooks/Projections); das Feature ist
-// bewusst minimal und zeigt den "kitchen-sink Entity"-Pfad ohne
-// Domain-Logik.
+// Items feature — server side. defineFeature() registers the entity,
+// the standard CRUD handlers and the schema items from schema.ts. NO
+// custom server code (no hooks/projections); the feature is
+// deliberately minimal and shows the "kitchen-sink entity" path without
+// domain logic.
 //
-// Beidseitig benutzte Schema-Definitionen leben in schema.ts. Server
-// hängt hier die Handler dran und ruft r.screen/r.nav.
+// Schema definitions used on both sides live in schema.ts. The server
+// attaches the handlers here and calls r.screen/r.nav.
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
@@ -65,7 +65,7 @@ export const itemsFeature = defineFeature("showcase", (r) => {
   r.screen(itemActiveScreen);
   r.screen(itemQuickAddScreen);
 
-  // Section "Data" — clickbar zum Auf/Zuklappen weil parent ohne screen.
+  // Section "Data" — click to expand/collapse because the parent has no screen.
   r.nav({ id: "data", label: "showcase:nav.data", icon: "table", order: 100 });
   r.nav({
     id: "item-list",

package/samples/apps/showcase/src/features/items/i18n.ts

@@ -1,6 +1,6 @@
-// Items-Feature i18n-Bundle. Convention: feature-prefix per
-// `showcase:` + `entity:item:field:<name>` für Field-Labels. Plus
-// die zwei Nav-Labels die in feature.ts referenziert werden.
+// Items feature i18n bundle. Convention: feature prefix per
+// `showcase:` + `entity:item:field:<name>` for field labels. Plus
+// the two nav labels referenced in feature.ts.
 
 import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
 

package/samples/apps/showcase/src/features/items/index.ts

@@ -1,6 +1,6 @@
-// Public-Surface des Items-Features. Server importiert `itemsFeature`,
-// Web-Client importiert `itemsClient`. schema/ ist intern, wird nicht
-// re-exported — nur feature.ts und web/index.ts dürfen darauf zugreifen.
+// Public surface of the items feature. The server imports `itemsFeature`,
+// the web client imports `itemsClient`. schema/ is internal, not
+// re-exported — only feature.ts and web/index.ts may access it.
 
 export { itemsFeature } from "./feature";
 export { itemsClient } from "./web";

package/samples/apps/showcase/src/features/items/schema/index.ts

@@ -1,7 +1,7 @@
-// Re-exports — eine Datei pro Entity, Index sammelt sie. So kann
-// das Feature später weitere Entities (z.B. tag.ts, comment.ts)
-// hinzufügen ohne dass feature.ts oder web/index.ts ihre Imports
-// ändern müssen.
+// Re-exports — one file per entity, the index collects them. That way
+// the feature can later add further entities (e.g. tag.ts, comment.ts)
+// without feature.ts or web/index.ts having to change
+// their imports.
 
 export {
   itemActiveScreen,

package/samples/apps/showcase/src/features/items/schema/item.ts

@@ -69,8 +69,8 @@ export const itemEditScreen: EntityEditScreenDefinition = {
         title: "References (Tier 2.7e Remote-Combobox-Demo)",
         columns: 1,
         fields: [
-          // Single + Remote — Bug-Test-Surface 1: Click auf Dropdown-Item
-          // muss onChange feuern (selektiert das Item, schließt das Popup).
+          // Single + remote — bug test surface 1: click on a dropdown item
+          // must fire onChange (selects the item, closes the popup).
           "parentId",
           // Multi + Remote — Bug-Test-Surface 2: Tippen filtert die Liste
           // serverseitig. Mit ~200 seed-Items echte Search-Last.
@@ -110,18 +110,18 @@ export const itemListScreen: EntityListScreenDefinition = {
     // auf item:list (limit:200), zeigt parentId als parent.title.
     { field: "parentId", hideOnNarrow: true },
   ],
-  // Server-side Pagination Demo — Showcase seedet ~200 items, der
-  // Pager hat 4 Seiten zum Durchklicken bei pageSize: 50.
+  // Server-side pagination demo — the showcase seeds ~200 items, the
+  // pager has 4 pages to click through at pageSize: 50.
   pagination: "pages",
   pageSize: 50,
   defaultSort: { field: "title", dir: "asc" },
   searchable: true,
-  // RowActions-Demo. Default-Payload ist `{ id: row.id }` — reicht für
-  // delete. Confirm-Dialog wegen style="danger" automatisch.
-  // Tier 2.7e-1 zeigt "navigate"-kind: ein zweiter Action-Button der
-  // statt Server-Call zu einem actionForm springt + die row.id als
-  // URL-Param übergibt (das actionForm liest sie via searchParams als
-  // initial value für ein title-Feld).
+  // RowActions demo. The default payload is `{ id: row.id }` — enough for
+  // delete. Confirm dialog automatically because of style="danger".
+  // Tier 2.7e-1 shows the "navigate" kind: a second action button that
+  // jumps to an actionForm instead of making a server call + passes row.id as a
+  // URL param (the actionForm reads it via searchParams as an
+  // initial value for a title field).
   rowActions: [
     { kind: "navigate", id: "edit", label: "showcase:actions.edit", screen: "item-edit" },
     {
@@ -129,7 +129,7 @@ export const itemListScreen: EntityListScreenDefinition = {
       id: "duplicate",
       label: "showcase:actions.duplicate",
       screen: "item-quick-add",
-      // DSL-Limit: kein "Copy of"-Prefix darstellbar → server-side im Handler lösen.
+      // DSL limit: no "Copy of" prefix expressible → solve server-side in the handler.
       params: { pick: ["title", "priority"] },
     },
     {
@@ -159,7 +159,7 @@ export const itemFeedScreen: EntityListScreenDefinition = {
     "dueDate",
   ],
   pagination: "infinite",
-  pageSize: 30, // kleinere Pages damit Scroll-Effekt häufiger triggert
+  pageSize: 30, // smaller pages so the scroll effect triggers more often
   defaultSort: { field: "title", dir: "asc" },
   searchable: true,
   rowActions: [
@@ -167,10 +167,10 @@ export const itemFeedScreen: EntityListScreenDefinition = {
   ],
 };
 
-// Tier 2.7c Demo — Screen-Level Filter. Selbe Entity, gleicher Query-
-// Handler wie itemListScreen, aber mit fixem WHERE: nur Items mit
-// status="active". Klassisches Bucketing-Pattern (z.B. "Active Tasks"
-// vs "All Tasks") ohne Custom-Page schreiben zu müssen.
+// Tier 2.7c demo — screen-level filter. Same entity, same query
+// handler as itemListScreen, but with a fixed WHERE: only items with
+// status="active". Classic bucketing pattern (e.g. "Active Tasks"
+// vs "All Tasks") without having to write a custom page.
 export const itemActiveScreen: EntityListScreenDefinition = {
   id: "item-active",
   type: "entityList",
@@ -186,18 +186,18 @@ export const itemActiveScreen: EntityListScreenDefinition = {
   ],
 };
 
-// Tier 2.7d Demo — actionForm Screen-Typ. Non-CRUD Write-Handler-
-// driven Form, hier mit dem existing item:create-Handler aber
-// reduzierter Field-Auswahl (nur title + priority). Demonstriert dass
-// eine actionForm:
-//   - keine Entity-Reference braucht (fields sind inline)
-//   - einen beliebigen Write-Handler-QN triggert (hier item:create,
-//     üblich wäre auch sowas wie item:archive-batch oder
-//     invoice:approve mit dedizierten Handlern)
-//   - nach Submit redirecten kann (hier zur Liste)
+// Tier 2.7d demo — actionForm screen type. A non-CRUD write-handler-
+// driven form, here with the existing item:create handler but a
+// reduced field selection (only title + priority). Demonstrates that
+// an actionForm:
+//   - needs no entity reference (fields are inline)
+//   - triggers any write handler QN (here item:create,
+//     something like item:archive-batch or
+//     invoice:approve with dedicated handlers would be typical)
+//   - can redirect after submit (here to the list)
 //
-// Default-Werte greifen für nicht-Form-Felder: status=draft, isDone=
-// false, priority kommt aus dem Form, notes/dueDate optional.
+// Default values apply for non-form fields: status=draft, isDone=
+// false, priority comes from the form, notes/dueDate optional.
 export const itemQuickAddScreen: ActionFormScreenDefinition = {
   id: "item-quick-add",
   type: "actionForm",

package/samples/apps/showcase/src/features/items/web/index.ts

@@ -1,10 +1,10 @@
-// Items-Feature — Web-Plattform-Plugin. ClientFeatureDefinition mit
-// Translations. Items hat heute keine Custom-Screen-Components
-// (rendert über Standard-RenderEdit/RenderList), entsprechend keine
-// `components`-Map.
+// Items feature — web platform plugin. ClientFeatureDefinition with
+// translations. Items currently has no custom-screen components
+// (renders via the standard RenderEdit/RenderList), accordingly no
+// `components` map.
 //
-// Native-Plattform würde parallel dazu in features/items/native/
-// liegen — translations werden geteilt, components/UI nicht.
+// A native platform would live alongside it in features/items/native/
+// — translations are shared, components/UI are not.
 
 import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { itemsTranslations } from "../i18n";

package/samples/apps/styleguide/src/app/seed.ts

@@ -5,9 +5,9 @@ import { TestUsers } from "@cosmicdrift/kumiko-framework/seeding";
 
 import { demoEntity } from "../features/demo/feature";
 
-// Gibt der List-View echte Rows mit Status-/Flag-Vielfalt. price (money)
-// bleibt leer — der Money-Input zeigt sich im Edit-Screen, im Seed lassen wir
-// ihn weg um nicht von der money-Payload-Form abzuhängen.
+// Gives the list view real rows with status/flag variety. price (money)
+// stays empty — the money input shows in the edit screen, in the seed we leave
+// it out to avoid depending on the money payload shape.
 const STATUSES = ["draft", "review", "published", "archived"] as const;
 
 // Fixed across boots (unlike the framework-minted ids for every other seed

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

@@ -39,8 +39,8 @@ await runDevApp({
     aiSettingsFeature,
     workboardFeature,
   ],
-  // Aktiviert die Upload-Routes (/api/files) + ctx.services.files für den Avatar-
-  // Stresstest. In-Memory reicht für die Demo (nicht-persistent).
+  // Enables the upload routes (/api/files) + ctx.services.files for the avatar
+  // stress test. In-memory is enough for the demo (non-persistent).
   files: { storageProvider: createInMemoryFileProvider() },
   port: Number.parseInt(process.env["PORT"] ?? "4180", 10),
   clientEntry: "./src/app/client.tsx",

package/samples/apps/styleguide/src/app/shell.tsx

@@ -18,10 +18,10 @@ export function AppShell({
   children: ReactNode;
   schema: AppSchema;
 }): ReactNode {
-  // Content-Panel-Switch (= P4-Muster, hier demo-lokal): ist ein target in
-  // der URL aktiv (Klick auf eine Content-Seite oder das „+"), füllt das
-  // EditorPanel den Main-Bereich; sonst der normale Screen. „Nichts
-  // selektiert" → children (kein „Screen not found"-Regress).
+  // Content panel switch (= P4 pattern, demo-local): if a target is active in
+  // the URL (click on a content page or the "+"), the EditorPanel fills
+  // the main area; otherwise the normal screen. "Nothing
+  // selected" → children (no "Screen not found" regression).
   const nav = useNav();
   const resolvers = useResolvers();
   const activeTarget = parseTargetFromSearchParams(nav.searchParams);

package/samples/apps/styleguide/src/features/content/web.tsx

@@ -1,9 +1,9 @@
-// Client-Seite des Content-Stresstests: der navProvider hängt sich an den
-// statischen `content`-Nav-Knoten (QN "content:nav:content"), lädt die Seiten
-// per /api/query und emittiert sie als Tree-Leaves. navEntities ["page"]
-// abonniert die Live-Events → nach einem Create erscheint die neue Seite
-// sofort im Sidebar-Tree. Der content:edit-Resolver rendert das Anlege-
-// Formular (leeres target) bzw. die Detail-Ansicht (target mit id).
+// Client side of the content stress test: the navProvider attaches to the
+// static `content` nav node (QN "content:nav:content"), loads the pages
+// via /api/query and emits them as tree leaves. navEntities ["page"]
+// subscribes to the live events → after a create the new page appears
+// immediately in the sidebar tree. The content:edit resolver renders the create
+// form (empty target) or the detail view (target with id).
 
 import type {
   TargetRef,

package/samples/apps/styleguide/src/features/examples/feature.ts

@@ -1,7 +1,7 @@
-// Config-Stresstest (server). Die shadcn-Referenz-Designs NICHT handgebaut,
-// sondern 1:1 aus dem Schema erzeugt — um zu sehen was die Auto-UI trägt und
-// wo sie an Grenzen stößt. Erster Fall: "Shipping Address" (flache Form,
-// 2-Felder-Reihen, Custom-Submit-Label).
+// Config stress test (server). The shadcn reference designs are NOT hand-built
+// but generated 1:1 from the schema — to see what the auto-UI supports and
+// where it hits limits. First case: "Shipping Address" (flat form,
+// 2-field rows, custom submit label).
 
 import {
   createBooleanField,
@@ -83,10 +83,10 @@ export const examplesFeature = defineFeature("examples", (r) => {
   r.translations({ keys: EXAMPLES_I18N });
   r.crud("shipping", shippingEntity, editFormOnly);
 
-  // EINE titellose Section: Card-Titel + Subtitle (aus i18n) tragen den
-  // Kontext, die Felder fließen direkt darunter. street/apt/saveAsDefault
-  // spannen beide Spalten (volle Breite), city/state + zip/country teilen
-  // sich je eine Reihe.
+  // ONE untitled section: card title + subtitle (from i18n) carry the
+  // context, the fields flow directly below. street/apt/saveAsDefault
+  // span both columns (full width), city/state + zip/country share
+  // one row each.
   r.screen({
     id: "shipping-edit",
     type: "entityEdit",

package/samples/apps/styleguide/src/features/gallery/feature.ts

@@ -1,17 +1,17 @@
-// Gallery-Feature (server). Eine custom-Screen, die die Foundations
-// (Colors/Typography/Radius/Elevation/Spacing) + atomare Components
-// (Buttons, Cards) zeigt — das was die Entity-Auto-Screens nicht abdecken.
-// React-Component client-seitig via clientFeatures.components zugeordnet.
+// Gallery feature (server). A custom screen showing the foundations
+// (colors/typography/radius/elevation/spacing) + atomic components
+// (buttons, cards) — what the entity auto-screens do not cover.
+// React component assigned client-side via clientFeatures.components.
 //
-// Eigener FeatureName (nicht "styleguide") — zwei defineFeature mit gleichem
-// Namen würden in createRegistry werfen.
+// Own FeatureName (not "styleguide") — two defineFeature calls with the same
+// name would throw in createRegistry.
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import type { LocalizedString } from "../shared-i18n";
 
-// Server-Pendant zu den Nav-Labels — Boot-Validator braucht screen:gallery.title
-// serverseitig registriert, auch wenn die custom-Screen selbst keinen
-// gerenderten Titel aus i18n zieht.
+// Server counterpart to the nav labels — the boot validator needs screen:gallery.title
+// registered server-side, even if the custom screen itself does not pull a
+// rendered title from i18n.
 const GALLERY_I18N: Readonly<Record<string, LocalizedString>> = {
   "screen:gallery.title": { de: "Foundations & Components", en: "Foundations & Components" },
   "gallery:nav.styleguide": { de: "Styleguide", en: "Styleguide" },

package/samples/apps/styleguide/src/features/gallery/web/Gallery.tsx

@@ -7,8 +7,8 @@ import {
 import { Check, ChevronDown, Search, X } from "lucide-react";
 import type { ReactNode } from "react";
 
-// Literal Tailwind-Klassen (kein `bg-${token}`) — der v4-Scanner generiert nur
-// Klassen die wörtlich im Source stehen.
+// Literal Tailwind classes (no `bg-${token}`) — the v4 scanner only generates
+// classes that appear literally in the source.
 const SWATCHES: ReadonlyArray<readonly [string, string]> = [
   ["background", "bg-background"],
   ["foreground", "bg-foreground"],
@@ -114,7 +114,7 @@ interface Dividend {
   readonly amount: string;
   readonly bars: readonly Bar[];
 }
-// kumiko-lint-ignore no-logic-in-views demo: inline Chart-Daten-Prep für die Gallery-Fixtures (Lesbarkeit des Demos > Extraktion)
+// kumiko-lint-ignore no-logic-in-views demo: inline chart data prep for the gallery fixtures (demo readability > extraction)
 function bars(heights: readonly [number, number, number, number]): readonly Bar[] {
   return heights.map((h, i) => ({ k: "abcd"[i] as string, h }));
 }
@@ -164,7 +164,7 @@ function Badge({ children }: { children: ReactNode }): ReactNode {
   );
 }
 
-// Select-Attrappe (shadcn-Select-Trigger-Look) für statische Showcase-Blöcke.
+// Select stand-in (shadcn select trigger look) for static showcase blocks.
 function SelectStub({ value }: { value: string }): ReactNode {
   return (
     <div className="border-input bg-background flex h-9 items-center justify-between rounded-md border px-3 text-sm">
@@ -359,7 +359,7 @@ export function Gallery(): ReactNode {
           <div className="flex items-center gap-3 p-2">
             <div className="relative min-w-0 flex-1">
               <Search className="text-muted-foreground absolute left-3 top-1/2 size-4 -translate-y-1/2" />
-              {/* kumiko-lint-ignore primitives-discipline readOnly search-pill visual (rounded-full mit inset Icon) — Muster-Demo, kein Formularfeld */}
+              {/* kumiko-lint-ignore primitives-discipline readOnly search-pill visual (rounded-full with inset icon) — pattern demo, not a form field */}
               <input
                 className="bg-muted/50 placeholder:text-muted-foreground focus-visible:ring-ring h-10 w-full rounded-full border-none pl-9 pr-4 text-sm outline-none focus-visible:ring-2"
                 placeholder="Search holdings or tickers…"
@@ -744,10 +744,10 @@ export function Gallery(): ReactNode {
       </Block>
 
       <Block id="tags" title="Tags — bundled-feature layout">
-        {/* ponytail: faithful Layout-Nachbau des TagSection (tags/web) mit den
-            echten Primitiven + statischen Daten — die Live-Version hängt am
-            Dispatcher. Verifiziert die Inline-Create-Row (Input wächst,
-            Add-Button bündig daneben). */}
+        {/* ponytail: faithful layout replica of the TagSection (tags/web) with the
+            real primitives + static data — the live version hangs off the
+            dispatcher. Verifies the inline create row (input grows,
+            add button flush beside it). */}
         <div className="flex max-w-md flex-col gap-4">
           <Field id="tg-select" label="Tags">
             <Input
@@ -778,9 +778,9 @@ export function Gallery(): ReactNode {
       </Block>
 
       <Block id="nav" title="Navigation">
-        {/* ponytail: statischer Nachbau des Nav-Standards — die LIVE-Nav ist
-            die Sidebar links (NavTree), hier isoliert für die Doku. */}
-        {/* kumiko-lint-ignore primitives-discipline nav-surface demo (Navigations-Fläche, kein Card) */}
+        {/* ponytail: static replica of the nav standard — the LIVE nav is
+            the sidebar on the left (NavTree), isolated here for the docs. */}
+        {/* kumiko-lint-ignore primitives-discipline nav-surface demo (navigation surface, not a card) */}
         <div className="bg-card w-60 rounded-lg border p-3 text-sm shadow-sm">
           <div className="text-muted-foreground/70 px-2 pb-1 pt-2 text-[11px] font-medium uppercase tracking-wider">
             Workspace

package/samples/apps/styleguide/src/features/widgets/feature.ts

@@ -67,8 +67,8 @@ const LOAN_MARKERS = [
 const SENDERS = ["William Smith", "Alice Smith", "Bob Johnson", "Emily Davis"] as const;
 const SUBJECTS = ["Meeting Tomorrow", "Re: Project Update", "Weekend Plans", "Re: Budget"] as const;
 
-// Statische Demo-Inbox (18 Nachrichten) für die InfinityList-Demo — genug
-// Rows, um über pageSize=6 hinweg mehrere Seiten nachzuladen.
+// Static demo inbox (18 messages) for the InfinityList demo — enough
+// rows to load several pages beyond pageSize=6.
 const INBOX_MESSAGES = Array.from({ length: 18 }, (_, i) => ({
   id: `m${i + 1}`,
   // Cast is sound: `i % SENDERS.length` is always in [0, SENDERS.length) —

package/samples/apps/styleguide/src/features/widgets/web/DashboardFilterEcho.tsx

@@ -1,6 +1,6 @@
-// Demo-Komponente für den `custom`-Dashboard-Panel-Typ: zeigt, dass eine
-// eingehängte App-Komponente ihre Daten selbst holt und den aktuell
-// gewählten Screen-Filter-Wert über `filterParams` sieht (siehe
+// Demo component for the `custom` dashboard panel type: shows that an
+// attached app component fetches its data itself and sees the currently
+// selected screen filter value via `filterParams` (see
 // DashboardFilterDefinition in feature.ts).
 
 import { type ExtensionSectionProps, useTranslation } from "@cosmicdrift/kumiko-renderer";

package/samples/apps/styleguide/src/features/widgets/web/DashboardKpiIcon.tsx

@@ -1,7 +1,7 @@
-// Demo-Komponente für das statische `icon`-Feld eines Dashboard-stat-Panels:
-// über dieselbe extensionSectionComponents-Registry wie custom-Panels
-// aufgelöst, ignoriert aber den Entity-/Filter-Kontext (ein reines Icon hat
-// keinen Bezug dazu).
+// Demo component for the static `icon` field of a dashboard stat panel:
+// resolved via the same extensionSectionComponents registry as custom panels,
+// but ignores the entity/filter context (a plain icon has
+// no relation to it).
 
 import type { ReactNode } from "react";
 

package/samples/apps/ui-walkthrough/playwright.config.ts

@@ -1,11 +1,11 @@
 // @runtime test
-// Playwright-Config für den ui-walkthrough-Durchstich. Startet den
-// echten dev-server als webServer-Fixture, genau wie `bun dev` — nur
-// auf dem Port aus samples/e2e/e2e-ports.ts, damit keine Dev-Session kollidiert.
+// Playwright config for the ui-walkthrough run-through. Starts the
+// real dev server as a webServer fixture, exactly like `bun dev` — only
+// on the port from samples/e2e/e2e-ports.ts so no dev session collides.
 //
-// Der dev-server macht auf PORT-Env basierend das HTTP-Binding. Die
-// setupTestStack-Default ist ephemeral (fresh kumiko_test_<random> DB),
-// deshalb braucht's keine DB-Reset-Logik hier.
+// The dev server does the HTTP binding based on the PORT env. The
+// setupTestStack default is ephemeral (fresh kumiko_test_<random> DB),
+// so no DB reset logic is needed here.
 
 import {
   defineAppE2eConfig,