@cosmicdrift/kumiko-renderer 0.114.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.114.0",
+  "version": "1.0.0",
   "description": "Platform-agnostic React renderer for Kumiko screens. Contains the shared logic — primitives-contract, hooks, KumikoScreen, navigation & SSE abstractions — that any platform-specific renderer (web, native) composes. No DOM, no EventSource, no react-dom.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -15,8 +15,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.114.0",
-    "@cosmicdrift/kumiko-headless": "0.114.0",
+    "@cosmicdrift/kumiko-framework": "1.0.0",
+    "@cosmicdrift/kumiko-headless": "1.0.0",
     "react": "^19.2.6"
   },
   "devDependencies": {

package/src/app/kumiko-screen.tsx

@@ -5,7 +5,6 @@ import type {
   EntityDefinition,
   EntityEditScreenDefinition,
   EntityListScreenDefinition,
-  ProjectionListScreenDefinition,
   RowAction,
   RowActionNavigate,
   RowActionWriteHandler,
@@ -36,7 +35,6 @@ import { synthesizeConfigEditEntity, synthesizeConfigEditScreen } from "./config
 import { useCustomScreenComponent } from "./custom-screens";
 import type { FeatureSchema } from "./feature-schema";
 import { useNav } from "./nav";
-import { synthesizeProjectionEntity, synthesizeProjectionScreen } from "./projection-list-shim";
 import { lastSegment } from "./qn";
 import { dispatcherErrorText, WriteFailedError } from "./write-failed-error";
 
@@ -137,15 +135,6 @@ export function KumikoScreen({
           {...(onRowClick !== undefined && { onRowClick })}
         />
       );
-    case "projectionList":
-      return (
-        <ProjectionListBody
-          schema={schema}
-          screen={screen}
-          translate={translate}
-          {...(onRowClick !== undefined && { onRowClick })}
-        />
-      );
     case "actionForm":
       return <ActionFormBody schema={schema} screen={screen} translate={translate} />;
     case "configEdit":
@@ -1006,131 +995,6 @@ function EntityListBody({
   );
 }
 
-// ---- projection-list ----
-
-// Wie entityList, aber die List-Query kommt DIREKT aus `screen.query` (statt aus
-// der Entity abgeleitet) — dadurch cross-feature-fähig. v1 bewusst schlank:
-// rendert die Query-Rows mit den (explizit gelabelten) Columns + navigate-
-// RowActions/Row-Klick. Kein Server-Sort/-Pagination/-Facetten (eine Projection-
-// Query hat dafür keinen garantierten Contract) — die kommen bei Bedarf später.
-function ProjectionListBody({
-  schema,
-  screen,
-  translate,
-  onRowClick,
-}: {
-  readonly schema: FeatureSchema;
-  readonly screen: ProjectionListScreenDefinition;
-  readonly translate?: Translate;
-  readonly onRowClick?: (row: ListRowViewModel, entityName: string) => void;
-}): ReactNode {
-  const { Banner } = usePrimitives();
-  const t = useTranslation();
-  const nav = useNav();
-  const effectiveTranslate = translate ?? t;
-  const entity = useMemo(() => synthesizeProjectionEntity(screen.columns), [screen.columns]);
-  const listScreen = useMemo(() => synthesizeProjectionScreen(screen), [screen]);
-  const rowsQuery = useQuery<PagedRows>(screen.query, {}, { live: true });
-
-  const runNavigate = useCallback(
-    (action: RowActionNavigate, row: ListRowViewModel) => {
-      const entityId =
-        action.entityId !== undefined ? String(row.values[action.entityId] ?? "") : undefined;
-      nav.navigate({
-        screenId: action.screen,
-        ...(entityId !== undefined && entityId !== "" && { entityId }),
-      });
-      const params =
-        action.params !== undefined ? evalRowExtractor(action.params, row.values) : undefined;
-      if (params !== undefined) {
-        const stringified: Record<string, string | null> = {};
-        for (const [k, v] of Object.entries(params)) {
-          stringified[k] = v === null || v === undefined ? null : String(v);
-        }
-        nav.setSearchParams(stringified);
-      }
-    },
-    [nav],
-  );
-
-  const rowActions = useMemo((): readonly DataTableRowAction[] | undefined => {
-    if (screen.rowActions === undefined) return undefined;
-    const out: DataTableRowAction[] = [];
-    for (const action of screen.rowActions) {
-      // v1: nur navigate (writeHandler-RowActions bräuchten den Dispatcher-Pfad).
-      if (action.kind !== "navigate") continue;
-      const navigateAction = action;
-      const visible = action.visible;
-      out.push({
-        id: action.id,
-        label: effectiveTranslate(action.label),
-        ...(action.style !== undefined && { style: action.style }),
-        onTrigger: (row: ListRowViewModel) => runNavigate(navigateAction, row),
-        ...(visible !== undefined && {
-          isVisible: (row: ListRowViewModel) => evalFieldCondition(visible, row.values),
-        }),
-      });
-    }
-    return out.length > 0 ? out : undefined;
-  }, [screen.rowActions, effectiveTranslate, runNavigate]);
-
-  const toolbarActions = useMemo((): readonly ToolbarActionButton[] | undefined => {
-    if (screen.toolbarActions === undefined) return undefined;
-    const out: ToolbarActionButton[] = [];
-    for (const action of screen.toolbarActions) {
-      // v1: nur navigate (writeHandler-Toolbar bräuchte den Dispatcher-Pfad).
-      if (action.kind !== "navigate") continue;
-      const target = action.screen;
-      out.push({
-        id: action.id,
-        label: effectiveTranslate(action.label),
-        ...(action.style !== undefined && { style: action.style }),
-        onTrigger: () => nav.navigate({ screenId: target }),
-      });
-    }
-    return out.length > 0 ? out : undefined;
-  }, [screen.toolbarActions, effectiveTranslate, nav]);
-
-  if (rowsQuery.loading && rowsQuery.data === null) {
-    return (
-      <Banner padded variant="loading" testId="kumiko-screen-loading">
-        Loading…
-      </Banner>
-    );
-  }
-  if (rowsQuery.error) {
-    return (
-      <Banner padded variant="error" testId="kumiko-screen-error">
-        {rowsQuery.error.i18nKey}
-      </Banner>
-    );
-  }
-
-  const rowClickAction = screen.rowActions?.find(
-    (a): a is RowActionNavigate => a.kind === "navigate" && a.rowClick === true,
-  );
-  const wrappedOnRowClick = rowClickAction
-    ? (row: ListRowViewModel) => runNavigate(rowClickAction, row)
-    : onRowClick !== undefined
-      ? (row: ListRowViewModel) => onRowClick(row, listScreen.entity)
-      : undefined;
-
-  return (
-    <RenderList
-      screen={listScreen}
-      entity={entity}
-      rows={rowsQuery.data?.rows ?? []}
-      featureName={schema.featureName}
-      searchable={screen.searchable ?? false}
-      sort={screen.defaultSort ?? null}
-      {...(rowActions !== undefined && { rowActions })}
-      {...(toolbarActions !== undefined && { toolbarActions })}
-      {...(translate !== undefined && { translate })}
-      {...(wrappedOnRowClick !== undefined && { onRowClick: wrappedOnRowClick })}
-    />
-  );
-}
-
 // ---- actionForm (Tier 2.7d) ----
 
 // Action-Form-Body — non-CRUD Write-Handler-driven Form. Re-uses

package/src/components/render-edit-logic.ts

@@ -1,14 +1,11 @@
 import type { EditSectionViewModel, SubmitResult } from "@cosmicdrift/kumiko-headless";
 
-// Hides the Save button when no field is editable and no extension section
-// exists (extension carries its own dirty/save; a purely read-only form has nothing to submit).
-// Explicit-positive per kind (653/1), not `s.kind !== "fields"` — a future
-// third EditSectionViewModel member would otherwise default to "editable"
-// without anyone deciding that on purpose.
+// A read-only inspector form — every field readOnly, no editable section — has
+// nothing to submit, so the renderer drops the Save button rather than show a
+// dead disabled one. An extension section carries its own dirty/save, so it
+// counts as editable.
 export function hasEditableSection(sections: readonly EditSectionViewModel[]): boolean {
-  return sections.some(
-    (s) => s.kind === "extension" || (s.kind === "fields" && s.fields.some((f) => !f.readOnly)),
-  );
+  return sections.some((s) => s.kind !== "fields" || s.fields.some((f) => !f.readOnly));
 }
 
 // Single source of truth for the extension-section entity-id. The section mount

package/src/components/render-edit.tsx

@@ -247,9 +247,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     [screen, entity, snapshot.values, translate, featureName],
   );
 
-  // isFormEditable, not "hasEditableField" (653/2) — true for an extension
-  // section with no fields of its own too (it carries its own dirty/save).
-  const isFormEditable = hasEditableSection(vm.sections);
+  const hasEditableField = hasEditableSection(vm.sections);
 
   // Persistiert alle composed Extension-Sections mit der aufgelösten entityId.
   // false = eine Section schlug fehl (ihr i18n-Key landet im Banner). Ohne
@@ -357,7 +355,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
           {translate("kumiko.actions.cancel")}
         </Button>
       )}
