@tuturuuu/ui 0.26.0 → 0.27.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## [0.27.0](https://github.com/tutur3u/platform/compare/ui-v0.26.1...ui-v0.27.0) (2026-08-14)
+
+
+### Features
+
+* **tasks:** add board lifecycle actions ([3295657](https://github.com/tutur3u/platform/commit/329565797b8bb3cefdf8f3812e6f5391576bf394))
+* **workspaces:** assign roles to pending invites ([#5125](https://github.com/tutur3u/platform/issues/5125)) ([d4052fd](https://github.com/tutur3u/platform/commit/d4052fd40de66bda4e9535740bbcfd5a8da19123))
+* **workspaces:** revamp invitation access flow ([7ea94af](https://github.com/tutur3u/platform/commit/7ea94afc2c5e14af1c83d1478ad9c006268b13c0))
+* **workspaces:** support multi-role invitations ([f6f78ba](https://github.com/tutur3u/platform/commit/f6f78bac6c2120fd70c09e85c075c4206be4f897))
+
+
+### Bug Fixes
+
+* **contacts:** preserve server referral search results ([8d0941d](https://github.com/tutur3u/platform/commit/8d0941de693fb784fd2487582d905f2cbd0fb16e))
+* **tasks:** allow board lifecycle actions ([9a6bc0c](https://github.com/tutur3u/platform/commit/9a6bc0ce31c4191bed81607fdb5c9ee2af8e1d04))
+* **workspaces:** manage roles for pending invites ([2466f6c](https://github.com/tutur3u/platform/commit/2466f6cbbd447207d87eb0e0d78b3c713b02b739))
+
+
+### Performance Improvements
+
+* **vercel:** reduce realtime fallback polling ([e9e44a4](https://github.com/tutur3u/platform/commit/e9e44a4eb17c971beb9e1b737c4580466e427be5))
+* **vercel:** reduce realtime fallback polling ([#5126](https://github.com/tutur3u/platform/issues/5126)) ([fde2692](https://github.com/tutur3u/platform/commit/fde2692ff73a45616a40b93de9fff30ffc941fd2))
+
+## [0.26.1](https://github.com/tutur3u/platform/compare/ui-v0.26.0...ui-v0.26.1) (2026-08-11)
+
+
+### Bug Fixes
+
+* **vercel:** harden navigation prefetch policy ([b8cf61c](https://github.com/tutur3u/platform/commit/b8cf61c86727817faff1f28da768fee4b3e52e68))
+
+
+### Performance Improvements
+
+* **vercel:** reduce speculative app requests ([423e240](https://github.com/tutur3u/platform/commit/423e2401c16b2cad4785ba46a08bf5b3d1c8a749))
+* **vercel:** reduce speculative app requests ([#5116](https://github.com/tutur3u/platform/issues/5116)) ([9e2b59b](https://github.com/tutur3u/platform/commit/9e2b59bcaa0bbc7a593ff91e2d2331aca4ab6595))
+
 ## [0.26.0](https://github.com/tutur3u/platform/compare/ui-v0.25.3...ui-v0.26.0) (2026-08-09)
 
 

package/README.md

@@ -6,12 +6,11 @@ Shared UI components and design system for Tuturuuu Platform.
 
 ```bash
 npm install @tuturuuu/ui
-# or
-yarn add @tuturuuu/ui
-# or
-bun add @tuturuuu/ui
 ```
 
+Using another package manager? Run `pnpm add @tuturuuu/ui`,
+`yarn add @tuturuuu/ui`, or `bun add @tuturuuu/ui` instead.
+
 The public package depends on other published Tuturuuu packages, including
 `@tuturuuu/apis` and `@tuturuuu/ai`. Release those dependencies first, then
 publish UI from the same production commit so standalone apps can install
@@ -19,18 +18,41 @@ publish UI from the same production commit so standalone apps can install
 
 ## Usage
 
+Import the shared stylesheet once from your app's root layout or entry point:
+
 ```typescript
-import { Button, Card } from '@tuturuuu/ui'
+import '@tuturuuu/ui/globals.css';
+```
+
+Then import each component from its public subpath:
+
+```tsx
+import { Button } from '@tuturuuu/ui/button';
+import {
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle,
+} from '@tuturuuu/ui/card';
 
 export default function MyComponent() {
   return (
     <Card>
-      <Button variant="primary">Click me</Button>
+      <CardHeader>
+        <CardTitle>Welcome to Tuturuuu</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <Button>Get started</Button>
+      </CardContent>
     </Card>
-  )
+  );
 }
 ```
 
+The package exports TypeScript and TSX source files. Configure your framework
+or bundler to transpile `@tuturuuu/ui` and its published Tuturuuu dependencies
+when it does not transpile package source automatically.
+
 ## Features
 
 - Fully accessible components

package/biome.json

@@ -1,5 +1,5 @@
 {
   "root": false,
-  "$schema": "https://biomejs.dev/schemas/2.5.7/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.8/schema.json",
   "extends": "//"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuturuuu/ui",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -56,43 +56,43 @@
     "@streamdown/math": "^1.0.2",
     "@streamdown/mermaid": "^1.0.2",
     "@tanstack/react-hotkeys": "^0.10.0",
-    "@tanstack/react-pacer": "^0.22.1",
+    "@tanstack/react-pacer": "^0.23.0",
     "@tanstack/react-query": "^5.101.2",
     "@tanstack/react-table": "^9.0.0",
     "@tanstack/react-virtual": "^3.14.9",
-    "@tiptap/core": "3.29.2",
-    "@tiptap/extension-collaboration": "3.29.2",
-    "@tiptap/extension-collaboration-caret": "3.29.2",
-    "@tiptap/extension-color": "3.29.2",
-    "@tiptap/extension-drag-handle": "3.29.2",
-    "@tiptap/extension-drag-handle-react": "3.29.2",
-    "@tiptap/extension-highlight": "3.29.2",
-    "@tiptap/extension-horizontal-rule": "3.29.2",
-    "@tiptap/extension-image": "3.29.2",
-    "@tiptap/extension-link": "3.29.2",
-    "@tiptap/extension-list": "3.29.2",
-    "@tiptap/extension-node-range": "3.29.2",
-    "@tiptap/extension-placeholder": "3.29.2",
-    "@tiptap/extension-strike": "3.29.2",
-    "@tiptap/extension-subscript": "3.29.2",
-    "@tiptap/extension-superscript": "3.29.2",
-    "@tiptap/extension-table": "3.29.2",
-    "@tiptap/extension-table-cell": "3.29.2",
-    "@tiptap/extension-table-header": "3.29.2",
-    "@tiptap/extension-table-row": "3.29.2",
-    "@tiptap/extension-text-align": "3.29.2",
-    "@tiptap/extension-text-style": "3.29.2",
-    "@tiptap/extension-youtube": "3.29.2",
-    "@tiptap/pm": "3.29.2",
-    "@tiptap/react": "3.29.2",
-    "@tiptap/starter-kit": "3.29.2",
-    "@tuturuuu/ai": "0.8.1",
-    "@tuturuuu/apis": "0.11.0",
-    "@tuturuuu/hooks": "0.1.0",
+    "@tiptap/core": "3.30.0",
+    "@tiptap/extension-collaboration": "3.30.0",
+    "@tiptap/extension-collaboration-caret": "3.30.0",
+    "@tiptap/extension-color": "3.30.0",
+    "@tiptap/extension-drag-handle": "3.30.0",
+    "@tiptap/extension-drag-handle-react": "3.30.0",
+    "@tiptap/extension-highlight": "3.30.0",
+    "@tiptap/extension-horizontal-rule": "3.30.0",
+    "@tiptap/extension-image": "3.30.0",
+    "@tiptap/extension-link": "3.30.0",
+    "@tiptap/extension-list": "3.30.0",
+    "@tiptap/extension-node-range": "3.30.0",
+    "@tiptap/extension-placeholder": "3.30.0",
+    "@tiptap/extension-strike": "3.30.0",
+    "@tiptap/extension-subscript": "3.30.0",
+    "@tiptap/extension-superscript": "3.30.0",
+    "@tiptap/extension-table": "3.30.0",
+    "@tiptap/extension-table-cell": "3.30.0",
+    "@tiptap/extension-table-header": "3.30.0",
+    "@tiptap/extension-table-row": "3.30.0",
+    "@tiptap/extension-text-align": "3.30.0",
+    "@tiptap/extension-text-style": "3.30.0",
+    "@tiptap/extension-youtube": "3.30.0",
+    "@tiptap/pm": "3.30.0",
+    "@tiptap/react": "3.30.0",
+    "@tiptap/starter-kit": "3.30.0",
+    "@tuturuuu/ai": "0.8.2",
+    "@tuturuuu/apis": "0.11.2",
+    "@tuturuuu/hooks": "0.1.1",
     "@tuturuuu/icons": "0.1.0",
-    "@tuturuuu/internal-api": "0.29.0",
+    "@tuturuuu/internal-api": "0.30.0",
     "@tuturuuu/supabase": "0.5.0",
-    "@tuturuuu/utils": "0.24.0",
+    "@tuturuuu/utils": "0.25.0",
     "@types/debug": "^4.1.13",
     "browser-image-compression": "^2.0.2",
     "class-variance-authority": "^0.7.1",
@@ -104,17 +104,17 @@
     "debug": "^4.4.3",
     "embla-carousel-react": "^8.6.0",
     "eventemitter3": "^5.0.4",
-    "framer-motion": "^13.0.0",
+    "framer-motion": "^13.1.0",
     "gsap": "^3.15.0",
     "html-entities": "^2.6.0",
-    "html2canvas-pro": "^2.3.3",
+    "html2canvas-pro": "^2.3.6",
     "input-otp": "^1.4.2",
-    "katex": "^0.18.1",
+    "katex": "^0.18.4",
     "lodash": "4.18.1",
     "moment": "^2.30.1",
-    "motion": "^13.0.0",
-    "next": "^16.3.0",
-    "next-intl": "^4.13.5",
+    "motion": "^13.1.0",
+    "next": "^16.3.1",
+    "next-intl": "^4.13.6",
     "next-themes": "^0.4.6",
     "nuqs": "^2.9.5",
     "prosemirror-state": "^1.4.4",
@@ -124,8 +124,8 @@
     "react-colorful": "^5.8.0",
     "react-day-picker": "^10.0.1",
     "react-dom": "^19.2.8",
-    "react-dropzone": "^20.0.0",
-    "react-hook-form": "^7.84.0",
+    "react-dropzone": "^20.1.0",
+    "react-hook-form": "^7.85.0",
     "react-markdown": "^10.1.0",
     "react-papaparse": "^4.4.0",
     "react-pdf": "^10.4.1",
@@ -133,13 +133,13 @@
     "react-resizable-panels": "^4.12.2",
     "react-syntax-highlighter": "^16.1.1",
     "recharts": "3.10.1",
-    "slot-text": "^0.3.3",
-    "sonner": "^2.0.7",
+    "slot-text": "^0.3.4",
+    "sonner": "^2.0.8",
     "streamdown": "^2.5.0",
     "tailwind-scrollbar": "^4.0.2",
     "tailwind-scrollbar-hide": "^4.0.0",
     "tailwindcss-animate": "^1.0.7",
-    "tiptap-extension-resize-image": "^1.4.5",
+    "tiptap-extension-resize-image": "^1.4.6",
     "use-debounce": "^10.1.1",
     "vaul": "^1.1.2",
     "y-protocols": "^1.0.7",
@@ -150,14 +150,14 @@
     "@tailwindcss/postcss": "^4.3.3",
     "@tailwindcss/typography": "^0.5.20",
     "@tanstack/react-query": "^5.101.4",
-    "@tanstack/react-table": "^9.0.0",
-    "@testing-library/jest-dom": "^7.0.0",
+    "@tanstack/react-table": "^9.1.2",
+    "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.2",
     "@tuturuuu/types": "0.27.0",
     "@tuturuuu/typescript-config": "0.1.1",
     "@types/html2canvas": "^1.0.0",
     "@types/lodash": "^4.17.25",
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
     "@types/react-resizable": "^4.0.0",
@@ -166,7 +166,7 @@
     "@vitejs/plugin-react": "^6.0.5",
     "autoprefixer": "^10.5.4",
     "jsdom": "^30.0.1",
-    "postcss": "^8.5.25",
+    "postcss": "^8.5.26",
     "postcss-load-config": "^6.0.1",
     "tailwindcss": "^4.3.3",
     "typescript": "7.0.2",
@@ -396,12 +396,6 @@
     },
     "./calendar-app/hooks/*": "./src/components/ui/calendar-app/hooks/*.ts",
     "./calendar-app/components/*": "./src/components/ui/calendar-app/components/*.tsx",
-    "./calendar-app/components/sidebar/*": "./src/components/ui/calendar-app/components/sidebar/*.tsx",
-    "./calendar-app/components/time-tracker": {
-      "types": "./src/components/ui/calendar-app/components/time-tracker/index.tsx",
-      "import": "./src/components/ui/calendar-app/components/time-tracker/index.tsx"
-    },
-    "./calendar-app/components/time-tracker/*": "./src/components/ui/calendar-app/components/time-tracker/*.tsx",
     "./custom/icon-picker": {
       "types": "./src/components/ui/custom/icon-picker/index.ts",
       "import": "./src/components/ui/custom/icon-picker/index.ts"

package/src/components/ui/calendar-app/hooks/use-calendar-settings.test.ts

@@ -0,0 +1,32 @@
+import {
+  resolveFirstDayOfWeek as resolveCanonicalFirstDayOfWeek,
+  resolveTimezone as resolveCanonicalTimezone,
+} from '@tuturuuu/utils/calendar-settings-resolver';
+import { describe, expect, it } from 'vitest';
+import {
+  resolveFirstDayOfWeek,
+  resolveTimezone,
+} from '../../../../lib/calendar-settings-resolver';
+
+describe('shared calendar settings resolver integration', () => {
+  it('keeps the UI compatibility path on the canonical resolver', () => {
+    expect(resolveTimezone).toBe(resolveCanonicalTimezone);
+    expect(resolveFirstDayOfWeek).toBe(resolveCanonicalFirstDayOfWeek);
+  });
+
+  it('prefers saved user values and preserves locale fallback', () => {
+    expect(
+      resolveTimezone(
+        { timezone: 'Asia/Ho_Chi_Minh' },
+        { timezone: 'Europe/London' }
+      )
+    ).toBe('Asia/Ho_Chi_Minh');
+    expect(
+      resolveFirstDayOfWeek(
+        { first_day_of_week: 'auto' },
+        { first_day_of_week: 'auto' },
+        'vi-VN'
+      )
+    ).toBe('monday');
+  });
+});

package/src/components/ui/custom/combobox.tsx

@@ -101,6 +101,8 @@ interface ComboboxProps {
   onCreate?: (value: string) => unknown | Promise<unknown>;
   /** Callback when search input changes */
   onSearchChange?: (value: string) => void;
+  /** Whether Command should filter the provided options locally */
+  shouldFilter?: boolean;
   /** Callback when the popover opens or closes */
   onOpenChange?: (open: boolean) => void;
   /** Whether there are more options to load */
@@ -148,6 +150,7 @@ export function Combobox({
   useFirstValueAsDefault = false,
   onCreate,
   onSearchChange,
+  shouldFilter = true,
   onOpenChange,
   hasMore = false,
   onLoadMore,
@@ -543,6 +546,7 @@ export function Combobox({
           sideOffset={4}
         >
           <Command
+            shouldFilter={shouldFilter}
             filter={(value, search) => {
               if (value.startsWith(actionValuePrefix)) return 1;
               if (value.startsWith(createValuePrefix)) return 1;

package/src/components/ui/custom/nav-link.test.tsx

@@ -7,10 +7,12 @@ import { NavLink } from './nav-link';
 
 const navigationState = vi.hoisted(() => ({
   pathname: '/personal/tasks',
+  prefetch: vi.fn(),
 }));
 
 vi.mock('next/navigation', () => ({
   usePathname: () => navigationState.pathname,
+  useRouter: () => ({ prefetch: navigationState.prefetch }),
 }));
 
 vi.mock('next-intl', () => ({
@@ -51,9 +53,54 @@ function renderNavLink(
 describe('NavLink', () => {
   beforeEach(() => {
     navigationState.pathname = '/personal/tasks';
+    navigationState.prefetch.mockReset();
     vi.restoreAllMocks();
   });
 
+  it('prefetches internal routes only after navigation intent', () => {
+    renderNavLink({
+      href: '/personal/tasks/boards',
+      title: 'Boards',
+    });
+
+    const link = screen.getByRole('link', { name: 'Boards' });
+    expect(navigationState.prefetch).not.toHaveBeenCalled();
+
+    fireEvent.mouseEnter(link);
+    fireEvent.focus(link);
+
+    expect(navigationState.prefetch).toHaveBeenCalledTimes(1);
+    expect(navigationState.prefetch).toHaveBeenCalledWith(
+      '/personal/tasks/boards'
+    );
+  });
+
+  it('does not prefetch external routes', () => {
+    renderNavLink({
+      external: true,
+      href: 'https://docs.tuturuuu.com',
+      title: 'Docs',
+    });
+
+    fireEvent.mouseEnter(screen.getByRole('link', { name: 'Docs' }));
+
+    expect(navigationState.prefetch).not.toHaveBeenCalled();
+  });
+
+  it.each([
+    ['protocol-relative', '//docs.tuturuuu.com/guide'],
+    ['email', 'mailto:support@tuturuuu.com'],
+    ['telephone', 'tel:+84123456789'],
+  ])('does not prefetch %s URLs', (_label, href) => {
+    renderNavLink({ href, title: 'External destination' });
+
+    fireEvent.mouseEnter(
+      screen.getByRole('link', { name: 'External destination' })
+    );
+
+    expect(navigationState.prefetch).not.toHaveBeenCalled();
+  });
+
   it('matches wildcard aliases even when the primary route is exact', () => {
     navigationState.pathname = '/personal/tasks/boards/board-1';
 

package/src/components/ui/custom/nav-link.tsx

@@ -12,9 +12,9 @@ import {
 import { getWorkspaceConfigIdList } from '@tuturuuu/internal-api';
 import { cn } from '@tuturuuu/utils/format';
 import Link from 'next/link';
-import { usePathname } from 'next/navigation';
+import { usePathname, useRouter } from 'next/navigation';
 import { useTranslations } from 'next-intl';
-import { useState } from 'react';
+import { useRef, useState } from 'react';
 import { Badge } from '../badge';
 import { Button } from '../button';
 import {
@@ -58,7 +58,7 @@ function getComparablePath(
       ? new URL(target)
       : new URL(target, base);
 
-    if (isAbsoluteHttpUrl(target) && url.origin !== base) return null;
+    if (url.origin !== base) return null;
 
     return url.pathname;
   } catch {
@@ -103,6 +103,7 @@ export function NavLink({
 }: NavLinkProps) {
   const t = useTranslations();
   const pathname = usePathname();
+  const router = useRouter();
   const {
     title,
     icon,
@@ -338,6 +339,27 @@ export function NavLink({
         })()
       : href;
 
+  const prefetchedHrefRef = useRef<string | null>(null);
+  const prefetchOnIntent = () => {
+    if (
+      !effectiveHref ||
+      newTab ||
+      link.external ||
+      isDisabled ||
+      isResolvingHref ||
+      hasSubMenu ||
+      archivedItems.length > 0 ||
+      !getComparablePath(effectiveHref)
+    ) {
+      return;
+    }
+
+    if (prefetchedHrefRef.current === effectiveHref) return;
+
+    prefetchedHrefRef.current = effectiveHref;
+    router.prefetch(effectiveHref);
+  };
+
   const commonProps = {
     className: cn(
       'group/navlink flex w-full cursor-pointer items-center justify-between rounded-md p-2 font-medium text-sm',
@@ -388,6 +410,8 @@ export function NavLink({
         onClick();
       }
     },
+    onFocus: prefetchOnIntent,
+    onMouseEnter: prefetchOnIntent,
   };
 
   const linkElement =
@@ -425,6 +449,7 @@ export function NavLink({
     ) : effectiveHref && !isDisabled ? (
       <Link
         href={effectiveHref}
+        prefetch={false}
         {...commonProps}
         target={newTab ? '_blank' : '_self'}
       >

package/src/components/ui/custom/workspace-access/adapters.test.ts

@@ -1,9 +1,21 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 import {
   createStandardWorkspaceAccessAdapter,
+  mergeWorkspaceInvitationRoles,
   normalizeWorkspaceAccessRole,
 } from './adapters';
 
+const mocks = vi.hoisted(() => ({
+  inviteWorkspaceMember: vi.fn().mockResolvedValue({ message: 'success' }),
+}));
+
+vi.mock('@tuturuuu/internal-api/workspaces', async (importOriginal) => ({
+  ...(await importOriginal<
+    typeof import('@tuturuuu/internal-api/workspaces')
+  >()),
+  inviteWorkspaceMember: mocks.inviteWorkspaceMember,
+}));
+
 describe('workspace access adapters', () => {
   it('normalizes role permissions into the shared access role shape', () => {
     expect(
@@ -37,4 +49,80 @@ describe('workspace access adapters', () => {
       createStandardWorkspaceAccessAdapter().updateMemberProfile
     ).toBeTypeOf('function');
   });
+
+  it('hydrates pending email and registered-user invitations with their assigned roles', () => {
+    const members = mergeWorkspaceInvitationRoles(
+      [
+        {
+          default_permissions: [],
+          email: 'pending@example.com',
+          id: null,
+          is_creator: false,
+          pending: true,
+          roles: [],
+        },
+        {
+          default_permissions: [],
+          email: null,
+          id: 'user-2',
+          is_creator: false,
+          pending: true,
+          roles: [],
+        },
+        {
+          default_permissions: [],
+          email: 'joined@example.com',
+          id: 'user-3',
+          is_creator: false,
+          pending: false,
+          roles: [{ id: 'role-owner', name: 'Owner', permissions: [] }],
+        },
+      ],
+      [
+        {
+          email: 'Pending@Example.com',
+          roles: [
+            { id: 'role-editor', name: 'Editor' },
+            { id: 'role-reviewer', name: 'Reviewer' },
+          ],
+          userId: null,
+        },
+        {
+          email: null,
+          roles: [{ id: 'role-reviewer', name: 'Reviewer' }],
+          userId: 'user-2',
+        },
+      ]
+    );
+
+    expect(members[0]?.roles).toEqual([
+      { id: 'role-editor', name: 'Editor', permissions: [] },
+      { id: 'role-reviewer', name: 'Reviewer', permissions: [] },
+    ]);
+    expect(members[1]?.roles).toEqual([
+      { id: 'role-reviewer', name: 'Reviewer', permissions: [] },
+    ]);
+    expect(members[2]?.roles).toEqual([
+      { id: 'role-owner', name: 'Owner', permissions: [] },
+    ]);
+  });
+
+  it('forwards multiple role assignments with every standard invite', async () => {
+    const adapter = createStandardWorkspaceAccessAdapter();
+
+    await adapter.inviteMembers('ws-1', {
+      accessPreset: 'member',
+      emails: ['editor@example.com'],
+      memberType: 'MEMBER',
+      roleIds: ['role-editor', 'role-reviewer'],
+    });
+
+    expect(mocks.inviteWorkspaceMember).toHaveBeenCalledWith('ws-1', {
+      accessPreset: 'member',
+      confirmDefaultAdminMigration: undefined,
+      email: 'editor@example.com',
+      memberType: 'MEMBER',
+      roleIds: ['role-editor', 'role-reviewer'],
+    });
+  });
 });