@ziyarago/ui 0.13.0 → 0.15.0

package/src/react/index.js

@@ -2,7 +2,7 @@
 // React 18+ adapter. Usage: import { UiButton, UiAppShell } from '@ziyarago/ui/react'
 import React, { useState, useRef, useEffect, useLayoutEffect, useSyncExternalStore, createElement, cloneElement, isValidElement } from 'react';
 import { createPortal } from 'react-dom';
-import { components, subscribeUiLocale, getUiVersion } from '../core/index.js';
+import { components, registerComponents, subscribeUiLocale, getUiVersion } from '../core/index.js';
 
 const C = {};
 const useIsoLayoutEffect = typeof document === 'undefined' ? useEffect : useLayoutEffect;
@@ -37,6 +37,13 @@ const wrap = (name, def) => {
   return Comp;
 };
 for (const [name, def] of Object.entries(components)) C[name] = wrap(name, def);
+/** Wraps definitions like the built-in ones, registers them in C (cross references work both ways) and returns { UiName: Component }. */
+export function defineUiComponents(defs, { override = false } = {}) {
+  registerComponents(defs, { override });
+  const out = {};
+  for (const [name, def] of Object.entries(defs)) out['Ui' + name] = C[name] = wrap(name, def);
+  return out;
+}
 
 // Explicit named exports (not destructuring): Next.js reads the export names of a 'use client' module statically.
 export const UiButton = C.Button;
@@ -51,7 +58,6 @@ export const UiFilterChips = C.FilterChips;
 export const UiTextField = C.TextField;
 export const UiSelect = C.Select;
 export const UiCodeInput = C.CodeInput;
-export const UiStepper = C.Stepper;
 export const UiCard = C.Card;
 export const UiModal = C.Modal;
 export const UiDrawer = C.Drawer;
@@ -62,21 +68,12 @@ export const UiProgress = C.Progress;
 export const UiRing = C.Ring;
 export const UiKpiTile = C.KpiTile;
 export const UiDataTable = C.DataTable;
-export const UiKanbanColumn = C.KanbanColumn;
-export const UiKanbanCard = C.KanbanCard;
 export const UiTimeline = C.Timeline;
 export const UiTopNav = C.TopNav;
 export const UiSideNav = C.SideNav;
 export const UiAppShell = C.AppShell;
 export const UiPageHeader = C.PageHeader;
 export const UiAuthLayout = C.AuthLayout;
-export const UiLeadCard = C.LeadCard;
-export const UiHotelCard = C.HotelCard;
-export const UiTourCard = C.TourCard;
-export const UiPrayerTimes = C.PrayerTimes;
-export const UiRamadanTracker = C.RamadanTracker;
-export const UiQiblaCompass = C.QiblaCompass;
-export const UiCallRow = C.CallRow;
 export const UiAlert = C.Alert;
 export const UiBanner = C.Banner;
 export const UiAccordion = C.Accordion;
@@ -89,24 +86,14 @@ export const UiDataState = C.DataState;
 export const UiLoadingOverlay = C.LoadingOverlay;
 export const UiConfirmDialog = C.ConfirmDialog;
 export const UiPopconfirm = C.Popconfirm;
-export const UiCarousel = C.Carousel;
-export const UiGallery = C.Gallery;
 export const UiCode = C.Code;
-export const UiPricingCard = C.PricingCard;
-export const UiIntegrationCard = C.IntegrationCard;
-export const UiIncomingCall = C.IncomingCall;
-export const UiCallCard = C.CallCard;
 export const UiDropdown = C.Dropdown;
 export const UiMenu = C.Menu;
 export const UiTooltip = C.Tooltip;
-export const UiHoverCard = C.HoverCard;
 export const UiPopover = C.Popover;
 export const UiCopyButton = C.CopyButton;
-export const UiCommandBar = C.CommandBar;
 export const UiCommandPalette = C.CommandPalette;
-export const UiNotificationBell = C.NotificationBell;
 export const UiToggleGroup = C.ToggleGroup;
-export const UiFab = C.Fab;
 export const UiTextarea = C.Textarea;
 export const UiNumberInput = C.NumberInput;
 export const UiPasswordInput = C.PasswordInput;
@@ -114,123 +101,41 @@ export const UiSearchInput = C.SearchInput;
 export const UiRadioGroup = C.RadioGroup;
 export const UiSlider = C.Slider;
 export const UiRating = C.Rating;
