@cosmicdrift/kumiko-framework 0.328.0 → 0.329.0

package/src/engine/__tests__/screen.test.ts

@@ -1,1684 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import * as z from "zod";
-import { withBootValidatorFixture } from "../../testing/boot-validator-fixture";
-import { validateBoot as validateBootRaw } from "../boot-validator";
-import { createTenantConfig } from "../config-helpers";
-import { defineFeature } from "../define-feature";
-import { defineEntityListHandler } from "../entity-handlers";
-import { createDerivedField, createEntity, createTextField } from "../factories";
-import { createRegistry } from "../registry";
-import type { ScreenDefinition } from "../types/screen";
-
-function validateBoot(features: Parameters<typeof validateBootRaw>[0]): void {
-  validateBootRaw(withBootValidatorFixture(features));
-}
-
-function productEntity() {
-  return createEntity({
-    table: "products",
-    fields: {
-      name: createTextField({ personal: false, reason: "test_fixture" }),
-      sku: createTextField({ personal: false, reason: "test_fixture" }),
-    },
-  });
-}
-
-function derivedProductEntity() {
-  return createEntity({
-    table: "derived_products",
-    fields: {
-      name: createTextField({ personal: false, reason: "test_fixture" }),
-    },
-    derivedFields: {
-      summary: createDerivedField({
-        valueType: "text",
-        derive: (row) => String(row["name"]),
-      }),
-    },
-  });
-}
-
-describe("r.screen() — registration", () => {
-  test("stores an entityList screen on the FeatureDefinition", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name", "sku"],
-      });
-    });
-    expect(feature.screens["product-list"]).toBeDefined();
-    expect(feature.screens["product-list"]?.type).toBe("entityList");
-  });
-
-  test("stores a projectionList screen bound to an explicit (cross-feature) query", () => {
-    const feature = defineFeature("app", (r) => {
-      r.screen({
-        id: "rent-list",
-        type: "projectionList",
-        query: "ledger:query:schedule:list",
-        columns: [
-          { field: "description", label: "app:col.desc" },
-          {
-            field: "amount",
-            label: "app:col.amount",
-            renderer: { react: { __component: "EuroCell" } },
-          },
-        ],
-      });
-    });
-    const screen = feature.screens["rent-list"];
-    expect(screen?.type).toBe("projectionList");
-    if (screen?.type !== "projectionList") throw new Error("type-narrow failed");
-    expect(screen.query).toBe("ledger:query:schedule:list");
-  });
-
-  test("validateBoot rejects a projectionList with empty columns", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({ id: "x", type: "projectionList", query: "app:query:foo:list", columns: [] });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/empty columns list/i);
-  });
-
-  test("validateBoot rejects a projectionList with an empty query", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({ id: "x", type: "projectionList", query: "", columns: ["name"] });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/empty or non-string query/i);
-  });
-
-  test("stores a projectionDetail screen bound to an explicit query", () => {
-    const feature = defineFeature("app", (r) => {
-      r.screen({
-        id: "rent-detail",
-        type: "projectionDetail",
-        query: "ledger:query:schedule:detail",
-        layout: { sections: [{ title: "app:section.basics", fields: ["description"] }] },
-      });
-    });
-    const screen = feature.screens["rent-detail"];
-    expect(screen?.type).toBe("projectionDetail");
-    if (screen?.type !== "projectionDetail") throw new Error("type-narrow failed");
-    expect(screen.query).toBe("ledger:query:schedule:detail");
-  });
-
-  test("validateBoot rejects a projectionDetail with an empty query", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "",
-          layout: { sections: [{ title: "s", fields: ["name"] }] },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/empty or non-string query/i);
-  });
-
-  test("validateBoot rejects a projectionDetail with empty sections", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: { sections: [] },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/empty sections list/i);
-  });
-
-  test("validateBoot rejects a projectionDetail section with zero fields", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: { sections: [{ title: "s", fields: [] }] },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/zero fields/i);
-  });
-
-  test("validateBoot rejects a projectionDetail extension section with contributesToFormSubmit: true (read-only screen, solon#264)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "extension",
-                title: "s",
-                component: { react: { __component: "c" } },
-                entityName: "lease",
-                contributesToFormSubmit: true,
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/no form submit to contribute to/i);
-  });
-
-  test("validateBoot rejects a projectionDetail extension section without entityName", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              { kind: "extension", title: "s", component: { react: { __component: "c" } } },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/has no entityName/i);
-  });
-
-  test("validateBoot rejects a projectionDetail extension section with no component", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [{ kind: "extension", title: "s", component: {}, entityName: "lease" }],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/has no component/i);
-  });
-
-  test("validateBoot boots a projectionDetail extension section without contributesToFormSubmit (self-persisting, solon#264)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "extension",
-                title: "s",
-                component: { react: { __component: "c" } },
-                entityName: "lease",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).not.toThrow();
-  });
-
-  test("validateBoot rejects a projectionDetail relatedList section with an empty query (fw#2166)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [{ kind: "relatedList", title: "s", query: "", columns: ["name"] }],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /Screen "x".*relatedList.*empty or non-string query/,
-    );
-  });
-
-  test("validateBoot rejects a relatedList rowClick with no matching detailFor screen (fw#2166)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "relatedList",
-                title: "s",
-                query: "app:query:foo:list",
-                columns: ["name"],
-                rowClick: { entity: "invoice" },
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /Add detailFor: "invoice" to the screen that shows it\./,
-    );
-  });
-
-  test("validateBoot accepts a relatedList rowClick with a detailFor screen in another feature (fw#2166)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "relatedList",
-                title: "s",
-                query: "app:query:foo:list",
-                columns: ["name"],
-                rowClick: { entity: "invoice" },
-              },
-            ],
-          },
-        });
-      }),
-      defineFeature("billing", (r) => {
-        r.entity(
-          "invoice",
-          createEntity({
-            table: "invoices",
-            fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-          }),
-        );
-        r.screen({
-          id: "invoice-detail",
-          type: "custom",
-          renderer: { react: { __component: "stub" } },
-          detailFor: "invoice",
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).not.toThrow();
-  });
-
-  test("validateBoot rejects a relatedList section in a wizard layout (fw#2166)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            mode: "wizard",
-            sections: [
-              { kind: "relatedList", title: "s", query: "app:query:foo:list", columns: ["name"] },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/relatedList.*wizard layout/);
-  });
-
-  test("validateBoot accepts a valid relatedList section without rowClick (fw#2166)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              { kind: "relatedList", title: "s", query: "app:query:foo:list", columns: ["name"] },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).not.toThrow();
-  });
-
-  describe("relatedList search + facets (fw#2740)", () => {
-    test("rejects searchable: true when the bound query's schema has no search parameter", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name"],
-                  searchable: true,
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(/searchable: true.*"search"/);
-    });
-
-    test("accepts searchable: true when the bound query's schema accepts search", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler(
-            "foo:list",
-            z.object({ search: z.string().optional() }),
-            async () => ({ rows: [], nextCursor: null }),
-            {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            },
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name"],
-                  searchable: true,
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).not.toThrow();
-    });
-
-    test("rejects facets when the bound query's schema has no filters parameter", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name", "status"],
-                  facets: [
-                    {
-                      field: "status",
-                      type: "select",
-                      label: "Status",
-                      options: [{ value: "active", label: "Active" }],
-                    },
-                  ],
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(/declares facets but query.*"filters"/);
-    });
-
-    test("rejects a facet whose field is not a declared column", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler(
-            "foo:list",
-            z.object({ filters: z.array(z.object({})).optional() }),
-            async () => ({ rows: [], nextCursor: null }),
-            {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            },
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name"],
-                  facets: [
-                    {
-                      field: "status",
-                      type: "select",
-                      label: "Status",
-                      options: [{ value: "active", label: "Active" }],
-                    },
-                  ],
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(
-        /relatedList section "s".*facet references field "status" which is not a declared column/,
-      );
-    });
-
-    test("accepts valid facets when the bound query's schema accepts filters", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler(
-            "foo:list",
-            z.object({ filters: z.array(z.object({})).optional() }),
-            async () => ({ rows: [], nextCursor: null }),
-            {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            },
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name", "status"],
-                  facets: [
-                    {
-                      field: "status",
-                      type: "select",
-                      label: "Status",
-                      options: [{ value: "active", label: "Active" }],
-                    },
-                  ],
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).not.toThrow();
-    });
-  });
-
-  describe("relatedList parentFilter", () => {
-    test("rejects parentFilter combined with parentParam on the same section", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler(
-            "foo:list",
-            z.object({ filter: z.unknown().optional() }),
-            async () => ({ rows: [], nextCursor: null }),
-            {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            },
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name"],
-                  parentParam: "orderId",
-                  parentFilter: { field: "orderId" },
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(/declares both parentFilter and parentParam/);
-    });
-
-    test("rejects parentFilter when the bound query's schema has no filter parameter", () => {
-      const features = [
-        defineFeature("app", (r) => {
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:foo:list",
-                  columns: ["name"],
-                  parentFilter: { field: "orderId" },
-                },
-              ],
-            },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(
-        /declares parentFilter but query.*no "filter" parameter/,
-      );
-    });
-
-    test("rejects parentFilter.field that is not a declared field on the entity behind the query", () => {
-      const orderEntity = createEntity({
-        table: "orders",
-        fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-      });
-      const features = [
-        defineFeature("app", (r) => {
-          r.entity("order", orderEntity);
-          r.queryHandler(
-            defineEntityListHandler("order", orderEntity, {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            }),
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:order:list",
-                  columns: ["name"],
-                  parentFilter: { field: "unknownField" },
-                },
-              ],
-            },
-          });
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).toThrow(
-        /parentFilter\.field "unknownField" is not a declared field/,
-      );
-    });
-
-    test("accepts a valid parentFilter whose field is a real entity field and the query accepts filter", () => {
-      const orderEntity = createEntity({
-        table: "orders",
-        fields: {
-          name: createTextField({ personal: false, reason: "test_fixture" }),
-          orderId: createTextField({ personal: false, reason: "test_fixture" }),
-        },
-      });
-      const features = [
-        defineFeature("app", (r) => {
-          r.entity("order", orderEntity);
-          r.queryHandler(
-            defineEntityListHandler("order", orderEntity, {
-              access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-            }),
-          );
-          r.screen({
-            id: "x",
-            type: "projectionDetail",
-            query: "app:query:foo:detail",
-            layout: {
-              sections: [
-                {
-                  kind: "relatedList",
-                  title: "s",
-                  query: "app:query:order:list",
-                  columns: ["name"],
-                  parentFilter: { field: "orderId" },
-                },
-              ],
-            },
-          });
-          r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-            access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-          });
-        }),
-      ];
-      expect(() => validateBoot(features)).not.toThrow();
-    });
-  });
-
-  test("validateBoot rejects a relatedList section on entityEdit (fw#2166)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.entity("product", productEntity());
-        r.screen({
-          id: "product-edit",
-          type: "entityEdit",
-          entity: "product",
-          layout: {
-            sections: [
-              { kind: "relatedList", title: "s", query: "shop:query:foo:list", columns: ["name"] },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(entityEdit\) relatedList section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("validateBoot rejects a relatedList section on configEdit (fw#2166)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.config({
-          keys: { "site-name": createTenantConfig("text", { default: "" }) },
-        });
-        r.screen({
-          id: "settings",
-          type: "configEdit",
-          scope: "tenant",
-          configKeys: { siteName: "shop:config:site-name" },
-          fields: { siteName: { type: "text" } } as never,
-          layout: {
-            sections: [
-              { kind: "relatedList", title: "s", query: "shop:query:foo:list", columns: ["name"] },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(configEdit\) relatedList section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("validateBoot rejects a relatedList section on actionForm (fw#2166)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.writeHandler(
-          "restock",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          { access: { roles: ["Admin"] } },
-        );
-        r.screen({
-          id: "restock",
-          type: "actionForm",
-          handler: "shop:write:restock",
-          fields: { qty: { type: "number" } } as never,
-          layout: {
-            sections: [
-              { kind: "relatedList", title: "s", query: "shop:query:foo:list", columns: ["name"] },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(actionForm\) relatedList section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("validateBoot rejects a relatedList rowAction with an unregistered write-handler (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "relatedList",
-                title: "s",
-                query: "app:query:foo:list",
-                columns: ["name"],
-                rowActions: [{ id: "sync", label: "actions.sync", handler: "app:write:missing" }],
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /relatedList\).*rowAction "sync" handler "app:write:missing".*not a registered write-handler/,
-    );
-  });
-
-  test("validateBoot accepts a relatedList rowAction bound to a registered write-handler (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.writeHandler(
-          "sync",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          {
-            access: { roles: ["Admin"] },
-          },
-        );
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.queryHandler("foo:list", z.object({}), async () => ({ rows: [], nextCursor: null }), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "relatedList",
-                title: "s",
-                query: "app:query:foo:list",
-                columns: ["name"],
-                rowActions: [
-                  {
-                    id: "sync",
-                    label: "actions.sync",
-                    handler: "app:write:sync",
-                    payload: { pick: ["name"] },
-                  },
-                ],
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).not.toThrow();
-  });
-
-  test("validateBoot rejects a relatedList section with both rowClick and a rowActions rowClick:true entry (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("billing", (r) => {
-        r.entity(
-          "invoice",
-          createEntity({
-            table: "invoices",
-            fields: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-          }),
-        );
-        r.screen({
-          id: "invoice-detail",
-          type: "custom",
-          renderer: { react: { __component: "stub" } },
-          detailFor: "invoice",
-        });
-      }),
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "relatedList",
-                title: "s",
-                query: "app:query:foo:list",
-                columns: ["name"],
-                rowClick: { entity: "invoice" },
-                rowActions: [
-                  {
-                    kind: "navigate",
-                    id: "open",
-                    label: "actions.open",
-                    entity: "invoice",
-                    entityId: "id",
-                    rowClick: true,
-                  },
-                ],
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /relatedList\).*has both a rowClick and 1 rowActions marked rowClick:true/,
-    );
-  });
-
-  test("validateBoot rejects a projectionDetail writeForm section with an empty fieldDefs map (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: {},
-                fields: ["name"],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/\(writeForm\) has an empty fieldDefs map/);
-  });
-
-  test("validateBoot rejects a projectionDetail writeForm section with zero fields (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: [],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/\(writeForm\) has zero fields/);
-  });
-
-  test("validateBoot rejects a projectionDetail writeForm field with no entry in fieldDefs (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["sku"],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(writeForm\) field "sku" has no entry in fieldDefs/,
-    );
-  });
-
-  test("validateBoot rejects a projectionDetail writeForm section in a wizard layout (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            mode: "wizard",
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(/writeForm.*wizard layout/);
-  });
-
-  test("validateBoot rejects a projectionDetail writeForm section with an unregistered write-handler (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "app:write:missing",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(writeForm\) handler "app:write:missing".*not a registered write-handler/,
-    );
-  });
-
-  test("validateBoot accepts a valid projectionDetail writeForm section (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.writeHandler(
-          "save",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          {
-            access: { roles: ["Admin"] },
-          },
-        );
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "app:write:save",
-                submitLabel: "actions.save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).not.toThrow();
-  });
-
-  // withBootValidatorFixture auto-fills every key requiredKeysFromFeature
-  // reports, so every other boot test in this file passes regardless of
-  // whether required-surface-keys.ts's writeForm branch names the right key
-  // — it would pass even for a wrong namespace. Bypass the fixture (raw
-  // validateBootRaw, no stubTranslations) to pin the actual key contract.
-  test("validateBoot requires a translation for a writeForm field's own label, namespaced under the write-form pseudo-entity (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        // Screens always require their own "screen:<id>.title" key — supplied
-        // here so the throw below isolates the one key this test is about.
-        r.translations({ keys: { "screen:x.title": { en: "X" } } });
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.writeHandler(
-          "save",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          { access: { roles: ["Admin"] } },
-        );
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-
-    expect(() => validateBootRaw(features)).toThrow(
-      '[i18n] Feature "app": required translation key missing: "app:entity:__write-form-section__:field:name"',
-    );
-  });
-
-  test("translating the writeForm field's pseudo-entity key lets boot pass", () => {
-    const features = [
-      defineFeature("app", (r) => {
-        r.translations({
-          keys: {
-            "screen:x.title": { en: "X" },
-            "app:entity:__write-form-section__:field:name": { en: "Name" },
-          },
-        });
-        r.queryHandler("foo:detail", z.object({}), async () => ({}), {
-          access: { openToAll: { reason: "test handler callable by any signed-in test user" } },
-        });
-        r.writeHandler(
-          "save",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          { access: { roles: ["Admin"] } },
-        );
-        r.screen({
-          id: "x",
-          type: "projectionDetail",
-          query: "app:query:foo:detail",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "app:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-
-    expect(() => validateBootRaw(features)).not.toThrow();
-  });
-
-  test("validateBoot rejects a writeForm section on entityEdit (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.entity("product", productEntity());
-        r.screen({
-          id: "product-edit",
-          type: "entityEdit",
-          entity: "product",
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "shop:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(entityEdit\) writeForm section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("validateBoot rejects a writeForm section on configEdit (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.config({
-          keys: { "site-name": createTenantConfig("text", { default: "" }) },
-        });
-        r.screen({
-          id: "settings",
-          type: "configEdit",
-          scope: "tenant",
-          configKeys: { siteName: "shop:config:site-name" },
-          fields: { siteName: { type: "text" } } as never,
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "shop:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(configEdit\) writeForm section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("validateBoot rejects a writeForm section on actionForm (fw editable-detail-screens)", () => {
-    const features = [
-      defineFeature("shop", (r) => {
-        r.writeHandler(
-          "restock",
-          z.object({}),
-          async () => ({ isSuccess: true as const, data: null }),
-          { access: { roles: ["Admin"] } },
-        );
-        r.screen({
-          id: "restock",
-          type: "actionForm",
-          handler: "shop:write:restock",
-          fields: { qty: { type: "number" } } as never,
-          layout: {
-            sections: [
-              {
-                kind: "writeForm",
-                title: "s",
-                fieldDefs: { name: createTextField({ personal: false, reason: "test_fixture" }) },
-                fields: ["name"],
-                handler: "shop:write:save",
-              },
-            ],
-          },
-        });
-      }),
-    ];
-    expect(() => validateBoot(features)).toThrow(
-      /\(actionForm\) writeForm section "s".*projectionDetail-only/,
-    );
-  });
-
-  test("stores an entityEdit screen with sections + conditional fields", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: {
-          sections: [
-            {
-              title: "shop:section.basics",
-              columns: 2,
-              fields: ["name", { field: "sku", readOnly: { field: "sku", ne: null } }],
-            },
-          ],
-        },
-      });
-    });
-    const screen = feature.screens["product-edit"];
-    expect(screen?.type).toBe("entityEdit");
-    if (screen?.type !== "entityEdit") throw new Error("type-narrow failed");
-    expect(screen.layout.sections).toHaveLength(1);
-  });
-
-  test("stores a custom screen with a renderer + routes", () => {
-    const feature = defineFeature("dashboard", (r) => {
-      r.screen({
-        id: "overview",
-        type: "custom",
-        renderer: { react: { __component: "dashboard-overview" } },
-        routes: [{ path: "/revenue", component: { react: { __component: "revenue" } } }],
-      });
-    });
-    const screen = feature.screens["overview"];
-    expect(screen?.type).toBe("custom");
-    if (screen?.type !== "custom") throw new Error("type-narrow failed");
-    expect(screen.routes).toHaveLength(1);
-  });
-
-  test("rejects duplicate screen ids within the same feature", () => {
-    expect(() =>
-      defineFeature("shop", (r) => {
-        r.entity("product", productEntity());
-        r.screen({
-          id: "product-list",
-          type: "entityList",
-          entity: "product",
-          columns: ["name"],
-        });
-        r.screen({
-          id: "product-list",
-          type: "entityEdit",
-          entity: "product",
-          layout: { sections: [] },
-        });
-      }),
-    ).toThrow(/already registered/);
-  });
-
-  test("rejects non-kebab-case screen ids", () => {
-    expect(() =>
-      defineFeature("shop", (r) => {
-        r.entity("product", productEntity());
-        r.screen({
-          id: "productList",
-          type: "entityList",
-          entity: "product",
-          columns: ["name"],
-        });
-      }),
-    ).toThrow(/kebab-case/);
-  });
-
-  test("accepts kebab-case screen ids", () => {
-    expect(() =>
-      defineFeature("shop", (r) => {
-        r.entity("product", productEntity());
-        r.screen({
-          id: "product-list",
-          type: "entityList",
-          entity: "product",
-          columns: ["name"],
-        });
-      }),
-    ).not.toThrow();
-  });
-});
-
-describe("createRegistry — screen indexing", () => {
-  test("indexes screens by qualified name", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const registry = createRegistry([feature]);
-    expect(registry.getAllScreens().size).toBe(1);
-    expect(registry.getScreen("shop:screen:product-list")).toBeDefined();
-  });
-
-  test("returns undefined for unknown qualified names", () => {
-    const registry = createRegistry([]);
-    expect(registry.getScreen("ghost:screen:nope")).toBeUndefined();
-  });
-
-  test("getScreenFeature maps a screen back to its owning feature", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const registry = createRegistry([feature]);
-    expect(registry.getScreenFeature("shop:screen:product-list")).toBe("shop");
-    expect(registry.getScreenFeature("shop:screen:does-not-exist")).toBeUndefined();
-  });
-
-  test("same screen id from two features qualifies to different names", () => {
-    const shop = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const warehouse = defineFeature("warehouse", (r) => {
-      r.entity("item", productEntity());
-      r.screen({ id: "list", type: "entityList", entity: "item", columns: ["name"] });
-    });
-    const registry = createRegistry([shop, warehouse]);
-    expect(registry.getAllScreens().size).toBe(2);
-    expect(registry.getScreen("shop:screen:list")).toBeDefined();
-    expect(registry.getScreen("warehouse:screen:list")).toBeDefined();
-  });
-
-  test("getScreensByEntity groups entity-bound screens", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-      r.screen({
-        id: "product-edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: { sections: [{ title: "t", fields: ["name"] }] },
-      });
-      // custom screens have no entity; they must not show up in the index.
-      r.screen({ id: "overview", type: "custom", renderer: { react: { __c: true } } });
-    });
-    const registry = createRegistry([feature]);
-    const byProduct = registry.getScreensByEntity("product");
-    expect(byProduct).toHaveLength(2);
-    // Stored screens carry the qualified id — same contract as
-    // getScreen(qn).id / getAllScreens() values. Saves ui-core the reverse
-    // index when recursing through slots / field renderers by QN.
-    expect(byProduct.map((s) => s.id).sort()).toEqual([
-      "shop:screen:product-edit",
-      "shop:screen:product-list",
-    ]);
-  });
-
-  test("getScreensByEntity aggregates screens on the same entity from two different features", () => {
-    const shop = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const reporting = defineFeature("reporting", (r) => {
-      r.screen({
-        id: "product-stats",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const registry = createRegistry([shop, reporting]);
-    const byProduct = registry.getScreensByEntity("product");
-    expect(byProduct.map((s) => s.id).sort()).toEqual([
-      "reporting:screen:product-stats",
-      "shop:screen:product-list",
-    ]);
-  });
-
-  test("getScreen / getScreensByEntity return stored screens with qualified id", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "product-list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name"],
-      });
-    });
-    const registry = createRegistry([feature]);
-    // Input-side (unregistered FeatureDefinition) keeps the short form.
-    expect(feature.screens["product-list"]?.id).toBe("product-list");
-    // Registry-side always exposes the qualified form.
-    expect(registry.getScreen("shop:screen:product-list")?.id).toBe("shop:screen:product-list");
-  });
-
-  test("getScreensByEntity returns empty for unknown entities", () => {
-    const registry = createRegistry([]);
-    expect(registry.getScreensByEntity("ghost")).toHaveLength(0);
-  });
-});
-
-describe("validateBoot — screen validation", () => {
-  test("entityList with unknown entity fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "ghost",
-        columns: ["name"],
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/references entity "ghost"/);
-  });
-
-  test("cross-feature entity-ref hint points at the real owner", () => {
-    // Entity exists, but in another feature. The hint helps the feature
-    // author realise cross-feature screen ownership isn't supported.
-    const shop = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-    });
-    const ui = defineFeature("ui", (r) => {
-      r.screen({ id: "list", type: "entityList", entity: "product", columns: ["name"] });
-    });
-    expect(() => validateBoot([shop, ui])).toThrow(/owned by feature "shop"/);
-  });
-
-  test("entityList with unknown field (string form) fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name", "mistake"],
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/field "mistake"/);
-  });
-
-  test("entityList with unknown field (object form) fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "product",
-        columns: [{ field: "nonexistent" }],
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/field "nonexistent"/);
-  });
-
-  test("entityList with a derived-field column boots (derived is a valid column)", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", derivedProductEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name", "summary"],
-      });
-    });
-    expect(() => validateBoot([feature])).not.toThrow();
-  });
-
-  test("entityList defaultSort on a derived field fails boot (server sort can't apply)", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", derivedProductEntity());
-      r.screen({
-        id: "list",
-        type: "entityList",
-        entity: "product",
-        columns: ["name", "summary"],
-        defaultSort: { field: "summary", dir: "asc" },
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/defaultSort references unknown field "summary"/);
-  });
-
-  test("entityEdit with unknown field (string form in sections) fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: {
-          sections: [{ title: "s", fields: ["name", "oops"] }],
-        },
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/field "oops"/);
-  });
-
-  test("entityEdit with unknown field (object form in sections) fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: {
-          sections: [{ title: "s", fields: [{ field: "ghost" }] }],
-        },
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/field "ghost"/);
-  });
-
-  test("custom screen without a renderer-component (neither react nor native) fails", () => {
-    const feature = defineFeature("dashboard", (r) => {
-      const screen: ScreenDefinition = {
-        id: "empty",
-        type: "custom",
-        renderer: {},
-      };
-      r.screen(screen);
-    });
-    expect(() => validateBoot([feature])).toThrow(/neither a react nor a native component/);
-  });
-
-  test("custom screen with just react passes", () => {
-    const feature = defineFeature("dashboard", (r) => {
-      r.screen({
-        id: "ok",
-        type: "custom",
-        renderer: { react: { __component: true } },
-      });
-    });
-    expect(() => validateBoot([feature])).not.toThrow();
-  });
-
-  test("custom screen with just native passes (mobile-only feature)", () => {
-    const feature = defineFeature("dashboard", (r) => {
-      r.screen({
-        id: "ok",
-        type: "custom",
-        renderer: { native: { __component: true } },
-      });
-    });
-    expect(() => validateBoot([feature])).not.toThrow();
-  });
-
-  test("fully-populated entityEdit with sections + slots + conditionals passes boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: {
-          sections: [
-            {
-              title: "shop:section.basics",
-              columns: 2,
-              fields: ["name", { field: "sku", visible: true, required: true }],
-            },
-          ],
-        },
-        slots: { header: { react: { __component: "h" } } },
-        access: { roles: ["Admin"] },
-      });
-    });
-    expect(() => validateBoot([feature])).not.toThrow();
-  });
-
-  test("wizard entityEdit with slots.footer passes boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit-wizard",
-        type: "entityEdit",
-        entity: "product",
-        layout: {
-          mode: "wizard",
-          sections: [
-            { title: "shop:section.basics", fields: ["name"] },
-            { title: "shop:section.details", fields: ["sku"] },
-          ],
-        },
-        slots: { footer: { react: { __component: "f" } } },
-      });
-    });
-    expect(() => validateBoot([feature])).not.toThrow();
-  });
-
-  test("entityList with empty columns fails boot", () => {
-    // Blank columns list renders as a blank table — almost always an author
-    // oversight. Locked down at boot rather than silently producing an empty
-    // UI surface.
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({ id: "list", type: "entityList", entity: "product", columns: [] });
-    });
-    expect(() => validateBoot([feature])).toThrow(/empty columns list/);
-  });
-
-  test("entityEdit with empty sections fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: { sections: [] },
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/empty sections list/);
-  });
-
-  test("entityEdit with a section that has zero fields fails boot", () => {
-    const feature = defineFeature("shop", (r) => {
-      r.entity("product", productEntity());
-      r.screen({
-        id: "edit",
-        type: "entityEdit",
-        entity: "product",
-        layout: { sections: [{ title: "shop:section.empty", fields: [] }] },
-      });
-    });
-    expect(() => validateBoot([feature])).toThrow(/zero fields/);
-  });
-});