@skiddph/prui 0.1.1 → 0.2.1

package/dist/app/app.d.ts

@@ -1,13 +1,7 @@
-import { AppliedTheme, ThemeName } from '../theme';
+import { AppliedTheme, ThemeDefault } from '../theme';
 import { PropsMeta } from '../core/props-meta';
 import { PageSetName } from './auto-pages';
 import * as React from "react";
-/**
- * <App> is the whole shell: responsive sidebar with collapsible nav groups and
- * mobile drawer plus scroll lock, sticky header with brand and theme switch,
- * built-in command palette on the "/" hotkey, and router wiring (BrowserRouter
- * by default, memory mode for embedded use).
- */
 export type NavIconType = React.ComponentType<{
     className?: string;
 }>;
@@ -33,21 +27,37 @@ export interface SearchConfig {
     placeholder?: string;
 }
 export interface ThemeConfig {
-    default?: ThemeName;
+    /** Named theme or the 'dark' / 'light' shorthand. Default 'control'. */
+    default?: ThemeDefault;
     persist?: boolean;
 }
 export interface SidebarConfig {
     /** Width in px, default 240. */
     width?: number;
+    /** Whether the mobile hamburger/drawer is available. Default true. */
+    collapsible?: boolean;
+    /** Whether the mobile drawer starts open. Default false. */
     defaultOpen?: boolean;
 }
