@declarion/react 0.29.0 → 0.30.0

package/dist-lib/lib/actions.d.ts

@@ -48,6 +48,16 @@ export declare function filterUnavailableMutationActions(actions: Array<{
  * Checks if an action has parameters that need user input.
  */
 export declare function actionHasParams(action: Action): boolean;
+/**
+ * Tooltip text for an action control (plan 2026-07-02-action-display-description).
+ * Precedence: disabled-reason > description > name.
+ *
+ * A labeled control already shows the name, so its tooltip is the description
+ * alone; an icon-only control (`display.icon_only`) has no visible label, so it
+ * shows "name - description" to keep the name reachable on hover. Absent
+ * description falls back to the name - byte-identical to pre-description behavior.
+ */
+export declare function actionTooltip(action: Action | undefined, name: string, isDisabled: boolean, reason: string | null | undefined): string;
 /**
  * Builds the full dot-qualified action code for API calls.
  */

package/dist-lib/testing.js

@@ -1,4 +1,4 @@
-import { H as e, X as t, Y as n, Z as r, mt as i, t as a } from "./ActionRunner-DtUDeH4F.js";
+import { H as e, X as t, Y as n, Z as r, mt as i, t as a } from "./ActionRunner-HrBGEIPi.js";
 import { useState as o } from "react";
 import { MemoryRouter as s } from "react-router-dom";
 import { QueryClient as c, QueryClientProvider as l } from "@tanstack/react-query";

package/dist-lib/types/schema.d.ts

@@ -186,6 +186,7 @@ export interface ChildQuickAdd {
 }
 export interface ChildDisplay {
     name: LocalizedString;
+    description?: LocalizedString;
     icon?: string;
     mode?: ChildDisplayMode;
     columns?: string[];
@@ -268,6 +269,7 @@ export interface ParameterDef {
 }
 export interface AssociationDisplay {
     name?: LocalizedString;
+    description?: LocalizedString;
     icon?: string;
 }
 export interface AssociationDef {
@@ -536,6 +538,9 @@ export interface Screen {
     visibility?: ScreenVisibility;
     display?: {
         name: LocalizedString;
+        /** Localized explanation of the screen, surfaced via the list-header info
+         *  affordance (falls back to the entity description). Optional. */
+        description?: LocalizedString;
         icon: string;
     };
     columns?: string[];
@@ -617,6 +622,7 @@ export interface ActivityRailConfig {
 export interface ViewDefinition {
     code: string;
     name: LocalizedString;
+    description?: LocalizedString;
     icon?: string;
     filters?: Array<{
         field: string;
@@ -806,11 +812,12 @@ export interface Action {
          */
         shortcut?: string;
         /**
-         * Localized help text for tooltip/popover.
-         * Reason: separate from display.name so the title stays terse while a
-         * longer explanation surfaces on hover.
+         * Localized explanation of what the action does. Surfaces as the control
+         * tooltip (precedence: disabled-reason > description > name) and the
+         * ActionDialog subtitle. Optional; absent renders exactly as before.
+         * (Supersedes the removed `help` field - plan 2026-07-02 Decision 16.)
          */
-        help?: LocalizedString;
+        description?: LocalizedString;
     };
     visibility?: string[];
     confirmation?: LocalizedString;
@@ -874,6 +881,7 @@ export interface HandlerDef {
     entity?: string;
     display?: {
         name?: LocalizedString;
+        description?: LocalizedString;
         icon?: string;
     };
     params?: OrderedMap<HandlerParam>;

package/dist-lib/{value-CNUbJNK-.js → value-D9BaSRFG.js}

@@ -1,4 +1,4 @@
-import { Ft as e, It as t, zt as n } from "./ActionRunner-DtUDeH4F.js";
+import { Ft as e, It as t, zt as n } from "./ActionRunner-HrBGEIPi.js";
 import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
 //#region src/components/file-widgets/helpers.ts
 var s = ["thumb_200", "thumb_300"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",