@cosmicdrift/kumiko-samples 0.353.0 → 0.354.1

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

@@ -15,6 +15,44 @@ const RESPONSE_POINTS = Array.from({ length: 48 }, (_, i) => ({
   value: i === 20 ? null : 120 + Math.round(80 * Math.abs(Math.sin(i / 5))),
 }));
 
+const LOAN_START_MS = Date.UTC(2020, 0, 1);
+const LOAN_TODAY_MS = Date.UTC(2026, 5, 15);
+const LOAN_MONTHS = 240;
+const LOAN_PRINCIPAL_MINOR = 25_000_000;
+const LOAN_MONTHLY_RATE = 0.035 / 12;
+
+const loanMonthMs = (monthIndex: number): number => Date.UTC(2020, monthIndex, 1);
+
+// Annuity loan over 20 years: remaining principal falls, cumulative interest
+// grows. "Today" is a fixed date, not the clock, so the window and the
+// screenshots stay stable.
+const growth = (1 + LOAN_MONTHLY_RATE) ** LOAN_MONTHS;
+const annuityMinor = (LOAN_PRINCIPAL_MINOR * LOAN_MONTHLY_RATE * growth) / (growth - 1);
+let balanceMinor: number = LOAN_PRINCIPAL_MINOR;
+let interestPaidMinor = 0;
+const LOAN_REMAINING_POINTS = [{ atMs: loanMonthMs(0), value: LOAN_PRINCIPAL_MINOR }];
+const LOAN_INTEREST_POINTS = [{ atMs: loanMonthMs(0), value: 0 }];
+for (let i = 1; i <= LOAN_MONTHS; i++) {
+  const interest = balanceMinor * LOAN_MONTHLY_RATE;
+  balanceMinor = Math.max(0, balanceMinor - (annuityMinor - interest));
+  interestPaidMinor += interest;
+  LOAN_REMAINING_POINTS.push({ atMs: loanMonthMs(i), value: Math.round(balanceMinor) });
+  LOAN_INTEREST_POINTS.push({ atMs: loanMonthMs(i), value: Math.round(interestPaidMinor) });
+}
+const LOAN_SERIES = [
+  { key: "remaining", label: "widgets:dashboard:loan-remaining", points: LOAN_REMAINING_POINTS },
+  { key: "interest", label: "widgets:dashboard:loan-interest", points: LOAN_INTEREST_POINTS },
+];
+const LOAN_MARKERS = [
+  { atMs: loanMonthMs(84), label: { i18nKey: "widgets:dashboard:marker-extra-1" }, kind: "extra" },
+  { atMs: loanMonthMs(150), label: { i18nKey: "widgets:dashboard:marker-extra-2" }, kind: "extra" },
+  {
+    atMs: loanMonthMs(LOAN_MONTHS),
+    label: { i18nKey: "widgets:dashboard:marker-payoff" },
+    kind: "payoff",
+  },
+];
+
 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;
 
@@ -104,6 +142,31 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
         chart: "timeseries",
         query: "widgets:query:metrics:response-times",
       },
+      {
+        kind: "chart",
+        id: "loan",
+        label: "widgets:dashboard:loan",
+        chart: "stacked-area",
+        query: "widgets:query:metrics:loan",
+        valueFormat: { kind: "currency", currency: "EUR", fractionDigits: 0 },
+        brush: true,
+        legendTotals: false,
+        initialWindow: "from-today",
+        markerLegend: "legend",
+        markerKinds: {
+          extra: { tone: "active", label: "widgets:dashboard:kind-extra" },
+          payoff: { tone: "positive", label: "widgets:dashboard:kind-payoff" },
+        },
+        ranges: {
+          default: "max",
+          options: [
+            { value: "y1", label: "widgets:dashboard:range-y1", months: 12 },
+            { value: "y3", label: "widgets:dashboard:range-y3", months: 36 },
+            { value: "y5", label: "widgets:dashboard:range-y5", months: 60 },
+            { value: "max", label: "widgets:dashboard:range-all" },
+          ],
+        },
+      },
       {
         kind: "list",
         id: "latest",
@@ -204,6 +267,26 @@ export const widgetsFeature = defineFeature("widgets", (r) => {
       },
     },
   );
