@nubisco/ui 1.53.0 → 1.53.1

package/dist/components/labs/Spreadsheet.d.ts

@@ -0,0 +1,104 @@
+/**
+ * NbSpreadsheet — labs-tier spreadsheet-style data grid.
+ *
+ * Status: experimental. API may change. Use via `app.use(NubiscoUILabs)`.
+ */
+
+export type TSpreadsheetCellType = 'text' | 'number' | 'date'
+export type TSpreadsheetAlign = 'left' | 'center' | 'right'
+export type TSpreadsheetPinCol = 'left' | 'right'
+export type TSpreadsheetPinRow = 'top' | 'bottom'
+export type TSpreadsheetSortDir = 'asc' | 'desc'
+
+export interface ISpreadsheetColumn {
+  /** Stable id used for selection, sort, and host commits. */
+  id: string
+  /** Header label. */
+  label: string
+  /** Initial pixel width. Default 120. */
+  width?: number
+  /** Minimum width when the user resizes. Default 60. */
+  minWidth?: number
+  /** Pin the column to the left or right edge of the viewport. */
+  pinned?: TSpreadsheetPinCol
+  /** Text alignment inside the cell. Defaults: number+date right, text left. */
+  align?: TSpreadsheetAlign
+  /** Cell value type — drives default formatter, parser, and input mode. */
+  type?: TSpreadsheetCellType
+  /** All cells in this column are read-only. */
+  readOnly?: boolean
+  /** Allow header-click sorting. */
+  sortable?: boolean
+  /** Host-supplied display formatter. Defaults pick a sensible string. */
+  format?: (raw: unknown, row: ISpreadsheetRow) => string
+  /** Host-supplied parser for committed edits. Defaults follow `type`. */
+  parse?: (input: string) => unknown
+}
+
+export interface ISpreadsheetRow {
+  id: string
+  /** columnId -> raw value */
+  values: Record<string, unknown>
+  /** Pinned rows stick to the top or bottom of the viewport. */
+  pinned?: TSpreadsheetPinRow
+  /** Row-wide CSS class for theming (e.g. 'weekend'). */
+  className?: string
+  /** Marks the row as a totals/computed row — disables editing. */
+  computed?: boolean
+}
+
+export interface ISpreadsheetCellAttrs {
+  readOnly?: boolean
+  className?: string
+  tooltip?: string
+  /** Override the formatted display string. */
+  display?: string
+  /** Mark a single cell as derived (read-only + style). */
+  computed?: boolean
+}
+
+export interface ISpreadsheetChange {
+  rowId: string
+  columnId: string
+  before: unknown
+  after: unknown
+}
+
+export interface ISpreadsheetSelection {
+  startRowId: string
+  startColumnId: string
+  endRowId: string
+  endColumnId: string
+}
+
+export interface ISpreadsheetProps {
+  columns: ISpreadsheetColumn[]
+  rows: ISpreadsheetRow[]
+  /** Per-cell metadata. Called lazily for visible cells. */
+  cellAttrs?: (
+    rowId: string,
+    columnId: string,
+    row: ISpreadsheetRow,
+    column: ISpreadsheetColumn,
+  ) => ISpreadsheetCellAttrs | void
+  /**
+   * Compute a derived value for a cell. Lets the host implement totals or
+   * formulas without putting raw values in `row.values`. `get` reads other
+   * cells' raw values.
+   */
+  computed?: (
+    rowId: string,
+    columnId: string,
+    get: (rowId: string, columnId: string) => unknown,
+  ) => unknown
+  /** Allow column resize. Default true. */
+  resizable?: boolean
+  /** Allow row reorder by dragging the row header. Default false. */
+  rowReorderable?: boolean
+  /** Show a row index gutter on the left. Default true. */
+  showGutter?: boolean
+  /** Approximate visible rows used for the simple virtualization. Default 80. */
+  windowRows?: number
+  /** Locale used for default Intl-based number/date formatting. */
+  locale?: string
+}

package/dist/directives/ToolTip.directive.d.ts

@@ -1,5 +1,5 @@
 import type { App } from 'vue';
