@cosmicdrift/kumiko-renderer 0.350.0 → 0.352.0

package/dist/app/kumiko-screen.js

@@ -3,8 +3,8 @@ import { evalFieldCondition, isWriteFormEditSection, metricField, parseRefTarget
 import { applyFormatSpec, buildOptionLabels, computeRelatedListSectionViewModel, fieldLabelKey, fieldOptionLabelKey, isSafeHref, } from "@cosmicdrift/kumiko-headless";
 import { resolveActionIcon } from "@cosmicdrift/kumiko-types/action-icon";
 import { TENANT_CURRENCY_CONFIG_KEY } from "@cosmicdrift/kumiko-types/fields";
+import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 import { Fragment, useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Temporal } from "temporal-polyfill";
 import { QueryOptionLabel, resolveOptionsQueryPayload, } from "../components/query-options-select.js";
 import { extractCreatedId, extractIdField } from "../components/reference-create-dialog.js";
 import { RenderEdit, resolveRecordTitle, } from "../components/render-edit.js";

package/dist/app/list-facets.js

@@ -1,7 +1,7 @@
 // Split from kumiko-screen.tsx: related-list-section.tsx renders through
 // kumiko-screen.tsx, so importing this back from there would be a require cycle.
 import { parseRefTarget } from "@cosmicdrift/kumiko-framework/ui-types";
-import { Temporal } from "temporal-polyfill";
+import { Temporal } from "@cosmicdrift/kumiko-types/temporal";
 // Fills in a "reference" spec's initially-empty `options` from the
 // field-keyed options ReferenceFacetBridges resolved, shared by every caller.
 export function mergeReferenceFacetOptions(specs, optionsByField) {

package/dist/components/availability-options-select.d.ts

@@ -0,0 +1,22 @@
+import type { EditFieldViewModel } from "@cosmicdrift/kumiko-headless";
+import type { OptionsQueryPayload } from "@cosmicdrift/kumiko-types/fields";
+import type { ReactNode } from "react";
+export type SelectOptionEntry = {
+    readonly value: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly disabled?: boolean;
+};
+export declare function staticSelectOptions(field: EditFieldViewModel): readonly SelectOptionEntry[];
+export declare function mergeOptionAvailability(options: readonly SelectOptionEntry[], rows: readonly unknown[], current: string): readonly SelectOptionEntry[];
+type AvailabilityOptionsSelectProps = {
+    readonly field: EditFieldViewModel;
+    readonly query: string;
+    readonly payload: OptionsQueryPayload;
+    readonly row: Readonly<Record<string, unknown>>;
+    readonly id: string;
+    readonly hasError: boolean;
+    readonly onChange: (value: unknown) => void;
+};
+export declare function AvailabilityOptionsSelect({ field, query, payload, row, id, hasError, onChange, }: AvailabilityOptionsSelectProps): ReactNode;
+export {};

package/dist/components/availability-options-select.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useQuery } from "../hooks/use-query.js";
+import { usePrimitives } from "../primitives.js";
+import { resolveOptionsQueryPayload } from "./query-options-select.js";
+// Rows come from a query handler, so they are checked once here instead of trusted.
+function isAvailabilityRow(row) {
+    return (typeof row === "object" &&
+        row !== null &&
+        "value" in row &&
+        typeof row.value === "string" &&
+        (!("disabled" in row) || row.disabled === undefined || typeof row.disabled === "boolean") &&
+        (!("hint" in row) || row.hint === undefined || typeof row.hint === "string"));
+}
+// Static options with the translated labels of the view-model.
+export function staticSelectOptions(field) {
+    const labels = field.optionLabels;
+    return (field.options ?? []).map((value) => ({ value, label: labels?.[value] ?? value }));
+}
+// Static options stay authoritative: rows for unknown values are ignored, and the
+// stored value is never disabled so a downgraded tenant keeps seeing its choice.
+export function mergeOptionAvailability(options, rows, current) {
+    const byValue = new Map();
+    for (const row of rows) {
+        if (isAvailabilityRow(row))
+            byValue.set(row.value, row);
+    }
+    return options.map((option) => {
+        const row = byValue.get(option.value);
+        if (row === undefined)
+            return option;
+        const disabled = row.disabled === true && option.value !== current;
+        return {
+            ...option,
+            ...(row.hint !== undefined && { description: row.hint }),
+            ...(disabled && { disabled: true }),
+        };
+    });
+}
+// Select with static options whose availability (SelectFieldDef.optionsAvailabilityQuery)
+// comes from a query, so it has to be a mounted component for useQuery. Until the
+// result arrives, and when the query fails, every option stays choosable; the write
+// path enforces the rule either way.
+export function AvailabilityOptionsSelect({ field, query, payload, row, id, hasError, onChange, }) {
+    const { Input } = usePrimitives();
+    const { data } = useQuery(query, resolveOptionsQueryPayload(payload, row));
+    const current = typeof field.value === "string" ? field.value : "";
+    const display = field.display === "radio" || field.display === "dropdown" ? field.display : undefined;
+    return (_jsx(Input, { kind: "select", id: id, name: field.field, disabled: field.readOnly, required: field.required, hasError: hasError, value: current, onChange: (v) => onChange(v), options: mergeOptionAvailability(staticSelectOptions(field), data?.rows ?? [], current), ...(display !== undefined && { display }) }));
+}

package/dist/components/render-field.js

@@ -13,6 +13,7 @@ import { useQuery } from "../hooks/use-query.js";
 import { referenceOptionSource } from "../hooks/use-reference-lookup.js";
 import { useLocale, useTranslation } from "../i18n.js";
 import { usePrimitives } from "../primitives.js";
+import { AvailabilityOptionsSelect, staticSelectOptions } from "./availability-options-select.js";
 import { EmbeddedListField } from "./embedded-list-field.js";
 import { MultiSelectCheckboxes } from "./multi-select-checkboxes.js";
 import { QueryOptionsSelect } from "./query-options-select.js";
@@ -42,7 +43,9 @@ export function RenderField({ field, issues, onChange, featureName, labelAppendi
     // Reference-Field rendert eine eigene Component — sie nutzt
     // useQuery() für den Live-Lookup, also muss sie als React-
     // Komponente gemountet werden (nicht als pure render-Call).
-    const control = field.readOnly && field.renderer !== undefined ? (_jsx(FieldRendererOutput, { field: field, renderer: field.renderer, appLocale: appLocale, ...(row !== undefined && { row }) })) : field.type === "embedded" && field.embeddedListCells !== undefined ? (_jsx(EmbeddedListField, { field: field, id: id, onChange: onChange, allIssues: allIssues ?? {}, featureName: featureName ?? "" })) : field.type === "reference" ? (readOnlyText ? (_jsx(ReadOnlyReferenceValue, { field: field, featureName: featureName ?? "" })) : (_jsx(ReferenceInput, { field: field, id: id, hasError: hasError, onChange: onChange, Input: Input, featureName: featureName ?? "" }))) : field.type === "select" && field.selectOptionsQuery !== undefined && !readOnlyText ? (_jsx(QueryOptionsSelect, { field: field, query: field.selectOptionsQuery.query, payload: field.selectOptionsQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) ? (_jsx(Text, { testId: `field-value-${field.field}`, children: readOnlyDisplayText(field, appLocale, t) })) : field.type === "text" && field.writeOnly === true && !readOnlyText ? (_jsx(WriteOnlyTextInput, { field: field, id: id, hasError: hasError, onChange: onChange, changed: changed === true })) : (renderInput({
+    const control = field.readOnly && field.renderer !== undefined ? (_jsx(FieldRendererOutput, { field: field, renderer: field.renderer, appLocale: appLocale, ...(row !== undefined && { row }) })) : field.type === "embedded" && field.embeddedListCells !== undefined ? (_jsx(EmbeddedListField, { field: field, id: id, onChange: onChange, allIssues: allIssues ?? {}, featureName: featureName ?? "" })) : field.type === "reference" ? (readOnlyText ? (_jsx(ReadOnlyReferenceValue, { field: field, featureName: featureName ?? "" })) : (_jsx(ReferenceInput, { field: field, id: id, hasError: hasError, onChange: onChange, Input: Input, featureName: featureName ?? "" }))) : field.type === "select" && field.selectOptionsQuery !== undefined && !readOnlyText ? (_jsx(QueryOptionsSelect, { field: field, query: field.selectOptionsQuery.query, payload: field.selectOptionsQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : field.type === "select" &&
+        field.selectOptionsAvailabilityQuery !== undefined &&
+        !readOnlyText ? (_jsx(AvailabilityOptionsSelect, { field: field, query: field.selectOptionsAvailabilityQuery.query, payload: field.selectOptionsAvailabilityQuery.payload, row: row ?? { [field.field]: field.value }, id: id, hasError: hasError, onChange: onChange })) : readOnlyText && !isComplexFieldType(field.type) ? (_jsx(Text, { testId: `field-value-${field.field}`, children: readOnlyDisplayText(field, appLocale, t) })) : field.type === "text" && field.writeOnly === true && !readOnlyText ? (_jsx(WriteOnlyTextInput, { field: field, id: id, hasError: hasError, onChange: onChange, changed: changed === true })) : (renderInput({
         field,
         id,
         hasError,
@@ -374,11 +377,7 @@ function renderInput({ field, id, hasError, onChange, Input, appLocale, Banner,
             // `<feature>:entity:<entity>:field:<field>:option:<value>`).
             // Wenn keine Translations registriert sind, fallback auf raw
             // value als Label — der ComboboxInput zeigt dann unverändert.
-            const rawOptions = field.options ?? [];
-            const labels = field.optionLabels;
-            const selectOptions = labels !== undefined
-                ? rawOptions.map((value) => ({ value, label: labels[value] ?? value }))
-                : rawOptions;
+            const selectOptions = field.optionLabels !== undefined ? staticSelectOptions(field) : (field.options ?? []);
             // `display` is shared with multiSelect's "checkboxes", which is not a
             // select presentation — narrow to the two a select field can request.
             const display = field.display === "radio" || field.display === "dropdown" ? field.display : undefined;

package/dist/primitives.d.ts

@@ -347,6 +347,9 @@ export type InputProps = {
          *  without a group stay ungrouped and come before all groups. Options
          *  with description or group never render as a segmented control. */
         readonly group?: string;
+        /** Not choosable and visibly muted. A disabled option that is the
+         *  current `value` stays displayed as the selection. */
+        readonly disabled?: boolean;
     }[];
     readonly disabled?: boolean;
     readonly required?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.350.0",
+  "version": "0.352.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,9 +15,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.350.0",
-    "@cosmicdrift/kumiko-headless": "0.350.0",
-    "@cosmicdrift/kumiko-types": "0.350.0",
+    "@cosmicdrift/kumiko-framework": "0.352.0",
+    "@cosmicdrift/kumiko-headless": "0.352.0",
+    "@cosmicdrift/kumiko-types": "0.352.0",
     "react": "^19.2.6",
     "temporal-polyfill": "^0.3.2",
     "zod": "^4.4.3"
@@ -28,7 +28,7 @@
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29.1.1",
     "react-dom": "^19.2.6",
-    "@cosmicdrift/kumiko-locale-de": "0.350.0"
+    "@cosmicdrift/kumiko-locale-de": "0.352.0"
   },
   "repository": {
     "type": "git",

package/src/changes.json

@@ -1,4 +1,9 @@
 [
+  {
+    "version": "0.352.0",
+    "type": "improvement",
+    "title": "Select inputs accept disabled options and load their availability from optionsAvailabilityQuery"
+  },
   {
     "version": "0.348.0",
     "type": "improvement",