-export const UiChipInput = C.ChipInput;
-export const UiInlineEdit = C.InlineEdit;
-export const UiColorPicker = C.ColorPicker;
 export const UiFileUpload = C.FileUpload;
 export const UiCombobox = C.Combobox;
 export const UiMultiSelect = C.MultiSelect;
-export const UiGroupedSelect = C.GroupedSelect;
 export const UiPhoneInput = C.PhoneInput;
 export const UiCalendar = C.Calendar;
 export const UiDatePicker = C.DatePicker;
 export const UiTimePicker = C.TimePicker;
 export const UiFormField = C.FormField;
 export const UiLoginForm = C.LoginForm;
-export const UiStepForm = C.StepForm;
 export const UiTag = C.Tag;
 export const UiKbd = C.Kbd;
 export const UiStatsCard = C.StatsCard;
-export const UiKpiInline = C.KpiInline;
 export const UiMiniChart = C.MiniChart;
 export const UiDescriptions = C.Descriptions;
 export const UiLazyImage = C.LazyImage;
-export const UiSystemStatus = C.SystemStatus;
-export const UiTreeView = C.TreeView;
-export const UiCalendarView = C.CalendarView;
 export const UiSubNav = C.SubNav;
-export const UiActionRail = C.ActionRail;
 export const UiSplitLayout = C.SplitLayout;
 export const UiSettingsSection = C.SettingsSection;
 export const UiScrollArea = C.ScrollArea;
-export const UiDealCard = C.DealCard;
-export const UiPipelineBoard = C.PipelineBoard;
-export const UiContactPanel = C.ContactPanel;
-export const UiSalesFunnel = C.SalesFunnel;
-export const UiBookingCard = C.BookingCard;
-export const UiGuestCard = C.GuestCard;
-export const UiRoomGrid = C.RoomGrid;
-export const UiRoomCalendar = C.RoomCalendar;
-export const UiOccupancyChart = C.OccupancyChart;
 export const UiChip = C.Chip;
 export const UiIconTile = C.IconTile;
 export const UiStatusIcon = C.StatusIcon;
-export const UiUserCell = C.UserCell;
-export const UiStatRow = C.StatRow;
-export const UiCountryRow = C.CountryRow;
-export const UiStatLine = C.StatLine;
-export const UiStatStrip = C.StatStrip;
-export const UiVersusBar = C.VersusBar;
-export const UiSegBar = C.SegBar;
-export const UiHeroBanner = C.HeroBanner;
-export const UiTabTiles = C.TabTiles;
 export const UiPillTabs = C.PillTabs;
-export const UiPillSelect = C.PillSelect;
-export const UiChartCard = C.ChartCard;
-export const UiActionCard = C.ActionCard;
 export const UiSnackbar = C.Snackbar;
-export const UiTourPopover = C.TourPopover;
-export const UiProfileHeader = C.ProfileHeader;
 export const UiAuthSplit = C.AuthSplit;
-export const UiAuthShowcase = C.AuthShowcase;
 export const UiSocialAuth = C.SocialAuth;
 export const UiStatusPage = C.StatusPage;
-export const UiValidatedField = C.ValidatedField;
 export const UiFooter = C.Footer;
-export const UiDataGroup = C.DataGroup;
-export const UiOptionCard = C.OptionCard;
-export const UiOptionCards = C.OptionCards;
-export const UiRichEditor = C.RichEditor;
-export const UiRangeSlider = C.RangeSlider;
-export const UiRangeCalendar = C.RangeCalendar;
-export const UiStepDialog = C.StepDialog;
-export const UiFullscreenDialog = C.FullscreenDialog;
 export const UiPageDashboard = C.PageDashboard;
-export const UiPagePatterns = C.PagePatterns;
-export const UiPageCrm = C.PageCrm;
-export const UiPageBookings = C.PageBookings;
-export const UiPageCatalog = C.PageCatalog;
-export const UiPageDetail = C.PageDetail;
 export const UiPageSettings = C.PageSettings;
 export const UiPageUserList = C.PageUserList;
-export const UiPageProfile = C.PageProfile;
-export const UiPageForm = C.PageForm;
-export const UiPageOrder = C.PageOrder;
-export const UiPageAccount = C.PageAccount;
 export const UiPagePricing = C.PagePricing;
