@declarion/react 0.2.0 → 0.2.2

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

@@ -1,16 +1,49 @@
-/**
- * Shared toast configuration constants.
- *
- * The toaster is mounted once in `app.tsx` (sonner `<Toaster>` with
- * `closeButton` + `visibleToasts={5}`). Every toast emitter - the central
- * `ActionRunner` and the handful of direct `toast.error` callsites in
- * `useMutations`, `useVersionWatcher`, and form gates in `SmartDetailPage` -
- * MUST import this constant rather than hardcoding `Infinity` (which
- * piles toasts up indefinitely and overwhelms the surface).
- *
- * 60s is the chosen balance: well past human read time, short enough that
- * walking away does not produce a stale wall of red on return. `closeButton`
- * on the Toaster and the in-description Copy button cover the explicit
- * read-and-keep flow for users who need longer than 60s.
- */
-export declare const ERROR_TOAST_DURATION_MS = 60000;
+import { type ToastType } from "../components/shared/toast/DeclarionToast";
+export type { ToastType, ToastAction } from "../components/shared/toast/DeclarionToast";
+/** Per-call toast options. Severity sets the defaults; these override them. */
+export interface ToastOptions {
+    /** Auto-dismiss after this many ms. 0 = sticky. Defaults to the variant's. */
+    duration?: number;
+    /** Force sticky (never auto-dismiss) regardless of duration. */
+    sticky?: boolean;
+    /** Trailing action button - e.g. View / Retry / Undo / Reload. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Correlation id, shown top-right in mono, included when the user copies. */
+    requestId?: string;
+    /** Expandable detail block (stack trace, server payload). */
+    details?: string;
+    /** Repeats sharing a `group` roll up into one toast with a ×N badge. */
+    group?: string;
+    /** Explicit id - reuse to replace an existing toast in place (idempotent). */
+    id?: string;
+}
+/** Fields a loading toast can morph into when its async work resolves. */
+export interface ToastUpdate {
+    type?: ToastType;
+    title?: string;
+    message?: string;
+    duration?: number;
+    sticky?: boolean;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    requestId?: string;
+    details?: string;
+}
+/** Morph an existing toast in place - the loading -> success/error path. */
+declare function update(id: string, patch: ToastUpdate): void;
+/** The app-wide toast API. Import this - not `sonner` - everywhere. */
+export declare const toast: {
+    success: (title: string, message?: string, opts?: ToastOptions) => string;
+    info: (title: string, message?: string, opts?: ToastOptions) => string;
+    warning: (title: string, message?: string, opts?: ToastOptions) => string;
+    error: (title: string, message?: string, opts?: ToastOptions) => string;
+    loading: (title: string, message?: string, opts?: ToastOptions) => string;
+    update: typeof update;
+    dismiss: (id: string) => string | number;
+    dismissAll: () => string | number;
+};

package/dist-lib/stores/appearance.d.ts

@@ -5,6 +5,7 @@ export type SidebarMode = "wide" | "collapsed";
 export type TabsPosition = "top" | "bottom";
 export type AiSurface = "command" | "panel" | "both" | "off";
 export type FaviconSource = "google" | "direct" | "none";
+export type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
 export interface Appearance {
     theme: ThemeId;
     accent: AccentId;
@@ -19,6 +20,8 @@ export interface Appearance {
     aiSurface: AiSurface;
     /** Favicon source for unknown hosts in URL cells. See ui_favicon_source. */
     faviconSource: FaviconSource;
+    /** Where toasts appear. Read by <Toaster> in app.tsx. See ui_toast_position. */
+    toastPosition: ToastPosition;
 }
 export declare function applyAppearance(a: Appearance): void;
 interface AppearanceState extends Appearance {

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

@@ -172,6 +172,7 @@ export interface StatusGroupDef {
     initial: string;
     statuses: StatusDef[];
     transitions?: Record<string, string[]>;
+    display_mode?: "pill" | "stepper";
 }
 export interface PropertyDef {
     name: LocalizedString;
@@ -338,6 +339,7 @@ export interface SectionNode {
     columns?: number;
     icon?: string;
     badge?: SectionBadgeConfig;
+    emphasis?: "primary" | "secondary";
 }
 export interface RowConfig {
     items: LayoutNode[];
@@ -389,6 +391,15 @@ export interface LayoutNode {
     position_field?: string;
     interaction?: "navigate" | "inline_edit" | "row_edit" | "readonly";
 }
+export interface AuditLineDef {
+    label: LocalizedString;
+    at?: string;
+    by?: string;
+}
+export interface AuditConfig {
+    enabled?: boolean;
+    lines?: AuditLineDef[];
+}
 export interface Screen {
     type: "list" | "detail" | "custom" | "record_list";
     entity?: string;
@@ -409,6 +420,8 @@ export interface Screen {
     items?: LayoutNode[];
     sidebar?: LayoutNode[];
     sidebar_width?: string;
+    highlights?: string[];
+    audit?: AuditConfig;
     self?: boolean;
     list_width?: string;
     list_resizable?: boolean;