@declarion/react 0.52.0 → 0.54.0

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

@@ -1,7 +1,7 @@
 import { type ReactNode } from "react";
 import { type ResolvedActionLayoutNode } from "../../lib/actions";
 import { type Action } from "../../types/schema";
-import { type WidgetContext } from "../../components/actions/ResponsiveActionBar";
+import { type WidgetContext } from "./ResponsiveActionBar";
 export type ObjectActionBarSlot = "detail" | "detail_toolbar" | "list_row" | "quick_peek";
 export type ObjectActionSelection = {
     include: string[];

package/dist-lib/components/chrome/Breadcrumbs.d.ts

@@ -1,4 +1,4 @@
-import { type IconName } from "../../components/primitives";
+import { type IconName } from "../primitives";
 export interface Crumb {
     label: string;
     icon?: IconName | (string & {});

package/dist-lib/components/detail-layout/DetailAuditStrip.d.ts

@@ -1,5 +1,5 @@
 import type { Entity, Schema, Screen } from "../../types/schema";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 interface DetailAuditStripProps {
     screen: Screen;
     entity: Entity;

package/dist-lib/components/detail-layout/DetailHighlights.d.ts

@@ -1,6 +1,6 @@
 import type { Entity, Schema, Screen } from "../../types/schema";
 import type { StatusInfo } from "../../types/api";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 interface DetailHighlightsProps {
     screen: Screen;
     entity: Entity;

package/dist-lib/components/detail-layout/DraggableChildrenTable.d.ts

@@ -1,5 +1,5 @@
 import type { Entity, Schema } from "../../types/schema";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 import type { PendingChildRow } from "./LayoutRenderer";
 import type { ResolvedChildConfig } from "../../lib/child-config";
 interface DraggableChildrenTableProps {

package/dist-lib/components/detail-layout/EditableChildrenTable.d.ts

@@ -1,5 +1,5 @@
 import type { Entity, Schema } from "../../types/schema";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 import type { PendingChildRow } from "./LayoutRenderer";
 import type { ResolvedChildConfig } from "../../lib/child-config";
 interface EditableChildrenTableProps {

package/dist-lib/components/detail-layout/LayoutRenderer.d.ts

@@ -1,6 +1,6 @@
 import type { Entity, LayoutNode, Schema } from "../../types/schema";
 import type { StatusInfo, PropertyValue } from "../../types/api";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 export interface PendingChildRow {
     _key: string;
     _deleted?: boolean;

package/dist-lib/components/file-widgets/host.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { Entity, Screen } from "../../types/schema";
 import type { FileFieldDef, FileFieldValue } from "../../types/files";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 export declare function getEntityFileField(entity: Pick<Entity, "files">, fieldName: string): FileFieldDef | undefined;
 export declare function getFileFieldValue(record: Record<string, unknown>, fieldName: string): FileFieldValue;
 export declare function getSchemaFieldValue(entity: Pick<Entity, "fields" | "files">, record: Record<string, unknown>, fieldName: string): unknown;

package/dist-lib/components/layout/Layout.d.ts

@@ -1,5 +1,5 @@
 import { useTabStore } from "../../stores/tabs";
 import { type NavNode, type Screen } from "../../types/schema";
-import type { Crumb } from "../../components/chrome/Breadcrumbs";
+import type { Crumb } from "../chrome/Breadcrumbs";
 export declare function Layout(): import("react").JSX.Element | null;
 export declare function buildCrumbs(nodes: NavNode[], screens: Record<string, Screen>, pathname: string, tabs: ReturnType<typeof useTabStore.getState>["tabs"], activeTabId: string | null, topLevelNavigate: (to: string) => void): Crumb[];

package/dist-lib/components/layout/TopBar.d.ts

@@ -1,5 +1,5 @@
 import { type RefObject } from "react";
-import { type Crumb } from "../../components/chrome/Breadcrumbs";
+import { type Crumb } from "../chrome/Breadcrumbs";
 export interface TopBarProps {
     breadcrumbs?: Crumb[];
     onCrumbClick?: (c: Crumb) => void;

package/dist-lib/components/list/InlineEditCell.d.ts

@@ -1,4 +1,4 @@
-import { type SelectOption } from "../../components/primitives";
+import { type SelectOption } from "../primitives";
 export type InlineEditTrigger = "dblclick" | "enter" | "always";
 export type InlineEditKind = "text" | "select" | "bool";
 export interface InlineEditCellProps {

package/dist-lib/components/list/PeekFieldCell.d.ts

@@ -1,4 +1,4 @@
-import { type Refs } from "../../components/fields";
+import { type Refs } from "../fields";
 import type { EntityField } from "../../types/schema";
 export interface PeekFieldCellProps {
     field: EntityField;

package/dist-lib/components/list/QuickPeek.d.ts

@@ -1,6 +1,6 @@
 import { type ReactNode } from "react";
 import { type Action, type Entity, type EntityField, type Screen } from "../../types/schema";
-import type { Refs } from "../../components/fields";
+import type { Refs } from "../fields";
 import { type ResolvedActionLayoutNode } from "../../lib/actions";
 export interface QuickPeekRegularFieldSpec {
     key: string;

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

@@ -15,7 +15,7 @@ export interface DocumentsMenuProps {
     /** 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
+     *  template-less, non-manager caller - the default - makes ZERO extra
      *  network calls - Business Case 6. */
     canManageTemplates?: boolean;
 }

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

@@ -9,11 +9,11 @@ interface RecordDocumentsPanelProps {
      *  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). */
+     *  generate and nothing generated. */
     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
+     *  template-less, non-manager caller - the 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,

package/dist-lib/components/pages/auth/AuthShell.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { Icon } from "../../../components/primitives/Icons";
+import { Icon } from "../../primitives/Icons";
 export type AuthShellProps = {
     children: ReactNode;
     /**

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

@@ -1,7 +1,7 @@
 import type { ListRow } from "./table-features";
 import type { ListResponse, RowData } from "../../../types/api";
 import { type Action, type Entity, type Screen } from "../../../types/schema";
-import type { resolveCellRenderer } from "../../../components/fields/cells/registry";
+import type { resolveCellRenderer } from "../../fields/cells/registry";
 import type { RowInteraction } from "./useListRowInteraction";
 type CellRenderer = ReturnType<typeof resolveCellRenderer>;
 interface ListCardRowProps {

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

@@ -1,7 +1,7 @@
 import type { ListRow } from "./table-features";
 import type { Virtualizer } from "@tanstack/react-virtual";
 import type { ListResponse, RowData } from "../../../types/api";
-import type { resolveCellRenderer } from "../../../components/fields/cells/registry";
+import type { resolveCellRenderer } from "../../fields/cells/registry";
 import type { Action, Entity, Screen } from "../../../types/schema";
 import type { RowInteraction } from "./useListRowInteraction";
 interface ListCardsBodyProps {

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

@@ -1,5 +1,5 @@
 import { type ResolvedActionLayoutNode } from "../../../lib/actions";
-import { type WidgetContext } from "../../../components/actions/ResponsiveActionBar";
+import { type WidgetContext } from "../../actions/ResponsiveActionBar";
 import type { Action, Entity, Screen } from "../../../types/schema";
 export interface ListFloatbarProps {
     selectedIds: string[];

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

@@ -1,5 +1,5 @@
 import { type ResolvedActionLayoutNode } from "../../../lib/actions";
-import { type WidgetContext } from "../../../components/actions/ResponsiveActionBar";
+import { type WidgetContext } from "../../actions/ResponsiveActionBar";
 import type { Action } from "../../../types/schema";
 export interface ListHeaderProps {
     title: string;

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

@@ -1,6 +1,6 @@
 import { type RefObject } from "react";
 import type { ListColumnDef } from "./table-features";
-import { type Refs } from "../../../components/fields/cells/registry";
+import { type Refs } from "../../fields/cells/registry";
 import type { Action, Entity, Screen } from "../../../types/schema";
 import type { RowData } from "../../../types/api";
 type SchemaMaps = {

package/dist-lib/components/pages/list/filter-meta.d.ts

@@ -1,5 +1,5 @@
 import type { Entity, Screen, ScreenFilterSpecialValues } from "../../../types/schema";
-import type { FilterFieldMeta } from "../../../components/filters/FilterDrawer";
+import type { FilterFieldMeta } from "../../filters/FilterDrawer";
 /**
  * Build FilterFieldMeta array from screen + entity for the FilterDrawer.
  *

package/dist-lib/components/pages/list/use-filter-value-labels.d.ts

@@ -1,6 +1,6 @@
 import { type FilterNode, type FilterValueResolver } from "../../../lib/filters";
 import type { Entity } from "../../../types/schema";
-import type { FilterFieldMeta } from "../../../components/filters/FilterDrawer";
+import type { FilterFieldMeta } from "../../filters/FilterDrawer";
 import type { Refs } from "../../../types/api";
 /**
  * useFilterValueLabels - the single source of human labels for stored filter

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

@@ -39,7 +39,12 @@ export interface ListQueryResult {
     error: unknown;
     /** True while a load has been running long enough to be worth saying so. */
     isLoadingStale: boolean;
-    retry: () => void;
+    /**
+     * Cancels this query's in-flight fetch and refetches it, resolving when both
+     * have settled - in that order. Returning nothing made every completion-based
+     * state silently instant, so a control that waited on it never waited.
+     */
+    retry: () => Promise<void>;
     /** The total, and how it was produced. Undefined while the count is in flight
      *  or after it failed - a caller degrades to the loaded row count. */
     countTotal: number | undefined;

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

@@ -1,5 +1,5 @@
 import type { MouseEvent as ReactMouseEvent } from "react";
-import type { QuickPeekFieldSpec } from "../../../components/list/QuickPeek";
+import type { QuickPeekFieldSpec } from "../../list/QuickPeek";
 import { useLongPress } from "../../../hooks/useLongPress";
 import type { RowData } from "../../../types/api";
 import { type Action, type Entity, type Screen } from "../../../types/schema";

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

@@ -1,6 +1,6 @@
 import type { FilterNode } from "../../../lib/filters";
 import { type Screen } from "../../../types/schema";
-import type { ViewItem } from "../../../components/list/ViewSwitcher";
+import type { ViewItem } from "../../list/ViewSwitcher";
 interface ListViewsInput {
     screenCode: string;
     screen: Screen | undefined;

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

@@ -1,5 +1,5 @@
 import { type ResolvedActionLayoutNode } from "../../../lib/actions";
-import type { ActionRunHandler, WidgetContext } from "../../../components/actions/ResponsiveActionBar";
+import type { ActionRunHandler, WidgetContext } from "../../actions/ResponsiveActionBar";
 import type { Action, Entity, Screen } from "../../../types/schema";
 export interface UseRowMenuArgs {
     row: Record<string, unknown>;

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

@@ -9,10 +9,16 @@
  */
 export interface RefreshControlProps {
     liveObject: {
+        /** Resolves when the refresh it starts has settled. See useOwnRefresh. */
         refetch: () => unknown;
-        isFetching: boolean;
         isLoading: boolean;
         isLive: boolean;
+        /**
+         * @deprecated Ignored; the control reports only the refresh a person
+         * started. Passing it changes nothing. Declared so a consumer that builds
+         * this object literally still compiles.
+         */
+        isFetching?: boolean;
     };
     realtime?: boolean;
 }

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

@@ -0,0 +1,9 @@
+/**
+ * Whether the refresh THIS control started is still running. A control driven
+ * by its query's flag reports somebody else's work and sits disabled exactly
+ * when a person reaches for it. docs/architecture.md.
+ */
+export declare function useOwnRefresh(refetch: () => unknown): {
+    refreshing: boolean;
+    refresh: () => void;
+};