-export const UiPageFaq = C.PageFaq;
-export const UiPageAnalytics = C.PageAnalytics;
-export const UiPageCalendar = C.PageCalendar;
-export const UiPageKanban = C.PageKanban;
-export const UiPageBilling = C.PageBilling;
-export const UiPageTeam = C.PageTeam;
-export const UiPageIntegrations = C.PageIntegrations;
-export const UiPageSearch = C.PageSearch;
-export const UiPageArticle = C.PageArticle;
-export const UiPageChangelog = C.PageChangelog;
-export const UiPageHelp = C.PageHelp;
-export const UiPageStates = C.PageStates;
-export const UiPageLegal = C.PageLegal;
-export const UiPageLocations = C.PageLocations;
-export const UiPageBookingFlow = C.PageBookingFlow;
-export const UiPageItinerary = C.PageItinerary;
-export const UiPagePrayer = C.PagePrayer;
-export const UiPageGroupManager = C.PageGroupManager;
-export const UiPageTourPublic = C.PageTourPublic;
-export const UiPageNotifications = C.PageNotifications;
-export const UiPageInbox = C.PageInbox;
-export const UiPageCheckout = C.PageCheckout;
-export const UiPageOnboarding = C.PageOnboarding;
-export const UiPageLanding = C.PageLanding;
 export const UiPageAuth = C.PageAuth;
 export const UiPageStatus = C.PageStatus;
-export const UiTreeSelect = C.TreeSelect;
 export const UiContextMenu = C.ContextMenu;
-export const UiSortable = C.Sortable;
-export const UiMap = C.Map;
-export const UiImageUpload = C.ImageUpload;
-export const UiScreensaver = C.Screensaver;
-export const UiTour = C.Tour;
 export const UiHeading = C.Heading;
 export const UiText = C.Text;
 export const UiBox = C.Box;
@@ -242,10 +147,6 @@ export const UiLink = C.Link;
 export const UiPressable = C.Pressable;
 export const UiIcon = C.Icon;
 export const UiPortal = C.Portal;
-export const UiLiquidGlass = C.LiquidGlass;
 export const UiBottomSheet = C.BottomSheet;
-export const UiActionsheet = C.Actionsheet;
-export const UiImageViewer = C.ImageViewer;
-export const UiChatAi = C.ChatAi;
 export { fmt, setIconBase, rules, LOCALES, setUiLocale, getUiLocale, setUiMessages, isRtlLocale } from '../core/index.js';
 export { useUiTheme } from '../theme.js';

package/src/resolver.js

@@ -3,20 +3,31 @@
 //   import { ZiyaragoUiResolver } from '@ziyarago/ui/resolver'
 //   Components({ resolvers: [ZiyaragoUiResolver()] })
 // Zero dependencies: it only maps <UiButton> to { name: 'UiButton', from: '@ziyarago/ui/vue' }.
+import { createRequire } from 'node:module';
 import { components } from './core/index.js';
 
 const NAMES = new Set(Object.keys(components));
 
