@declarion/react 0.32.0 → 0.34.0

package/dist-lib/components/pages/DocumentsMenu.d.ts

@@ -0,0 +1,22 @@
+import { type Entity } from "../../types/schema";
+import { type ListViewState } from "./exportRequest";
+export interface DocumentsMenuProps {
+    entityCode: string;
+    scope: "detail" | "list";
+    objectIds?: string[];
+    viewState?: ListViewState;
+    selectedIds?: string[];
+    locale?: string;
+    /** Static system-template capability from the schema projection
+     *  (`entity.documents`). Absent/both-falsy means no SYSTEM template
+     *  applies for this caller/tenant/entity - the button still renders if
+     *  the lazy tenant-template probe (below) finds one. */
+    capability?: Entity["documents"];
+    /** True when the caller can manage tenant document templates (heuristic:
+     *  `document_template` is present & readable in `schema.entities`). Gates
+     *  the lazy `document.templates.available` visibility probe so a
+     *  template-less, non-manager caller (the Haia default) makes ZERO extra
+     *  network calls - Business Case 6. */
+    canManageTemplates?: boolean;
+}
+export declare function DocumentsMenu({ entityCode, scope, objectIds, viewState, selectedIds, capability, canManageTemplates, }: DocumentsMenuProps): import("react").JSX.Element | null;

package/dist-lib/components/pages/RecordDocumentsPanel.d.ts

@@ -0,0 +1,42 @@
+import { type LocalizedString } from "../../types/schema";
+interface RecordDocumentsPanelProps {
+    entityCode: string;
+    objectId: string;
+    /** Static system-template capability for this entity's detail scope
+     *  (`entity.documents.generate_one` from the schema projection). When
+     *  true the shelf always mounts (even with zero attachments yet, since a
+     *  template applies and the caller may generate one from Generate). When
+     *  false/absent the shelf mounts ONLY if the record already has >=1
+     *  attached document - it never orphans visible history, but it also
+     *  never shows an empty "no documents" shelf on an entity with nothing to
+     *  generate and nothing generated (the Haia case). */
+    canGenerateOne?: boolean;
+    /** True when the caller can manage tenant document templates. Together with
+     *  canGenerateOne this gates whether the attachment fetch runs at all: a
+     *  template-less, non-manager caller (the Haia default) makes ZERO
+     *  document.object_links calls per record view. The rare orphaned-attachment
+     *  case (a template was removed but its current-attached docs remain) then
+     *  surfaces only to managers on the record and to everyone via My Documents,
+     *  which is the right trade for the stakeholder's "no gratuitous cost" bar. */
+    canManageTemplates?: boolean;
+}
+interface RecordDocument {
+    generated_document_id: string;
+    template_code: string;
+    template_source: string;
+    input?: Record<string, unknown>;
+    title?: LocalizedString;
+    output_format: string;
+    status: string;
+    download_url?: string;
+    filename?: string;
+    created_at: string;
+    ready_at?: string;
+    error_text?: string;
+}
+/** Pure refetchInterval predicate, exported for direct unit testing (a
+ *  timer-driven integration test through the full useQuery/React lifecycle
+ *  is slow and flaky; this is the actual decision logic). */
+export declare function pendingPollInterval(rows: Array<Pick<RecordDocument, "status">> | undefined): number | false;
+export declare function RecordDocumentsPanel({ entityCode, objectId, canGenerateOne, canManageTemplates }: RecordDocumentsPanelProps): import("react").JSX.Element | null;
+export {};

package/dist-lib/components/pages/list/ListHeader.d.ts

@@ -8,16 +8,6 @@ export interface ListHeaderProps {
      *  description). Empty = no affordance, header renders identically. The
      *  affordance is inline with the title baseline: zero height delta. */
     description?: string;