-      {isFormEditable && (
+      {hasEditableField && (
         <Button
           type="submit"
           disabled={(snapshot.isUnchanged && !extensionDirty) || isSubmitting}

package/src/app/projection-list-shim.ts

@@ -1,62 +0,0 @@
-// Shim für ProjectionList-Renderer (analog action-form-shim.ts / config-edit-shim.ts).
-//
-// RenderList + computeListViewModel verlangen ein `entity: EntityDefinition` +
-// ein `screen: EntityListScreenDefinition`-Pair, nutzen davon aber nur
-// `entity.fields` (Spalten-Typ/Label) und die List-Felder des Screens
-// (columns/rowActions/…). Ein projectionList-Screen ist query-getrieben und hat
-// KEINE Entity — die zwei Helper hier shapen den Input ad-hoc um, damit die
-// bestehende List-Maschinerie reused werden kann. Die Query selbst wird NICHT
-// hierüber aufgelöst (der Body nimmt `screen.query` direkt).
-//
-// Selbe Schulden-Reservation wie bei den anderen Shims: greift die List-
-// Maschinerie künftig auf weitere EntityDefinition-Felder (transitions, idType,
-// derivedFields) oder cross-referenziert ein Boot-Validator die schema.entities-
-// Map, brechen die Type-Lies hier silent — dann ist Zeit für eine echte
-// query-native ListView-Komponente.
-
-import type {
-  EntityDefinition,
-  EntityListScreenDefinition,
-  ListColumnSpec,
-  ProjectionListScreenDefinition,
-} from "@cosmicdrift/kumiko-framework/ui-types";
-import { normalizeListColumn } from "@cosmicdrift/kumiko-framework/ui-types";
-
-const PROJECTION_PSEUDO_ENTITY = "__projection__";
-
-/** Minimale EntityDefinition aus den Column-Feldern: jedes Feld ein Text-Feld,
- *  nicht sortierbar (eine Projection-Query hat keinen garantierten Server-Sort).
- *  computeListViewModel liest nur `fields[<col>].type` → Text reicht; die
- *  Präsentation kommt aus dem Column-Renderer + explizitem Label. */
-export function synthesizeProjectionEntity(columns: readonly ListColumnSpec[]): EntityDefinition {
-  const fields: Record<string, { type: "text"; sortable: false }> = {};
-  for (const col of columns) {
-    fields[normalizeListColumn(col).field] = { type: "text", sortable: false };
-  }
-  return { fields } as unknown as EntityDefinition;
-}
-
-/** Wandelt ein ProjectionListScreenDefinition in die EntityListScreen-Shape die
- *  RenderList erwartet. `type` = "entityList" + Pseudo-Entity halten den Type-
- *  Constraint; RenderList branched nicht auf `type` und liest `entity` nur für
- *  Fehlermeldungen. Die List-Felder werden 1:1 durchgereicht. */
-export function synthesizeProjectionScreen(
-  screen: ProjectionListScreenDefinition,
-): EntityListScreenDefinition {
-  return {
-    id: screen.id,
-    type: "entityList",
-    entity: PROJECTION_PSEUDO_ENTITY,
-    columns: screen.columns,
-    ...(screen.rowRenderer !== undefined && { rowRenderer: screen.rowRenderer }),
-    ...(screen.cardRenderer !== undefined && { cardRenderer: screen.cardRenderer }),
-    ...(screen.rowActions !== undefined && { rowActions: screen.rowActions }),
-    ...(screen.toolbarActions !== undefined && { toolbarActions: screen.toolbarActions }),
-    ...(screen.pagination !== undefined && { pagination: screen.pagination }),
-    ...(screen.pageSize !== undefined && { pageSize: screen.pageSize }),
-    ...(screen.defaultSort !== undefined && { defaultSort: screen.defaultSort }),
-    ...(screen.searchable !== undefined && { searchable: screen.searchable }),
-    ...(screen.slots !== undefined && { slots: screen.slots }),
-    ...(screen.access !== undefined && { access: screen.access }),
-  };
-}