@cosmicdrift/kumiko-renderer 0.327.0 → 0.328.1

package/src/hooks/use-reference-lookup.ts

@@ -1,76 +0,0 @@
-// Tier 2.7e-4: Renderer-Side Eagerload für Reference-Felder.
-//
-// Pro Reference-Spalte einer Liste wird einmal `<feature>:query:
-// <refEntity>:list` (limit:200) gerufen, eine Map<uuid, displayValue>
-// gebaut, und der Renderer nutzt sie als Cell-Display-Renderer.
-//
-// Strategy-Trade-offs:
-//   - Server-side Drizzle-Joins wären effizienter (eine Query statt
-//     N+1), würden aber die executor-API um lookupTables erweitern
-//     müssen. Für das MVP geht der Renderer-Side-Pfad vor.
-//   - Limit:200 ist eine harte UX-Grenze: bei mehr Entries in der
-//     referenced Entity zeigen die letzten Rows nur noch UUIDs.
-//     Searchable-Combobox (Tier 2.1c) + Server-Eagerload mit
-//     ID-Whitelist heben das später auf.
-//
-// Dieser Hook ist call-stable: Lookup-Map wird durch useQuery's
-// internen Cache shared zwischen List + Edit-Form für die gleiche
-// Entity, Live-Updates kommen via SSE (use-query-live).
-
-import {
-  REFERENCE_LOOKUP_SOURCES,
-  SYSTEM_REFERENCE_LABELS,
-} from "@cosmicdrift/kumiko-framework/ui-types";
-import { useMemo } from "react";
-import { toKebab } from "../app/qn";
-import { useTranslation } from "../i18n";
-import { REFERENCE_LIST_LOOKUP_LIMIT } from "./reference-limits";
-import { useQuery } from "./use-query";
-
-export type ReferenceLookupMap = ReadonlyMap<string, string>;
-
-/** Where a reference target's label rows come from: the central override for
- *  that `feature:entity` if one exists, else the entity-convention list
- *  handler plus the caller's own label field. */
-export function referenceLookupSource(
-  refFeature: string,
-  refEntity: string,
-  labelField: string,
-): { readonly queryQn: string; readonly labelKey: string } {
-  const override = REFERENCE_LOOKUP_SOURCES[`${refFeature}:${refEntity}`];
-  if (override !== undefined) return override;
-  return {
-    queryQn: `${toKebab(refFeature)}:query:${toKebab(refEntity)}:list`,
-    labelKey: labelField,
-  };
-}
-
-/** Empty while the query loads (or fails), so callers fall back to the raw id.
- *  `featureName` is the reference's target feature, not the screen's. */
-export function useReferenceLookup(
-  featureName: string,
-  refEntity: string,
-  labelField: string,
-): { readonly map: ReferenceLookupMap; readonly loading: boolean } {
-  const { queryQn, labelKey } = referenceLookupSource(featureName, refEntity, labelField);
-  const result = useQuery<{ rows: ReadonlyArray<Record<string, unknown>> }>(queryQn, {
-    limit: REFERENCE_LIST_LOOKUP_LIMIT,
-  });
-  const translate = useTranslation();
-  const systemLabel = SYSTEM_REFERENCE_LABELS[`${featureName}:${refEntity}`];
-  const map = useMemo(() => {
-    const out = new Map<string, string>();
-    for (const row of result.data?.rows ?? []) {
-      const id = row["id"];
-      if (id === undefined || id === null) continue;
-      const idStr = String(id);
-      const label = row[labelKey] ?? id;
-      out.set(idStr, String(label));
-    }
-    // System-scope ids (e.g. SYSTEM_TENANT_ID) never have a backing row, so
-    // the bulk lookup above never covers them — inject the label directly.
-    if (systemLabel !== undefined) out.set(systemLabel.id, translate(systemLabel.labelKey));
-    return out;
-  }, [result.data, labelKey, systemLabel, translate]);
-  return { map, loading: result.loading };
-}