+  r.queryHandler(
+    "metrics:loan",
+    z.object({}),
+    async () => ({
+      series: LOAN_SERIES,
+      markers: LOAN_MARKERS,
+      windowStartMs: LOAN_START_MS,
+      windowEndMs: loanMonthMs(LOAN_MONTHS),
+      todayMs: LOAN_TODAY_MS,
+    }),
+    {
+      access: {
+        openToAll: {
+          reason:
+            "demo dashboard widget: returns static canned data with no per-user or " +
+            "tenant scoping; any signed-in user may query it",
+        },
+      },
+    },
+  );
   r.queryHandler(
     "metrics:latest-items",
     z.object({}),

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

@@ -19,6 +19,18 @@ export const WIDGETS_I18N = {
   "widgets:dashboard:net-worth-assets": { de: "Vermögen", en: "Assets" },
   "widgets:dashboard:net-worth-debts": { de: "Schulden", en: "Debts" },
   "widgets:dashboard:response-times": { de: "Antwortzeit", en: "Response time" },
+  "widgets:dashboard:loan": { de: "Kreditverlauf", en: "Loan balance" },
+  "widgets:dashboard:loan-remaining": { de: "Restschuld", en: "Remaining balance" },
+  "widgets:dashboard:loan-interest": { de: "Gezahlte Zinsen", en: "Interest paid" },
+  "widgets:dashboard:kind-extra": { de: "Sondertilgung", en: "Extra repayment" },
+  "widgets:dashboard:kind-payoff": { de: "Ablösung", en: "Payoff" },
+  "widgets:dashboard:marker-extra-1": { de: "Sondertilgung 2027", en: "Extra repayment 2027" },
+  "widgets:dashboard:marker-extra-2": { de: "Sondertilgung 2032", en: "Extra repayment 2032" },
+  "widgets:dashboard:marker-payoff": { de: "Kredit getilgt", en: "Loan repaid" },
+  "widgets:dashboard:range-y1": { de: "1 Jahr", en: "1 year" },
+  "widgets:dashboard:range-y3": { de: "3 Jahre", en: "3 years" },
+  "widgets:dashboard:range-y5": { de: "5 Jahre", en: "5 years" },
+  "widgets:dashboard:range-all": { de: "Alles", en: "All" },
   "widgets:dashboard:latest": { de: "Neueste Ereignisse", en: "Latest events" },
   "widgets:dashboard:col-name": { de: "Name", en: "Name" },
   "widgets:dashboard:col-status": { de: "Status", en: "Status" },

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

@@ -146,6 +146,10 @@ export function Widgets(): ReactNode {
         </div>
       </SectionCard>
 
+      <div className="flex h-12 w-64 items-stretch" data-testid="progress-stretch-host">
+        <ProgressBar value={0.5} testId="progress-stretch-bar" />
+      </div>
+
       <SectionCard
         title={t("widgets:catalog:repayment-model")}
         action={

package/samples/apps/ui-walkthrough/package.json

@@ -19,5 +19,8 @@
     "react-dom": "^19.2.6",
     "zod": "^4.4.3",
     "@cosmicdrift/kumiko-locale-de": "workspace:*"
+  },
+  "devDependencies": {
+    "@cosmicdrift/kumiko-testing": "workspace:*"
   }
 }

package/samples/apps/use-all-bundled/README.md

@@ -6,8 +6,7 @@ Canonical smoke-sample. Mounts every bundled-feature so framework-CI catches fea
 
 Sprint 9.8 found 12 framework bugs in a Studio deployment that all could have
 been caught earlier: 27 of 30 bundled features had zero integration coverage
-from any real app. This sample is the gate; deployment-specific rollout notes
-belong to your private operations documentation.
+from any real app. This sample is the gate.
 
 ## CI-Gate
 

package/samples/apps/use-all-bundled/feature-manifest.json

@@ -1399,7 +1399,7 @@
     },
     {
       "name": "jobs",
-      "description": "Persistence and operator tooling for background jobs registered via `r.job(...)`. Every job execution writes directly into `store_job_runs` (current status + duration) and `store_job_run_logs` (per-line log rows) from the BullMQ callbacks — no event stream in between (#2243). A daily `retention-cleanup` job deletes runs (and their logs) older than `retentionDays`; an hourly `stale-run-sweep` job marks runs stuck at status `running` past `staleRunTimeoutHours` as `failed` (#2246 — a crashed worker never fires the completion callback, so nothing else ever revisits the row). Exposes `jobs:write:trigger` (manual run) and `jobs:write:retry` (operator retry of a failed run), plus `jobs:query:list`, `jobs:query:details`, and `jobs:query:catalog` (manual jobs) for the operator UI. A job that declares `tenantVisibleFailure` also records its last failed attempt per tenant and subject in `store_tenant_job_failures`, which the tenant itself reads through `jobs:query:failures` — a translation key only, never the provider's message (fw#3079).",
+      "description": "Persistence and operator tooling for background jobs registered via `r.job(...)`. Every job execution writes directly into `store_job_runs` (current status + duration) and `store_job_run_logs` (per-line log rows) from the BullMQ callbacks — no event stream in between (#2243). A daily `retention-cleanup` job deletes runs (and their logs) older than `retentionDays`; an hourly `stale-run-sweep` job marks runs stuck at status `running` past `staleRunTimeoutHours` as `failed` (#2246 — a crashed worker never fires the completion callback, so nothing else ever revisits the row). Exposes `jobs:write:trigger` (manual run) and `jobs:write:retry` (operator retry of a failed run), plus `jobs:query:list`, `jobs:query:details`, and `jobs:query:catalog` (manual jobs) for the operator UI. A job that declares `tenantVisibleFailure` also records its last failed attempt per tenant and subject in `store_tenant_job_failures`, which the tenant itself reads through `jobs:query:failures` — a translation key only, never the provider's message (fw#3079). A job that declares `tenantVisibleRun` also keeps its run state per tenant and subject in `store_tenant_job_runs` (queued, running, plus the latest completed or failed run, no payload, error text or logs), which the tenant reads through `jobs:query:tenant-runs` (fw#3616); the stale-run sweep fails its stuck `running` rows and drops its stuck `queued` rows.",
       "toggleableDefault": null,
       "requires": [],
       "optionalRequires": [],

package/samples/apps/user-data-rights-demo/README.md

@@ -115,9 +115,7 @@ then 500s). For a real deploy, swap to the persistent provider in
 
 Then set `S3_BUCKET` / `S3_REGION` / `S3_ACCESS_KEY` / `S3_SECRET_KEY` (plus
 optional `S3_ENDPOINT` for Hetzner/S3-compatible stores) and the app override
-`file-foundation:config:provider = "s3-env"`. For full wiring and production
-verification, follow your deployment team's private operations documentation.
-
+`file-foundation:config:provider = "s3-env"`.
 ## Adding your own domain
 
 To add another DSGVO-compliant entity to the demo:

package/samples/recipes/legal-pages/README.md

@@ -87,8 +87,8 @@ imprint" decision.
 
 ```bash
 # In the app workspace:
-bun kumiko migrate generate    # detects text-block entity → SQL migration
-bun kumiko migrate apply       # one-time (pre-deploy step in prod)
+bun kumiko-schema generate <name>    # detects text-block entity → SQL migration
+bun kumiko-schema apply       # one-time (pre-deploy step in prod)
 ```
 
 ### 3. Initial seed of the required blocks
@@ -141,8 +141,7 @@ await seedTextBlock(db, {
 ```
 
 → Templates for full legally-sound texts: e-recht24.de
-or datenschutz-generator.de by Dr. Schwenke. Follow your deployment team's
-private legal-template documentation for the approved source process.
+or datenschutz-generator.de by Dr. Schwenke.
 
 ### 4. Visit the pages
 

package/samples/recipes/managed-pages/README.md

@@ -81,8 +81,8 @@ the recipe lists `createConfigFeature()` explicitly (see `src/feature.ts`).
 ### 2. Create the table
 
 ```bash
-bun kumiko migrate generate    # detects the `page` entity → SQL migration
-bun kumiko migrate apply
+bun kumiko-schema generate <name>    # detects the `page` entity → SQL migration
+bun kumiko-schema apply
 ```
 
 ### 3. Authoring + branding

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

@@ -88,6 +88,4 @@ Wenn eine kaputte Migration den Boot blockiert: setze `skippable: true` im seed-
 
 ## See also
 
-- **Plan-Doc:** your deployment team's private operations documentation —
-  Phase-2+ Operations (projection-rebuild, event-replay, stream-migration, ...)
 - **Driver-Use-Case:** `seeds/2026-02-01-fix-admin-roles.ts` in this recipe