@nexub/core 0.0.0-stage → 2.2.0

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+/** Every user-facing default string in @nexub/react and @nexub/react-native. Explicit component props still win. */
+interface NexubMessages {
+    close: string;
+    dismissAlert: string;
+    dismissBanner: string;
+    remove: string;
+    removeFilter: string;
+    removeFile: (fileName: string) => string;
+    uploadFiles: string;
+    clickToUpload: string;
+    orDragAndDrop: string;
+    clearSearch: string;
+    showPassword: string;
+    hidePassword: string;
+    increment: string;
+    decrement: string;
+    loading: string;
+    pagination: string;
+    previousPage: string;
+    nextPage: string;
+    goToPage: (page: number) => string;
+    breadcrumb: string;
+    breadcrumbMore: string;
+    moreCount: (count: number) => string;
+    rating: string;
+    ratingStars: (stars: number) => string;
+    mainNavigation: string;
+    sidebar: string;
+    searchPlaceholder: string;
+    noResults: string;
+    pickDate: string;
+    pickDateRange: string;
+    /** Calendar nav and day labels (DatePicker, DateRangePicker). */
+    previousMonth: string;
+    nextMonth: string;
+    calendarNavigation: string;
+    /** Wraps a day's formatted date when it is today. */
+    todayDate: (date: string) => string;
+    /** Wraps a day's (possibly today-wrapped) label when it is selected. */
+    selectedDate: (label: string) => string;
+    commandPalette: string;
+    /** Toaster region label; Radix replaces `{hotkey}`. */
+    notifications: string;
+    undo: string;
+    promptLabel: string;
+    sendMessage: string;
+    stopGenerating: string;
+    promptHint: string;
+    thinking: string;
+    youSaid: string;
+    assistantSaid: string;
+    failedToSend: string;
+    retry: string;
+    copy: string;
+    copied: string;
+    goodResponse: string;
+    badResponse: string;
+    regenerate: string;
+    sources: string;
+    source: (index: number) => string;
+    jumpToLatest: string;
+    conversation: string;
+    pageOf: (page: number, total: number) => string;
+    previous: string;
+    next: string;
+    search: string;
+    searchProduct: (productName: string) => string;
+    keyboardShortcut: (shortcut: string) => string;
+    commandKey: string;
+    controlKey: string;
+    searching: string;
+    searchFailed: string;
+    noResultsFor: (query: string) => string;
+    typeToSearch: string;
+    switchOrganization: (name: string) => string;
+    organizations: string;
+    switchToLightTheme: string;
+    switchToDarkTheme: string;
+    glass: string;
+    glassClear: string;
+    glassBalanced: string;
+    glassTinted: string;
+    glassSolid: string;
+    accountMenu: (name: string) => string;
+    manageAccount: string;
+    privacyPolicy: string;
+    termsOfService: string;
+    signOut: string;
+    signingOut: string;
+    accountAndApps: string;
+    /** Sheet grabber: cycles the sheet height. */
+    resize: string;
+    cancel: string;
+    show: (label: string) => string;
+    hide: (label: string) => string;
+    /** Read in place of a masked value. */
+    hidden: string;
+    deleteDigit: string;
+    /** OTP / PIN entry, e.g. "Digit 2 of 6". */
+    codeDigit: (index: number, total: number) => string;
+    offline: string;
+    page: (index: number, total: number) => string;
+    moreActions: string;
+}
+declare const defaultMessages: NexubMessages;
+type Direction = 'ltr' | 'rtl';
+/** 'rtl' for Arabic, Hebrew, Persian and Urdu locales, else 'ltr'. */
+declare function directionOf(locale: string): Direction;
+
+declare function moneyFormatter(currency: string, locale?: string, options?: Intl.NumberFormatOptions): Intl.NumberFormat;
+/** The currency's fraction digits for this locale (JPY 0, USD 2, KWD 3). */
+declare function fractionDigits(currency: string, locale?: string): number;
+/** The narrow symbol on its own, e.g. "$", "€", "₹". */
+declare function currencySymbol(currency: string, locale?: string): string;
+/** Plain number text for editing: locale decimal separator, no grouping, no symbol. */
+declare function formatForEditing(value: number, currency: string, locale?: string): string;
+/** Display text: grouping and the currency's full fraction digits, no symbol. */
+declare function formatForDisplay(value: number, currency: string, locale?: string): string;
+/**
+ * Parses what a person typed into a number, or null when empty/unparseable.
+ * The locale's grouping separators are dropped and its decimal separator marks
+ * the fraction (so in de-DE "1.234,5" is 1234.5). Rounds to the currency's
+ * fraction digits.
+ */
+declare function parseMoney(text: string, currency: string, locale?: string): number | null;
+
+/** Semantic or product tone: overrides a component's colour with a role. */
+type ToneValue = 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'leap' | 'bookub' | 'payub' | 'founderub';
+/** Nexub product brands; each remaps the tertiary role family. */
+type Product = 'leap' | 'bookub' | 'payub' | 'founderub';
+/** Glass intensity dial (user preference). 'off' makes every glass surface solid. */
+type GlassMode = 'clear' | 'balanced' | 'tinted' | 'off';
+/** Contrast level of the colour scheme. */
+type ContrastLevel = 'standard' | 'medium' | 'high';
+/** The control ladder (24 / 32 / 40 / 48 / 56). */
+type ControlSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+export { type ContrastLevel, type ControlSize, type Direction, type GlassMode, type NexubMessages, type Product, type ToneValue, currencySymbol, defaultMessages, directionOf, formatForDisplay, formatForEditing, fractionDigits, moneyFormatter, parseMoney };

