@cosmicdrift/kumiko-samples 0.374.0 → 0.378.0

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

@@ -1,6 +1,6 @@
 import { emailPasswordClient } from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";
 import { localeDeClient } from "@cosmicdrift/kumiko-locale-de/web";
-import { createKumikoApp } from "@cosmicdrift/kumiko-renderer-web";
+import { createKumikoApp } from "@cosmicdrift/kumiko-renderer/web";
 import { demoClient } from "../features/demo/web";
 import { driverClient } from "../features/demo-driver/web";
 import { AppShell } from "./shell";

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

@@ -5,7 +5,7 @@ import {
   DefaultTopbarActions,
   useShellUser,
 } from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";
-import { type AppSchema, WorkspaceShell } from "@cosmicdrift/kumiko-renderer-web";
+import { type AppSchema, WorkspaceShell } from "@cosmicdrift/kumiko-renderer/web";
 import { MoonStar, Sun } from "lucide-react";
 import type { ReactNode } from "react";
 

package/samples/apps/workspaces/src/features/demo/web/index.ts

@@ -1,4 +1,4 @@
-import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer-web";
+import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { demoTranslations } from "../i18n";
 
 export const demoClient: ClientFeatureDefinition = {

package/samples/apps/workspaces/src/features/demo-driver/web/index.ts

@@ -1,4 +1,4 @@
-import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer-web";
+import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { driverTranslations } from "../i18n";
 
 export const driverClient: ClientFeatureDefinition = {

package/samples/recipes/apex-landing/package.json

@@ -8,7 +8,7 @@
   },
   "dependencies": {
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
-    "@cosmicdrift/kumiko-headless": "workspace:*"
+    "@cosmicdrift/kumiko-renderer": "workspace:*"
   },
   "devDependencies": {
     "@cosmicdrift/kumiko-testing": "workspace:*",

package/samples/recipes/apex-landing/src/feature.ts

@@ -18,7 +18,7 @@ import {
   type ApexPage,
   type ApexPricingTier,
   renderApexPage,
-} from "@cosmicdrift/kumiko-headless/apex";
+} from "@cosmicdrift/kumiko-renderer/headless/apex";
 import { HERO_SCREENSHOT } from "./constants";
 
 // --- Inputs: shapes the surrounding features hand you -----------------------

package/samples/recipes/apex-surface-auth/README.md

@@ -34,7 +34,7 @@ import {
 import {
   RequestAccountDeletionScreen, ConfirmAccountDeletionScreen,
 } from "@cosmicdrift/kumiko-bundled-features/user-data-rights/web";
-import { createPublicSurface } from "@cosmicdrift/kumiko-renderer-web";
+import { createPublicSurface } from "@cosmicdrift/kumiko-renderer/web";
 
 // createLoginRoute, not a raw LoginScreen render — it owns the challenge-
 // swap for a second factor, so mounting auth-mfa later doesn't need this

package/samples/recipes/apex-surface-auth/src/feature.ts

@@ -11,7 +11,7 @@
 //   2. Client (Kommentar unten + README): wie createPublicSurface + AuthShell
 //      die Screens in der Apex-Chrome mounten.
 //
-// CLIENT-WIRING (apex.tsx der App — renderer-web, hier nur als Referenz, da
+// CLIENT-WIRING (apex.tsx der App — renderer/web, hier nur als Referenz, da
 // Recipes keine Browser-Deps ziehen):
 //
 //   import {
@@ -22,7 +22,7 @@
 //     RequestAccountDeletionScreen, ConfirmAccountDeletionScreen,
 //     defaultTranslations as deletionI18n,
 //   } from "@cosmicdrift/kumiko-bundled-features/user-data-rights/web";
-//   import { createPublicSurface } from "@cosmicdrift/kumiko-renderer-web";
+//   import { createPublicSurface } from "@cosmicdrift/kumiko-renderer/web";
 //
 //   // AuthShell: die Auth-Card rendert in der Marketing-Chrome statt
 //   // Fullscreen. Default (ohne Provider) bleibt der Fullscreen-Wrapper.

package/samples/recipes/compose-stacks/README.md

@@ -36,22 +36,25 @@ the option.
 | `composeGdprStack` | `kmsMode` | `kms` or `allowPlaintextPii` |
 | `composeGdprStack({ selfService })`, `composeUserDataRightsStack` | `mail` | a mounted `channel-email` |
 | `composeSecurityStack` | `kmsMode`, `rateLimit` not `false` | `kms` or `allowPlaintextPii` |
-| `composeSaasStack({ billing: "stripe" })` | `billing` | a mounted subscription provider |
+| `composeSaasStack({ billing: "stripe" })` | `billing` (warning only) | a mounted subscription provider |
 
 A missing option fails the boot with:
 
 ```
 [runProdApp] stacks in `features` need boot options that are not set:
-  - composeSaasStack needs the boot option `billing`: set billing: { stripe: { priceToTier }, defaultTier }
+  - composeGdprStack needs the boot option `kmsMode`: set kmsMode: "required" (or { plaintextReason } for a demo)
 ```
 
+A stripe `composeSaasStack` without `billing` boots and logs the same line as a warning, so an
+app can go live before its prices exist.
+
 ## Flow
 
 1. `src/app.ts` lists the stacks and the boot options they need.
 2. The test boots with `KUMIKO_DRY_RUN_ENV=boot`, which runs the whole
    validation and stops before any DB or Redis connection: with the options
-   the boot passes, without `billing` or `kmsMode` it fails and names the
-   stacks.
+   the boot passes, without `kmsMode` it fails and names the stacks, and
+   without `billing` it warns.
 
 ## Tests
 

package/samples/recipes/delivery-notifications/README.md

@@ -8,7 +8,7 @@ Shows how a feature sends notifications to multiple channels (InApp + Email + Pu
 
 **Mail text is stored data:** The boot seed (`seedNotificationTemplates`) writes the declared `template` and `meta` into the template store as system templates. The email channel renders them with `renderer-mail-html`. A notification routed to email without `template` and `meta` fails its delivery.
 
-**Tenant override:** A tenant admin overrides the text through the template-resolver handlers (`upsertTenant`, then `publish`). The next mail for that tenant uses the override; the system text stays for everyone else.
+**Tenant override:** Only a SystemAdmin edits templates unless the app unlocks them. The app lists the mail in `createTemplateResolverFeature({ tenantEditable: [{ kind: "mail", slug, access: { roles: ["TenantAdmin"] } }] })`; then a tenant admin overrides the text through the template-resolver handlers (`upsertTenant`, then `publish`) and every other template is refused with 403. The next mail for that tenant uses the override; the system text stays for everyone else.
 
 **Sending:** The write handler calls `ctx.notify(type, { to, data })`. The `data` keys are the template variables; sending fails loudly when a required variable is missing.
 

package/samples/recipes/embedded/README.md

@@ -19,6 +19,14 @@ object and an embedded list rendered by a declarative `entityEdit` screen.
   `createEmbeddedListField`; its renderer receives `embeddedListCells`, so no
   custom screen component is required.
 
+- **Derived head totals** (`src/screens/invoice-receive.screen.ts`): an
+  `actionForm` declares `derive` so net, VAT, and gross follow the lines
+  (`listSum`), or follow a typed net and VAT rate while the list is empty
+  (`whenEmpty`, `percent`). The renderer shows them read-only and live; the
+  handler wraps its schema with `withFormDerivations(schema, screen)`
+  (`src/handlers/invoice-receive.write.ts`), so totals sent by the client are
+  replaced on the server.
+
 ## When to reach for it
 
 Use an embedded field or list when the nested data is created, changed, and

package/samples/recipes/embedded/src/feature.ts

@@ -15,6 +15,9 @@
 //             on its `lines` sub-fields (Issue #1835), plus a declarative
 //             entityEdit screen that renders the list end-to-end via
 //             EmbeddedListField, no custom-screen code required
+//   invoice-receive — actionForm whose net/VAT/gross head fields are derived
+//             from the lines (`derive`); the handler recomputes them with
+//             `withFormDerivations`, so client-sent totals are never trusted
 
 import { defineFeature } from "@cosmicdrift/kumiko-framework/engine";
 import { contactEntity } from "./entities/contact";
@@ -22,6 +25,8 @@ import { invoiceEntity } from "./entities/invoice";
 import { productEntity } from "./entities/product";
 import { contactCreate } from "./handlers/contact-create.write";
 import { contactDetail } from "./handlers/contact-detail.query";
+import { invoiceReceive } from "./handlers/invoice-receive.write";
+import { invoiceReceiveScreen } from "./screens/invoice-receive.screen";
 
 export { contactEntity } from "./entities/contact";
 export { invoiceEntity } from "./entities/invoice";
@@ -43,6 +48,7 @@ export const embeddedFeature = defineFeature("contacts", (r) => {
 
   r.writeHandler(contactCreate);
   r.queryHandler(contactDetail);
+  r.writeHandler(invoiceReceive);
 
   r.crud("product", productEntity, { write: adminWrite, read: openRead });
   r.crud("invoice", invoiceEntity, { write: adminWrite, read: openRead });
@@ -55,4 +61,6 @@ export const embeddedFeature = defineFeature("contacts", (r) => {
       sections: [{ columns: 1, fields: ["customer", "lines"] }],
     },
   });
+
+  r.screen(invoiceReceiveScreen);
 });

package/samples/recipes/embedded/src/handlers/invoice-receive.write.ts

@@ -0,0 +1,38 @@
+import {
+  defineWriteHandler,
+  fieldToZod,
+  withFormDerivations,
+} from "@cosmicdrift/kumiko-framework/engine";
+import { z } from "zod";
+import { invoiceReceiveLines, invoiceReceiveScreen } from "../screens/invoice-receive.screen";
+
+const moneyPayload = z.object({ amount: z.number(), currency: z.string().min(1) });
+
+// The preprocess recomputes net/VAT/gross before validation: totals sent by the
+// client never reach the handler.
+const receiveInput = withFormDerivations(
+  z.object({
+    supplier: z.string().min(1),
+    invoiceNumber: z.string().min(1),
+    lines: fieldToZod(invoiceReceiveLines, ["EUR"]),
+    netTotal: moneyPayload,
+    vatRate: z.number().optional(),
+    vatTotal: moneyPayload,
+    grossTotal: moneyPayload,
+  }),
+  invoiceReceiveScreen,
+);
+
+export const invoiceReceive = defineWriteHandler({
+  name: "invoice:receive",
+  schema: receiveInput,
+  access: { roles: ["Admin"] },
+  handler: async (event) => ({
+    isSuccess: true,
+    data: {
+      netTotal: event.payload.netTotal,
+      vatTotal: event.payload.vatTotal,
+      grossTotal: event.payload.grossTotal,
+    },
+  }),
+});

package/samples/recipes/embedded/src/screens/invoice-receive.screen.ts

@@ -0,0 +1,59 @@
+import {
+  type ActionFormScreenDefinition,
+  createDecimalField,
+  createEmbeddedListField,
+  createTextField,
+} from "@cosmicdrift/kumiko-framework/engine";
+
+const euro = { kind: "literal", code: "EUR" } as const;
+
+export const invoiceReceiveLines = createEmbeddedListField(
+  {
+    description: { type: "text", required: true },
+    amount: { type: "money", required: true },
+    vatRate: { type: "decimal", scale: 2, required: true },
+    vatAmount: { type: "money" },
+  },
+  {
+    derived: { vatAmount: { op: "percent", from: ["amount", "vatRate"] } },
+    totals: ["amount", "vatAmount"],
+  },
+);
+
+// Net/VAT/gross are derived: with line items they are the sum of the lines,
+// without lines the net amount and the VAT rate are typed and VAT/gross follow.
+export const invoiceReceiveScreen: ActionFormScreenDefinition = {
+  id: "invoice-receive",
+  type: "actionForm",
+  handler: "contacts:write:invoice:receive",
+  fields: {
+    supplier: createTextField({ required: true, personal: "tenant", find: "none" }),
+    invoiceNumber: createTextField({
+      required: true,
+      personal: false,
+      reason: "is_business_data",
+    }),
+    lines: invoiceReceiveLines,
+    netTotal: { type: "money", currency: euro },
+    vatRate: createDecimalField({ precision: 5, scale: 2 }),
+    vatTotal: { type: "money", currency: euro },
+    grossTotal: { type: "money", currency: euro },
+  },
+  derive: {
+    netTotal: { op: "listSum", list: "lines", cell: "amount" },
+    vatTotal: {
+      op: "listSum",
+      list: "lines",
+      cell: "vatAmount",
+      whenEmpty: { op: "percent", from: ["netTotal", "vatRate"] },
+    },
+    grossTotal: { op: "sum", from: ["netTotal", "vatTotal"] },
+  },
+  layout: {
+    sections: [
+      { columns: 2, fields: ["supplier", "invoiceNumber"] },
+      { columns: 1, fields: ["lines"] },
+      { columns: 2, fields: ["netTotal", "vatRate", "vatTotal", "grossTotal"] },
+    ],
+  },
+};

package/samples/recipes/embedded-entity-form/package.json

@@ -5,7 +5,6 @@
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "@cosmicdrift/kumiko-renderer": "workspace:*",
-    "@cosmicdrift/kumiko-renderer-web": "workspace:*",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/samples/recipes/embedded-entity-form/src/web/accept-suggestion-drawer.tsx

@@ -1,6 +1,6 @@
 import type { RenderEditControls } from "@cosmicdrift/kumiko-renderer";
 import { RenderEdit, useDispatcher, usePrimitives } from "@cosmicdrift/kumiko-renderer";
-import { Drawer } from "@cosmicdrift/kumiko-renderer-web";
+import { Drawer } from "@cosmicdrift/kumiko-renderer/web";
 import { type ReactNode, useMemo, useRef, useState } from "react";
 import { z } from "zod";
 import { prospectEntity } from "../entities/prospect";

package/samples/recipes/notes-history-basic/README.md

@@ -47,7 +47,7 @@ handler as above. Register `notesHistoryClient()` once (for its component +
 i18n), then mount it either way:
 
 ```tsx illustration
-import { createKumikoApp } from "@cosmicdrift/kumiko-renderer-web";
+import { createKumikoApp } from "@cosmicdrift/kumiko-renderer/web";
 import { notesHistoryClient, NotesSection, NOTES_SECTION_EXTENSION_NAME } from "@cosmicdrift/kumiko-bundled-features/notes-history/web";
 
 // once, at app boot — required even for standalone use (registers i18n):

package/samples/recipes/record-detail-layout/package.json

@@ -9,7 +9,6 @@
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "@cosmicdrift/kumiko-renderer": "workspace:*",
-    "@cosmicdrift/kumiko-renderer-web": "workspace:*",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/samples/recipes/tags-basic/README.md

@@ -48,7 +48,7 @@ as above. Register `tagsClient()` once (for its component + i18n), then mount it
 either way:
 
 ```tsx illustration
-import { createKumikoApp } from "@cosmicdrift/kumiko-renderer-web";
+import { createKumikoApp } from "@cosmicdrift/kumiko-renderer/web";
 import { tagsClient, TagSection, TAGS_SECTION_EXTENSION_NAME } from "@cosmicdrift/kumiko-bundled-features/tags/web";
 
 // once, at app boot — required even for standalone use (registers i18n):

package/samples/recipes/user-profile/README.md

@@ -46,7 +46,7 @@ itself needs no client registration):
 ```tsx illustration
 import { userProfileClient } from "@cosmicdrift/kumiko-bundled-features/user-profile/web";
 import { emailPasswordClient } from "@cosmicdrift/kumiko-bundled-features/auth-email-password/web";
-import { createKumikoApp } from "@cosmicdrift/kumiko-renderer-web";
+import { createKumikoApp } from "@cosmicdrift/kumiko-renderer/web";
 
 createKumikoApp({
   clientFeatures: [emailPasswordClient(), userProfileClient()],

package/samples/recipes/wizard-form/package.json

@@ -10,7 +10,6 @@
     "@cosmicdrift/kumiko-bundled-features": "workspace:*",
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "@cosmicdrift/kumiko-renderer": "workspace:*",
-    "@cosmicdrift/kumiko-renderer-web": "workspace:*",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/samples/recipes/wizard-form/src/web/index.ts

@@ -3,11 +3,11 @@
 // A `kind: "extension"` section only resolves through
 // clientFeatures.extensionSectionComponents (createKumikoApp → ExtensionSectionsProvider)
 // — never imported directly from feature.ts, which keeps the server file
-// free of the renderer-web graph. Without registering this export, an app
+// free of the renderer/web graph. Without registering this export, an app
 // mounting this recipe gets RenderEdit's fallback placeholder instead of
 // the real review step.
 
-import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer-web";
+import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer/web";
 import { ListingReviewSection } from "./listing-review-section";
 
 export const listingsClient: ClientFeatureDefinition = {

package/samples/recipes/wizard-form/src/web/listing-review-section.tsx

@@ -1,11 +1,11 @@
 import type { ExtensionSectionProps } from "@cosmicdrift/kumiko-renderer";
-import { DetailList } from "@cosmicdrift/kumiko-renderer-web";
+import { DetailList } from "@cosmicdrift/kumiko-renderer/web";
 import type { ReactNode } from "react";
 
 // Registered under the `__component` name the feature's review section
 // points at (see feature.ts) — never imported by feature.ts itself, the
 // string name is the only link so the server file stays free of the
-// renderer-web graph.
+// renderer/web graph.
 export function ListingReviewSection({ values }: ExtensionSectionProps): ReactNode {
   return (
     <DetailList

package/samples/recipes/writeform-section/package.json

@@ -10,7 +10,6 @@
   "dependencies": {
     "@cosmicdrift/kumiko-framework": "workspace:*",
     "@cosmicdrift/kumiko-renderer": "workspace:*",
-    "@cosmicdrift/kumiko-renderer-web": "workspace:*",
     "react": "^19.2.6"
   },
   "devDependencies": {