+// Plugin packages (see docs-private/PRO-SPLIT.md, "Plugin contract") export ./names (JSON array of component names without the Ui prefix) and ./vue.
+// A plugin may be a package name or { from, names } for tests and custom setups.
+const loadPlugin = p => {
+  if (typeof p !== 'string') return { from: p.from, names: new Set(p.names) };
+  const req = createRequire(process.cwd() + '/');
+  return { from: p + '/vue', names: new Set(req(p + '/names')) };
+};
+
 /**
- * @param {{ prefix?: string, css?: boolean | string, exclude?: string[], from?: string }} [options]
+ * @param {{ prefix?: string, css?: boolean | string, exclude?: string[], from?: string, plugins?: Array<string | { from: string, names: string[] }> }} [options]
  *   prefix  component prefix, default 'Ui' (must match the registered names, which are always Ui*)
  *   css     true: import '@ziyarago/ui/style.css' as a side effect together with the first resolved component (once per module that uses one);
  *           a string: import that path instead (for example your own entry that imports the css inside a Tailwind @layer). Default false.
  *   exclude component names (without prefix) that must not be auto-imported, e.g. ['Button'] if you keep your own UiButton.
  *   from    module the components are imported from, default '@ziyarago/ui/vue'
+ *   plugins add-on packages whose components auto-import too: ['@ziyarago/ui-pro'] (needs its ./names and ./vue exports) or [{ from, names }]
  */
 export function ZiyaragoUiResolver(options = {}) {
-  const { prefix = 'Ui', css = false, exclude = [], from = '@ziyarago/ui/vue' } = options;
+  const { prefix = 'Ui', css = false, exclude = [], from = '@ziyarago/ui/vue', plugins = [] } = options;
+  const loaded = plugins.map(loadPlugin);
   const skip = new Set(exclude.map(n => n.replace(/^Ui/, '')));
   const sideEffects = css ? (css === true ? '@ziyarago/ui/style.css' : css) : undefined;
   return {
@@ -24,8 +35,10 @@ export function ZiyaragoUiResolver(options = {}) {
     resolve(name) {
       if (!name.startsWith(prefix)) return;
       const bare = name.slice(prefix.length);
-      if (!NAMES.has(bare) || skip.has(bare)) return;
-      return { name: 'Ui' + bare, from, ...(sideEffects ? { sideEffects } : {}) };
+      if (skip.has(bare)) return;
+      const pl = NAMES.has(bare) ? null : loaded.find(x => x.names.has(bare));
+      if (!pl && !NAMES.has(bare)) return;
+      return { name: 'Ui' + bare, from: pl ? pl.from : from, ...(sideEffects ? { sideEffects } : {}) };
     },
   };
 }

package/src/vue/index.js

@@ -1,6 +1,6 @@
 // Vue 3 adapter. Usage: import { UiButton, UiAppShell } from '@ziyarago/ui/vue'
 import { h, ref, reactive, defineComponent, onMounted, onBeforeUnmount, Teleport, cloneVNode, isVNode } from 'vue';
-import { components, subscribeUiLocale } from '../core/index.js';
+import { components, registerComponents, subscribeUiLocale } from '../core/index.js';
 import { BOOL_PROPS } from '../core/bools.js';
 
 const C = {};
@@ -28,8 +28,15 @@ const wrap = (name, def) => defineComponent({
   },
 });
 for (const [name, def] of Object.entries(components)) C[name] = wrap(name, def);
+/** Wraps definitions like the built-in ones, registers them in C (cross references work both ways) and returns { UiName: Component }. */
+export function defineUiComponents(defs, { override = false } = {}) {
+  registerComponents(defs, { override });
+  const out = {};
+  for (const [name, def] of Object.entries(defs)) out['Ui' + name] = C[name] = wrap(name, def);
+  return out;
+}
 