package/dist/index.js

@@ -0,0 +1,150 @@
+// src/messages.ts
+var defaultMessages = {
+  close: "Close",
+  dismissAlert: "Dismiss alert",
+  dismissBanner: "Dismiss banner",
+  remove: "Remove",
+  removeFilter: "Remove filter",
+  removeFile: (fileName) => `Remove ${fileName}`,
+  uploadFiles: "Upload files",
+  clickToUpload: "Click to upload",
+  orDragAndDrop: "or drag and drop",
+  clearSearch: "Clear search",
+  showPassword: "Show password",
+  hidePassword: "Hide password",
+  increment: "Increment",
+  decrement: "Decrement",
+  loading: "Loading\u2026",
+  pagination: "Pagination",
+  previousPage: "Go to previous page",
+  nextPage: "Go to next page",
+  goToPage: (page) => `Go to page ${page}`,
+  breadcrumb: "breadcrumb",
+  breadcrumbMore: "More",
+  moreCount: (count) => `${count} more`,
+  rating: "Rating",
+  ratingStars: (stars) => `${stars} star${stars !== 1 ? "s" : ""}`,
+  mainNavigation: "Main",
+  sidebar: "Sidebar",
+  searchPlaceholder: "Search\u2026",
+  noResults: "No results found.",
+  pickDate: "Pick a date",
+  pickDateRange: "Pick a date range",
+  previousMonth: "Go to previous month",
+  nextMonth: "Go to next month",
+  calendarNavigation: "Calendar navigation",
+  todayDate: (date) => `Today, ${date}`,
+  selectedDate: (label) => `${label}, selected`,
+  commandPalette: "Command palette",
+  notifications: "Notifications ({hotkey})",
+  undo: "Undo",
+  promptLabel: "Message",
+  sendMessage: "Send message",
+  stopGenerating: "Stop generating",
+  promptHint: "Press Enter to send, Shift+Enter for a new line",
+  thinking: "Thinking",
+  youSaid: "You said",
+  assistantSaid: "Assistant said",
+  failedToSend: "Failed to send",
+  retry: "Retry",
+  copy: "Copy",
+  copied: "Copied",
+  goodResponse: "Good response",
+  badResponse: "Bad response",
+  regenerate: "Regenerate",
+  sources: "Sources",
+  source: (n) => `Source ${n}`,
+  jumpToLatest: "Jump to latest",
+  conversation: "Conversation",
+  pageOf: (page, total) => `Page ${page} of ${total}`,
+  previous: "Previous",
+  next: "Next",
+  search: "Search",
+  searchProduct: (productName) => `Search ${productName}`,
+  keyboardShortcut: (shortcut) => `Keyboard shortcut: ${shortcut}`,
+  commandKey: "Command",
+  controlKey: "Control",
+  searching: "Searching\u2026",
+  searchFailed: "Search failed. Try again.",
+  noResultsFor: (query) => `No results for \u201C${query}\u201D`,
+  typeToSearch: "Type to search",
+  switchOrganization: (name) => `${name}, switch organization`,
+  organizations: "Organizations",
+  switchToLightTheme: "Switch to light theme",
+  switchToDarkTheme: "Switch to dark theme",
+  glass: "Glass",
+  glassClear: "Clear",
+  glassBalanced: "Balanced",
+  glassTinted: "Tinted",
+  glassSolid: "Solid",
+  accountMenu: (name) => `Account: ${name}`,
+  manageAccount: "Manage your Nexub Account",
+  privacyPolicy: "Privacy policy",
+  termsOfService: "Terms of service",
+  signOut: "Sign out",
+  signingOut: "Signing out\u2026",
+  accountAndApps: "Account and apps",
+  resize: "Resize",
+  cancel: "Cancel",
+  show: (label) => `Show ${label}`,
+  hide: (label) => `Hide ${label}`,
+  hidden: "Hidden",
+  deleteDigit: "Delete",
+  codeDigit: (index, total) => `Digit ${index} of ${total}`,
+  offline: "You\u2019re offline. Some things may not be up to date.",
+  page: (index, total) => `Page ${index} of ${total}`,
+  moreActions: "More actions"
+};
+var RTL_LANGUAGES = /* @__PURE__ */ new Set(["ar", "he", "fa", "ur"]);
+function directionOf(locale) {
+  return RTL_LANGUAGES.has(locale.toLowerCase().split(/[-_]/)[0]) ? "rtl" : "ltr";
+}
+
+// src/money.ts
+function part(fmt, n, type) {
+  if (typeof fmt.formatToParts === "function") return fmt.formatToParts(n).find((p) => p.type === type)?.value;
+  return /\p{Nd}([^\p{Nd}]+)\p{Nd}/u.exec(fmt.format(n))?.[1];
+}
+function moneyFormatter(currency, locale, options = {}) {
+  return new Intl.NumberFormat(locale, { style: "currency", currency, currencyDisplay: "narrowSymbol", ...options });
+}
+function fractionDigits(currency, locale) {
+  const fmt = moneyFormatter(currency, locale);
+  if (typeof fmt.resolvedOptions === "function") return fmt.resolvedOptions().maximumFractionDigits ?? 2;
+  const runs = fmt.format(0).match(/\p{Nd}+/gu) ?? [];
+  return runs.length > 1 ? runs[runs.length - 1].length : 0;
+}
+function currencySymbol(currency, locale) {
+  const fmt = moneyFormatter(currency, locale);
+  if (typeof fmt.formatToParts === "function")
+    return fmt.formatToParts(0).find((p) => p.type === "currency")?.value ?? currency;
+  const symbol = fmt.format(0).replace(/[\p{Nd}\s.,\u00a0\u202f\u066b\u066c'’-]/gu, "");
+  return symbol || currency;
+}
+function formatForEditing(value, currency, locale) {
+  return new Intl.NumberFormat(locale, {
+    useGrouping: false,
+    maximumFractionDigits: fractionDigits(currency, locale)
+  }).format(value);
+}
+function formatForDisplay(value, currency, locale) {
+  const digits = fractionDigits(currency, locale);
+  return new Intl.NumberFormat(locale, { minimumFractionDigits: digits, maximumFractionDigits: digits }).format(value);
+}
+function parseMoney(text, currency, locale) {
+  const plain = new Intl.NumberFormat(locale);
+  const decimal = part(plain, 1.1, "decimal") ?? ".";
+  const group = part(plain, 1e4, "group");
+  let s = text.trim().replace(/[\s\u00a0\u202f]/g, "");
+  if (group && group !== decimal) s = s.split(group).join("");
+  s = s.replace(decimal, ".").replace(/[−–]/g, "-").replace(/[^0-9.-]/g, "");
+  const negative = s.startsWith("-");
+  s = s.replace(/-/g, "");
+  if (!/\d/.test(s) || (s.match(/\./g) ?? []).length > 1) return null;
+  const n = Number(s);
+  if (!Number.isFinite(n)) return null;
+  const f = 10 ** fractionDigits(currency, locale);
+  return (negative ? -1 : 1) * (Math.round(n * f) / f);
+}
+
+export { currencySymbol, defaultMessages, directionOf, formatForDisplay, formatForEditing, fractionDigits, moneyFormatter, parseMoney };

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@nexub/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.2.0",
+  "description": "Platform-neutral core of Nexub Design System, shared by @nexub/react (web) and @nexub/react-native: UI strings, locale direction, money formatting and shared prop types. Pure TypeScript, no DOM, no React.",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/Nexub-AI/nexub-ds#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nexub-AI/nexub-ds.git",
+    "directory": "packages/core"
+  },
+  "keywords": [
+    "design-system",
+    "i18n",
+    "money",
+    "nexub"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.