@opencxh/ui-kit 3.137.8 → 3.137.9

package/dist/src/content/SettingsPage.d.ts

@@ -0,0 +1,71 @@
+import { default as React, ReactNode } from 'react';
+import { PageHeaderAction } from './PageHeader';
+/**
+ * What a panel adds to the frame it is rendered in: the record it drilled into,
+ * and the way back out. The settings frame already draws the app breadcrumb and
+ * the page title, so a panel that repeats them produces the double bar this
+ * component exists to remove.
+ */
+export interface SettingsTrailEntry {
+    /** Appended to the frame breadcrumb; usually the detail record's name. */
+    title?: string;
+    /** When set, the frame renders the back affordance and calls this. */
+    onBack?: () => void;
+}
+export interface SettingsFrameApi {
+    /**
+     * `ownerId` scopes the write to one panel instance. Stable across renders,
+     * so it is safe to use as a hook dependency.
+     */
+    setTrail: (ownerId: string, entry: SettingsTrailEntry | null) => void;
+}
+/**
+ * Provided by the settings frame (the shell overlay), consumed by panels that
+ * are federated remotes. Safe across the module-federation boundary because
+ * React and `@opencxh/ui-kit` are both shared singletons — a second copy of
+ * either would hand panels a different context object and the trail would
+ * silently never arrive.
+ */
+export declare const SettingsFrameProvider: React.Provider<SettingsFrameApi | null>;
+export declare function useSettingsFrame(): SettingsFrameApi | null;
+/**
+ * State half of the frame contract, for the host to own. Returns the current
+ * trail plus the stable api to hand down through `SettingsFrameProvider`.
+ */
+export declare function useSettingsFrameHost(): {
+    trail: SettingsTrailEntry | null;
+    api: SettingsFrameApi;
+};
+declare const paddingClasses: {
+    readonly none: "";
+    readonly sm: "px-3 py-3";
+    readonly md: "px-5 py-4";
+};
+export interface SettingsPageProps {
+    children: ReactNode;
+    /**
+     * Primary actions, right-aligned in the sticky footer — the Cancel/Save pair
+     * of a form. Omit entirely on a read-only or list page and no footer renders.
+     */
+    actions?: PageHeaderAction[];
+    /** Left-aligned footer actions, set apart from the primary pair (e.g. Delete). */
+    secondaryActions?: PageHeaderAction[];
+    /** Renders the back affordance in the frame header (or inline when unframed). */
+    onBack?: () => void;
+    backLabel?: string;
+    /** The record's own name, appended to the frame breadcrumb. */
+    title?: string;
+    /** Swaps the body for a skeleton while keeping the footer in place. */
+    loading?: boolean;
+    padding?: keyof typeof paddingClasses;
+    className?: string;
+    contentClassName?: string;
+}
+/**
+ * The body of one settings panel. Owns the three things every panel used to
+ * re-invent: the scroll container, the content padding, and where the actions
+ * live. Title, description and breadcrumb belong to the frame — pass `title`
+ * and `onBack` to extend them rather than drawing a second header here.
+ */
+export declare const SettingsPage: React.FC<SettingsPageProps>;
+export {};

package/dist/src/forms/Form.d.ts

@@ -59,6 +59,12 @@ export interface FormGroupItem<T = any> {
     width?: string | number;
     /** Placeholder text */
     placeholder?: string;
+    /**
+     * Visible rows for `textarea`. Defaults to 4, which is right for a note and
+     * far too small for a field that holds an instruction someone actually reads
+     * back while editing (a system prompt).
+     */
+    rows?: number;
     /** Autocomplete attribute */
     autocomplete?: string;
     /** Options for select/radio/checkbox types */

package/dist/src/index.d.ts

@@ -46,6 +46,7 @@ export { PageToolbar, PageToolbarActions, type PageToolbarActionsProps, type Pag
 export { RichText, type RichTextProps } from './content/RichText';
 export { SectionCaption, type SectionCaptionProps } from './content/SectionCaption';
 export { SectionDivider, type SectionDividerProps } from './content/SectionDivider';
+export { SettingsFrameProvider, SettingsPage, useSettingsFrame, useSettingsFrameHost, type SettingsFrameApi, type SettingsPageProps, type SettingsTrailEntry } from './content/SettingsPage';
 export { SettingsRow, SettingsSection, type SettingsRowProps, type SettingsSectionProps } from './content/SettingsRow';
 export { SourceChip, type SourceChipProps } from './content/SourceChip';
 export { Table, dateFilterHandler, selectFilterHandler, type TableAction, type TableColumn, type TableFilter, type TableProps } from './content/Table';

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@opencxh/ui-kit",
-  "version": "3.137.8",
+  "version": "3.137.9",
   "description": "Theme-aware UI component library for OpenCXH platform",
   "type": "module",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"