-import type { IComponentContent } from '@/types/ContentRenderer';
+import type { IComponentContent } from '../types/ContentRenderer';
 export interface ITooltipOptions {
     body?: string | Array<IComponentContent>;
     header?: string | Array<IComponentContent>;

package/dist/global.d.ts

@@ -0,0 +1,135 @@
+// AUTO-GENERATED: do not edit by hand
+// Re-run the build to update this file when components change
+import AiLabel from './components/AiLabel.vue'
+import Badge from './components/Badge.vue'
+import BarChart from './components/Charts/BarChart.vue'
+import Blueprint from './components/Blueprint.vue'
+import BlueprintCard from './components/BlueprintCard.vue'
+import BlueprintControls from './components/BlueprintControls.vue'
+import BlueprintDomRenderer from './components/BlueprintDomRenderer.vue'
+import BlueprintMinimap from './components/BlueprintMinimap.vue'
+import BlueprintPixiRenderer from './components/BlueprintPixiRenderer.vue'
+import Board from './components/Board.vue'
+import BottomPanel from './components/BottomPanel.vue'
+import Breadcrumbs from './components/Breadcrumbs.vue'
+import Button from './components/Button.vue'
+import Calendar from './components/Calendar.vue'
+import Checkbox from './components/Checkbox.vue'
+import CheckboxGroup from './components/CheckboxGroup.vue'
+import ColorStrip from './components/ColorStrip.vue'
+import CommandPalette from './components/CommandPalette.vue'
+import DataTable from './components/DataTable.vue'
+import DatePicker from './components/DatePicker.vue'
+import Field from './components/Field.vue'
+import FileUploader from './components/FileUploader.vue'
+import Flag from './components/Flag.vue'
+import Form from './components/Form.vue'
+import GanttChart from './components/Charts/GanttChart.vue'
+import Grid from './components/Grid.vue'
+import Icon from './components/Icon.vue'
+import ImageCropper from './components/ImageCropper.vue'
+import InterpolationChart from './components/Charts/InterpolationChart.vue'
+import JsonTree from './components/JsonTree.vue'
+import Label from './components/Label.vue'
+import LineChart from './components/Charts/LineChart.vue'
+import Menu from './components/Menu.vue'
+import MenuBar from './components/MenuBar.vue'
+import MenuBarItem from './components/MenuBarItem.vue'
+import MenuDivider from './components/MenuDivider.vue'
+import MenuItem from './components/MenuItem.vue'
+import Message from './components/Message.vue'
+import Modal from './components/Modal.vue'
+import NumberInput from './components/NumberInput.vue'
+import Pagination from './components/Pagination.vue'
+import Panel from './components/Panel.vue'
+import PieChart from './components/Charts/PieChart.vue'
+import ProgressBar from './components/ProgressBar.vue'
+import Radio from './components/Radio.vue'
+import Select from './components/Select.vue'
+import Shell from './components/Shell.vue'
+import ShellPanel from './components/ShellPanel.vue'
+import SidebarBrand from './components/SidebarBrand.vue'
+import SidebarLink from './components/SidebarLink.vue'
+import SidebarMenu from './components/SidebarMenu.vue'
+import SidebarMenuGroup from './components/SidebarMenuGroup.vue'
+import SidebarMenuItem from './components/SidebarMenuItem.vue'
+import SidebarVariantScope from './components/SidebarVariantScope.vue'
+import Slider from './components/Slider.vue'
+import Sparkline from './components/Charts/Sparkline.vue'
+import Submenu from './components/Submenu.vue'
+import Switch from './components/Switch.vue'
+import TextInput from './components/TextInput.vue'
+import Toast from './components/Toast.vue'
+import Tree from './components/Tree.vue'
+import TreeNode from './components/TreeNode.vue'
+import UserMenu from './components/UserMenu.vue'
+
+declare module 'vue' {
+  interface IGlobalComponents {
+    NbAiLabel: typeof AiLabel
+    NbBadge: typeof Badge
+    NbBarChart: typeof BarChart
+    NbBlueprint: typeof Blueprint
+    NbBlueprintCard: typeof BlueprintCard
+    NbBlueprintControls: typeof BlueprintControls
+    NbBlueprintDomRenderer: typeof BlueprintDomRenderer
+    NbBlueprintMinimap: typeof BlueprintMinimap
+    NbBlueprintPixiRenderer: typeof BlueprintPixiRenderer
+    NbBoard: typeof Board
+    NbBottomPanel: typeof BottomPanel
+    NbBreadcrumbs: typeof Breadcrumbs
+    NbButton: typeof Button
+    NbCalendar: typeof Calendar
+    NbCheckbox: typeof Checkbox
+    NbCheckboxGroup: typeof CheckboxGroup
+    NbColorStrip: typeof ColorStrip
+    NbCommandPalette: typeof CommandPalette
+    NbDataTable: typeof DataTable
+    NbDatePicker: typeof DatePicker
+    NbField: typeof Field
+    NbFileUploader: typeof FileUploader
+    NbFlag: typeof Flag
+    NbForm: typeof Form
+    NbGanttChart: typeof GanttChart
+    NbGrid: typeof Grid
+    NbIcon: typeof Icon
+    NbImageCropper: typeof ImageCropper
+    NbInterpolationChart: typeof InterpolationChart
+    NbJsonTree: typeof JsonTree
+    NbLabel: typeof Label
+    NbLineChart: typeof LineChart
+    NbMenu: typeof Menu
+    NbMenuBar: typeof MenuBar
+    NbMenuBarItem: typeof MenuBarItem
+    NbMenuDivider: typeof MenuDivider
+    NbMenuItem: typeof MenuItem
+    NbMessage: typeof Message
+    NbModal: typeof Modal
+    NbNumberInput: typeof NumberInput
+    NbPagination: typeof Pagination
+    NbPanel: typeof Panel
+    NbPieChart: typeof PieChart
+    NbProgressBar: typeof ProgressBar
+    NbRadio: typeof Radio
+    NbSelect: typeof Select
+    NbShell: typeof Shell
+    NbShellPanel: typeof ShellPanel
+    NbSidebarBrand: typeof SidebarBrand
+    NbSidebarLink: typeof SidebarLink
+    NbSidebarMenu: typeof SidebarMenu
+    NbSidebarMenuGroup: typeof SidebarMenuGroup
+    NbSidebarMenuItem: typeof SidebarMenuItem
+    NbSidebarVariantScope: typeof SidebarVariantScope
+    NbSlider: typeof Slider
+    NbSparkline: typeof Sparkline
+    NbSubmenu: typeof Submenu
+    NbSwitch: typeof Switch
+    NbTextInput: typeof TextInput
+    NbToast: typeof Toast
+    NbTree: typeof Tree
+    NbTreeNode: typeof TreeNode
+    NbUserMenu: typeof UserMenu
+  }
+}
+
+export {}

package/dist/types/Decoration.d.ts

@@ -0,0 +1,6 @@
+interface IDecoration {
+  decorationType?: string
+  decorationProps?: Record<string, any>
+}
+
+export { IDecoration }

package/dist/types/Option.d.ts

@@ -0,0 +1,29 @@
+import { IDecoration } from './Decoration'
+
+// #region IOption
+interface IOption extends IDecoration {
+  id?: number | string
+  label?: string
+  name?: string
+  value?: string | number
+  color?: string
+  context?: string
+  i18n_key?: string
+  createdBy?: number | string
+  createdAt?: string
+  disabled?: boolean
+  tooltip?: string
+  unformatted?: boolean
+  code?: string
+  hidden?: boolean
+}
+// #endregion IOption
+
+// #region IOptionGroup
+interface IOptionGroup {
+  groupName?: string // Optional: Name of the group
+  options: IOption[]
+}
+// #endregion IOptionGroup
+
+export { IOption, IOptionGroup }

package/dist/types/Props.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Shared prop interfaces for Nubisco UI components.
+ *
+ * Hierarchy:
+ *
+ *   IDefaultProps
+ *     └── IHumanInputComponent
+ *           └── IFieldComponent  (+ IWithLabel + IWithMessages + IWithFieldAppearance)
+ *                 └── IReadableFieldComponent
+ *
+ * Compose these interfaces in component `.d.ts` files rather than redeclaring
+ * common props. This keeps definitions DRY and feeds intellisense with the
+ * JSDoc descriptions below.
+ */
+
+// #region IDefaultProps
+/** Any component that can be identified by an explicit DOM id. */
+interface IDefaultProps {
+  /**
+   * Explicit element id.
+   * When omitted, a deterministic id is auto-generated by `useStableId()` from the
+   * component type and `name` prop — e.g. `nb-text-input-email`.
+   */
+  id?: string
+}
+// #endregion IDefaultProps
+
+// #region IWithMessages
+/** Components that carry validation / feedback messages below the field. */
+interface IWithMessages {
+  /** Validation error — takes precedence over `warning` and `helper` when set. */
+  error?: string
+  /** Non-blocking caution message — shown only when `error` is absent. */
+  warning?: string
+  /** Contextual hint displayed when neither `error` nor `warning` is set. */
+  helper?: string
+}
+// #endregion IWithMessages
+
+// #region IWithLabel
+/** Components that render a user-visible label. */
+interface IWithLabel {
+  /** Label text rendered above (`default` variant) or inside (`fluid` variant) the field. */
+  label?: string
+}
+// #endregion IWithLabel
+
+// #region IWithFieldAppearance
+/** Components that support the standard field presentation variants and sizes. */
+interface IWithFieldAppearance {
+  /**
+   * Presentation variant:
+   * - `default` — label above, message below (standard style).
+   * - `fluid`   — label and status icon inside the field box.
+   */
+  variant?: 'default' | 'fluid'
+  /**
+   * Control size. `xs` is the compact size for dense surfaces (inspectors,
+   * toolbars); `md` is the baseline for standalone forms. Every value here
+   * is backed by a real style rule — an unknown size no longer falls back
+   * silently.
+   */
+  size?: 'xs' | 'sm' | 'md' | 'lg'
+}
+// #endregion IWithFieldAppearance
+
+// #region IHumanInputComponent
+/**
+ * Interactive form control that participates in form submission and can be
+ * disabled or marked as required.
+ */
+interface IHumanInputComponent extends IDefaultProps {
+  /**
+   * HTML `name` attribute forwarded to the native input.
+   * Also drives auto-generated IDs when `id` is omitted:
+   * `{component-type}-{name}` — e.g. `nb-select-country`.
+   */
+  name?: string
+  /** Prevents interaction and visually dims the control. */
+  disabled?: boolean
+  /** Marks the field as mandatory — surfaced in the label and `aria-required`. */
+  required?: boolean
+}
+// #endregion IHumanInputComponent
+
+// #region IFieldComponent
+/**
+ * Full labeled field with placeholder text, validation messages, variant and
+ * size. The baseline for text-like, number, and select inputs.
+ */
+interface IFieldComponent
+  extends
+    IHumanInputComponent,
+    IWithLabel,
+    IWithMessages,
+    IWithFieldAppearance {
+  /** Placeholder text shown when the field has no value. */
+  placeholder?: string
+}
+// #endregion IFieldComponent
+
+// #region IReadableFieldComponent
+/**
+ * Extends `IFieldComponent` with a read-only mode: the value is visible and
+ * copyable but cannot be changed by the user.
+ */
+interface IReadableFieldComponent extends IFieldComponent {
+  /** Makes the field read-only — value is visible but not editable. */
+  readonly?: boolean
+}
+// #endregion IReadableFieldComponent
+
+export {
+  IDefaultProps,
+  IWithMessages,
+  IWithLabel,
+  IWithFieldAppearance,
+  IHumanInputComponent,
+  IFieldComponent,
+  IReadableFieldComponent,
+}

package/dist/types/Size.d.ts

@@ -0,0 +1,33 @@
+// #region ESize
+// String-based size tokens (for CSS classes, spacing scales, etc.)
+export enum ESize {
+  ExtraExtraSmall = 'xxs',
+  ExtraSmall = 'xs',
+  Small = 'sm',
+  Medium = 'md',
+  Large = 'lg',
+  ExtraLarge = 'xl',
+  ExtraExtraLarge = 'xxl',
+}
+// #endregion ESize
+
+// #region ESizeShort
+export enum ESizeShort {
+  Small = 'sm',
+  Medium = 'md',
+  Large = 'lg',
+}
+// #endregion ESizeShort
+
+// #region ESizePixel
+// Numeric size values in pixels (for icons, images, components with fixed dimensions)
+export enum ESizePixel {
+  ExtraExtraSmall = 8,
+  ExtraSmall = 12,
+  Small = 14,
+  Medium = 16,
+  Large = 20,
+  ExtraLarge = 60,
+  ExtraExtraLarge = 92,
+}
+// #endregion ESizePixel

package/dist/types/Variants.d.ts

@@ -0,0 +1,12 @@
+// #region EVariant
+enum EVariant {
+  Primary = 'primary',
+  Secondary = 'secondary',
+  Ghost = 'ghost',
+  Danger = 'danger',
+  Success = 'success',
+  Warning = 'warning',
+}
+// #endregion EVariant
+
+export { EVariant }

package/dist/types/Vite.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from 'vite'
+
+export const VitePlugin = <T extends Plugin>(p: T): Plugin & T => p

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubisco/ui",
-  "version": "1.53.0",
+  "version": "1.53.1",
   "description": "Vue 3 UI component library",
   "packageManager": "pnpm@11.0.8",
   "repository": {
@@ -77,10 +77,13 @@
   "scripts": {
     "clean": "rm -rf dist",
     "prebuild": "pnpm run clean",
-    "build": "pnpm run build:lib && pnpm run build:types && pnpm run build:plugins",
+    "build": "pnpm run build:lib && pnpm run build:types && pnpm run build:plugins && pnpm run verify:types",
     "build:lib": "vite build",
-    "build:types": "vue-tsc --noEmit false --declaration --emitDeclarationOnly --outDir dist",
+    "build:types": "vue-tsc --noEmit false --declaration --emitDeclarationOnly --outDir dist && node scripts/copy-type-modules.mjs && node scripts/rewrite-dist-aliases.mjs dist",
     "build:plugins": "tsc --project tsconfig.plugins.json",
+    "verify:types": "pnpm run verify:dist-types && pnpm run verify:consumer-types",
+    "verify:dist-types": "node scripts/verify-dist-types.mjs dist",
+    "verify:consumer-types": "node scripts/verify-consumer-types.mjs",
     "dev": "vite build --watch",
     "prepublishOnly": "pnpm run build",
     "test": "vitest run",