-    /** Total matching rows, from the separate count query. Undefined while
-     *  the count is in flight or after it failed. */
-    total: number | undefined;
-    /** Strategy used to produce `total` ("exact" | "estimated"). Drives
-     *  display precision. Undefined when no count has resolved. */
-    countMode?: "exact" | "estimated";
-    /** True while the count query is in flight - render a loading affordance
-     *  in the count slot instead of a number. */
-    countPending?: boolean;
-    loaded: number;
     toolbarActions: {
         code: string;
         action: Action;
@@ -33,4 +23,4 @@ export interface ListHeaderProps {
     /** Dispatch surface threaded into ResponsiveActionBar (plan §8 Task 10). */
     widgetContext: WidgetContext;
 }
-export declare function ListHeader({ title, description, total, countMode, countPending, loaded, toolbarActions, screenActionLayout, entityActionLayout, selectedIds, data, rowKey, onActionSuccess, widgetContext, }: ListHeaderProps): import("react").JSX.Element | null;
+export declare function ListHeader({ title, description, toolbarActions, screenActionLayout, entityActionLayout, selectedIds, data, rowKey, onActionSuccess, widgetContext, }: ListHeaderProps): import("react").JSX.Element | null;

package/dist-lib/components/primitives/Icons.d.ts

@@ -48,6 +48,7 @@ export declare const Icon: {
     field: FC<IconProps>;
     file: FC<IconProps>;
     "file-diff": FC<IconProps>;
+    filePlus: FC<IconProps>;
     filter: FC<IconProps>;
     flow: FC<IconProps>;
     folder: FC<IconProps>;

package/dist-lib/components/primitives/Tooltip.d.ts

@@ -0,0 +1,30 @@
+import type { FocusEventHandler, ReactNode, RefObject } from "react";
+export interface AnchoredTooltip {
+    open: boolean;
+    /** Spread onto the trigger element (button, span, ...). */
+    triggerHandlers: {
+        onMouseEnter: () => void;
+        onMouseLeave: () => void;
+        onFocus: FocusEventHandler;
+        onBlur: () => void;
+    };
+    /** aria-describedby value for the trigger while the tooltip is open. */
+    describedBy: string | undefined;
+    /** The tooltip portal; render as a sibling of the trigger. null when empty. */
+    portal: ReactNode;
+}
+export declare function useAnchoredTooltip(ref: RefObject<HTMLElement | null>, content: string | undefined): AnchoredTooltip;
+export interface TooltipProps {
+    /** Tooltip text. Empty/absent renders the trigger with no tooltip. */
+    content?: string;
+    children: ReactNode;
+    /** Extra props forwarded to the trigger wrapper (e.g. data-testid). */
+    triggerProps?: React.HTMLAttributes<HTMLSpanElement>;
+}
+export declare function Tooltip({ content, children, triggerProps }: TooltipProps): import("react").JSX.Element;
+export interface InfoTooltipProps {
+    label: string;
+    size?: number;
+    "data-testid"?: string;
+}
+export declare function InfoTooltip({ label, size, ...rest }: InfoTooltipProps): import("react").JSX.Element;

package/dist-lib/components/primitives/index.d.ts

@@ -15,6 +15,8 @@ export { Dropdown } from "./Dropdown";
 export type { DropdownProps } from "./Dropdown";
 export { HoverCard } from "./HoverCard";
 export type { HoverCardProps, HoverCardAlign } from "./HoverCard";
+export { Tooltip, InfoTooltip } from "./Tooltip";
+export type { TooltipProps, InfoTooltipProps } from "./Tooltip";
 export { Chip } from "./Chip";
 export type { ChipProps } from "./Chip";
 export { SectionCard } from "./SectionCard";

package/dist-lib/components/shared/ActionResultDialog.d.ts

@@ -1,6 +1,10 @@
 export interface DisplayField {
     label: string;
     value: string;
+    type?: "text" | "download" | "link";
+    href?: string;
+    download_url?: string;
+    filename?: string;
     copyable?: boolean;
     monospace?: boolean;
 }

package/dist-lib/components/shared/RecordHeader.d.ts

@@ -4,6 +4,7 @@ interface RecordHeaderProps {
     avatarName?: string;
     title: string;
     recordId?: string;
+    description?: string;
     highlights?: ReactNode;
     mode: "display" | "edit" | "create";
     dirty?: boolean;
@@ -12,5 +13,5 @@ interface RecordHeaderProps {
     right?: ReactNode;
     showTitle?: boolean;
 }
-export declare function RecordHeader({ icon, avatarName, title, recordId, highlights, mode, dirty, showBack, onBack, right, showTitle, }: RecordHeaderProps): import("react").JSX.Element;
+export declare function RecordHeader({ icon, avatarName, title, recordId, description, highlights, mode, dirty, showBack, onBack, right, showTitle, }: RecordHeaderProps): import("react").JSX.Element;
 export {};

package/dist-lib/components/shared/ResponsiveActionBar.d.ts

@@ -117,6 +117,14 @@ export interface ResponsiveActionBarProps {
     reservedRightWidth?: number;
     /** Rendering density / measurement strategy. */
     kind?: "detail" | "toolbar" | "row";
+    /**
+     * When true (default) a kind="detail" bar stretches to `width: 100%` so it
+     * can measure the available width and overflow into a "More" menu. Set false
+     * when the bar shares a single flex row with other controls (e.g. the detail
+     * header's Refresh/Live pill): a 100%-width bar would wrap onto its own line.
+     * Content-sized is safe for the header slot, which carries few actions.
+     */
+    fillContainer?: boolean;
     /**
      * Test seam: when provided, overrides the measurement decision for each
      * node. Return true = node fits inline; false = overflows to More.
@@ -176,4 +184,4 @@ export interface ResponsiveActionBarProps {
  * kind="row": single kebab "⋮" with all actions in dropdown.
  * kind default: "toolbar".
  */
-export declare function ResponsiveActionBar({ layout, row, rowSelection, onRun, reservedRightWidth, kind, measurementOverride, entityActions, globalActions, ariaLabel, trailingNormalItems, trailingDestructiveItems, widgetContext, onActionClick, }: ResponsiveActionBarProps): import("react").JSX.Element | null;
+export declare function ResponsiveActionBar({ layout, row, rowSelection, onRun, reservedRightWidth, kind, fillContainer, measurementOverride, entityActions, globalActions, ariaLabel, trailingNormalItems, trailingDestructiveItems, widgetContext, onActionClick, }: ResponsiveActionBarProps): import("react").JSX.Element | null;

package/dist-lib/icons.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./DynamicIcon-DCRdxxZ7.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./DynamicIcon-BWO6QtNF.js";
 export { o as DynamicIcon, a as Icon, n as LucideIcon, i as getIcon, t as getIconRegistryVersion, e as setIconRegistry, r as subscribeIconRegistry };