package/src/hooks/use-store.ts

@@ -1,48 +0,0 @@
-import type { Store } from "@cosmicdrift/kumiko-headless";
-import { useRef, useSyncExternalStore } from "react";
-
-// React-Bindings für Kumikos Store-Primitive (`createStore` aus
-// @cosmicdrift/kumiko-headless). Beide Hooks sind dünne Wrapper um React's
-// useSyncExternalStore — die ganze Subscribe/Notify-Mechanik lebt im
-// Store selbst, hier wird nur React verdrahtet.
-//
-// useStore: gibt den ganzen Snapshot zurück. Re-rendert wenn der
-// Store seine Identität wechselt. Object.is-Gate im Store selbst
-// verhindert no-op-Updates.
-//
-// useStoreSelector: gibt eine abgeleitete Sicht zurück. Selectors die
-// Object-/Array-Literale zurückgeben (z.B. `s => ({ a, b })`) erzeugen
-// pro Render eine neue Identität — useSyncExternalStore würde das als
-// "Change" lesen und in eine Re-Render-Schleife laufen. Der dritte
-// Arg `equals` dient genau dafür: gleiche Auswahl → cached
-// Identität zurück, kein Re-Render.
-
-// @wrapper-known semantic-alias
-export function useStore<T>(store: Store<T>): T {
-  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
-}
-
-export function useStoreSelector<T, S>(
-  store: Store<T>,
-  select: (snapshot: T) => S,
-  equals: (a: S, b: S) => boolean = Object.is,
-): S {
-  // Cache der letzten Auswahl. Beim nächsten getSnapshot-Call vergleicht
-  // der Wrapper die neu berechnete Auswahl mit dem Cache und gibt — falls
-  // gleich — die cached Identität zurück. Das ist der Trick, der
-  // Selector-Returns wie `s => ({ a, b })` stabil hält.
-  const lastSelected = useRef<S>(undefined as S);
-  const initialized = useRef(false);
-
-  const getSelectedSnapshot = (): S => {
-    const next = select(store.getSnapshot());
-    if (initialized.current && equals(lastSelected.current, next)) {
-      return lastSelected.current;
-    }
-    lastSelected.current = next;
-    initialized.current = true;
-    return next;
-  };
-
-  return useSyncExternalStore(store.subscribe, getSelectedSnapshot, getSelectedSnapshot);
-}

package/src/hooks/use-stream-handler.ts

