@cosmicdrift/kumiko-samples 0.351.0 → 0.353.0

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

@@ -5,6 +5,7 @@
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import { z } from "zod";
+import { demoMoney, demoMonthYear, demoPercent, demoText } from "./demo-locale";
 import { WIDGETS_I18N } from "./i18n";
 
 // Statische Demo-Zeitreihe (48 Punkte à 30 Minuten) — kein Date-API,
@@ -33,6 +34,13 @@ const INBOX_MESSAGES = Array.from({ length: 18 }, (_, i) => ({
   unread: i % 4 === 0,
 }));
 
+function openAmount(amount: number, locale: string): string {
+  return demoText("widgets:dashboard:demo-amount-open", locale).replace(
+    "{amount}",
+    demoMoney(amount, "EUR", locale),
+  );
+}
+
 export const widgetsFeature = defineFeature("widgets", (r) => {
   r.screen({ id: "widgets", type: "custom", renderer: { react: { __component: "widgets" } } });
   r.screen({
@@ -129,11 +137,14 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:portfolio-stat",
     z.object({ region: z.string().optional() }),
-    async ({ payload: { region } }) => ({
-      value: region === "us" ? "38.120 $" : region === "eu" ? "54.630 €" : "92.753 €",
-      sub: "über 4 Konten",
+    async ({ payload: { region } }, ctx) => ({
+      value:
+        region === "us"
+          ? demoMoney(38120, "USD", ctx.locale)
+          : demoMoney(region === "eu" ? 54630 : 92753, "EUR", ctx.locale),
+      sub: demoText("widgets:catalog:portfolio-sub", ctx.locale),
       tone: "positive",
-      delta: "12 %",
+      delta: demoPercent(0.12, ctx.locale),
       deltaDirection: "up",
       deltaTone: "positive",
     }),
@@ -150,7 +161,7 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:net-worth-assets",
     z.object({ region: z.string().optional() }),
-    async () => ({ value: "120.000 €" }),
+    async (_query, ctx) => ({ value: demoMoney(120000, "EUR", ctx.locale) }),
     {
       access: {
         openToAll: {
@@ -164,7 +175,7 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:net-worth-debts",
     z.object({ region: z.string().optional() }),
-    async () => ({ value: "65.370 €" }),
+    async (_query, ctx) => ({ value: demoMoney(65370, "EUR", ctx.locale) }),
     {
       access: {
         openToAll: {
@@ -196,10 +207,18 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:latest-items",
     z.object({}),
-    async () => ({
+    async (_query, ctx) => ({
       rows: [
-        { id: "i1", name: "API-Timeout eu-central", status: "resolved" },
-        { id: "i2", name: "Zertifikat erneuert", status: "done" },
+        {
+          id: "i1",
+          name: demoText("widgets:dashboard:demo-incident-timeout", ctx.locale),
+          status: "resolved",
+        },
+        {
+          id: "i2",
+          name: demoText("widgets:dashboard:demo-incident-certificate", ctx.locale),
+          status: "done",
+        },
       ],
       nextCursor: null,
     }),
@@ -249,10 +268,16 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:upcoming-events",
     z.object({}),
-    async () => ({
+    async (_query, ctx) => ({
       rows: [
-        { primary: "Zinsanpassung Baudarlehen", trailing: "Aug 2026" },
-        { primary: "Bausparvertrag zuteilungsreif", trailing: "Okt 2026" },
+        {
+          primary: demoText("widgets:dashboard:demo-event-rate-adjustment", ctx.locale),
+          trailing: demoMonthYear(2026, 8, ctx.locale),
+        },
+        {
+          primary: demoText("widgets:dashboard:demo-event-savings-contract", ctx.locale),
+          trailing: demoMonthYear(2026, 10, ctx.locale),
+        },
       ],
     }),
     {
@@ -268,10 +293,18 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
   r.queryHandler(
     "metrics:goal-progress",
     z.object({}),
-    async () => ({
+    async (_query, ctx) => ({
       rows: [
-        { label: "Baudarlehen", value: "42.000 € offen", fraction: 0.71 },
-        { label: "Autokredit", value: "3.200 € offen", fraction: 0.92 },
+        {
+          label: demoText("widgets:dashboard:demo-goal-mortgage", ctx.locale),
+          value: openAmount(42000, ctx.locale),
+          fraction: 0.71,
+        },
+        {
+          label: demoText("widgets:dashboard:demo-goal-car-loan", ctx.locale),
+          value: openAmount(3200, ctx.locale),
+          fraction: 0.92,
+        },
       ],
     }),
     {

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

@@ -27,6 +27,34 @@ export const WIDGETS_I18N = {
   "widgets:dashboard:filter-region": { de: "Region", en: "Region" },
   "widgets:dashboard:filter-region-eu": { de: "Europa", en: "Europe" },
   "widgets:dashboard:filter-region-us": { de: "USA", en: "USA" },
+  "widgets:dashboard:filter-echo-title": { de: "Custom-Panel", en: "Custom panel" },
+  "widgets:dashboard:filter-echo-filtered": {
+    de: "Gefiltert nach Region: {region}",
+    en: "Filtered by region: {region}",
+  },
+  "widgets:dashboard:filter-echo-unfiltered": {
+    de: "Ungefiltert (alle Regionen)",
+    en: "Unfiltered (all regions)",
+  },
+  "widgets:dashboard:demo-incident-timeout": {
+    de: "API-Timeout eu-central",
+    en: "API timeout eu-central",
+  },
+  "widgets:dashboard:demo-incident-certificate": {
+    de: "Zertifikat erneuert",
+    en: "Certificate renewed",
+  },
+  "widgets:dashboard:demo-event-rate-adjustment": {
+    de: "Zinsanpassung Baudarlehen",
+    en: "Mortgage rate adjustment",
+  },
+  "widgets:dashboard:demo-event-savings-contract": {
+    de: "Bausparvertrag zuteilungsreif",
+    en: "Building savings contract ready for allocation",
+  },
+  "widgets:dashboard:demo-goal-mortgage": { de: "Baudarlehen", en: "Mortgage" },
+  "widgets:dashboard:demo-goal-car-loan": { de: "Autokredit", en: "Car loan" },
+  "widgets:dashboard:demo-amount-open": { de: "{amount} offen", en: "{amount} outstanding" },
   "widgets:catalog:portfolio": { de: "Portfolio", en: "Portfolio" },
   "widgets:catalog:portfolio-sub": { de: "über 4 Konten", en: "across 4 accounts" },
   "widgets:catalog:remaining-debt": { de: "Restschuld", en: "Remaining debt" },

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

@@ -3,18 +3,19 @@
 // gewählten Screen-Filter-Wert über `filterParams` sieht (siehe
 // DashboardFilterDefinition in feature.ts).
 
-import type { ExtensionSectionProps } from "@cosmicdrift/kumiko-renderer";
+import { type ExtensionSectionProps, useTranslation } from "@cosmicdrift/kumiko-renderer";
 import { SectionCard } from "@cosmicdrift/kumiko-renderer-web";
 import type { ReactNode } from "react";
 
 export function DashboardFilterEcho({ filterParams }: ExtensionSectionProps): ReactNode {
+  const t = useTranslation();
   const region = filterParams?.["region"];
   return (
-    <SectionCard title="Custom-Panel">
+    <SectionCard title={t("widgets:dashboard:filter-echo-title")}>
       <p className="text-sm text-muted-foreground">
         {typeof region === "string"
-          ? `Gefiltert nach Region: ${region}`
-          : "Ungefiltert (alle Regionen)"}
+          ? t("widgets:dashboard:filter-echo-filtered", { region })
+          : t("widgets:dashboard:filter-echo-unfiltered")}
       </p>
     </SectionCard>
   );

package/samples/apps/ui-walkthrough/src/app/assistant-action.tsx

@@ -1,4 +1,4 @@
-import { usePrimitives } from "@cosmicdrift/kumiko-renderer";
+import { usePrimitives, useTranslation } from "@cosmicdrift/kumiko-renderer";
 import { WandSparkles } from "lucide-react";
 import { type ReactNode, useEffect, useState } from "react";
 
@@ -6,6 +6,7 @@ const noop = (): void => {};
 
 export function AssistantAction(): ReactNode {
   const { Dialog } = usePrimitives();
+  const t = useTranslation();
   const [open, setOpen] = useState(false);
 
   // Registered here on purpose: an overflow menu that unmounts this component
@@ -30,7 +31,7 @@ export function AssistantAction(): ReactNode {
         className="inline-flex h-9 items-center gap-2 rounded-md border border-border bg-card px-3 text-sm font-medium text-foreground hover:bg-accent"
       >
         <WandSparkles className="h-4 w-4" aria-hidden="true" />
-        Assistent
+        {t("tasks.assistant.label")}
         <kbd className="rounded border border-border px-1 font-sans text-xs text-muted-foreground">
           ⌘K
         </kbd>
@@ -38,9 +39,9 @@ export function AssistantAction(): ReactNode {
       <Dialog
         open={open}
         onOpenChange={setOpen}
-        title="Assistent"
-        description="Der Assistent ist im Walkthrough nicht angebunden."
-        confirmLabel="Schließen"
+        title={t("tasks.assistant.label")}
+        description={t("tasks.assistant.description")}
+        confirmLabel={t("tasks.assistant.close")}
         onConfirm={noop}
         testId="assistant-dialog"
       />

package/samples/apps/ui-walkthrough/src/app/shell.tsx

@@ -13,6 +13,7 @@ import {
   SidebarBrand,
   ThemeMenuItem,
   ThemeToggle,
+  useTranslation,
 } from "@cosmicdrift/kumiko-renderer-web";
 import { MoonStar, Sun } from "lucide-react";
 import type { ReactNode } from "react";
@@ -20,7 +21,6 @@ import { AssistantAction } from "./assistant-action";
 import { BETA_TENANT_ID, DEV_TENANT_ID } from "./auth-constants";
 
 const APP_NAME = "Kumiko Walkthrough";
-const APP_TAGLINE = "Design-Referenz";
 
 const tenantName = (tenantId: string): string => {
   if (tenantId === DEV_TENANT_ID) return "Dev Tenant";
@@ -40,9 +40,10 @@ export function AppShell({
   readonly children: ReactNode;
   readonly schema: AppSchema;
 }): ReactNode {
+  const t = useTranslation();
   return (
     <DefaultAppShell
-      brand={<SidebarBrand name={APP_NAME} plan={APP_TAGLINE} />}
+      brand={<SidebarBrand name={APP_NAME} plan={t("tasks.shell.tagline")} />}
       schema={schema}
       headerActions={
         <>

package/samples/apps/ui-walkthrough/src/features/tasks/i18n.ts

@@ -5,6 +5,10 @@ import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
 
 export const tasksTranslations: TranslationsByLocale = {
   de: {
+    "tasks.shell.tagline": "Design-Referenz",
+    "tasks.assistant.label": "Assistent",
+    "tasks.assistant.description": "Der Assistent ist im Walkthrough nicht angebunden.",
+    "tasks.assistant.close": "Schließen",
     "tasks.nav.group": "Allgemein",
     "tasks.nav.list": "Aufgaben",
     "tasks.nav.new": "Neue Aufgabe",
@@ -21,6 +25,10 @@ export const tasksTranslations: TranslationsByLocale = {
     "tasks:entity:task:field:notes": "Notizen",
   },
   en: {
+    "tasks.shell.tagline": "Design reference",
+    "tasks.assistant.label": "Assistant",
+    "tasks.assistant.description": "The assistant is not connected in the walkthrough.",
+    "tasks.assistant.close": "Close",
     "tasks.nav.group": "General",
     "tasks.nav.list": "Tasks",
     "tasks.nav.new": "New task",

package/samples/recipes/files-post-processing/package.json

@@ -7,6 +7,6 @@
     "@cosmicdrift/kumiko-framework": "workspace:*"
   },
   "devDependencies": {
-    "sharp": "^0.35.3"
+    "sharp": "^0.35.5"
   }
 }

package/samples/recipes/public-share-token/README.md

@@ -3,9 +3,8 @@
 Minimal pattern for **tokenized anonymous read surfaces**: authenticated users
 mint a link; visitors resolve it without login.
 
-Domain-agnostic — no credit/folder logic. Full consumer:
-[Cashcolt money-horse](https://github.com/CosmicDriftGameStudio/money-horse)
-(`share-by-token` + 5 layout templates).
+Domain-agnostic — no credit/folder logic. A full consumer adds snapshots,
+layout templates and tier gates on top.
 
 ## What it shows
 
@@ -16,8 +15,8 @@ Domain-agnostic — no credit/folder logic. Full consumer:
 - **`anonymousAccess`** on test stack (see integration test)
 
 Client wiring: [`recipes/apex-surface-auth`](../apex-surface-auth/) or a gate
-before `createKumikoApp` (money-horse uses `public-share-gate.tsx` like the public
-calculator).
+before `createKumikoApp` (a small gate component that renders the public view when
+the URL carries a share token).
 
 ## Handlers
 

package/samples/recipes/public-share-token/src/feature.ts

@@ -3,7 +3,7 @@
 // Pattern: authenticated create → plain token show-once → anonymous
 // read-by-token with SHA-256 lookup. Revoke sets revokedAt via executor.
 //
-// See money-horse for credit/folder snapshots, layouts, tier gates.
+// A full consumer adds domain snapshots, layouts and tier gates on top.
 
 import { generateToken } from "@cosmicdrift/kumiko-framework/api";
 import { fetchOne } from "@cosmicdrift/kumiko-framework/bun-db";

package/samples/recipes/security-baseline/README.md

@@ -54,6 +54,12 @@ export const APP_FEATURES = [
 For an app that does not mount `dsgvoSelfServiceFeatures()`, use
 `securityBaselineFeatures()` with its default options, as this recipe does.
 
+Dedupe keeps the first mounted instance. Late-bound state such as
+`bindAutoRevokeOnPasswordChange` must be bound on the instance returned by
+`composeFeatures`/`createApp`, not on a locally held handle to the dropped one:
+the dropped instance's hooks never run and password changes silently stop
+revoking sessions.
+
 A `createSessionsFeature({ ... })` mounted with different options than the
 preset's own no-arg instance still produces a clear boot error — dedupe only
 collapses provably interchangeable instances, never silently picks one:

package/samples/recipes/seed-migration/README.md

@@ -5,7 +5,7 @@ File-based migrations for Event-Sourcing operations — like `kumiko schema appl
 ## What it shows
 
 - **`seedsDir`-Option** in `runProdApp({ seedsDir: "./seeds" })` — beim Boot werden pending Files in chronologischer Reihenfolge angewendet und in `kumiko_es_operations` markiert.
-- **`SeedMigration`-Interface** — default-Export einer seed-File mit `description` + `run(ctx)`. ctx liefert `systemWriteAs` (System-User bypassed Access-Check) + Read-Helpers (`findUserByEmail`, `findMembershipsOfUser`, `findTenants`).
+- **`SeedMigration`-Interface** — default-Export einer seed-File mit `description` + `run(ctx)`. ctx liefert `systemWriteAs` (System-User bypassed Access-Check) + Read-Helpers (`findUserByEmail`, `findMembershipsOfUser`, `findTenants`, `findTemplateResources`).
 - **Idempotency** — Marker landet nach Erfolg in der Tracking-Tabelle, zweiter Boot skipped applied Seeds.
 - **Tx-Atomicity** — Jede Migration läuft in eigener Transaction; Failure rollt zurück + bricht Boot ab (kein Partial-Apply).
 - **Chronologische File-IDs** — Filename `<date>-<slug>.ts` (z.B. `2026-05-20-fix-admin-roles.ts`) ist die ID.
@@ -35,6 +35,18 @@ seed: 2026-05-20-fix-admin-roles.ts
 
 Bei typo / drift fail-t mit klarer message + exit-code 1 — CI nutzt es als prä-build-step. App-Author muss in `smoke.ts` den `features`-Array gegen die eigene App-Feature-Set tauschen (siehe TODO im File).
 
+### Archive template rows
+
+`findTemplateResources({ slug?, kind?, status?, locale?, tenantId? })` replaces a raw `SELECT … FROM read_template_resources`. It defaults to the system tenant and returns `[]` when template-resolver is not mounted:
+
+```ts
+for (const t of await ctx.findTemplateResources({ kind: "notification", status: "active" })) {
+  await ctx.systemWriteAs("template-resolver:write:archive", { id: t.id }, SYSTEM_TENANT_ID, [
+    "SystemAdmin",
+  ]);
+}
+```
+
 ## When to reach for it
 
 Du hast einen idempotent-Seeder der bei initialer Erstellung „Insert wenn nicht existiert" macht (z.B. `auth.admin.memberships`), und dann ändern sich die Soll-Daten — neue Rolle, anderer Tier, korrigierte Bezeichnung. Idempotent-Seeder skippen die existing Rows → DB driftet vom Code-Stand ab.

package/samples/recipes/tenant-settings/README.md

@@ -20,7 +20,7 @@ import { defineCreateWithTenantDefaults } from "@cosmicdrift/kumiko-bundled-feat
 export const invoiceEntity = createEntity({
   table: "read_invoices",
   fields: {
-    title: createTextField({ required: true }),
+    title: createTextField({ personal: false, reason: "is_business_data", required: true }),
     amount: createMoneyField({ required: true }),
     language: createSelectField({ options: ["en", "de", "fr"] as const }),
   },

package/packages/bundled-features/src/shared/has-where-rule.ts

@@ -1,11 +0,0 @@
-import type { OwnershipMap } from "@cosmicdrift/kumiko-framework/engine";
-
-// `where`-rules are read-path only (buildOwnershipClause). The write path
-// decides in memory against the concrete row, so a where-rule there can only
-// ever deny — boot validation rejects the shape (fw#2626). Feature factories
-// that accept an `ownership` option reject it earlier, at build time, so the
-// author gets the option name in the message instead of an entity scope.
-export function hasWhereRule(map: OwnershipMap | undefined): boolean {
-  if (!map) return false;
-  return Object.values(map).some((rule) => rule !== "all" && rule.kind === "where");
-}