@nubisco/ui 1.53.0 → 1.53.2

package/dist/components/ImageCropper.d.ts

@@ -0,0 +1,27 @@
+interface ICropRect {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+enum EHandleName {
+  TopLeft = 'top-left',
+  Top = 'top',
+  TopRight = 'top-right',
+  Right = 'right',
+  BottomRight = 'bottom-right',
+  Bottom = 'bottom',
+  BottomLeft = 'bottom-left',
+  Left = 'left',
+}
+
+interface IImageCropperProps {
+  image?: File
+  cropAsCircle?: boolean
+  outputAsCircle?: boolean
+  lockAspectRatio?: boolean
+  showPreview?: boolean
+}
+
+export { ICropRect, EHandleName, IImageCropperProps }

package/dist/components/JsonTree.d.ts

@@ -0,0 +1,33 @@
+// Primitive JSON values
+type TJsonPrimitive = string | number | boolean | null
+
+// Recursive JSON values
+type TJsonValue = TJsonPrimitive | IJsonObject | TJsonArray
+interface IJsonObject {
+  [key: string]: TJsonValue
+}
+type TJsonArray = TJsonValue[]
+
+// Runtime-friendly node kind enum for component consumers
+enum EJsonNodeKind {
+  Object = 'object',
+  Array = 'array',
+  Primitive = 'primitive',
+}
+
+interface IJsonTreeProps {
+  title?: string | null
+  modelValue?: TJsonValue
+  root?: boolean
+  editable?: boolean
+  startCollapsed?: boolean
+}
+
+export {
+  TJsonPrimitive,
+  TJsonValue,
+  IJsonObject,
+  TJsonArray,
+  EJsonNodeKind,
+  IJsonTreeProps,
+}

package/dist/components/Label.d.ts

@@ -0,0 +1,14 @@
+enum ELabelSize {
+  Small = 'sm',
+  Medium = 'md',
+}
+
+interface ILabelProps {
+  htmlFor?: string
+  required?: boolean
+  disabled?: boolean
+  // Visual size of the label text
+  size?: ELabelSize
+}
+
+export { ELabelSize, ILabelProps }

package/dist/components/Menu.d.ts

@@ -0,0 +1,53 @@
+export type TMenuItemSize = 'xs' | 'sm' | 'md' | 'lg'
+
+export interface IMenuProps {
+  /** Controls visibility of the menu */
+  open?: boolean
+  /** Item height: xs=24, sm=32, md=40, lg=48 */
+  size?: TMenuItemSize
+  /** Minimum width in px */
+  minWidth?: number
+  /** Maximum width in px */
+  maxWidth?: number
+}
+
+export interface IMenuItemProps {
+  /** Phosphor icon name */
+  icon?: string
+  /** Display label */
+  label: string
+  /** Keyboard shortcut display text (e.g. "Cmd+C"), display only */
+  shortcut?: string
+  /** Disables the item */
+  disabled?: boolean
+  /** Renders with danger/destructive styling */
+  danger?: boolean
+  /** Makes this a checkbox-style selectable item */
+  selectable?: boolean
+  /** Whether selectable item is checked */
+  selected?: boolean
+  /** Radio group name, makes item part of a radio group */
+  radioGroup?: string
+}
+
+export interface ISubmenuProps {
+  /** Phosphor icon name */
+  icon?: string
+  /** Display label */
+  label: string
+  /** Disables the submenu trigger */
+  disabled?: boolean
+}
+
+export interface IMenuBarProps {
+  /** Optional max-width constraint */
+  maxWidth?: string
+}
+
+export interface IMenuContext {
+  size: TMenuItemSize
+  close: () => void
+  highlightedIndex: number
+  registerItem: (el: HTMLElement) => number
+  unregisterItem: (el: HTMLElement) => void
+}

package/dist/components/Message.d.ts

@@ -0,0 +1,17 @@
+enum EMessageVariant {
+  Error = 'error',
+  Warning = 'warning',
+  Helper = 'helper',
+}
+
+interface IMessageProps {
+  variant?: `${EMessageVariant}`
+  /**
+   * Icon-only mode: hides the text and shows only an icon.
+   * On hover, the message text appears via a CSS tooltip.
+   * Used in the TextInput `fluid` variant.
+   */
+  iconOnly?: boolean
+}
+
+export { EMessageVariant, IMessageProps }

package/dist/components/Modal.d.ts

@@ -0,0 +1,10 @@
+import { ESizeShort } from '../types/Size.d'
+
+interface IModalProps {
+  open?: boolean
+  title?: string
+  size?: ESizeShort
+  closeOnOverlay?: boolean
+}
+
+export { IModalProps }

package/dist/components/Modal.vue.d.ts

@@ -1,4 +1,4 @@
-import { ESizeShort } from '@/types/Size.d';
+import { ESizeShort } from '../types/Size.d';
 import type { IModalProps } from './Modal.d';
 declare var __VLS_13: {}, __VLS_20: {}, __VLS_28: {};
 type __VLS_Slots = {} & {

package/dist/components/NumberInput.vue.d.ts

@@ -1,4 +1,4 @@
-import type { IFieldComponent } from '@/types/Props.d';
+import type { IFieldComponent } from '../types/Props.d';
 export interface INumberInputProps extends IFieldComponent {
     modelValue?: number | null;
     min?: number;

package/dist/components/Pagination.d.ts

@@ -0,0 +1,38 @@
+import type { ESizeShort } from '../types/Size.d'
+
+/**
+ * NbPagination: footer companion for `NbDataTable` (usable standalone). Fully
+ * controlled: it emits `update:page` / `update:pageSize` and renders whatever
+ * `page`, `pageSize` and `total` you pass back, so it works for server-side
+ * paging without change.
+ */
+export interface IPaginationProps {
+  /** Current 1-based page number. */
+  page: number
+  /** Rows shown per page. */
+  pageSize: number
+  /** Total number of rows across all pages. */
+  total: number
+  /** Selectable page sizes. Default `[10, 20, 30, 40, 50]`. */
+  pageSizeOptions?: number[]
+  /** Control density. Matches the shared `ESizeShort` scale. Default `md`. */
+  size?: ESizeShort | 'sm' | 'md' | 'lg'
+  /** Disables all controls. */
+  disabled?: boolean
+  /** Label before the page-size select. Default `Items per page:`. */
+  pageSizeLabel?: string
+  /** Noun used in the range read-out, e.g. `... of 240 items`. Default `items`. */
+  itemLabel?: string
+}
+
+export interface IPaginationEmits {
+  /** New 1-based page (`v-model:page`). */
+  'update:page': [page: number]
+  /** New page size (`v-model:pageSize`). Page resets to 1 alongside. */
+  'update:pageSize': [pageSize: number]
+}
+
+export type {
+  IPaginationProps as NbPaginationProps,
+  IPaginationEmits as NbPaginationEmits,
+}

package/dist/components/Pagination.vue.d.ts

@@ -1,4 +1,4 @@
-import { ESizeShort } from '@/types/Size.d';
+import { ESizeShort } from '../types/Size.d';
 import { IPaginationProps } from './Pagination.d';
 declare const __VLS_export: import("vue").DefineComponent<IPaginationProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:page": (page: number) => any;

package/dist/components/ProgressBar.d.ts

@@ -0,0 +1,27 @@
+import { IDefaultProps, IWithLabel } from '../types/Props.d'
+
+enum EProgressBarSize {
+  Small = 'sm',
+  Medium = 'md',
+}
+
+enum EProgressBarStatus {
+  Active = 'active',
+  Finished = 'finished',
+  Error = 'error',
+}
+
+interface IProgressBarProps extends IDefaultProps, IWithLabel {
+  /** Current progress against `max`. Omit for an indeterminate bar. */
+  value?: number
+  /** Upper bound the progress is measured against. */
+  max?: number
+  /** Contextual hint below the bar. Rendered in the error style when `status` is `error`. */
+  helper?: string
+  /** Track thickness: `md` is 8px, `sm` is 4px. */
+  size?: EProgressBarSize
+  /** Semantic state. `finished` and `error` fill the bar and recolor it. */
+  status?: EProgressBarStatus
+}
+
+export { EProgressBarSize, EProgressBarStatus, IProgressBarProps }

package/dist/components/Radio.d.ts

@@ -0,0 +1,28 @@
+import {
+  IHumanInputComponent,
+  IWithLabel,
+  IWithMessages,
+} from '../types/Props.d'
+
+interface IRadioOption {
+  label: string
+  value: string
+  disabled?: boolean
+}
+
+enum ERadioDirection {
+  Horizontal = 'horizontal',
+  Vertical = 'vertical',
+}
+
+interface IRadioProps extends IHumanInputComponent, IWithLabel, IWithMessages {
+  modelValue?: string
+  options: IRadioOption[]
+  /** Required for native radio-button grouping via the HTML `name` attribute. */
+  name: string
+  direction?: ERadioDirection
+  /** Makes options visible but non-interactive. */
+  readonly?: boolean
+}
+
+export { IRadioOption, ERadioDirection, IRadioProps }

package/dist/components/Select.d.ts

@@ -0,0 +1,23 @@
+import { IFieldComponent } from '../types/Props.d'
+
+interface ISelectOption {
+  label: string
+  value: string | number
+  disabled?: boolean
+}
+
+interface ISelectProps extends IFieldComponent {
+  modelValue?: string | number | Array<string | number> | null
+  options?: ISelectOption[]
+  /** Allows selecting multiple options simultaneously. */
+  multiple?: boolean
+  /** Shows a text input at the bottom of the dropdown so users can create new options. Emits `create` with the entered value. */
+  creatable?: boolean
+  /** Placeholder text for the create input when `creatable` is true. */
+  createPlaceholder?: string
+}
+
+export { ISelectOption, ISelectProps }
+
+// Clean aliases — prefer these in new code.
+export type { ISelectOption as NbSelectOption, ISelectProps as NbSelectProps }

package/dist/components/Shell.d.ts

@@ -0,0 +1,60 @@
+type TInspectorSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+type TSidebarVariant = 'compact' | 'verbose'
+
+interface IShellProps {
+  /**
+   * Whether the inspector column is visible.
+   * @default false
+   */
+  inspectorVisible?: boolean
+  /**
+   * When true the inspector takes ~50 % of the viewport width instead of the
+   * default fixed width. Has no effect when `inspectorVisible` is false.
+   * @default false
+   */
+  inspectorExpanded?: boolean
+  /**
+   * Controls the width of the inspector panel.
+   * - xs: 288px
+   * - sm: 360px
+   * - md: 560px (current default, backwards compatible)
+   * - lg: 50vw
+   * - xl: 75vw
+   * @default 'md'
+   */
+  inspectorSize?: TInspectorSize
+  /**
+   * Allow the user to resize the inspector by dragging its left edge, clamped
+   * between the `inspectorSize` width (the floor) and 50% of the viewport.
+   * Double-clicking the handle resets to the `inspectorSize` default. Pair with
+   * `v-model:inspector-width` to persist the chosen width.
+   * @default false
+   */
+  resizable?: boolean
+  /**
+   * The user-chosen inspector width in pixels when `resizable` is on, as a
+   * v-model (`v-model:inspector-width`). `null` (the default / reset state)
+   * means "use the `inspectorSize` width". The component emits
+   * `update:inspectorWidth` on drag and on double-click reset; the consumer
+   * owns persistence.
+   */
+  inspectorWidth?: number | null
+  /**
+   * Whether the main content area has padding.
+   * Set to false for full-bleed content like viewports/canvases.
+   * @default true
+   */
+  mainPadding?: boolean
+  /**
+   * Sidebar presentation mode.
+   * - 'compact': narrow icon-only rail (56px). Use with NbSidebarLink. This is
+   *   the default and matches the legacy behaviour.
+   * - 'verbose': wider sidebar (240px) with full-width rows. Use with
+   *   NbSidebarMenu, NbSidebarMenuGroup and NbSidebarMenuItem to render
+   *   grouped, multi-level navigation with icons and labels.
+   * @default 'compact'
+   */
+  sidebarVariant?: TSidebarVariant
+}
+
+export { IShellProps, TInspectorSize, TSidebarVariant }

package/dist/components/ShellPanel.d.ts

@@ -0,0 +1,33 @@
+export type TShellPanelSize = 'collapsed' | 'default' | 'full'
+
+export interface IShellPanelProps {
+  /**
+   * Current panel size. Use v-model:size for two-way binding.
+   *
+   * - collapsed: header only, no content, does not grow
+   * - default: content visible. Sizing follows the `fluid` prop —
+   *   `false` (the back-compat default) shares column space equally
+   *   with sibling panels via `flex: 1 1 0%`; `true` uses `flex: 0 0
+   *   auto` so the panel takes only the height its content needs.
+   * - full: content visible, flex: 1, sibling panels collapse automatically
+   *
+   * @default 'default'
+   */
+  size?: TShellPanelSize
+  /**
+   * Panel title shown in the header.
+   */
+  title?: string
+  /**
+   * When true, a `default`-sized panel sizes to its content instead of
+   * sharing column space equally with siblings. Right for inspectors
+   * with multiple unrelated sections — a panel with two rows shouldn't
+   * eat the same height as a panel with twenty.
+   *
+   * The `collapsed` and `full` sizes are unaffected (collapsed is
+   * always header-only; full always fills).
+   *
+   * @default false
+   */
+  fluid?: boolean
+}

package/dist/components/SidebarBrand.d.ts

@@ -0,0 +1,14 @@
+interface ISidebarBrandProps {
+  /** Primary brand name (top line, prominent). */
+  title: string
+  /** Optional secondary line below the title (smaller, muted). */
+  subtitle?: string
+  /**
+   * Optional icon rendered to the left of the title. Uses NbIcon when provided
+   * as a string; for fully custom marks (logo, gradient block) use the
+   * `icon` slot instead.
+   */
+  icon?: string
+}
+
+export { ISidebarBrandProps }

package/dist/components/SidebarLink.d.ts

@@ -0,0 +1,24 @@
+interface ISidebarLinkProps {
+  /**
+   * Target route. When vue-router is installed, the link renders as a
+   * `<RouterLink>` and accepts any value valid for its `to` prop (string path or
+   * location object). Without vue-router, a string `to` falls back to a plain
+   * `<a>` and an object `to` falls back to a `<button>` that emits `click`.
+   */
+  to?: string | Record<string, unknown>
+  /** External href — renders as a plain `<a>`. Used when `to` is not set. */
+  href?: string
+  /** Tooltip text shown to the right of the sidebar on hover. */
+  tooltip?: string
+  /** Marks the link as the currently active route. */
+  active?: boolean
+  /** Prevents interaction. */
+  disabled?: boolean
+  /**
+   * Applies a danger (red) hover style — use for destructive actions like
+   * sign-out.
+   */
+  danger?: boolean
+}
+
+export { ISidebarLinkProps }

package/dist/components/SidebarMenu.d.ts

@@ -0,0 +1,10 @@
+interface ISidebarMenuProps {
+  /**
+   * Visual density of menu rows.
+   * - 'comfortable' (default): generous vertical padding
+   * - 'compact': tighter rows for navigation-heavy apps
+   */
+  density?: 'comfortable' | 'compact'
+}
+
+export { ISidebarMenuProps }

package/dist/components/SidebarMenuGroup.d.ts

@@ -0,0 +1,16 @@
+interface ISidebarMenuGroupProps {
+  /** Section heading displayed above the items. */
+  label: string
+  /**
+   * When true, the group can be collapsed by clicking its heading.
+   * @default false
+   */
+  collapsible?: boolean
+  /**
+   * Initial collapsed state when `collapsible` is true. Ignored otherwise.
+   * @default false
+   */
+  defaultCollapsed?: boolean
+}
+
+export { ISidebarMenuGroupProps }

package/dist/components/SidebarMenuItem.d.ts

@@ -0,0 +1,42 @@
+interface ISidebarMenuItemProps {
+  /** Visible row label. */
+  label: string
+  /**
+   * Optional icon name (uses NbIcon). Recommended for top-level items in
+   * verbose sidebars; child items typically omit it.
+   */
+  icon?: string
+  /**
+   * Target route. When vue-router is installed (the app called
+   * `app.use(router)`), the row renders as a `<RouterLink>` and accepts any
+   * value valid for its `to` prop (a string path or a location object). When
+   * vue-router is not present, a string `to` falls back to a plain anchor
+   * (`href`) and an object `to` falls back to a button that emits `click`.
+   * Ignored for items that have sub-items (those toggle/expand instead).
+   */
+  to?: string | Record<string, unknown>
+  /** External href, used when `to` is not set. Always renders a plain anchor. */
+  href?: string
+  /** Marks the row as the currently active route. */
+  active?: boolean
+  /** Prevents interaction. */
+  disabled?: boolean
+  /**
+   * Initial expanded state when the item has sub-items. Ignored when there
+   * are no children.
+   * @default false
+   */
+  defaultExpanded?: boolean
+  /** Small badge text displayed on the right (counts, status). */
+  badge?: string | number
+  /**
+   * Visual variant of the badge.
+   * - 'neutral' (default): muted, blends with sidebar
+   * - 'accent': uses the sidebar active colour, ideal for feature flags
+   *   like "AI", "BETA", "NEW"
+   * - 'success' | 'warning' | 'danger': semantic colours
+   */
+  badgeVariant?: 'neutral' | 'accent' | 'success' | 'warning' | 'danger'
+}
+
+export { ISidebarMenuItemProps }

package/dist/components/Slider.d.ts

@@ -0,0 +1,26 @@
+import {
+  IHumanInputComponent,
+  IWithLabel,
+  IWithMessages,
+  IWithFieldAppearance,
+} from '../types/Props.d'
+
+interface ISliderProps
+  extends
+    IHumanInputComponent,
+    IWithLabel,
+    IWithMessages,
+    IWithFieldAppearance {
+  modelValue?: number | [number, number] | null
+  min?: number
+  max?: number
+  step?: number
+  /** Enables a two-handle range selector instead of a single-value slider. */
+  range?: boolean
+  /** Shows a `NbNumberInput` alongside the track for direct value entry. */
+  showInput?: boolean
+}
+
+type TActiveHandle = 'low' | 'high' | null
+
+export { ISliderProps, TActiveHandle }

package/dist/components/Switch.d.ts

@@ -0,0 +1,20 @@
+import { IHumanInputComponent, IWithLabel } from '../types/Props.d'
+
+enum ESwitchSize {
+  Small = 'sm',
+  Medium = 'md',
+  Large = 'lg',
+}
+
+enum ESwitchVariant {
+  Primary = 'primary',
+  Secondary = 'secondary',
+}
+
+interface ISwitchProps extends IHumanInputComponent, IWithLabel {
+  modelValue?: boolean
+  variant?: ESwitchVariant
+  size?: ESwitchSize
+}
+
+export { ESwitchSize, ESwitchVariant, ISwitchProps }

package/dist/components/TextInput.vue.d.ts

@@ -1,4 +1,4 @@
-import type { IReadableFieldComponent } from '@/types/Props.d';
+import type { IReadableFieldComponent } from '../types/Props.d';
 export interface ITextInputProps extends IReadableFieldComponent {
     /** Native input type forwarded to the `<input>` element. */
     type?: string;

package/dist/components/Tree.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Tree component types.
+ *
+ * Carbon Design System-inspired tree view with layer system integration.
+ */
+
+export type TTreeDropPosition = 'before' | 'after' | 'inside'
+
+export interface ITreeDropEvent {
+  /** ID of the node being dragged */
+  sourceId: string
+  /** ID of the node being dropped onto */
+  targetId: string
+  /** Where relative to the target the drop occurred */
+  position: TTreeDropPosition
+}
+
+export interface ITreeProps {
+  /** Currently selected node ID (v-model) */
+  modelValue?: string | null
+  /** Compact mode: 24px rows instead of 32px */
+  compact?: boolean
+  /** Size variant */
+  size?: 'sm' | 'md'
+  /** Enable drag and drop reordering */
+  draggable?: boolean
+}
+
+export interface ITreeNodeProps {
+  /** Unique node identifier */
+  id: string
+  /** Display label */
+  label: string
+  /** Icon name (from NbIcon) */
+  icon?: string
+  /** Whether the node is disabled */
+  disabled?: boolean
+  /** Depth level (auto-computed from nesting, override to set manually) */
+  depth?: number | null
+  /** Override tree-level draggable for this node (opt-in or opt-out) */
+  draggable?: boolean | null
+}
+
+export interface ITreeDragState {
+  /** ID of the node currently being dragged, or null */
+  dragId: string | null
+  /** ID of the current drop target node, or null */
+  dropTargetId: string | null
+  /** Drop position relative to the target */
+  dropPosition: TTreeDropPosition | null
+}
+
+export interface ITreeContext {
+  selectedId: string | null
+  select: (id: string) => void
+  toggle: (id: string) => void
+  expandedIds: Set<string>
+  compact: boolean
+  draggable: boolean
+  drag: ITreeDragState
+  onDragStart: (id: string) => void
+  onDragOver: (id: string, position: TTreeDropPosition) => void
+  onDragLeave: (id: string) => void
+  onDrop: () => void
+  onDragEnd: () => void
+  registerNode: (id: string, el: HTMLElement) => void
+  unregisterNode: (id: string) => void
+}

package/dist/components/TreeNode.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TreeNode.vue.d.ts","sourceRoot":"","sources":["../../src/components/TreeNode.vue"],"names":[],"mappings":"AAmcA,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAA;AAsU/E,QAAA,IAAI,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAY,CAAE;AACpE,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC3C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAKhD,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"TreeNode.vue.d.ts","sourceRoot":"","sources":["../../src/components/TreeNode.vue"],"names":[],"mappings":"AAocA,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,UAAU,CAAA;AAsU/E,QAAA,IAAI,QAAQ,IAAW,EAAE,QAAQ,IAAW,EAAE,QAAQ,IAAY,CAAE;AACpE,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC3C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,GAC7C;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAKhD,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}