@declarion/react 0.1.33 → 0.1.44

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

@@ -0,0 +1,82 @@
+import type { CSSProperties, InputHTMLAttributes, ReactNode } from "react";
+export type FieldLabelProps = {
+    children?: ReactNode;
+    required?: boolean;
+    hint?: string;
+};
+export declare const FieldLabel: ({ children, required, hint }: FieldLabelProps) => import("react/jsx-runtime").JSX.Element;
+export type TextInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "prefix"> & {
+    value?: string | null;
+    onChange?: (v: string) => void;
+    prefix?: ReactNode;
+    suffix?: ReactNode;
+    style?: CSSProperties;
+};
+export declare function TextInput({ value, onChange, placeholder, prefix, suffix, style, ...rest }: TextInputProps): import("react/jsx-runtime").JSX.Element;
+export type TextAreaProps = {
+    value?: string | null;
+    onChange?: (v: string) => void;
+    placeholder?: string;
+    rows?: number;
+};
+export declare function TextArea({ value, onChange, placeholder, rows }: TextAreaProps): import("react/jsx-runtime").JSX.Element;
+export type SelectOption = {
+    value: string;
+    label: ReactNode;
+};
+export type SelectProps = {
+    value?: string;
+    options: SelectOption[];
+    onChange: (v: string) => void;
+    placeholder?: string;
+};
+export declare function Select({ value, options, onChange, placeholder }: SelectProps): import("react/jsx-runtime").JSX.Element;
+export type DateInputProps = {
+    value?: string | null;
+    onChange?: (v: string) => void;
+};
+export declare function DateInput({ value, onChange }: DateInputProps): import("react/jsx-runtime").JSX.Element;
+export type PasswordInputProps = {
+    value?: string | null;
+    onChange?: (v: string) => void;
+    placeholder?: string;
+    showStrength?: boolean;
+};
+export declare function PasswordInput({ value, onChange, placeholder, showStrength, }: PasswordInputProps): import("react/jsx-runtime").JSX.Element;
+export type TagsInputProps = {
+    value?: string[];
+    onChange: (v: string[]) => void;
+};
+export declare function TagsInput({ value, onChange }: TagsInputProps): import("react/jsx-runtime").JSX.Element;
+export type JsonFieldProps = {
+    value?: string;
+    onChange?: (v: string) => void;
+};
+export declare function JsonField({ value, onChange }: JsonFieldProps): import("react/jsx-runtime").JSX.Element;
+export type RefFieldItem = {
+    id: string;
+    name: string;
+};
+export type RefFieldProps = {
+    value?: string;
+    entity?: string;
+    onChange?: (v: string) => void;
+    items?: RefFieldItem[];
+};
+export declare function RefField({ value, entity, onChange, items }: RefFieldProps): import("react/jsx-runtime").JSX.Element;
+export type ViewFieldProps = {
+    label: ReactNode;
+    children?: ReactNode;
+    mono?: boolean;
+    wide?: boolean;
+    empty?: boolean;
+};
+export declare function ViewField({ label, children, mono, wide, empty }: ViewFieldProps): import("react/jsx-runtime").JSX.Element;
+export type QuickEditCellProps = {
+    value?: string;
+    onChange?: (v: string) => void;
+    type?: "text" | "select" | "bool";
+    options?: SelectOption[];
+    tone?: string;
+};
+export declare function QuickEditCell({ value, onChange, type, options }: QuickEditCellProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { CSSProperties, MouseEvent, ReactNode } from "react";
+export type IconBtnProps = {
+    icon: ReactNode;
+    onClick?: (e: MouseEvent<HTMLButtonElement>) => void;
+    title?: string;
+    size?: number;
+    active?: boolean;
+    disabled?: boolean;
+    style?: CSSProperties;
+};
+export declare const IconBtn: import("react").ForwardRefExoticComponent<IconBtnProps & import("react").RefAttributes<HTMLButtonElement>>;

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

@@ -0,0 +1,87 @@
+import type { CSSProperties, FC } from "react";
+export type IconProps = {
+    size?: number;
+    cls?: string;
+    style?: CSSProperties;
+};
+export declare const Icon: {
+    readonly home: FC<IconProps>;
+    readonly inbox: FC<IconProps>;
+    readonly flow: FC<IconProps>;
+    readonly pipeline: FC<IconProps>;
+    readonly leads: FC<IconProps>;
+    readonly company: FC<IconProps>;
+    readonly activity: FC<IconProps>;
+    readonly users: FC<IconProps>;
+    readonly tenant: FC<IconProps>;
+    readonly shield: FC<IconProps>;
+    readonly key: FC<IconProps>;
+    readonly group: FC<IconProps>;
+    readonly idp: FC<IconProps>;
+    readonly audit: FC<IconProps>;
+    readonly log: FC<IconProps>;
+    readonly handlers: FC<IconProps>;
+    readonly jobs: FC<IconProps>;
+    readonly sched: FC<IconProps>;
+    readonly entity: FC<IconProps>;
+    readonly field: FC<IconProps>;
+    readonly action: FC<IconProps>;
+    readonly code: FC<IconProps>;
+    readonly search: FC<IconProps>;
+    readonly filter: FC<IconProps>;
+    readonly columns: FC<IconProps>;
+    readonly plus: FC<IconProps>;
+    readonly minus: FC<IconProps>;
+    readonly sort: FC<IconProps>;
+    readonly more: FC<IconProps>;
+    readonly x: FC<IconProps>;
+    readonly check: FC<IconProps>;
+    readonly down: FC<IconProps>;
+    readonly up: FC<IconProps>;
+    readonly right: FC<IconProps>;
+    readonly left: FC<IconProps>;
+    readonly cheveron: FC<IconProps>;
+    readonly back: FC<IconProps>;
+    readonly calendar: FC<IconProps>;
+    readonly clock: FC<IconProps>;
+    readonly email: FC<IconProps>;
+    readonly link: FC<IconProps>;
+    readonly hash: FC<IconProps>;
+    readonly eye: FC<IconProps>;
+    readonly eyeOff: FC<IconProps>;
+    readonly copy: FC<IconProps>;
+    readonly trash: FC<IconProps>;
+    readonly edit: FC<IconProps>;
+    readonly save: FC<IconProps>;
+    readonly refresh: FC<IconProps>;
+    readonly download: FC<IconProps>;
+    readonly upload: FC<IconProps>;
+    readonly paperclip: FC<IconProps>;
+    readonly tag: FC<IconProps>;
+    readonly bolt: FC<IconProps>;
+    readonly bell: FC<IconProps>;
+    readonly ai: FC<IconProps>;
+    readonly sparkle: FC<IconProps>;
+    readonly command: FC<IconProps>;
+    readonly menu: FC<IconProps>;
+    readonly dot: FC<IconProps>;
+    readonly globe: FC<IconProps>;
+    readonly folder: FC<IconProps>;
+    readonly branch: FC<IconProps>;
+    readonly sun: FC<IconProps>;
+    readonly moon: FC<IconProps>;
+    readonly settings: FC<IconProps>;
+    readonly logout: FC<IconProps>;
+    readonly loader: FC<IconProps>;
+    readonly grid: FC<IconProps>;
+    readonly star: FC<IconProps>;
+    readonly warning: FC<IconProps>;
+    readonly info: FC<IconProps>;
+    readonly building: FC<IconProps>;
+    readonly device: FC<IconProps>;
+    readonly arrowUp: FC<IconProps>;
+    readonly arrowDown: FC<IconProps>;
+    readonly external: FC<IconProps>;
+    readonly dbtable: FC<IconProps>;
+};
+export type IconName = keyof typeof Icon;

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

@@ -0,0 +1,4 @@
+import type { ReactNode } from "react";
+export declare function Kbd({ children }: {
+    children?: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+export type MenuItemProps = {
+    icon?: ReactNode;
+    children?: ReactNode;
+    onClick?: () => void;
+    danger?: boolean;
+    kbd?: ReactNode;
+    active?: boolean;
+    divider?: boolean;
+};
+export declare function MenuItem({ icon, children, onClick, danger, kbd, active, divider }: MenuItemProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { CSSProperties, ReactNode } from "react";
+export type PillTone = "indigo" | "emerald" | "amber" | "rose" | "sky" | "violet" | "slate" | "teal";
+export type PillSize = "xs" | "sm" | "md";
+export type PillProps = {
+    tone?: PillTone;
+    size?: PillSize;
+    dot?: boolean;
+    style?: CSSProperties;
+    children?: ReactNode;
+};
+export declare function Pill({ tone, children, size, dot, style }: PillProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,8 @@
+export type RecordIdBadgeProps = {
+    value: string;
+};
+/**
+ * Compact record-ID badge. Truncates UUIDs to their first segment for readability
+ * and copies the full value on click. Non-UUID ids render in full.
+ */
+export declare function RecordIdBadge({ value }: RecordIdBadgeProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { ReactNode } from "react";
+export type RowFieldProps = {
+    label: ReactNode;
+    children?: ReactNode;
+    wide?: boolean;
+    editing?: boolean;
+    required?: boolean;
+    hint?: string;
+};
+export declare function RowField({ label, children, wide, editing, required }: RowFieldProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import { type PillTone } from "./Pill";
+export type SectionBadge = {
+    text: string;
+    tone?: PillTone;
+    dot?: boolean;
+};
+export type SectionCardProps = {
+    title: ReactNode;
+    subtitle?: ReactNode;
+    right?: ReactNode;
+    badge?: SectionBadge;
+    children?: ReactNode;
+    collapsible?: boolean;
+    defaultOpen?: boolean;
+    icon?: ReactNode;
+    padding?: string;
+};
+export declare function SectionCard({ title, subtitle, right, badge, children, collapsible, defaultOpen, icon, padding, }: SectionCardProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,3 @@
+export declare function Spinner({ size }: {
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1 @@
+export declare function cx(...a: Array<string | false | null | undefined>): string;

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

@@ -0,0 +1,31 @@
+export { cx } from "./cx";
+export { Icon } from "./Icons";
+export type { IconProps, IconName } from "./Icons";
+export { Btn } from "./Btn";
+export type { BtnProps, BtnKind, BtnSize } from "./Btn";
+export { IconBtn } from "./IconBtn";
+export type { IconBtnProps } from "./IconBtn";
+export { Pill } from "./Pill";
+export type { PillProps, PillTone, PillSize } from "./Pill";
+export { Kbd } from "./Kbd";
+export { Avatar } from "./Avatar";
+export type { AvatarProps } from "./Avatar";
+export { Dropdown } from "./Dropdown";
+export type { DropdownProps } from "./Dropdown";
+export { Chip } from "./Chip";
+export type { ChipProps } from "./Chip";
+export { SectionCard } from "./SectionCard";
+export type { SectionCardProps, SectionBadge } from "./SectionCard";
+export { RecordIdBadge } from "./RecordIdBadge";
+export type { RecordIdBadgeProps } from "./RecordIdBadge";
+export { RowField } from "./RowField";
+export type { RowFieldProps } from "./RowField";
+export { BoolToggle } from "./BoolToggle";
+export type { BoolToggleProps } from "./BoolToggle";
+export { MenuItem } from "./MenuItem";
+export type { MenuItemProps } from "./MenuItem";
+export { Check } from "./Check";
+export type { CheckProps } from "./Check";
+export { Spinner } from "./Spinner";
+export { FieldLabel, TextInput, TextArea, Select, DateInput, PasswordInput, TagsInput, JsonField, RefField, ViewField, QuickEditCell, } from "./Fields";
+export type { FieldLabelProps, TextInputProps, TextAreaProps, SelectProps, SelectOption, DateInputProps, PasswordInputProps, TagsInputProps, JsonFieldProps, RefFieldProps, RefFieldItem, ViewFieldProps, QuickEditCellProps, } from "./Fields";

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

@@ -6,5 +6,5 @@ interface ActionConfirmDialogProps {
     onConfirm: () => void;
     isPending: boolean;
 }
-export declare function ActionConfirmDialog({ open, onOpenChange, actionName, message, onConfirm, isPending, }: ActionConfirmDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActionConfirmDialog({ open, onOpenChange, actionName, message, onConfirm, isPending, }: ActionConfirmDialogProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -6,17 +6,7 @@ interface ActionDialogProps {
     actionName: string;
     onSubmit: (params: Record<string, unknown>) => void;
     isPending: boolean;
-    /**
-     * Target record for default-value prefill via the `$row.<field>` template
-     * syntax. When a param default is a string literal `$row.foo`, the dialog
-     * substitutes `row.foo` at open time. For batch invocations on a list
-     * page, pass the first selected row (or omit - callers that invoke the
-     * action without a single-row context simply don't get row prefills).
-     *
-     * The substitution is client-side only. The server ignores template
-     * syntax - it only sees the concrete value the admin submits.
-     */
     row?: Record<string, unknown>;
 }
-export declare function ActionDialog({ open, onOpenChange, action, actionName, onSubmit, isPending, row, }: ActionDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActionDialog({ open, onOpenChange, action, actionName, onSubmit, isPending, row, }: ActionDialogProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -14,5 +14,5 @@ interface ActionResultDialogProps {
     onClose: () => void;
     display: ActionDisplayResult;
 }
-export declare function ActionResultDialog({ open, onClose, display }: ActionResultDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ActionResultDialog({ open, onClose, display }: ActionResultDialogProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -0,0 +1,21 @@
+import { type ReactNode } from "react";
+import { type Action } from "../../types/schema";
+export interface RunActionOptions {
+    /** Full YAML action when available; drives destructive/long_running/resolved_params. */
+    action?: Action;
+    /** Presentation title for the modal/toast. */
+    title?: string;
+    /** When `action` is absent, individual flags still steer dispatch. */
+    destructive?: boolean;
+    longRunning?: boolean;
+    /** Invoked after the user confirms / fills params. */
+    execute: (params: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+interface ActionRunnerContextValue {
+    run: (opts: RunActionOptions) => void;
+}
+export declare function useActionRunner(): ActionRunnerContextValue;
+export declare function ActionRunnerProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,14 @@
+import { type IconName } from "../../components/primitives";
+export interface Crumb {
+    label: string;
+    icon?: IconName | string;
+    onClick?: () => void;
+    target?: unknown;
+    /** True for the final segment (rendered bold per design spec). */
+    isLast?: boolean;
+}
+export interface BreadcrumbsProps {
+    items: Crumb[];
+    onCrumbClick?: (crumb: Crumb) => void;
+}
+export declare function Breadcrumbs({ items, onCrumbClick }: BreadcrumbsProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,9 @@
+export type ChangePasswordDialogProps = {
+    open: boolean;
+    onClose: () => void;
+    onSubmit: (input: {
+        current: string;
+        next: string;
+    }) => Promise<void> | void;
+};
+export declare function ChangePasswordDialog({ open, onClose, onSubmit }: ChangePasswordDialogProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -7,5 +7,5 @@ interface ConfirmDialogProps {
     onConfirm: () => void;
     destructive?: boolean;
 }
-export declare function ConfirmDialog({ open, onOpenChange, title, description, confirmLabel, onConfirm, destructive, }: ConfirmDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConfirmDialog({ open, onOpenChange, title, description, confirmLabel, onConfirm, destructive, }: ConfirmDialogProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

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

@@ -4,5 +4,5 @@ interface CopyButtonProps {
     className?: string;
     size?: "sm" | "icon";
 }
-export declare function CopyButton({ value, title, className, size }: CopyButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function CopyButton({ value, title, size }: CopyButtonProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,6 +1,9 @@
-import type { LucideProps } from "lucide-react";
-interface DynamicIconProps extends LucideProps {
+import type { CSSProperties } from "react";
+interface DynamicIconProps {
     name: string;
+    size?: number | string;
+    className?: string;
+    style?: CSSProperties;
 }
-export declare function DynamicIcon({ name, ...props }: DynamicIconProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function DynamicIcon({ name, size, className, style }: DynamicIconProps): import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,17 +1,12 @@
 import { Component, type ErrorInfo, type ReactNode } from "react";
 interface Props {
     children: ReactNode;
-    /** Optional fallback UI. Defaults to a centered error card with retry button. */
     fallback?: ReactNode;
 }
 interface State {
     hasError: boolean;
     error: Error | null;
 }
-/**
- * Catches JavaScript errors in child components and renders a fallback UI
- * instead of crashing the entire app.
- */
 export declare class ErrorBoundary extends Component<Props, State> {
     constructor(props: Props);
     static getDerivedStateFromError(error: Error): State;

package/dist-lib/components/shell/AIPanel.d.ts

@@ -0,0 +1,6 @@
+export interface AIPanelProps {
+    open: boolean;
+    onClose: () => void;
+    context?: string;
+}
+export declare function AIPanel({ open, onClose, context }: AIPanelProps): import("react/jsx-runtime").JSX.Element | null;

package/dist-lib/components/shell/CommandPalette.d.ts

@@ -0,0 +1,18 @@
+import { type NavNode, type Screen } from "../../types/schema";
+export type CommandActionType = "nav" | "new" | "open" | "ai" | "ai-panel" | "theme";
+export interface CommandAction {
+    type: CommandActionType;
+    id?: string;
+    route?: string;
+    q?: string;
+}
+export interface CommandPaletteProps {
+    open: boolean;
+    onClose: () => void;
+    onAction: (a: CommandAction) => void;
+    mode?: "default" | "new";
+    navigation?: NavNode[];
+    screens?: Record<string, Screen>;
+    includeAI?: boolean;
+}
+export declare function CommandPalette({ open, onClose, onAction, mode, navigation, screens, includeAI, }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element | null;

package/dist-lib/components/views/ViewSwitcher.d.ts

@@ -1,5 +1,4 @@
 export interface ViewItem {
-    /** UUID for DB views, code string for system views */
     id: string;
     name: Record<string, string>;
     icon?: string;
@@ -18,10 +17,5 @@ interface ViewSwitcherProps {
     onSaveAs?: () => void;
     onSetDefault?: (viewId: string) => void;
 }
-/**
- * ViewSwitcher - dropdown at the top of list pages.
- * Shows system views (presets) + personal/shared DB views.
- * "Save View" button appears when dirty.
- */
-export declare function ViewSwitcher({ views, activeViewId, isDirty, onSelect, onSave, onSaveAs, onSetDefault, }: ViewSwitcherProps): import("react/jsx-runtime").JSX.Element;
+export declare function ViewSwitcher({ views, activeViewId, isDirty, onSelect, onSave, onSaveAs, }: ViewSwitcherProps): import("react/jsx-runtime").JSX.Element;
 export {};