@@ -1,134 +0,0 @@
-import type { DispatcherError } from "@cosmicdrift/kumiko-headless";
-import { useCallback, useEffect, useRef, useState } from "react";
-import { useDispatcher } from "../context/dispatcher-context";
-
-// React wrapper around dispatcher.stream (#1382). Accumulates yielded
-// chunks into `chunks` (unlike useQuery({live:true}), which only
-// invalidates and re-fetches). Each start() owns an AbortController;
-// a newer start() / unmount aborts the previous run so late chunks
-// cannot clobber fresher state.
-
-export type StreamStatus = "idle" | "streaming" | "done" | "error";
-
-export type UseStreamHandlerResult<TChunk> = {
-  readonly chunks: readonly TChunk[];
-  readonly status: StreamStatus;
-  readonly error: DispatcherError | null;
-  readonly start: (payload?: unknown) => Promise<void>;
-  readonly abort: () => void;
-  readonly reset: () => void;
-};
-
-export type UseStreamHandlerOptions = {
-  // When true, start() runs once on mount with the initial payload.
-  // Default false — streams are usually user-triggered (unlike queries).
-  readonly autoStart?: boolean;
-};
-
-export function useStreamHandler<TChunk = unknown>(
-  type: string,
-  payload: unknown = {},
-  options: UseStreamHandlerOptions = {},
-): UseStreamHandlerResult<TChunk> {
-  const dispatcher = useDispatcher();
-  const { autoStart = false } = options;
-
-  const [chunks, setChunks] = useState<readonly TChunk[]>([]);
-  const [status, setStatus] = useState<StreamStatus>("idle");
-  const [error, setError] = useState<DispatcherError | null>(null);
-
-  const activeCtrl = useRef<AbortController | null>(null);
-  const payloadRef = useRef(payload);
-  payloadRef.current = payload;
-
-  const abort = useCallback((): void => {
-    activeCtrl.current?.abort();
-    activeCtrl.current = null;
-    // User cancel — exit streaming so UI can re-enable the start button.
-    setStatus((s) => (s === "streaming" ? "idle" : s));
-  }, []);
-
-  const reset = useCallback((): void => {
-    abort();
-    setChunks([]);
-    setStatus("idle");
-    setError(null);
-  }, [abort]);
-
-  // Shared by every abort-detection branch below: only touch status if this
-  // run is still the active one (or activeCtrl was already cleared by abort()).
-  const settleAborted = useCallback((ctrl: AbortController): void => {
-    if (activeCtrl.current === null || activeCtrl.current === ctrl) setStatus("idle");
-  }, []);
-
-  const start = useCallback(
-    async (overridePayload?: unknown): Promise<void> => {
-      activeCtrl.current?.abort();
-      const ctrl = new AbortController();
-      activeCtrl.current = ctrl;
-
-      setChunks([]);
-      setError(null);
-      setStatus("streaming");
-
-      const body = overridePayload !== undefined ? overridePayload : payloadRef.current;
-      try {
-        for await (const chunk of dispatcher.stream<TChunk>(type, body, { signal: ctrl.signal })) {
-          // skip: a newer start() already superseded this run
-          if (ctrl.signal.aborted) {
-            settleAborted(ctrl);
-            return;
-          }
-          setChunks((prev) => [...prev, chunk]);
-        }
-        // skip: aborted after last chunk, don't mark done
-        if (ctrl.signal.aborted) {
-          settleAborted(ctrl);
-          return;
-        }
-        setStatus("done");
-      } catch (e) {
-        // skip: abort is not an error toast
-        if (ctrl.signal.aborted) {
-          settleAborted(ctrl);
-          return;
-        }
-        const mapped = asDispatcherError(e);
-        // skip: dispatcher-mapped abort (fetch cancelled)
-        if (mapped.code === "aborted") {
-          settleAborted(ctrl);
-          return;
-        }
-        setError(mapped);
-        setStatus("error");
-      }
-    },
-    [dispatcher, type, settleAborted],
-  );
-
-  useEffect(() => {
-    // skip: autoStart off — streams are usually user-triggered
-    if (!autoStart) return;
-    void start();
-  }, [autoStart, start]);
-
-  useEffect(() => {
-    return () => {
-      activeCtrl.current?.abort();
-    };
-  }, []);
-
-  return { chunks, status, error, start, abort, reset };
-}
-
-function asDispatcherError(e: unknown): DispatcherError {
-  if (e && typeof e === "object" && "code" in e && "message" in e && "i18nKey" in e) {
-    return e as DispatcherError;
-  }
-  return {
-    code: "stream_error",
-    httpStatus: 0,
-    i18nKey: "errors.unknown",
-    message: e instanceof Error ? e.message : String(e),
-  };
-}

package/src/i18n-defaults.ts