-export type RouterMode = "browser" | "memory";
+/** Session-timeout flow config (HRLabs extraction). */
+export interface AuthConfig {
+    /** Idle minutes before logout. Default 15. */
+    sessionTimeout?: number;
+    /** Idle minutes before the countdown warning. Default 2. */
+    warningTime?: number;
+    /** Called on expiry or early logout; default navigates to loginPath. */
+    onTimeout?: () => void;
+    loginPath?: string;
+}
+export type RouterMode = "browser" | "memory" | "react-router";
 export interface AppProps {
     brand?: BrandConfig;
     nav?: NavItem[];
     search?: boolean | SearchConfig;
     theme?: boolean | ThemeConfig;
     sidebar?: SidebarConfig;
+    /** Session-timeout flow; omit or false to disable. */
+    auth?: boolean | AuthConfig;
     router?: RouterMode;
     /** Extra header content. */
     header?: React.ReactNode;

package/dist/app/auth-shell.d.ts

@@ -0,0 +1,52 @@
+import { BrandConfig } from './app';
+import * as React from "react";
+/**
+ * AuthShell: the centered card layout for login/OTP/session-timeout screens
+ * (proposal: app-layer component sourced from HRLabs' auth screens). Brand
+ * mark on top, card below, full-viewport centering.
+ */
+export interface AuthShellProps {
+    title: string;
+    description?: React.ReactNode;
+    brand?: BrandConfig;
+    /** Column width class for the card. Default max-w-sm. */
+    width?: string;
+    footer?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+}
+export declare function AuthShell({ title, description, brand, width, footer, children, className }: AuthShellProps): React.JSX.Element;
+export declare const authShellPropsMeta: {
+    readonly name: "AuthShell";
+    readonly props: readonly [{
+        readonly name: "title";
+        readonly type: "string";
+        readonly default: null;
+        readonly control: "text";
+    }, {
+        readonly name: "description";
+        readonly type: "ReactNode";
+        readonly default: null;
+        readonly control: "text";
+    }, {
+        readonly name: "brand";
+        readonly type: "{ name, mark?, href? }";
+        readonly default: "undefined";
+        readonly control: "object";
+    }, {
+        readonly name: "width";
+        readonly type: "string";
+        readonly default: "'max-w-sm'";
+        readonly control: "text";
+    }, {
+        readonly name: "footer";
+        readonly type: "ReactNode";
+        readonly default: null;
+        readonly control: "none";
+    }, {
+        readonly name: "children";
+        readonly type: "ReactNode";
+        readonly default: null;
+        readonly control: "none";
+    }];
+};

package/dist/app/form.d.ts

@@ -3,19 +3,21 @@ import * as React from "react";
 /**
  * Schema-driven Form: fields from a schema, validation display included.
  * Each field: name, label, type, placeholder, required, options, defaultValue.
+ * The schema may be a bare field array or an object `{ fields, submitLabel }`;
+ * `defaultValues` is an alias of `initialValues`.
  */
-export type FormFieldType = "text" | "password" | "email" | "number" | "textarea" | "select" | "boolean";
+export type FormFieldType = "text" | "password" | "email" | "number" | "date" | "textarea" | "select" | "boolean";
 export interface FormFieldSchema {
     name: string;
     label: string;
     type?: FormFieldType;
     placeholder?: string;
     required?: boolean;
-    /** select options: label/value pairs. */
-    options?: {
+    /** select options: label/value pairs; plain strings and numbers are accepted. */
+    options?: (string | number | {
         label: string;
         value: string;
-    }[];
+    })[];
     defaultValue?: string | number | boolean;
     disabled?: boolean;
     /** Optional inline validation: return an error message or null. */
@@ -29,9 +31,13 @@ export interface FormSchema {
     /** Render fields in a 2-col grid on md+ when true. */
     columns?: 1 | 2;
 }
+/** A schema is either the fields array itself or the full object. */
+export type FormSchemaInput = FormFieldSchema[] | FormSchema;
 export interface FormProps {
-    schema: FormSchema;
+    schema: FormSchemaInput;
     initialValues?: Record<string, unknown>;
+    /** Alias of initialValues. */
+    defaultValues?: Record<string, unknown>;
     onSubmit?: (values: Record<string, unknown>) => void | Promise<void>;
     onCancel?: () => void;
     cancelLabel?: string;
@@ -40,5 +46,5 @@ export interface FormProps {
     error?: string | null;
     className?: string;
 }
-export declare function Form({ schema, initialValues, onSubmit, onCancel, cancelLabel, submitting, error, className, }: FormProps): React.JSX.Element;
+export declare function Form({ schema: schemaInput, initialValues, defaultValues, onSubmit, onCancel, cancelLabel, submitting, error, className, }: FormProps): React.JSX.Element;
 export declare const formPropsMeta: PropsMeta;

package/dist/app/index.d.ts

@@ -1,8 +1,11 @@
 /** PRUI App layer: config-driven super-components. */
+export { Routes, Route, Outlet, Link, NavLink, Navigate } from 'react-router-dom';
 export { AutoPages } from './auto-pages';
 export type { PagesMode, PagesConfig, PageSetName } from './auto-pages';
-export { App, AppShell, SidebarNav, CommandPalette, useThemeState, appPropsMeta, type AppProps, type NavItem, type NavIconType, type BrandConfig, type SearchConfig, type ThemeConfig, type SidebarConfig, type RouterMode, type PaletteEntry, } from './app';
-export { Resource, resourcePropsMeta, type ResourceProps, type ResourceColumn, type ResourceRow, type ResourceAction, type ListQuery, type ListResult, } from './resource';
+export { App, AppShell, SidebarNav, CommandPalette, useThemeState, appPropsMeta, type AppProps, type NavItem, type NavIconType, type BrandConfig, type SearchConfig, type ThemeConfig, type AuthConfig, type SidebarConfig, type RouterMode, type PaletteEntry, } from './app';
+export { Resource, resourcePropsMeta, type ResourceProps, type ResourceColumn, type ResourceRow, type ResourceAction, type ResourceFilterOptions, type ListQuery, type ListResult, } from './resource';
 export { Form, formPropsMeta, type FormProps, type FormSchema, type FormFieldSchema, type FormFieldType, } from './form';
 export { StatRow, statRowPropsMeta, type StatRowProps, type StatItem } from './stat-row';
 export { Settings, settingsPropsMeta, type SettingsProps, type SettingsSection, type SettingsField } from './settings';
+export { SessionTimeout, sessionTimeoutPropsMeta, type SessionTimeoutProps, } from './session-timeout';
+export { AuthShell, authShellPropsMeta, type AuthShellProps, } from './auth-shell';

package/dist/app/resource.d.ts

@@ -20,18 +20,24 @@ export interface ListQuery {
 }
 export interface ListResult<T> {
     rows: T[];
+    /** Next-page cursor. `cursor` is accepted as an alias. */
     nextCursor?: string | null;
+    cursor?: string | null;
 }
 export type ResourceRow = Record<string, unknown>;
+/** Select choices: plain strings/numbers or label/value pairs. */
+export type ResourceFilterOptions = (string | number | {
+    label: string;
+    value: string;
+    count?: number;
+})[];
 export interface ResourceColumn<T extends ResourceRow> extends Column<T> {
     /** Filter type rendered in the toolbar. */
-    filter?: "select" | "daterange" | "numberrange";
-    /** Options for filter select. */
-    filterOptions?: {
-        label: string;
-        value: string;
-        count?: number;
-    }[];
+    filter?: "select" | "date" | "daterange" | "number" | "numberrange" | "price" | "time";
+    /** Select filter choices: strings/numbers or {label, value} pairs. */
+    options?: ResourceFilterOptions;
+    /** Select filter choices; `options` is an alias of this. */
+    filterOptions?: ResourceFilterOptions;
     /** Field name for the form; defaults to key. */
     formField?: boolean;
 }
@@ -42,9 +48,13 @@ export interface ResourceProps<T extends ResourceRow> {
     columns: ResourceColumn<T>[];
     /** (query) => Promise<{rows, cursor}> */
     list: (query: ListQuery) => Promise<ListResult<T>>;
-    create?: (values: Record<string, unknown>) => Promise<void> | void;
-    update?: (row: T, values: Record<string, unknown>) => Promise<void> | void;
-    remove?: (row: T) => Promise<void> | void;
+    /** Return values are ignored — resolve or reject to signal outcome. */
+    create?: (values: Record<string, unknown>) => unknown;
+    update?: (row: T, values: Partial<T>) => unknown;
+    /** Deletes a row; `delete` is an alias. */
+    remove?: (row: T) => unknown;
+    /** Alias of remove. */
+    delete?: (row: T) => unknown;
     /** Enabled actions, default all three when the functions are provided. */
     actions?: ResourceAction[];
     /** Custom form node; receives the editing row (null on create). */
@@ -57,5 +67,5 @@ export interface ResourceProps<T extends ResourceRow> {
     pageSize?: number;
     className?: string;
 }
-export declare function Resource<T extends ResourceRow>({ name, columns, list, create, update, remove, actions, form, formSchema, rowKey, searchPlaceholder, pageSize: initialPageSize, className, }: ResourceProps<T>): React.JSX.Element;
+export declare function Resource<T extends ResourceRow>({ name, columns, list, create, update, remove, delete: deleteAlias, actions, form, formSchema, rowKey, searchPlaceholder, pageSize: initialPageSize, className, }: ResourceProps<T>): React.JSX.Element;
 export declare const resourcePropsMeta: PropsMeta;

package/dist/app/session-timeout.d.ts

@@ -0,0 +1,45 @@
+import * as React from "react";
+/**
+ * SessionTimeout: idle detection with a countdown warning, extracted from
+ * HRLabs' SessionTimeout flow. Tracks mousedown/keydown/scroll/touch activity;
+ * after `timeout` minus `warningTime` of inactivity it shows a countdown
+ * dialog (Continue session / Log out) and calls onTimeout when it expires.
+ */
+export interface SessionTimeoutProps {
+    /** Total idle time before logout, in minutes. Default 15. */
+    timeout?: number;
+    /** How long before the timeout the warning appears, in minutes. Default 2. */
+    warningTime?: number;
+    /** Called when the session expires (or the user logs out early). */
+    onTimeout?: () => void;
+    /** Called when the user extends the session. */
+    onExtend?: () => void;
+    /** Dialog copy overrides. */
+    title?: string;
+    message?: string;
+}
+export declare function SessionTimeout({ timeout, warningTime, onTimeout, onExtend, title, message, }: SessionTimeoutProps): React.JSX.Element;
+export declare const sessionTimeoutPropsMeta: {
+    readonly name: "SessionTimeout";
+    readonly props: readonly [{
+        readonly name: "timeout";
+        readonly type: "number";
+        readonly default: "15";
+        readonly control: "number";
+    }, {
+        readonly name: "warningTime";
+        readonly type: "number";
+        readonly default: "2";
+        readonly control: "number";
+    }, {
+        readonly name: "onTimeout";
+        readonly type: "() => void";
+        readonly default: null;
+        readonly control: "none";
+    }, {
+        readonly name: "onExtend";
+        readonly type: "() => void";
+        readonly default: null;
+        readonly control: "none";
+    }];
+};

package/dist/app/settings.d.ts

@@ -3,16 +3,33 @@ import * as React from "react";
 /**
  * Settings: a two-column settings page from a section list.
  * Left: section nav (in-page anchors). Right: section cards with fields.
+ * Fields are either fully typed (`name` + `type` + `value`/`onChange`, which
+ * render the matching primitive) or a free `control` node.
  */
+export type SettingsFieldType = "text" | "number" | "select" | "switch";
 export interface SettingsField {
     label: string;
     description?: string;
-    /** Controlled content: any node (input, switch, custom). */
+    /** Field key; required when type is set. */
+    name?: string;
+    type?: SettingsFieldType;
+    /** Choices for type select: strings/numbers or label/value pairs. */
+    options?: (string | number | {
+        label: string;
+        value: string;
+    })[];
+    /** Current value for typed fields. */
+    value?: string | number | boolean;
+    /** Change handler for typed fields. */
+    onChange?: (value: string | number | boolean) => void;
+    /** Controlled content: any node (input, switch, custom). Overrides type. */
     control?: React.ReactNode;
 }
 export interface SettingsSection {
     id: string;
-    title: string;
+    title?: string;
+    /** Alias of title. */
+    label?: string;
     description?: string;
     fields?: SettingsField[];
     /** Fully custom section body. */

package/dist/app.js

@@ -1,18 +1,29 @@
-import { A as e, a as t, b as o, C as r, F as p, R as P, S as m, c as S, d as u, e as M, f as g, r as A, s as R, g as c, u as d } from "./chunks/settings-DUz5nyX-.js";
+import { Link as e, NavLink as t, Navigate as o, Outlet as r, Route as p, Routes as u } from "react-router-dom";
+import { A as m, a as P, b as S, c as l, C as h, F as n, R as M, S as R, d as g, e as A, f, g as c, h as d, i as k, r as v, s as N, j as T, k as b, u as w } from "./chunks/auth-shell-DsAwGqf8.js";
 export {
-  e as App,
-  t as AppShell,
-  o as AutoPages,
-  r as CommandPalette,
-  p as Form,
-  P as Resource,
-  m as Settings,
-  S as SidebarNav,
-  u as StatRow,
-  M as appPropsMeta,
-  g as formPropsMeta,
-  A as resourcePropsMeta,
-  R as settingsPropsMeta,
-  c as statRowPropsMeta,
-  d as useThemeState
+  m as App,
+  P as AppShell,
+  S as AuthShell,
+  l as AutoPages,
+  h as CommandPalette,
+  n as Form,
+  e as Link,
+  t as NavLink,
+  o as Navigate,
+  r as Outlet,
+  M as Resource,
+  p as Route,
+  u as Routes,
+  R as SessionTimeout,
+  g as Settings,
+  A as SidebarNav,
+  f as StatRow,
+  c as appPropsMeta,
+  d as authShellPropsMeta,
+  k as formPropsMeta,
+  v as resourcePropsMeta,
+  N as sessionTimeoutPropsMeta,
+  T as settingsPropsMeta,
+  b as statRowPropsMeta,
+  w as useThemeState
 };