@nice2dev/ui 1.0.21 → 1.0.22

package/dist/editors.d.ts

@@ -1,6 +1,7 @@
 import { default as default_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
 import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui-core';
 import { NiceDataSource } from '@nice2dev/ui-core';
 import { NiceEditorSize } from '@nice2dev/ui-core';
 import { NiceFormFieldProps } from '@nice2dev/ui-core';
@@ -597,8 +598,20 @@ export declare interface NiceCodeEditorProps {
      * LSP bridge configuration. If provided, connects Monaco to the LSP server for enhanced language features.
      */
     lsp?: NiceCodeEditorLspConfig;
+    /**
+     * Extra TypeScript/JavaScript declaration sources fed to Monaco for IntelliSense
+     * (e.g. a generated `ctx.d.ts` describing a script context). Each entry is registered
+     * via `monaco.languages.typescript.{typescript|javascript}Defaults.addExtraLib`.
+     * Only takes effect for `javascript` / `typescript` languages. Re-applied when the array changes.
+     */
+    extraLibs?: Array<{
+        content: string;
+        filePath?: string;
+    }>;
     /** Additional CSS class */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
     /** Test ID */
     'data-testid'?: string;
 }
@@ -890,6 +903,8 @@ export declare interface NiceCropEditorProps {
     style?: default_2.CSSProperties;
     /** Test ID */
     'data-testid'?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -1107,6 +1122,8 @@ export declare interface NiceDocumentEditorProps extends NiceBaseProps {
     showToc?: boolean;
     /** Show find & replace bar (Ctrl+F). */
     showFindReplace?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceDropDownBox: default_2.FC<NiceDropDownBoxProps>;
@@ -1459,7 +1476,6 @@ declare interface NiceHtmlEditorAIRef {
 /** Available toolbar commands for the {@link NiceHtmlEditor}. */
 declare type NiceHtmlEditorCommand = 'bold' | 'italic' | 'underline' | 'strikethrough' | 'h1' | 'h2' | 'h3' | 'ul' | 'ol' | 'link' | 'unlink' | 'undo' | 'redo' | 'clear' | 'table' | 'image' | 'code' | 'markdown' | 'blockquote' | 'hr' | 'fontSize' | 'fontColor' | 'bgColor' | 'subscript' | 'superscript' | 'indent' | 'outdent' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'fullscreen' | 'removeFormat' | 'print' | 'source' | 'emoji' | 'findReplace';
 
-/** Props for the {@link NiceHtmlEditor} component � a WYSIWYG rich-text editor with toolbar, mentions, and image upload. */
 export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
     value: string;
     onChange: (html: string) => void;
@@ -1491,6 +1507,8 @@ export declare interface NiceHtmlEditorProps extends NiceFormFieldProps {
         label: string;
         html: string;
     }[];
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare type NiceImageAnnotationType = 'text' | 'rect' | 'circle' | 'line' | 'arrow';
@@ -1570,6 +1588,8 @@ export declare interface NiceImageEditorProps extends NiceBaseProps {
     onChange?: (state: NiceImageEditorState) => void;
     width?: number | string;
     height?: number | string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare interface NiceImageEditorState {
@@ -1642,6 +1662,53 @@ export declare interface NiceInvoiceLineEditorProps extends NiceFormFieldProps {
     maxLines?: number;
     /** Fires with computed totals whenever lines change. */
     onTotalsChange?: (totals: InvoiceTotals) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
+export declare const NiceKeyValueEditor: ForwardRefExoticComponent<NiceKeyValueEditorProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceKeyValueEditorProps extends NiceBaseProps {
+    /** Current rows (controlled). */
+    value: NiceKeyValuePair[];
+    /** Change callback with the full updated array. */
+    onChange: (pairs: NiceKeyValuePair[]) => void;
+    /** Allow toggling a row's value between text and secret (adds a lock toggle). */
+    allowSecret?: boolean;
+    /** Show a per-row enable/disable checkbox. */
+    allowToggle?: boolean;
+    /** Show a per-row description input. */
+    allowDescription?: boolean;
+    /** Suggested keys (rendered via a shared `<datalist>`). */
+    keySuggestions?: string[];
+    /** Placeholder for the key input. Default `'Key'`. */
+    keyPlaceholder?: string;
+    /** Placeholder for the value input. Default `'Value'`. */
+    valuePlaceholder?: string;
+    /** Label for the add-row button. Default `'Add'`. */
+    addLabel?: string;
+    /** Render read-only (no editing, no add/remove). */
+    readOnly?: boolean;
+    /** Highlight duplicate keys. Default `true`. */
+    duplicateKeyWarning?: boolean;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/** A single key/value row. */
+export declare interface NiceKeyValuePair {
+    /** Stable id (used as React key when present). */
+    id?: string;
+    /** The key/name. */
+    key: string;
+    /** The value. */
+    value: string;
+    /** `'secret'` renders the value masked with a reveal toggle. Default `'text'`. */
+    type?: 'text' | 'secret';
+    /** Whether the row is active. Only meaningful when `allowToggle` is set. */
+    enabled?: boolean;
+    /** Optional description / note. Only shown when `allowDescription` is set. */
+    description?: string;
 }
 
 export declare const NiceKnob: default_2.ForwardRefExoticComponent<NiceKnobProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1669,6 +1736,48 @@ export declare interface NiceKnobProps extends Omit<NiceFormFieldProps, 'size' |
     isLabelCentered?: boolean;
 }
 
+export declare const NiceLogConsole: ForwardRefExoticComponent<NiceLogConsoleProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceLogConsoleProps extends NiceBaseProps {
+    /** Entries to render, oldest → newest. */
+    entries: NiceLogEntry[];
+    /** Max height before the body scrolls. Number → px. Default `240`. */
+    maxHeight?: number | string;
+    /** Auto-scroll to the newest entry when `entries` grows. Default `true`. */
+    autoScroll?: boolean;
+    /** Show a per-entry timestamp gutter. Default `true`. */
+    showTimestamps?: boolean;
+    /** When set, only entries whose level is included are rendered. */
+    levelFilter?: NiceLogLevel[];
+    /** When provided, a "Clear" button is shown in the header. */
+    onClear?: () => void;
+    /** Header title. When omitted (and no `onClear`) the header is hidden. */
+    title?: string;
+    /** Content shown when there are no (visible) entries. Default `'No output'`. */
+    emptyText?: React.ReactNode;
+    /** Label for the clear button. Default `'Clear'`. */
+    clearLabel?: string;
+    /** Monospace font family override. */
+    fontFamily?: string;
+}
+
+/** A single line emitted to the console. */
+export declare interface NiceLogEntry {
+    /** Severity — drives colour and optional filtering. Defaults to `'log'`. */
+    level?: NiceLogLevel;
+    /** Human-readable message. */
+    message: string;
+    /** When the entry was produced. Epoch ms or `Date`. */
+    timestamp?: number | Date;
+    /** Optional structured payload appended (pretty-printed JSON) below the message. */
+    data?: unknown;
+    /** Optional source/tag shown as a dim prefix (e.g. a script or provider id). */
+    source?: string;
+}
+
+/** Severity of a single console entry. */
+export declare type NiceLogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+
 export declare const NiceLookup: default_2.FC<NiceLookupProps>;
 
 /** Column definition for the mini-grid lookup mode. */
@@ -1727,6 +1836,8 @@ export declare interface NiceMarkdownEditorProps extends NiceBaseProps {
     showLineNumbers?: boolean;
     onExportHtml?: (html: string) => void;
     onImageUpload?: (file: File) => Promise<string>;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare type NiceMarkdownPreviewMode = 'side' | 'tab' | 'none';
@@ -1911,6 +2022,8 @@ export declare interface NicePDFAnnotationEditorProps extends NiceFormFieldProps
     onAnnotationClick?: (annotation: PDFAnnotation) => void;
     /** Fires when an annotation is deleted. */
     onAnnotationDelete?: (id: string) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -2123,6 +2236,64 @@ export declare interface NiceScannerControlProps extends NiceFormFieldProps {
     onCameraFrame?: (video: HTMLVideoElement) => void;
 }
 
+export declare const NiceScriptRunner: ForwardRefExoticComponent<NiceScriptRunnerProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NiceScriptRunnerProps extends NiceBaseProps {
+    /** Script source (controlled). */
+    value: string;
+    /** Script change callback. */
+    onChange?: (value: string) => void;
+    /** Editor language. Default `'javascript'`. */
+    language?: NiceCodeLanguage;
+    /**
+     * Executes the script. Receives the current code and parsed input.
+     * Return (or resolve) a {@link NiceScriptRunResult}. Throwing is also supported —
+     * the error is surfaced in the result pane.
+     */
+    onRun: (code: string, input: unknown) => Promise<NiceScriptRunResult> | NiceScriptRunResult;
+    /** Sample input (entity/payload). Edited as JSON; parsed before `onRun`. */
+    input?: unknown;
+    /** Called with the parsed input when the input editor changes. */
+    onInputChange?: (input: unknown) => void;
+    /** Show the input editor. Defaults to `true` when `input` is provided. */
+    showInputPanel?: boolean;
+    /** Declaration libs forwarded to the code editor for IntelliSense (e.g. `ctx.d.ts`). */
+    extraLibs?: Array<{
+        content: string;
+        filePath?: string;
+    }>;
+    /** Editor height. Number → px. Default `260`. */
+    height?: number | string;
+    /** Externally-controlled running state. When omitted, the component manages its own. */
+    running?: boolean;
+    /** Debounced auto-run on code/input change. Default `false`. */
+    autoRun?: boolean;
+    /** Debounce for `autoRun`, ms. Default `600`. */
+    autoRunDelay?: number;
+    /** Panel arrangement. Default `'vertical'` (editor on top, output below). */
+    layout?: 'horizontal' | 'vertical';
+    /** Run button label. Default `'Run'`. */
+    runLabel?: string;
+    /** Editor theme. Default `'auto'`. */
+    theme?: 'auto' | 'light' | 'dark' | 'vs' | 'vs-dark';
+    /** Optional guided tour. `true` = built-in; array/object = custom steps. Shows a "?" button. */
+    tutorial?: NiceComponentTutorial;
+}
+
+/** Outcome of a single script run, returned by {@link NiceScriptRunnerProps.onRun}. */
+export declare interface NiceScriptRunResult {
+    /** Whether the run succeeded. */
+    ok: boolean;
+    /** Returned value (pretty-printed in the result pane). */
+    result?: unknown;
+    /** Log lines captured during the run. */
+    logs?: NiceLogEntry[];
+    /** Error message when `ok` is false. */
+    error?: string;
+    /** Wall-clock duration in milliseconds (shown in the status bar). */
+    durationMs?: number;
+}
+
 export declare const NiceSelect: default_2.ForwardRefExoticComponent<NiceSelectProps & default_2.RefAttributes<HTMLButtonElement>>;
 
 /** Props for the {@link NiceSelect} component. */

package/dist/editors.mjs

@@ -1,63 +1,66 @@
-import { N as a, a as c, b as s, c as N, d as o, e as t } from "./NiceTabs-nQEYYbsV.js";
-import { M as n, N as d, a as p, b as u, c as P, d as k, e as E, f as l, g as I, h as m, i as C, j as g, k as S, l as x, m as A, n as T } from "./NiceForm-BzKlOWJa.js";
-import { N as R, a as b, b as f, c as M, d as h, e as w, f as B, g as F, h as L, i as _, j, k as y, l as G, m as H, n as K, o as O, p as v, q, r as z, s as U, t as V, u as W, v as Y, w as J, x as Q, y as X, z as Z, A as $, B as ee, C as ie, D as ae, E as ce, F as se, G as Ne, H as oe, I as te } from "./NicePinCodeInput-DDK6qqFW.js";
+import { N as a, a as c, b as s, c as N, d as o, e as t } from "./NiceTabs-DJdhKste.js";
+import { M as n, N as d, a as u, b as p, c as l, d as E, e as P, f as k, g as I, h as m, i as C, j as g, k as S, l as x, m as A, n as T } from "./NiceForm-B7D1MASh.js";
+import { N as D, a as b, b as L, c as f, d as K, e as M, f as h, g as w, h as y, i as B, j as F, k as _, l as j, m as G, n as H, o as O, p as v, q as V, r as q, s as z, t as J, u as U, v as W, w as Y, x as Q, y as X, z as Z, A as $, B as ee, C as ie, D as ae, E as ce, F as se, G as Ne, H as oe, I as te, J as re, K as ne, L as de } from "./NicePinCodeInput-CjwFvOEQ.js";
 export {
   n as MASK_PRESETS,
-  R as NICE_COLOR_PRESET_KEYS,
+  D as NICE_COLOR_PRESET_KEYS,
   b as NiceAccountPicker,
-  f as NiceAddressInput,
+  L as NiceAddressInput,
   d as NiceAutocomplete,
-  M as NiceCalendar,
+  f as NiceCalendar,
   a as NiceCheckbox,
-  h as NiceCodeEditor,
-  w as NiceCodeEditorAI,
-  B as NiceColorPalette,
+  K as NiceCodeEditor,
+  M as NiceCodeEditorAI,
+  h as NiceColorPalette,
   c as NiceColorPicker,
-  F as NiceContactPicker,
-  p as NiceCountryPicker,
-  L as NiceCropEditor,
-  _ as NiceCurrencyInput,
-  u as NiceDatePicker,
-  j as NiceDateRangeBox,
-  P as NiceDateTimePicker,
-  y as NiceDocumentEditor,
-  G as NiceDropDownBox,
-  H as NiceEmojiPicker,
-  k as NiceFileUpload,
-  E as NiceForm,
-  K as NiceGradientPicker,
+  w as NiceContactPicker,
+  u as NiceCountryPicker,
+  y as NiceCropEditor,
+  B as NiceCurrencyInput,
+  p as NiceDatePicker,
+  F as NiceDateRangeBox,
+  l as NiceDateTimePicker,
+  _ as NiceDocumentEditor,
+  j as NiceDropDownBox,
+  G as NiceEmojiPicker,
+  E as NiceFileUpload,
+  P as NiceForm,
+  H as NiceGradientPicker,
   O as NiceHtmlEditor,
   v as NiceHtmlEditorAI,
-  q as NiceImageAnnotator,
-  z as NiceImageEditor,
-  U as NiceInputOtp,
-  V as NiceInvoiceLineEditor,
+  V as NiceImageAnnotator,
+  q as NiceImageEditor,
+  z as NiceInputOtp,
+  J as NiceInvoiceLineEditor,
+  U as NiceKeyValueEditor,
   W as NiceKnob,
-  Y as NiceLookup,
-  J as NiceMarkdownEditor,
-  l as NiceMaskedInput,
-  Q as NiceMention,
+  Y as NiceLogConsole,
+  Q as NiceLookup,
+  X as NiceMarkdownEditor,
+  k as NiceMaskedInput,
+  Z as NiceMention,
   s as NiceNumberInput,
-  X as NicePDFAnnotationEditor,
+  $ as NicePDFAnnotationEditor,
   I as NicePasswordInput,
   m as NicePhoneInput,
-  Z as NicePickList,
-  $ as NicePinCodeInput,
+  ee as NicePickList,
+  ie as NicePinCodeInput,
   C as NiceRadioGroup,
-  ee as NiceRangeSlider,
+  ae as NiceRangeSlider,
   g as NiceRating,
-  ie as NiceScannerControl,
+  ce as NiceScannerControl,
+  se as NiceScriptRunner,
   N as NiceSelect,
-  ae as NiceSignature,
-  ce as NiceSignaturePad,
+  Ne as NiceSignature,
+  oe as NiceSignaturePad,
   S as NiceSlider,
   x as NiceTagBox,
-  se as NiceTaxRatePicker,
+  te as NiceTaxRatePicker,
   A as NiceTextArea,
   o as NiceTextInput,
   T as NiceTimePicker,
   t as NiceToggle,
-  Ne as NiceTreeSelect,
-  oe as NiceVatInput,
-  te as NiceWiki
+  re as NiceTreeSelect,
+  ne as NiceVatInput,
+  de as NiceWiki
 };

package/dist/feedback.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./NiceErrorBoundary-XNceAa-3.cjs"),i=require("./NiceModal-BOkmGqPj.cjs");exports.NiceAlert=e.NiceAlert;exports.NiceConfirmDialog=e.NiceConfirmDialog;exports.NiceCookieConsent=e.NiceCookieConsent;exports.NiceDrawer=e.NiceDrawer;exports.NiceErrorBoundary=e.NiceErrorBoundary;exports.NiceLoginForm=e.NiceLoginForm;exports.NiceOfflineBanner=e.NiceOfflineBanner;exports.NiceRetryPanel=e.NiceRetryPanel;exports.NiceTimeoutFeedback=e.NiceTimeoutFeedback;exports.NiceToastContainer=e.NiceToastContainer;exports.alertIcons=e.alertIcons;exports.useNiceToast=e.useNiceToast;exports.NiceModal=i.NiceModal;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./NiceErrorBoundary-BXOLv-zG.cjs"),i=require("./NiceModal-BVT9cZbf.cjs");exports.NiceAlert=e.NiceAlert;exports.NiceConfirmDialog=e.NiceConfirmDialog;exports.NiceCookieConsent=e.NiceCookieConsent;exports.NiceDrawer=e.NiceDrawer;exports.NiceErrorBoundary=e.NiceErrorBoundary;exports.NiceLoginForm=e.NiceLoginForm;exports.NiceOfflineBanner=e.NiceOfflineBanner;exports.NiceRetryPanel=e.NiceRetryPanel;exports.NiceTimeoutFeedback=e.NiceTimeoutFeedback;exports.NiceToastContainer=e.NiceToastContainer;exports.alertIcons=e.alertIcons;exports.useNiceToast=e.useNiceToast;exports.NiceModal=i.NiceModal;

package/dist/feedback.d.ts

@@ -1,7 +1,6 @@
 import { Component } from 'react';
 import { default as default_2 } from 'react';
 import { ForwardRefExoticComponent } from 'react';
-import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { NiceSize } from '@nice2dev/ui-core';
 import { NiceStandardProps } from '@nice2dev/ui-core';
 import { NiceVariant } from '@nice2dev/ui-core';
@@ -120,7 +119,7 @@ export declare class NiceErrorBoundary extends Component<NiceErrorBoundaryProps,
     static getDerivedStateFromError(error: Error): NiceErrorBoundaryState;
     componentDidCatch(error: Error, errorInfo: default_2.ErrorInfo): void;
     handleReset: () => void;
-    render(): string | number | boolean | Iterable<default_2.ReactNode> | JSX_2.Element | null | undefined;
+    render(): string | number | boolean | Iterable<default_2.ReactNode> | default_2.JSX.Element | null | undefined;
 }
 
 /** Props for the {@link NiceErrorBoundary} component. */

package/dist/feedback.mjs

@@ -1,5 +1,5 @@
-import { N as i, a as o, b as s, c as r, d as c, e as N, f as n, g as t, h as f, i as l, j as m, u as d } from "./NiceErrorBoundary-CFJh1FyM.js";
-import { N as C } from "./NiceModal-DjN1yXgw.js";
+import { N as i, a as o, b as s, c as r, d as c, e as N, f as n, g as t, h as f, i as l, j as m, u as d } from "./NiceErrorBoundary-B0262Ffc.js";
+import { N as C } from "./NiceModal-MeC1cNtW.js";
 export {
   i as NiceAlert,
   o as NiceConfirmDialog,