@tuturuuu/ui 0.25.3 → 0.26.1

package/CHANGELOG.md

@@ -1,5 +1,104 @@
 # Changelog
 
+## [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)
+
+
+### Features
+
+* **apps:** add resilient error recovery shells ([f0f514d](https://github.com/tutur3u/platform/commit/f0f514d2b1712ea76c6845801fa2803369418a63))
+* **chat:** add connected site sync bridge ([05c27f5](https://github.com/tutur3u/platform/commit/05c27f5ac4a545af366097ee2a919ec755970b9b))
+* **chat:** add connected site sync bridge ([#5078](https://github.com/tutur3u/platform/issues/5078)) ([3de1a07](https://github.com/tutur3u/platform/commit/3de1a07dfa2fec96982aa0d116e003d0aa3fe47c))
+* **chat:** add external parity reconciliation ([953b9d6](https://github.com/tutur3u/platform/commit/953b9d6315611ef86ec2c213bbbbc5e62d5f4ad4))
+* **chat:** add external parity reconciliation ([#5086](https://github.com/tutur3u/platform/issues/5086)) ([5ef796f](https://github.com/tutur3u/platform/commit/5ef796f7812ec6a9f9a62193ba21633cd2503001))
+* **chat:** complete connected-site operational parity ([#5093](https://github.com/tutur3u/platform/issues/5093)) ([397e11b](https://github.com/tutur3u/platform/commit/397e11bd87d583fe1c65f83a2b8019c287650e19))
+* **chat:** complete connected-site parity ([fd4061d](https://github.com/tutur3u/platform/commit/fd4061d8b2f654e521c40ea9819a348ae81575c9))
+* **finance:** reconcile inventory provider sales ([56650e0](https://github.com/tutur3u/platform/commit/56650e066c473337700998d8af607380e8ea6202))
+* **inventory:** allocate bundle revenue and add cash checkout ([bd465f9](https://github.com/tutur3u/platform/commit/bd465f9bb35fad16d259378fa49611a8eb5ba95b))
+* **inventory:** secure Square POS event checkout ([532b463](https://github.com/tutur3u/platform/commit/532b46372116ee0bebfd83ba2af762cc9f668c3c))
+* **landing:** retile the app bento and rebuild the problem section ([c56f42a](https://github.com/tutur3u/platform/commit/c56f42adf754362a269ff08b380db1ee0cf8c6ca))
+* **meet:** revamp collaborative scheduling ([9124a5d](https://github.com/tutur3u/platform/commit/9124a5d559e071c7e6c1c713cfbca4d9f5205611))
+* **navigation:** open workspace selector on reveal ([c760d42](https://github.com/tutur3u/platform/commit/c760d42b5e0b8f7bd141e26e2ace956b7f39912e))
+* **offline:** own service worker runtime and refresh dependencies ([ae44477](https://github.com/tutur3u/platform/commit/ae44477603c39f0513244514771653287338a89f))
+* **onboarding:** connect product guidance across apps ([68cf626](https://github.com/tutur3u/platform/commit/68cf626c9650e5044b6c123f9423a6cebf1bba9a))
+* **reports:** add periodic reporting automation ([ec7bd5e](https://github.com/tutur3u/platform/commit/ec7bd5e10abb137e217d1dcf143624530276392f))
+* **ui:** align landing and locale experience ([aa6e47f](https://github.com/tutur3u/platform/commit/aa6e47f17356ce74111ccf130e8b17071cc7aadf))
+* **web:** improve workspace navigation context ([73959e3](https://github.com/tutur3u/platform/commit/73959e3c6745f60513d23740f30024c5d24e7ee4))
+* **web:** redesign marketing landing page ([13ede78](https://github.com/tutur3u/platform/commit/13ede784ac03af9f25bbb7df61095826c335e002))
+* **web:** refine marketing experience ([c7f1cec](https://github.com/tutur3u/platform/commit/c7f1cec0dd667e6d5f59aaf0bab82069b79c7376))
+
+
+### Bug Fixes
+
+* **auth:** isolate invitation caches by user ([c720f15](https://github.com/tutur3u/platform/commit/c720f1551b1276bedf393bd4fc8975e33f64aa83))
+* **auth:** resume a pending sign-in after switching accounts ([5403718](https://github.com/tutur3u/platform/commit/54037189ee895863eac621239eb54b8ea94c6ed0))
+* **chat:** address external bridge review findings ([30533fc](https://github.com/tutur3u/platform/commit/30533fc64093fed4b25279bc0e45d43bdb7a6cde))
+* **chat:** close bridge edge cases ([db585c8](https://github.com/tutur3u/platform/commit/db585c8486064837dcbce615a30f66c38c0a3ec0))
+* **chat:** decode external visitor labels ([1ca3e75](https://github.com/tutur3u/platform/commit/1ca3e75a939c06222c842da9fe5892a1bf9ce729))
+* **chat:** decode external visitor labels ([#5112](https://github.com/tutur3u/platform/issues/5112)) ([cb7af54](https://github.com/tutur3u/platform/commit/cb7af54264344961234da681c877c5677bf950fa))
+* **chat:** harden bridge review edge cases ([0ecfad7](https://github.com/tutur3u/platform/commit/0ecfad7c66454fdb3bcd971f1362d3789287f086))
+* **chat:** harden connected site migration ([73cccd0](https://github.com/tutur3u/platform/commit/73cccd04e9bd85a443891f3e52b443ef755570cb))
+* **chat:** harden connected site sync ([70e8785](https://github.com/tutur3u/platform/commit/70e8785967e145a77330272e671ca58dfc38fbee))
+* **chat:** harden connected-site parity ([a0d3148](https://github.com/tutur3u/platform/commit/a0d31483a87ed0ebd59f2be5c3bdbb342bd67855))
+* **chat:** harden external bridge boundaries ([2d25202](https://github.com/tutur3u/platform/commit/2d252023e5cfb1c7414ee2ed2d161e7f5de613f8))
+* **chat:** harden external bridge synchronization ([5b7c709](https://github.com/tutur3u/platform/commit/5b7c7092260b05c8de86c2383291433f81c9eead))
+* **chat:** harden external bridge synchronization ([63ccf91](https://github.com/tutur3u/platform/commit/63ccf9129ff8e7cf255bef8c74a3e096ab45cb7d))
+* **chat:** harden external parity replay ([896923b](https://github.com/tutur3u/platform/commit/896923b3c498a09fe0974de1aa0f8d291f8b2c84))
+* **chat:** harden external parity replay ([89c5498](https://github.com/tutur3u/platform/commit/89c5498aef4ad5ebf05ef93bfb05168417a5dfe2))
+* **chat:** mount query state adapter ([#5084](https://github.com/tutur3u/platform/issues/5084)) ([60253f8](https://github.com/tutur3u/platform/commit/60253f82477fc54923556706d12e4dc525a7a170))
+* **chat:** preserve native message behavior ([fc09530](https://github.com/tutur3u/platform/commit/fc095301f2d26ca2bc39de02ce17b1f341327de9))
+* **chat:** restore external inbox display parity ([#5108](https://github.com/tutur3u/platform/issues/5108)) ([b34ea6d](https://github.com/tutur3u/platform/commit/b34ea6d7d8ffda344053ed1f580128446d0d0a81))
+* **ci:** keep task helper collection source-only ([7355a05](https://github.com/tutur3u/platform/commit/7355a05385ccd8d1e2d1bcf6ac15ae5297e057ad))
+* **ci:** resolve shared task helper during e2e collection ([0319a3b](https://github.com/tutur3u/platform/commit/0319a3bd0df12592b823b7cebdff38cea3e50836))
+* **deps:** align Streamdown with Shiki 4 ([0d89f55](https://github.com/tutur3u/platform/commit/0d89f555b3228307e893a5d7723aaf8db8505d63))
+* **inventory:** correct storefront bundle checkout ([cb9c247](https://github.com/tutur3u/platform/commit/cb9c24740ceb77f9426ba640383a68bd9ed95d2c))
+* **platform:** improve satellite workspace routing ([0c49c48](https://github.com/tutur3u/platform/commit/0c49c4882d26704fb16ba94ee289ab0af7deb4de))
+* **platform:** merge notification and group visibility fixes ([4fe9e97](https://github.com/tutur3u/platform/commit/4fe9e970bf61bffaee4353b1ebb83ce2f880a4c8))
+* **platform:** persist settings dialog state ([04d2128](https://github.com/tutur3u/platform/commit/04d212807b6fabf33f43743c0b779ba9499334ba))
+* **platform:** restore notifications and group visibility ([eb570a4](https://github.com/tutur3u/platform/commit/eb570a47e7a3d38fc855fbf3e887ecbde853ece0))
+* **platform:** stabilize offline and calendar initialization ([8ef8fbc](https://github.com/tutur3u/platform/commit/8ef8fbc1274e108930adf38bb8e998384551058b))
+* resolve code quality findings ([63f10b5](https://github.com/tutur3u/platform/commit/63f10b5ec22a4194f48f448ee2b1b088b5da8f08))
+* **security:** remediate code scanning findings ([023db2e](https://github.com/tutur3u/platform/commit/023db2edf4b0557be108a9d772cbc7e2223af947))
+* **settings:** harden workspace role management ([0570687](https://github.com/tutur3u/platform/commit/0570687d255698e438d1eb02262ec0fa7c56240f))
+* **settings:** repair satellite workspace management ([63614cd](https://github.com/tutur3u/platform/commit/63614cdd1550cbf7084724dbed728e798b6f979c))
+* **tasks:** quiet the description toolbar and name the compact action honestly ([51838a0](https://github.com/tutur3u/platform/commit/51838a08a1875a44cd4c7f539b35203f890e1a39))
+* **tasks:** repair board share access and harden AI media attachments ([65b8092](https://github.com/tutur3u/platform/commit/65b809245cc01fb7a5f034f703083f329c20f1c1))
+* **tasks:** repair onboarding and external metadata ([e0b62eb](https://github.com/tutur3u/platform/commit/e0b62eb7119155f6e4cad3dc4fb4d0f9820c98e8))
+* **tasks:** restore task description on deep-link opens ([56d4efa](https://github.com/tutur3u/platform/commit/56d4efabd2f036e7dae39588d8aed7b129fa9a11))
+* **tasks:** show one skeleton per task dialog open ([944288b](https://github.com/tutur3u/platform/commit/944288bdc869ee80b3cdf537ee10feb17fdada22))
+* **tasks:** stop the task dialog remounting after it opens ([9a423da](https://github.com/tutur3u/platform/commit/9a423daf7e7c1e901a63ddcc1a8a94ddff9192c9))
+* **ui:** make member management mobile responsive ([104c812](https://github.com/tutur3u/platform/commit/104c8120949ef34bfdc48da74fdc0e2d35eb4ce7))
+* **ui:** preserve hosted workspace logos ([1f8e8b2](https://github.com/tutur3u/platform/commit/1f8e8b28c23f659952ad58f00a2a371acd8fcef9))
+* **ui:** publish portable vendored dependencies ([99ad359](https://github.com/tutur3u/platform/commit/99ad35903a27b8f9df26f22fc5f1003aed363d6f))
+* **ui:** refine member access settings ([b5b1ebf](https://github.com/tutur3u/platform/commit/b5b1ebf49a4a3b93532da74357899927f6e5d988))
+* **ui:** unify workspace access and sidebar controls ([450183e](https://github.com/tutur3u/platform/commit/450183ef78af8e09a386bebb93be7018379c5152))
+* **web:** harden prerender client boundaries ([ab1596a](https://github.com/tutur3u/platform/commit/ab1596a769e5a6ae43b0247c651ecbecea52d20d))
+* **workspaces:** harden invitation interactions ([b7f8f6c](https://github.com/tutur3u/platform/commit/b7f8f6cf52ceec1b67d36b11513eae7806284f5d))
+* **workspaces:** propagate a workspace rename without a page reload ([cca0b2d](https://github.com/tutur3u/platform/commit/cca0b2d7e14f6d72f1fdda1deaac18aaf07e9eee))
+* **workspaces:** repair shared member administration ([8a1515b](https://github.com/tutur3u/platform/commit/8a1515ba970adbe690b9d92f77a447adb93c339f))
+* **workspaces:** restore invitation access across apps ([3592699](https://github.com/tutur3u/platform/commit/35926990fc28e44996fd330c6403496d78d96872))
+* **workspaces:** restore invitation access across apps ([#5099](https://github.com/tutur3u/platform/issues/5099)) ([c7032c3](https://github.com/tutur3u/platform/commit/c7032c310639c2783b60ac560e83a84d65a5c7f5))
+* **workspaces:** route satellite creation through setup ([754bf1b](https://github.com/tutur3u/platform/commit/754bf1b81360e4755a171819f3a8e6a7c102f351))
+
+
+### Performance Improvements
+
+* **inventory:** add event-driven storefront caching ([2f571f4](https://github.com/tutur3u/platform/commit/2f571f4fc534bf5dee0ca36c4310d87b44e6e613))
+* **storefront:** share customer navigation shell ([21cb78d](https://github.com/tutur3u/platform/commit/21cb78db484d1e1fdb9f2469fcac4e3a948bd176))
+* **storefront:** stabilize navigation and cart rendering ([471c6b7](https://github.com/tutur3u/platform/commit/471c6b75abc6a4d69692e868cc1b220785e03262))
+
 ## [0.25.3](https://github.com/tutur3u/platform/compare/ui-v0.25.2...ui-v0.25.3) (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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuturuuu/ui",
-  "version": "0.25.3",
+  "version": "0.26.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -92,7 +92,7 @@
     "@tuturuuu/icons": "0.1.0",
     "@tuturuuu/internal-api": "0.29.0",
     "@tuturuuu/supabase": "0.5.0",
-    "@tuturuuu/utils": "0.23.1",
+    "@tuturuuu/utils": "0.24.1",
     "@types/debug": "^4.1.13",
     "browser-image-compression": "^2.0.2",
     "class-variance-authority": "^0.7.1",
@@ -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/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/legacy/polls/poll-display.test.tsx

@@ -0,0 +1,118 @@
+import { fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { PlanDetailsPollContent } from './poll-display';
+
+const mocks = vi.hoisted(() => ({
+  addPollOption: vi.fn(),
+  createPoll: vi.fn(),
+  deletePoll: vi.fn(),
+  deletePollOption: vi.fn(),
+  refresh: vi.fn(),
+  submitVote: vi.fn(),
+  toast: vi.fn(),
+  toggleWherePoll: vi.fn(),
+  useTimeBlocking: vi.fn(),
+}));
+
+vi.mock('@tuturuuu/apis/meet/actions', () => ({
+  addPollOption: (...args: unknown[]) => mocks.addPollOption(...args),
+  createPoll: (...args: unknown[]) => mocks.createPoll(...args),
+  deletePoll: (...args: unknown[]) => mocks.deletePoll(...args),
+  deletePollOption: (...args: unknown[]) => mocks.deletePollOption(...args),
+  submitVote: (...args: unknown[]) => mocks.submitVote(...args),
+  toggleWherePoll: (...args: unknown[]) => mocks.toggleWherePoll(...args),
+}));
+
+vi.mock('@tuturuuu/ui/hooks/time-blocking-provider', () => ({
+  useTimeBlocking: () => mocks.useTimeBlocking(),
+}));
+
+vi.mock('@tuturuuu/ui/hooks/use-toast', () => ({
+  toast: (...args: unknown[]) => mocks.toast(...args),
+}));
+
+vi.mock('next/navigation', () => ({
+  useRouter: () => ({ refresh: mocks.refresh }),
+}));
+
+vi.mock('next-intl', () => ({
+  useTranslations: () => (key: string) => key,
+}));
+
+vi.mock('./where-tu-meet', () => ({
+  DefaultWherePollContent: ({
+    onAddOption,
+    onVote,
+  }: {
+    onAddOption: (pollId: string, value: string) => Promise<unknown>;
+    onVote: (pollId: string, optionIds: string[]) => Promise<void>;
+  }) => (
+    <div>
+      <button type="button" onClick={() => onAddOption('poll-1', 'Cafe')}>
+        add guest option
+      </button>
+      <button type="button" onClick={() => onVote('poll-1', ['option-1'])}>
+        submit guest vote
+      </button>
+    </div>
+  ),
+}));
+
+describe('PlanDetailsPollContent guest authorization', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mocks.useTimeBlocking.mockReturnValue({
+      user: {
+        display_name: 'Guest',
+        id: 'guest-1',
+        is_guest: true,
+        password_hash: 'plan-bound-credential',
+      },
+    });
+    mocks.addPollOption.mockResolvedValue({
+      data: {
+        option: {
+          created_at: '2026-08-10T00:00:00.000Z',
+          guestVotes: [],
+          id: 'option-1',
+          poll_id: 'poll-1',
+          totalVotes: 0,
+          userVotes: [],
+          value: 'Cafe',
+        },
+      },
+    });
+    mocks.submitVote.mockResolvedValue({ data: { success: true } });
+  });
+
+  it('forwards the selected guest credential to option and vote actions', async () => {
+    render(
+      <PlanDetailsPollContent
+        plan={{ id: 'plan-1', is_confirmed: false, where_to_meet: true }}
+        isCreator={false}
+        platformUser={null}
+        polls={null}
+      />
+    );
+
+    fireEvent.click(screen.getByRole('button', { name: 'add guest option' }));
+    fireEvent.click(screen.getByRole('button', { name: 'submit guest vote' }));
+
+    await waitFor(() => {
+      expect(mocks.addPollOption).toHaveBeenCalledWith('plan-1', {
+        guestId: 'guest-1',
+        guestPasswordHash: 'plan-bound-credential',
+        pollId: 'poll-1',
+        userType: 'GUEST',
+        value: 'Cafe',
+      });
+      expect(mocks.submitVote).toHaveBeenCalledWith('plan-1', {
+        guestId: 'guest-1',
+        guestPasswordHash: 'plan-bound-credential',
+        optionIds: ['option-1'],
+        pollId: 'poll-1',
+        userType: 'GUEST',
+      });
+    });
+  });
+});

package/src/components/ui/legacy/polls/poll-display.tsx

@@ -94,6 +94,10 @@ export function PlanDetailsPollContent({
       optionIds,
       userType: userType as 'PLATFORM' | 'GUEST',
       guestId: userType === 'GUEST' ? (user?.id ?? undefined) : undefined,
+      guestPasswordHash:
+        userType === 'GUEST' && guestUser?.is_guest
+          ? guestUser.password_hash
+          : undefined,
     });
     if (result.error) {
       toast({
@@ -111,6 +115,10 @@ export function PlanDetailsPollContent({
       value,
       userType: userType as 'PLATFORM' | 'GUEST',
       guestId: userType === 'GUEST' ? (user?.id ?? undefined) : undefined,
+      guestPasswordHash:
+        userType === 'GUEST' && guestUser?.is_guest
+          ? guestUser.password_hash
+          : undefined,
     });
     if (result.error) {
       toast({

package/src/lib/calendar-settings-resolver.ts

@@ -1,200 +1 @@
-/**
- * Calendar Settings Resolver
- *
- * Implements priority system for calendar preferences:
- * User settings > Workspace settings > Auto-detection
- */
-
-type FirstDayOfWeek = 'auto' | 'sunday' | 'monday' | 'saturday';
-
-interface CalendarSettings {
-  timezone: string;
-  firstDayOfWeek: FirstDayOfWeek;
-  timeFormat: '12h' | '24h';
-}
-
-export interface CalendarUserSettings {
-  timezone?: string | null;
-  first_day_of_week?: string | null;
-  time_format?: string | null;
-}
-
-export interface CalendarWorkspaceSettings {
-  timezone?: string | null;
-  first_day_of_week?: string | null;
-}
-
-/**
- * Detects the system timezone using Intl API
- */
-export function detectSystemTimezone(): string {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone;
-  } catch {
-    // Fallback to UTC if detection fails
-    return 'UTC';
-  }
-}
-
-/**
- * Detects the first day of week based on locale
- * Vietnamese: Monday
- * US/Canada: Sunday
- * Middle East: Saturday
- */
-export function detectLocaleFirstDay(locale?: string): FirstDayOfWeek {
-  const userLocale =
-    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
-
-  // Vietnamese locale uses Monday as first day
-  if (userLocale.startsWith('vi')) {
-    return 'monday';
-  }
-
-  // US, Canada, and some other countries use Sunday
-  if (userLocale.startsWith('en-US') || userLocale.startsWith('en-CA')) {
-    return 'sunday';
-  }
-
-  // Middle Eastern countries typically use Saturday
-  if (userLocale.startsWith('ar') || userLocale.startsWith('he')) {
-    return 'saturday';
-  }
-
-  // Most European and other countries use Monday
-  return 'monday';
-}
-
-/**
- * Detects the preferred time format based on locale
- * Uses Intl.DateTimeFormat to determine if the locale uses 12h or 24h format
- */
-export function detectLocaleTimeFormat(locale?: string): '12h' | '24h' {
-  const userLocale =
-    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
-
-  try {
-    // Use Intl.DateTimeFormat to detect the locale's preferred format
-    const formatter = new Intl.DateTimeFormat(userLocale, { hour: 'numeric' });
-    const parts = formatter.formatToParts(new Date(2000, 0, 1, 13, 0));
-    const hourPart = parts.find((p) => p.type === 'hour');
-
-    // If hour is "1" instead of "13", it's 12-hour format
-    return hourPart?.value === '1' ? '12h' : '24h';
-  } catch {
-    // Fallback to 12h for English locales, 24h for others
-    return userLocale.startsWith('en') ? '12h' : '24h';
-  }
-}
-
-/**
- * Resolves the effective time format based on user setting
- */
-export function resolveTimeFormat(
-  user?: Pick<CalendarUserSettings, 'time_format'> | null,
-  locale?: string
-): '12h' | '24h' {
-  // User setting takes priority
-  if (user?.time_format && user.time_format !== 'auto') {
-    return user.time_format as '12h' | '24h';
-  }
-
-  // Auto-detection based on locale
-  return detectLocaleTimeFormat(locale);
-}
-
-/**
- * Resolves the effective timezone based on priority system
- */
-export function resolveTimezone(
-  user?: Pick<CalendarUserSettings, 'timezone'> | null,
-  workspace?: Pick<CalendarWorkspaceSettings, 'timezone'> | null
-): string {
-  // Priority 1: User setting
-  if (user?.timezone && user.timezone !== 'auto') {
-    return user.timezone;
-  }
-
-  // Priority 2: Workspace setting
-  if (workspace?.timezone && workspace.timezone !== 'auto') {
-    return workspace.timezone;
-  }
-
-  // Priority 3: Auto-detection
-  return detectSystemTimezone();
-}
-
-/**
- * Resolves the effective first day of week based on priority system
- */
-export function resolveFirstDayOfWeek(
-  user?: Pick<CalendarUserSettings, 'first_day_of_week'> | null,
-  workspace?: Pick<CalendarWorkspaceSettings, 'first_day_of_week'> | null,
-  locale?: string
-): FirstDayOfWeek {
-  // Priority 1: User setting
-  if (user?.first_day_of_week && user.first_day_of_week !== 'auto') {
-    return user.first_day_of_week as FirstDayOfWeek;
-  }
-
-  // Priority 2: Workspace setting
-  if (workspace?.first_day_of_week && workspace.first_day_of_week !== 'auto') {
-    return workspace.first_day_of_week as FirstDayOfWeek;
-  }
-
-  // Priority 3: Auto-detection based on locale
-  return detectLocaleFirstDay(locale);
-}
-
-/**
- * Resolves all calendar settings at once
- */
-export function resolveCalendarSettings(
-  user?: CalendarUserSettings | null,
-  workspace?: CalendarWorkspaceSettings | null,
-  locale?: string
-): CalendarSettings {
-  return {
-    timezone: resolveTimezone(user, workspace),
-    firstDayOfWeek: resolveFirstDayOfWeek(user, workspace, locale),
-    timeFormat: resolveTimeFormat(user, locale),
-  };
-}
-
-/**
- * Converts first day of week string to number (for Date compatibility)
- * 0 = Sunday, 1 = Monday, 6 = Saturday
- */
-export function firstDayToNumber(day: FirstDayOfWeek, locale?: string): number {
-  if (day === 'auto') {
-    day = detectLocaleFirstDay(locale);
-  }
-
-  switch (day) {
-    case 'sunday':
-      return 0;
-    case 'monday':
-      return 1;
-    case 'saturday':
-      return 6;
-    default:
-      return 1; // Default to Monday
-  }
-}
-
-/**
- * Converts number to first day of week string
- * 0 = Sunday, 1 = Monday, 6 = Saturday
- */
-export function numberToFirstDay(num: number): FirstDayOfWeek {
-  switch (num) {
-    case 0:
-      return 'sunday';
-    case 1:
-      return 'monday';
-    case 6:
-      return 'saturday';
-    default:
-      return 'monday'; // Default to Monday
-  }
-}
+export * from '@tuturuuu/utils/calendar-settings-resolver';

package/src/readme-contract.test.tsx

@@ -0,0 +1,57 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { render, screen } from '@testing-library/react';
+import { Button } from '@tuturuuu/ui/button';
+import { Card, CardContent, CardHeader, CardTitle } from '@tuturuuu/ui/card';
+import { describe, expect, it } from 'vitest';
+
+const repoRoot = resolve(
+  process.cwd(),
+  process.cwd().endsWith('/packages/ui') ? '../..' : '.'
+);
+
+function readRepoFile(path: string) {
+  return readFileSync(resolve(repoRoot, path), 'utf8');
+}
+
+describe('@tuturuuu/ui public quickstart', () => {
+  it('documents only executable public package entry points', () => {
+    const readme = readRepoFile('packages/ui/README.md');
+    const packageJson = JSON.parse(
+      readRepoFile('packages/ui/package.json')
+    ) as {
+      exports: Record<string, unknown>;
+    };
+
+    expect(
+      readme.match(/import '@tuturuuu\/ui\/globals\.css';/gu) ?? []
+    ).toHaveLength(1);
+    expect(readme).toContain("import { Button } from '@tuturuuu/ui/button';");
+    expect(readme).toMatch(
+      /import\s*\{[\s\S]*?Card[\s\S]*?CardContent[\s\S]*?CardHeader[\s\S]*?CardTitle[\s\S]*?\}\s*from '@tuturuuu\/ui\/card';/u
+    );
+    expect(readme).not.toMatch(/from ['"]@tuturuuu\/ui['"]/u);
+    expect(readme).not.toContain('variant="primary"');
+    expect(packageJson.exports['.']).toBeUndefined();
+    expect(packageJson.exports['./button']).toBeDefined();
+    expect(packageJson.exports['./*']).toBe('./src/components/ui/*.tsx');
+  });
+
+  it('renders the documented component tree through public subpaths', () => {
+    render(
+      <Card>
+        <CardHeader>
+          <CardTitle>Welcome to Tuturuuu</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <Button>Get started</Button>
+        </CardContent>
+      </Card>
+    );
+
+    expect(
+      screen.getByRole('button', { name: 'Get started' })
+    ).toBeInTheDocument();
+    expect(screen.getByText('Welcome to Tuturuuu')).toBeInTheDocument();
+  });
+});