@cosmicdrift/kumiko-renderer 0.155.0 → 0.156.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.155.0",
+  "version": "0.156.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,10 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.155.0",
-    "@cosmicdrift/kumiko-headless": "0.155.0",
-    "react": "^19.2.6"
+    "@cosmicdrift/kumiko-framework": "0.156.0",
+    "@cosmicdrift/kumiko-headless": "0.156.0",
+    "react": "^19.2.6",
+    "temporal-polyfill": "^0.3.2"
   },
   "devDependencies": {
     "@testing-library/react": "^16.3.2",

package/src/app/kumiko-screen.tsx

@@ -87,6 +87,12 @@ export type KumikoScreenProps = {
   // createKumikoApp does exactly that; override to open a drawer,
   // inline-expand, etc.
   readonly onRowClick?: (row: ListRowViewModel, entityName: string) => void;
+  // Copy-Link-Action auf entityEdit-Update-Screens (Issue #912). Bereits
+  // vollständig gebunden (URL-Bau + Clipboard) — createKumikoApp/RoutedScreen
+  // liefert die Default-Impl, dieses platform-neutrale Package baut selbst
+  // keine URLs/Clipboard-Calls (guard-renderer-boundaries). Nur in
+  // update-mode sichtbar (entityId muss gesetzt sein).
+  readonly onCopyLink?: () => Promise<void> | void;
 };
 
 // Build the qualified name the registry would stamp on screen ingest:
@@ -112,6 +118,7 @@ export function KumikoScreen({
   translate,
   entityId,
   onRowClick,
+  onCopyLink,
 }: KumikoScreenProps): ReactNode {
   const { Banner, Text } = usePrimitives();
   const screen = useMemo(
@@ -138,6 +145,7 @@ export function KumikoScreen({
           screen={screen}
           translate={translate}
           {...(entityId !== undefined && { entityId })}
+          {...(onCopyLink !== undefined && { onCopyLink })}
         />
       );
     case "entityList":
@@ -306,11 +314,13 @@ function EntityEditScreen({
   screen,
   translate,
   entityId,
+  onCopyLink,
 }: {
   readonly schema: FeatureSchema;
   readonly screen: EntityEditScreenDefinition;
   readonly translate?: Translate;
   readonly entityId?: string;
+  readonly onCopyLink?: () => Promise<void> | void;
 }): ReactNode {
   const { Banner, Text } = usePrimitives();
   const entity = schema.entities[screen.entity];
@@ -333,6 +343,7 @@ function EntityEditScreen({
         entity={entity}
         entityId={entityId}
         {...(translate !== undefined && { translate })}
+        {...(onCopyLink !== undefined && { onCopyLink })}
       />
     );
   }
@@ -402,12 +413,14 @@ function EntityEditUpdateBody({
   entity,
   entityId,
   translate,
+  onCopyLink,
 }: {
   readonly schema: FeatureSchema;
   readonly screen: EntityEditScreenDefinition;
   readonly entity: EntityDefinition;
   readonly entityId: string;
   readonly translate?: Translate;
+  readonly onCopyLink?: () => Promise<void> | void;
 }): ReactNode {
   const { Banner, Text } = usePrimitives();
   const detailQn = `${toKebab(schema.featureName)}:query:${toKebab(screen.entity)}:detail`;
@@ -452,6 +465,7 @@ function EntityEditUpdateBody({
       record={record}
       onReload={detailQuery.refetch}
       {...(translate !== undefined && { translate })}
+      {...(onCopyLink !== undefined && { onCopyLink })}
     />
   );
 }
@@ -464,6 +478,7 @@ function EntityEditUpdateForm({
   record,
   onReload,
   translate,
+  onCopyLink,
 }: {
   readonly schema: FeatureSchema;
   readonly screen: EntityEditScreenDefinition;
@@ -472,6 +487,7 @@ function EntityEditUpdateForm({
   readonly record: Readonly<Record<string, unknown>>;
   readonly onReload: () => Promise<void> | void;
   readonly translate?: Translate;
+  readonly onCopyLink?: () => Promise<void> | void;
 }): ReactNode {
   // Seed the form with the server values for the entity's declared
   // fields; anything else (id, tenant_id, created_at…) stays out of
@@ -547,6 +563,7 @@ function EntityEditUpdateForm({
       onReload={() => void onReload()}
       {...(screen.submitLabel !== undefined && { submitLabel: screen.submitLabel })}
       {...(translate !== undefined && { translate })}
+      {...(onCopyLink !== undefined && { onCopyLink })}
     />
   );
 }

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

@@ -26,9 +26,11 @@ import type {
   EntityEditScreenDefinition,
   ProjectionDetailScreenDefinition,
 } from "@cosmicdrift/kumiko-framework/ui-types";
-import { isExtensionEditSection, normalizeEditField } from "@cosmicdrift/kumiko-framework/ui-types";
-
-const PROJECTION_DETAIL_PSEUDO_ENTITY = "__projection-detail__";
+import {
+  isExtensionEditSection,
+  normalizeEditField,
+  PROJECTION_DETAIL_ENTITY as PROJECTION_DETAIL_PSEUDO_ENTITY,
+} from "@cosmicdrift/kumiko-framework/ui-types";
 
 /** Minimale EntityDefinition aus den Layout-Feldern: jedes Feld ein Text-
  *  Feld — computeEditViewModel liest nur `fields[<f>].type`, Text reicht für

package/src/components/render-edit.tsx

@@ -76,6 +76,13 @@ export type RenderEditProps<TValues extends FormValues, TCtx = unknown> = {
   readonly onDelete?: () => Promise<void> | void;
   readonly onCancel?: () => void;
   readonly onReload?: () => void;
+  /** Copy-Link-Action (Issue #912) — nur in update-mode gesetzt (create-mode
+   *  hat noch keine entity-id, also keinen Permalink). Der Callback ist
+   *  bereits vollständig gebunden (URL-Bau + Clipboard passiert außerhalb,
+   *  in `@cosmicdrift/kumiko-renderer-web`'s RoutedScreen — dieses
+   *  platform-neutrale Package darf kein `navigator`/`window` anfassen,
+   *  siehe guard-renderer-boundaries). undefined = kein Button. */
+  readonly onCopyLink?: () => Promise<void> | void;
   /** i18n-key für den Submit-Button. Default: "kumiko.actions.save".
    *  Action-Forms (Tier 2.7d) übergeben hier ihren screen.submitLabel,
    *  damit "Speichern" durch domain-spezifischere Strings ersetzt
@@ -185,6 +192,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
     onDelete,
     onCancel,
     onReload,
+    onCopyLink,
     submitLabel,
     labelAppendix,
     fieldAppendix,
@@ -201,6 +209,7 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
   const translate = translateProp ?? t;
 
   const [confirmDeleteOpen, setConfirmDeleteOpen] = useState(false);
+  const [linkCopied, setLinkCopied] = useState(false);
   const [isSubmitting, setIsSubmitting] = useState(false);
   const [formError, setFormError] = useState<DispatcherError | null>(null);
   // Composed-Save: Extension-Sections melden hier ihren dirty-State (damit der
@@ -336,6 +345,19 @@ export function RenderEdit<TValues extends FormValues, TCtx = unknown>(
   // gegen Fehlklicks. Save bleibt rechts (primary affordance).
   const formActions = (
     <>
+      {onCopyLink !== undefined && (
+        <Button
+          type="button"
+          variant="secondary"
+          testId="render-edit-copy-link"
+          onClick={async () => {
+            await onCopyLink();
+            setLinkCopied(true);
+          }}
+        >
+          {translate(linkCopied ? "kumiko.actions.copyLinkCopied" : "kumiko.actions.copyLink")}
+        </Button>
+      )}
       {onDelete !== undefined && (
         <Button
           type="button"

package/src/format-when.ts

@@ -1,6 +1,11 @@
+import { Temporal } from "temporal-polyfill";
+
 // Shared timestamp formatter for operator screens (audit log, job runs) —
 // falls back to the raw ISO string on an unparseable value instead of "Invalid Date".
 export function formatWhen(value: string): string {
-  const d = new Date(value);
-  return Number.isNaN(d.getTime()) ? value : d.toLocaleString();
+  try {
+    return Temporal.Instant.from(value).toLocaleString();
+  } catch {
+    return value;
+  }
 }

package/src/hooks/use-ai-text.ts

@@ -149,6 +149,7 @@ export function useCompletion(debounceMs: number = DEFAULT_DEBOUNCE_MS): UseComp
       clearTimer();
       if (text.length === 0) {
         reset();
+        // skip: empty text, state already reset above
         return;
       }
       timerRef.current = setTimeout(() => {

package/src/hooks/use-query.ts

@@ -87,14 +87,14 @@ export function useQuery<TData = unknown>(
 
     setLoading(true);
     const result = await dispatcher.query<TData>(type, payload, { signal: ctrl.signal });
-    // Don't update state if a newer fetch has already taken over.
+    // skip: a newer fetch already superseded this one, don't clobber its state
     if (ctrl.signal.aborted) return;
     if (result.isSuccess) {
       setData(result.data);
       setError(null);
     } else {
       // A cancelled request comes back with code "aborted" from the
-      // dispatcher — skip the state update, another run replaces it.
+      // skip: aborted request, a newer run already replaces this result
       if (result.error.code === "aborted") return;
       setError(result.error);
     }
@@ -104,6 +104,7 @@ export function useQuery<TData = unknown>(
   useEffect(() => {
     if (!enabled) {
       setLoading(false);
+      // skip: query disabled, loading state already cleared above
       return;
     }
     void run();
@@ -117,8 +118,10 @@ export function useQuery<TData = unknown>(
   // Subscription-Lifecycle genau einmal durchwalzt.
   const subscribeLive = useLiveEvents();
   useEffect(() => {
+    // skip: live mode or query disabled, no SSE subscription needed
     if (!live || !enabled) return;
     const entity = entityFromQueryType(type);
+    // skip: query type has no mapped entity, nothing to subscribe to
     if (entity === undefined) return;
     return subscribeLive(entity, () => {
       void run();

package/src/i18n-defaults.ts

@@ -20,6 +20,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.actions.reload": "Neu laden",
     "kumiko.actions.create": "Neu",
     "kumiko.actions.edit": "Bearbeiten",
+    "kumiko.actions.copyLink": "Link kopieren",
+    "kumiko.actions.copyLinkCopied": "Kopiert!",
 
     // Version — Update-Awareness-Banner (UpdateChecker).
     "kumiko.version.update-available": "Eine neue Version ist verfügbar.",
@@ -155,6 +157,8 @@ export const kumikoDefaultTranslations: TranslationsByLocale = {
     "kumiko.actions.reload": "Reload",
     "kumiko.actions.create": "New",
     "kumiko.actions.edit": "Edit",
+    "kumiko.actions.copyLink": "Copy link",
+    "kumiko.actions.copyLinkCopied": "Copied!",
 
     "kumiko.version.update-available": "A new version is available.",