-export const { Button: UiButton, IconButton: UiIconButton, Badge: UiBadge, Avatar: UiAvatar, Switch: UiSwitch, Checkbox: UiCheckbox, SegmentedControl: UiSegmentedControl, Tabs: UiTabs, FilterChips: UiFilterChips, TextField: UiTextField, Select: UiSelect, CodeInput: UiCodeInput, Stepper: UiStepper, Card: UiCard, Modal: UiModal, Drawer: UiDrawer, Toast: UiToast, Breadcrumbs: UiBreadcrumbs, Pagination: UiPagination, Progress: UiProgress, Ring: UiRing, KpiTile: UiKpiTile, DataTable: UiDataTable, KanbanColumn: UiKanbanColumn, KanbanCard: UiKanbanCard, Timeline: UiTimeline, TopNav: UiTopNav, SideNav: UiSideNav, AppShell: UiAppShell, PageHeader: UiPageHeader, AuthLayout: UiAuthLayout, LeadCard: UiLeadCard, HotelCard: UiHotelCard, TourCard: UiTourCard, PrayerTimes: UiPrayerTimes, RamadanTracker: UiRamadanTracker, QiblaCompass: UiQiblaCompass, CallRow: UiCallRow, Alert: UiAlert, Banner: UiBanner, Accordion: UiAccordion, Skeleton: UiSkeleton, Spinner: UiSpinner, Divider: UiDivider, EmptyState: UiEmptyState, ErrorPage: UiErrorPage, DataState: UiDataState, LoadingOverlay: UiLoadingOverlay, ConfirmDialog: UiConfirmDialog, Popconfirm: UiPopconfirm, Carousel: UiCarousel, Gallery: UiGallery, Code: UiCode, PricingCard: UiPricingCard, IntegrationCard: UiIntegrationCard, IncomingCall: UiIncomingCall, CallCard: UiCallCard, Dropdown: UiDropdown, Menu: UiMenu, Tooltip: UiTooltip, HoverCard: UiHoverCard, Popover: UiPopover, CopyButton: UiCopyButton, CommandBar: UiCommandBar, CommandPalette: UiCommandPalette, NotificationBell: UiNotificationBell, ToggleGroup: UiToggleGroup, Fab: UiFab, Textarea: UiTextarea, NumberInput: UiNumberInput, PasswordInput: UiPasswordInput, SearchInput: UiSearchInput, RadioGroup: UiRadioGroup, Slider: UiSlider, Rating: UiRating, ChipInput: UiChipInput, InlineEdit: UiInlineEdit, ColorPicker: UiColorPicker, FileUpload: UiFileUpload, Combobox: UiCombobox, MultiSelect: UiMultiSelect, GroupedSelect: UiGroupedSelect, PhoneInput: UiPhoneInput, Calendar: UiCalendar, DatePicker: UiDatePicker, TimePicker: UiTimePicker, FormField: UiFormField, LoginForm: UiLoginForm, StepForm: UiStepForm, Tag: UiTag, Kbd: UiKbd, StatsCard: UiStatsCard, KpiInline: UiKpiInline, MiniChart: UiMiniChart, Descriptions: UiDescriptions, LazyImage: UiLazyImage, SystemStatus: UiSystemStatus, TreeView: UiTreeView, CalendarView: UiCalendarView, SubNav: UiSubNav, ActionRail: UiActionRail, SplitLayout: UiSplitLayout, SettingsSection: UiSettingsSection, ScrollArea: UiScrollArea, DealCard: UiDealCard, PipelineBoard: UiPipelineBoard, ContactPanel: UiContactPanel, SalesFunnel: UiSalesFunnel, BookingCard: UiBookingCard, GuestCard: UiGuestCard, RoomGrid: UiRoomGrid, RoomCalendar: UiRoomCalendar, OccupancyChart: UiOccupancyChart, Chip: UiChip, IconTile: UiIconTile, StatusIcon: UiStatusIcon, UserCell: UiUserCell, StatRow: UiStatRow, CountryRow: UiCountryRow, StatLine: UiStatLine, StatStrip: UiStatStrip, VersusBar: UiVersusBar, SegBar: UiSegBar, HeroBanner: UiHeroBanner, TabTiles: UiTabTiles, PillTabs: UiPillTabs, PillSelect: UiPillSelect, ChartCard: UiChartCard, ActionCard: UiActionCard, Snackbar: UiSnackbar, TourPopover: UiTourPopover, ProfileHeader: UiProfileHeader, AuthSplit: UiAuthSplit, AuthShowcase: UiAuthShowcase, SocialAuth: UiSocialAuth, StatusPage: UiStatusPage, ValidatedField: UiValidatedField, Footer: UiFooter, DataGroup: UiDataGroup, OptionCard: UiOptionCard, OptionCards: UiOptionCards, RichEditor: UiRichEditor, RangeSlider: UiRangeSlider, RangeCalendar: UiRangeCalendar, StepDialog: UiStepDialog, FullscreenDialog: UiFullscreenDialog, PageDashboard: UiPageDashboard, PagePatterns: UiPagePatterns, PageCrm: UiPageCrm, PageBookings: UiPageBookings, PageCatalog: UiPageCatalog, PageDetail: UiPageDetail, PageSettings: UiPageSettings, PageUserList: UiPageUserList, PageProfile: UiPageProfile, PageForm: UiPageForm, PageOrder: UiPageOrder, PageAccount: UiPageAccount, PagePricing: UiPagePricing, PageFaq: UiPageFaq, PageAnalytics: UiPageAnalytics, PageCalendar: UiPageCalendar, PageKanban: UiPageKanban, PageBilling: UiPageBilling, PageTeam: UiPageTeam, PageIntegrations: UiPageIntegrations, PageSearch: UiPageSearch, PageArticle: UiPageArticle, PageChangelog: UiPageChangelog, PageHelp: UiPageHelp, PageStates: UiPageStates, PageLegal: UiPageLegal, PageLocations: UiPageLocations, PageBookingFlow: UiPageBookingFlow, PageItinerary: UiPageItinerary, PagePrayer: UiPagePrayer, PageGroupManager: UiPageGroupManager, PageTourPublic: UiPageTourPublic, PageNotifications: UiPageNotifications, PageInbox: UiPageInbox, PageCheckout: UiPageCheckout, PageOnboarding: UiPageOnboarding, PageLanding: UiPageLanding, PageAuth: UiPageAuth, PageStatus: UiPageStatus, TreeSelect: UiTreeSelect, ContextMenu: UiContextMenu, Sortable: UiSortable, Map: UiMap, ImageUpload: UiImageUpload, Screensaver: UiScreensaver, Tour: UiTour, Heading: UiHeading, Text: UiText, Box: UiBox, Center: UiCenter, HStack: UiHStack, VStack: UiVStack, Grid: UiGrid, Link: UiLink, Pressable: UiPressable, Icon: UiIcon, Portal: UiPortal, LiquidGlass: UiLiquidGlass, BottomSheet: UiBottomSheet, Actionsheet: UiActionsheet, ImageViewer: UiImageViewer, ChatAi: UiChatAi } = C;
+export const { Button: UiButton, IconButton: UiIconButton, Badge: UiBadge, Avatar: UiAvatar, Switch: UiSwitch, Checkbox: UiCheckbox, SegmentedControl: UiSegmentedControl, Tabs: UiTabs, FilterChips: UiFilterChips, TextField: UiTextField, Select: UiSelect, CodeInput: UiCodeInput, Card: UiCard, Modal: UiModal, Drawer: UiDrawer, Toast: UiToast, Breadcrumbs: UiBreadcrumbs, Pagination: UiPagination, Progress: UiProgress, Ring: UiRing, KpiTile: UiKpiTile, DataTable: UiDataTable, Timeline: UiTimeline, TopNav: UiTopNav, SideNav: UiSideNav, AppShell: UiAppShell, PageHeader: UiPageHeader, AuthLayout: UiAuthLayout, Alert: UiAlert, Banner: UiBanner, Accordion: UiAccordion, Skeleton: UiSkeleton, Spinner: UiSpinner, Divider: UiDivider, EmptyState: UiEmptyState, ErrorPage: UiErrorPage, DataState: UiDataState, LoadingOverlay: UiLoadingOverlay, ConfirmDialog: UiConfirmDialog, Popconfirm: UiPopconfirm, Code: UiCode, Dropdown: UiDropdown, Menu: UiMenu, Tooltip: UiTooltip, Popover: UiPopover, CopyButton: UiCopyButton, CommandPalette: UiCommandPalette, ToggleGroup: UiToggleGroup, Textarea: UiTextarea, NumberInput: UiNumberInput, PasswordInput: UiPasswordInput, SearchInput: UiSearchInput, RadioGroup: UiRadioGroup, Slider: UiSlider, Rating: UiRating, FileUpload: UiFileUpload, Combobox: UiCombobox, MultiSelect: UiMultiSelect, PhoneInput: UiPhoneInput, Calendar: UiCalendar, DatePicker: UiDatePicker, TimePicker: UiTimePicker, FormField: UiFormField, LoginForm: UiLoginForm, Tag: UiTag, Kbd: UiKbd, StatsCard: UiStatsCard, MiniChart: UiMiniChart, Descriptions: UiDescriptions, LazyImage: UiLazyImage, SubNav: UiSubNav, SplitLayout: UiSplitLayout, SettingsSection: UiSettingsSection, ScrollArea: UiScrollArea, Chip: UiChip, IconTile: UiIconTile, StatusIcon: UiStatusIcon, PillTabs: UiPillTabs, Snackbar: UiSnackbar, AuthSplit: UiAuthSplit, SocialAuth: UiSocialAuth, StatusPage: UiStatusPage, Footer: UiFooter, PageDashboard: UiPageDashboard, PageSettings: UiPageSettings, PageUserList: UiPageUserList, PagePricing: UiPagePricing, PageAuth: UiPageAuth, PageStatus: UiPageStatus, ContextMenu: UiContextMenu, Heading: UiHeading, Text: UiText, Box: UiBox, Center: UiCenter, HStack: UiHStack, VStack: UiVStack, Grid: UiGrid, Link: UiLink, Pressable: UiPressable, Icon: UiIcon, Portal: UiPortal, BottomSheet: UiBottomSheet } = C;
 export const install = app => { for (const [n, c] of Object.entries(C)) app.component('Ui' + n, c); };
 export { fmt, setIconBase, rules } from '../core/index.js';
 export { useUiTheme } from '../theme.js';