@@ -1,220 +0,0 @@
-// Framework-Default-Bundle. Strings die die Renderer-Components hart
-// brauchen (Save/Cancel/Delete-Buttons, Empty-States, Search-Placeholder,
-// Nav-Toggle-aria-Labels, Validation-Reasons). createKumikoApp hängt das
-// als ALLERLETZTEN Fallback in den LocaleProvider — Apps können
-// einzelne Keys via clientFeatures.translations überschreiben.
-//
-// Convention: alle Keys mit `kumiko.`-Prefix damit sie nicht mit
-// App-Keys kollidieren. Sub-Pfade gruppieren nach Bereich (actions /
-// list / nav / form / validation).
-
-import type { TranslationsByLocale } from "./i18n";
-
-export const kumikoDefaultTranslations: TranslationsByLocale = {
-  en: {
-    "kumiko.actions.save": "Save",
-    "kumiko.actions.cancel": "Cancel",
-    "kumiko.actions.delete": "Delete",
-    "kumiko.actions.delete-confirm": "Confirm delete?",
-    "kumiko.actions.reload": "Reload",
-    "kumiko.actions.create": "New",
-    "kumiko.actions.edit": "Edit",
-    "kumiko.actions.view": "View",
-    "kumiko.actions.copyLink": "Copy link",
-    "kumiko.actions.copyLinkCopied": "Copied!",
-    "kumiko.actions.next": "Next",
-    "kumiko.actions.back": "Back",
-    "kumiko.actions.finish": "Finish",
-
-    "kumiko.wizard.step": "Step {current} of {total}",
-    "kumiko.wizard.step-with-title": "Step {current} of {total} · {title}",
-
-    "kumiko.version.update-available": "A new version is available.",
-
-    "kumiko.toast.learn-more": "Learn more",
-
-    "kumiko.field.open-calendar": "Open calendar",
-    "kumiko.field.dateField.placeholderYear": "Y",
-    "kumiko.field.dateField.placeholderMonth": "M",
-    "kumiko.field.dateField.placeholderDay": "D",
-    "kumiko.field.time": "Time",
-    "kumiko.field.timezone": "Time zone",
-    "kumiko.field.locatedTzHint": "Time local to the given location",
-    "kumiko.field.reference-created-no-id":
-      "Record was created but could not be selected automatically. Please select it manually.",
-    "kumiko.field.unsupported": "This field type can't be edited here yet.",
-    "kumiko.field.embedded-list.add-row": "Add row",
-    "kumiko.field.embedded-list.remove-row": "Remove row",
-    "kumiko.field.embedded-list.duplicate-row": "Duplicate row",
-    "kumiko.field.embedded-list.move-up": "Move up",
-    "kumiko.field.embedded-list.move-down": "Move down",
-    "kumiko.field.embedded-list.empty": "No rows yet.",
-    "kumiko.field.embedded-list.empty-cta": "Add first row",
-    "kumiko.field.embedded-list.paste-rows-truncated":
-      "{count} pasted row(s) were dropped (max row count reached).",
-    "kumiko.field.embedded-list.paste-cells-unmatched":
-      "{count} cell(s) had no matching option and were left unchanged.",
-    "kumiko.field.multiSelect.select-all": "Select all",
-    "kumiko.field.multiSelect.deselect-all": "Deselect all",
-
-    "kumiko.list.search-placeholder": "Search…",
-    "kumiko.list.empty.title": "No entries yet.",
-    "kumiko.list.empty.hint": "Create the first one to get started.",
-    "kumiko.list.no-entries": "No entries.",
-    "kumiko.list.end-of-list": "— End of list —",
-    "kumiko.list.sort.label": "Sort",
-    "kumiko.list.sort.unsorted": "Unsorted",
-    "kumiko.list.filter.reset": "Reset",
-    "kumiko.list.related-list-truncated":
-      "Showing the first {count} entries. More are available but not loaded — this list does not paginate.",
-    "kumiko.reference.system-tenant": "System",
-    "kumiko.reference.system-user": "System",
-
-    "kumiko.pager.status": "{from}–{to} of {total}",
-    "kumiko.pager.previousPage": "Previous page",
-    "kumiko.pager.nextPage": "Next page",
-    "kumiko.pager.page": "Page {entry}",
-
-    "kumiko.combobox.search-placeholder": "Search…",
-    "kumiko.combobox.empty": "No matches.",
-    "kumiko.combobox.loading": "Loading…",
-    "kumiko.combobox.placeholder": "—",
-
-    "kumiko.dashboard.filter.all": "All",
-
-    "kumiko.app-boot.loading": "Loading…",
-    "kumiko.app-boot.unauthorized": "You need to sign in to see this.",
-    "kumiko.app-boot.failed": "Couldn't load the app. Check your connection and try again.",
-    "kumiko.app-boot.no-open-screen":
-      "This app has no screen that's accessible without a role restriction.",
-
-    "kumiko.widget.loading": "Loading…",
-    "kumiko.widget.error.title": "Couldn't load.",
-
-    "kumiko.widget.upload.uploading": "Uploading…",
-    "kumiko.widget.upload.done": "Uploaded",
-    "kumiko.widget.upload.error": "Failed",
-    "kumiko.widget.upload.rejected-type": "File type not allowed",
-
-    "kumiko.widget.step-bar.done": "Done",
-
-    "kumiko.widget.drawer.restore": "Restore drawer width",
-    "kumiko.widget.drawer.maximize": "Maximize drawer width",
-    "kumiko.widget.drawer.resize": "Resize drawer",
-
-    "kumiko.widget.floatingPanel.move": "Move panel",
-    "kumiko.widget.floatingPanel.resizeTop": "Resize panel from the top edge",
-    "kumiko.widget.floatingPanel.resizeRight": "Resize panel from the right edge",
-    "kumiko.widget.floatingPanel.resizeBottom": "Resize panel from the bottom edge",
-    "kumiko.widget.floatingPanel.resizeLeft": "Resize panel from the left edge",
-
-    "kumiko.planCard.current": "Current plan",
-    "kumiko.planCard.priceUnavailable": "Price not available",
-
-    "kumiko.nav.expand": "Expand",
-    "kumiko.nav.collapse": "Collapse",
-    "kumiko.nav.search": "Search navigation…",
-    "kumiko.nav.language": "Language",
-
-    "kumiko.workspace.switch": "Switch workspace",
-    // Workspace-Switcher fallback label when activeId points at no visible workspace.
-    "kumiko.workspace.select": "Select workspace",
-
-    "kumiko.dialog.confirm": "Confirm",
-    "kumiko.dialog.cancel": "Cancel",
-    "kumiko.dialog.close": "Close",
-
-    "kumiko.aiText.acceptHint": "Tab = accept, Esc = discard",
-    "kumiko.aiText.correct": "Correct",
-    "kumiko.aiText.translate": "Translate",
-    "kumiko.aiText.rewrite": "Rewrite",
-    "kumiko.aiText.diff.before": "Before",
-    "kumiko.aiText.diff.after": "After",
-    "kumiko.aiText.diff.generating": "Generating…",
-    "kumiko.aiText.style.formal": "Formal",
-    "kumiko.aiText.style.casual": "Casual",
-    "kumiko.aiText.style.concise": "Concise",
-    "kumiko.aiText.style.expand": "Expand",
-    "kumiko.aiText.capExceeded": "Monthly AI limit reached.",
-
-    "kumiko.rowAction.failed": "Action failed",
-
-    "kumiko.contentEditor.insertVariable": "Insert {name}",
-    "kumiko.contentEditor.preview": "Preview",
-    "kumiko.contentEditor.editMode": "Edit",
-    "kumiko.contentEditor.bold": "Bold",
-    "kumiko.contentEditor.italic": "Italic",
-    "kumiko.contentEditor.heading1": "Heading 1",
-    "kumiko.contentEditor.heading2": "Heading 2",
-    "kumiko.contentEditor.bulletList": "Bullet list",
-    "kumiko.contentEditor.orderedList": "Numbered list",
-
-    "kumiko.config.source.user": "My value",
-    "kumiko.config.source.tenant": "Tenant",
-    "kumiko.config.source.system": "System",
-    "kumiko.config.source.appOverride": "App override",
-    "kumiko.config.source.computed": "Computed",
-    "kumiko.config.source.default": "Default",
-    "kumiko.config.source.missing": "Missing",
-    "kumiko.config.cascade.noValue": "No value set",
-    "kumiko.config.cascade.activeMarker": "active",
-    "kumiko.config.cascade.resetTo": "Reset override ({scope})",
-
-    "kumiko.form.error.generic": "Something went wrong.",
-    "kumiko.form.error.version-conflict":
-      "Record was modified in the meantime. Reload and try again.",
-    "kumiko.form.extension.save-failed": "A custom field could not be saved.",
-    "kumiko.form.draft.resume-multiple":
-      "Found multiple open drafts for this form. Which one do you want to resume?",
-    "kumiko.form.draft.resume-single":
-      "Found an open draft for this form. Do you want to resume it?",
-    "kumiko.form.draft.start-new": "Start new",
-
-    "kumiko.secretMint.title": "Your new secret",
-    "kumiko.secretMint.warning":
-      "Copy this now — it is shown only this once and cannot be retrieved later.",
-    "kumiko.secretMint.confirm": "I have copied it",
-    "kumiko.secretMint.copy": "Copy",
-    "kumiko.secretMint.copied": "Copied",
-    "kumiko.secretMint.done": "Done.",
-
-    "kumiko.validation.required": "Required.",
-    "kumiko.validation.invalid": "Invalid value.",
-    "kumiko.validation.too-short": "Too short (at least {min} characters).",
-    "kumiko.validation.too-long": "Too long (at most {max} characters).",
-    "kumiko.validation.out-of-range": "Value out of allowed range.",
-
-    "errors.validation.invalid_type": "Invalid value.",
-    "errors.validation.too_small": "Too small or too short (minimum: {minimum}).",
-    "errors.validation.too_big": "Too big or too long (maximum: {maximum}).",
-    "errors.validation.invalid_format": "Invalid format.",
-    "errors.validation.not_multiple_of": "Must be a multiple of {divisor}.",
-    "errors.validation.unrecognized_keys": "Unknown fields.",
-    "errors.validation.invalid_union": "Invalid value.",
-    "errors.validation.invalid_key": "Invalid key.",
-    "errors.validation.invalid_element": "Invalid entry.",
-    "errors.validation.invalid_value": "Invalid choice.",
-    "errors.validation.custom": "Invalid value.",
-    "errors.validation.unexpected_field": "Unknown field.",
-    "errors.validation.out_of_bounds": "Value out of allowed range.",
-    "errors.validation.invalid_option": "Invalid choice.",
-    "errors.validation.failed": "Validation failed.",
-
-    "errors.feature.disabled": "This feature is currently unavailable.",
-    "errors.access.denied": "You don't have permission to do this.",
-    "errors.notFound": "Not found.",
-    "errors.conflict": "Conflict — the operation could not be completed.",
-    "errors.versionConflict": "The record was modified in the meantime. Reload and try again.",
-    "errors.preconditionFailed": "The record changed in the meantime. Reload and try again.",
-    "errors.uniqueViolation": "This entry already exists.",
-    "errors.unprocessable": "The request could not be processed.",
-    "errors.unconfigured": "This feature isn't configured yet.",
-    "errors.internal": "Something went wrong. Please try again later.",
-    "errors.rate_limited": "Too many requests. Please try again shortly.",
-    "errors.cap.exceeded": "Limit reached. Upgrade your plan or wait for the next period.",
-    "errors.download.urlMissing": "Download unavailable — please try again.",
-    "auth.errors.originNotAllowed": "Requests from this origin are not allowed.",
-    "dispatcher.errors.network": "Network error. Please check your connection and try again.",
-    "dispatcher.errors.aborted": "Request was cancelled.",
-  },
-};