package/types/core.d.ts

@@ -1,4 +1,7 @@
 // Core (framework-neutral) entry. Most apps import from '@ziyarago/ui/vue' or '@ziyarago/ui/react' instead.
 export { rules, setIconBase, fmt } from './shared';
 export type * from './shared';
+export interface ComponentDefinition { state?: Record<string, unknown>; slots?: string[]; render: (ctx: any) => unknown }
+/** Extension API for add-on packages: adds definitions to the shared registry. Throws on a name clash with a different definition unless { override: true }. */
+export function registerComponents(defs: Record<string, ComponentDefinition>, options?: { override?: boolean }): Record<string, ComponentDefinition>;
 export const components: Record<string, { state?: Record<string, unknown>; slots?: string[]; render: (ctx: any) => unknown }>;

package/types/internal.d.ts

@@ -0,0 +1,30 @@
+// Semi-internal helpers for add-on packages such as @ziyarago/ui-pro. Not a public API: may change in any minor release.
+export const cx: (...a: unknown[]) => string;
+export const pick: (props: Record<string, any>, keys: string[]) => Record<string, any>;
+export const INPUT_ATTRS: string[];
+export const DZ: Record<string, number>;
+export const dzp: (props: any, base: number) => number;
+export const dzf: (n: number) => string;
+export const dzb: (props: any) => string;
+export const ddRef: (close: () => void, options?: Record<string, any>) => (el: any) => void;
+export const icon: (h: any, name: string, size?: number) => any;
+export const fmt: Record<string, (...args: any[]) => string>;
+export const trap: (options?: Record<string, any>) => (el: any) => void;
+export const life: (options?: Record<string, any>) => (el: any) => void;
+export const rove: (selector: string, options?: Record<string, any>) => (e: any) => void;
+export const tabIdx: (items: any[], isOn: (item: any) => boolean) => (i: number) => 0 | -1;
+export const listKeys: (selector: string, options?: Record<string, any>) => (e: any) => void;
+export const openKeys: (isOpen: boolean, open: () => void) => (e: any) => void;
+export const focusIn: (el: any) => void;
+export const toTrigger: (e: any) => void;
+export const trigger: (list: any) => any;
+export const rules: typeof import('./shared').rules;
+/** Page template helper: page(name, slotIds, layoutTree) returns [name, definition]. */
+export function page(name: string, slots: string[], tree: unknown): [string, import('./core').ComponentDefinition];
+export function t(component: string, key: string, params?: Record<string, string | number>): string;
+export function getUiLocale(): string;
+export function intlLocale(): string;
+export function defineMessages(component: string, messages: Record<string, Record<string, string>>): void;
+export function registerComponents(defs: Record<string, import('./core').ComponentDefinition>, options?: { override?: boolean }): Record<string, import('./core').ComponentDefinition>;
+export const components: Record<string, import('./core').ComponentDefinition>;
+export const BOOL_PROPS: Set<string>;

package/types/meta.d.ts

@@ -1,4 +1,12 @@
 export interface MetaProp { type: string; values?: string[]; default?: unknown; description?: string; required?: boolean; model?: boolean; forwarded?: boolean }
 export interface ComponentMeta { description: string; props?: Record<string, MetaProp>; slots?: Record<string, string>; events?: Record<string, string>; notes?: string[] }
+export interface MetaGroup { id: string; title?: string; blurb?: string; names: string[] }
+/** Extension API: adds metadata for plugin components. `tiers` are marked as pro, `groups` list them in the manifest. */
+export function registerMeta(extra: Record<string, ComponentMeta>, options?: { tiers?: string[]; groups?: MetaGroup[] }): Record<string, ComponentMeta>;
 export const meta: Record<string, ComponentMeta>;
 export default meta;
+/** Names of the Pro components by group (src/meta/tiers.js). Documented in the public meta, implemented in @ziyarago/ui-pro. */
+export const PRO: Record<string, string[]>;
+export const PRO_NAMES: Set<string>;
+export function isPro(name: string): boolean;
+export const GROUPS: MetaGroup[];

package/types/nuxt.d.ts

@@ -1,6 +1,8 @@
 export interface ModuleOptions {
   css?: boolean;
   prefix?: string;
+  /** Add-on packages (for example '@ziyarago/ui-pro'): their components auto-import and their style.css is added after the core css. */
+  plugins?: string[];
   theme?: false | { theme?: 'dark' | 'light'; palette?: 'gold' | 'tamam'; dir?: 'ltr' | 'rtl'; bg?: 'none' | 'aurora' | 'sunset' | 'ocean' | 'emerald' | 'rose' | 'mesh' };
 }
 declare const _default: import('@nuxt/schema').NuxtModule<ModuleOptions>;