@tuturuuu/ui 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.10.0](https://github.com/tutur3u/platform/compare/ui-v0.9.0...ui-v0.10.0) (2026-06-26)
+
+
+### Features
+
+* **settings:** lazy load searchable settings availability ([78091c0](https://github.com/tutur3u/platform/commit/78091c0acd16609c695be80b7c47f7840a34d74a))
+* **settings:** open settings dialog from sidebar ([f3d223f](https://github.com/tutur3u/platform/commit/f3d223fbe3b4ecc7c37b6f19645f6122ddfdf5b9))
+* **tanstack:** migrate module youtube links ([bcbf192](https://github.com/tutur3u/platform/commit/bcbf1927802283b3447a8851b3208362e0dff822))
+* **tasks:** add task progress tracking ([4cffb0f](https://github.com/tutur3u/platform/commit/4cffb0f041d41e3868481068d64b9e3b85a0011a))
+* **tasks:** stabilize shared board realtime collaboration ([6028caf](https://github.com/tutur3u/platform/commit/6028caf50432fd4dcebdaa5a59284e50972b1aa3))
+
+
+### Bug Fixes
+
+* **settings:** resolve lazy search import for docker build ([8a6dc1b](https://github.com/tutur3u/platform/commit/8a6dc1b39fd675daaa9f9b24c60b975b044db724))
+* **tasks:** align board skeleton and nav highlight ([1f20ad4](https://github.com/tutur3u/platform/commit/1f20ad4c21c607a085de6eb7dff772a077fc0fd1))
+* **tasks:** canonicalize task board entry routes ([6d83864](https://github.com/tutur3u/platform/commit/6d838648e7d817cdfac6ae40f06ce3418a899bf9))
+* **tasks:** default task boards to kanban ([477c12a](https://github.com/tutur3u/platform/commit/477c12aeee7644a28e6266f9c339e7ef5c3228bf))
+* **tasks:** harden board task loading ([459fecf](https://github.com/tutur3u/platform/commit/459fecf66414b83bcb18f98eda9677ec3e220855))
+* **tasks:** improve shared board collaboration ([fa4ca4d](https://github.com/tutur3u/platform/commit/fa4ca4d412c8f8f533ab87639b314fefc70f9107))
+* **tasks:** keep pinned special lists sticky ([83ff72c](https://github.com/tutur3u/platform/commit/83ff72ce9b3fd737db666a6caef96ed2ca026fc2))
+* **tasks:** match board name input surface ([2552733](https://github.com/tutur3u/platform/commit/2552733942f720bb1df0566f27753eb226115f3e))
+* **tasks:** show accessible guest task boards ([3153c48](https://github.com/tutur3u/platform/commit/3153c4814e599905ea3de36b3f63e941d6bc86d9))
+* **tasks:** stabilize task board loading states ([b7f4212](https://github.com/tutur3u/platform/commit/b7f4212981514fdb1f38b83be5baf7a8d2686571))
+* **tasks:** support assignees on shared personal boards ([112a561](https://github.com/tutur3u/platform/commit/112a561f38cd73bf4c928117cb4d2f0b178dc7e4))
+* **tasks:** support board guest assignees ([4e479aa](https://github.com/tutur3u/platform/commit/4e479aac13746a2e7c432be4f36ea87407849472))
+* **teach:** harden lesson save recovery ([d56a010](https://github.com/tutur3u/platform/commit/d56a010db5d22dcfde10fc51fbcf73c7abc62268))
+* **teach:** reconcile lesson editor saves ([6f2cb4f](https://github.com/tutur3u/platform/commit/6f2cb4f38c1f3b68aeadec11215066be4f7fbd78))
+
 ## [0.9.0](https://github.com/tutur3u/platform/compare/ui-v0.8.0...ui-v0.9.0) (2026-06-24)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuturuuu/ui",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -85,12 +85,12 @@
     "@tiptap/react": "3.27.1",
     "@tiptap/starter-kit": "3.27.1",
     "@tuturuuu/ai": "0.2.2",
-    "@tuturuuu/apis": "0.6.0",
+    "@tuturuuu/apis": "0.7.0",
     "@tuturuuu/hooks": "0.0.2",
     "@tuturuuu/icons": "0.0.6",
-    "@tuturuuu/internal-api": "0.10.0",
+    "@tuturuuu/internal-api": "0.11.0",
     "@tuturuuu/supabase": "0.4.0",
-    "@tuturuuu/utils": "0.9.0",
+    "@tuturuuu/utils": "0.10.0",
     "@types/debug": "^4.1.13",
     "browser-image-compression": "^2.0.2",
     "class-variance-authority": "^0.7.1",
@@ -149,7 +149,7 @@
     "@tanstack/react-table": "^8.21.3",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
-    "@tuturuuu/types": "0.11.0",
+    "@tuturuuu/types": "0.12.0",
     "@tuturuuu/typescript-config": "0.1.1",
     "@types/html2canvas": "^1.0.0",
     "@types/lodash": "^4.17.24",
@@ -305,6 +305,7 @@
     "./tu-do/initiatives/*": "./src/components/ui/tu-do/initiatives/*.tsx",
     "./tu-do/cycles/*": "./src/components/ui/tu-do/cycles/*.tsx",
     "./tu-do/logs/*": "./src/components/ui/tu-do/logs/*.tsx",
+    "./tu-do/progress/*": "./src/components/ui/tu-do/progress/*.tsx",
     "./tu-do/templates/types": {
       "types": "./src/components/ui/tu-do/templates/types.ts",
       "import": "./src/components/ui/tu-do/templates/types.ts"

package/src/components/ui/custom/__tests__/settings-dialog-search.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, it } from 'vitest';
+import { createSettingsSearchEngine } from '../settings-dialog-search';
+import type { SettingsNavGroup } from '../settings-dialog-shell';
+
+function TestIcon() {
+  return null;
+}
+
+const navItems: SettingsNavGroup[] = [
+  {
+    label: 'Workspace',
+    items: [
+      {
+        aliases: ['organization'],
+        description: 'Manage workspace profile and branding',
+        icon: TestIcon,
+        keywords: ['general'],
+        label: 'General',
+        name: 'workspace_general',
+      },
+      {
+        description: 'Invite people and manage roles',
+        icon: TestIcon,
+        keywords: ['team'],
+        label: 'Members',
+        name: 'workspace_members',
+      },
+    ],
+  },
+  {
+    label: 'Developer',
+    items: [
+      {
+        description: 'Secret keys for external apps',
+        icon: TestIcon,
+        label: 'API Keys',
+        name: 'api_keys',
+        searchLabels: ['sdk tokens'],
+      },
+      {
+        disabled: true,
+        icon: TestIcon,
+        label: 'Secrets',
+        name: 'secrets',
+      },
+    ],
+  },
+];
+
+describe('createSettingsSearchEngine', () => {
+  it('matches labels, group labels, descriptions, aliases, and keywords', () => {
+    const engine = createSettingsSearchEngine(navItems);
+
+    expect(engine.search('members')[0]?.items.map((item) => item.name)).toEqual(
+      ['workspace_members']
+    );
+    expect(
+      engine.search('organization')[0]?.items.map((item) => item.name)
+    ).toEqual(['workspace_general']);
+    expect(engine.search('sdk')[0]?.items.map((item) => item.name)).toEqual([
+      'api_keys',
+    ]);
+    expect(
+      engine.search('developer')[0]?.items.map((item) => item.name)
+    ).toEqual(['api_keys', 'secrets']);
+  });
+
+  it('normalizes accents and excludes disabled items from enabled traversal', () => {
+    const engine = createSettingsSearchEngine(navItems);
+
+    expect(engine.search('generál')[0]?.items.map((item) => item.name)).toEqual(
+      ['workspace_general']
+    );
+    expect(
+      engine.getEnabledItems('developer').map((item) => item.name)
+    ).toEqual(['api_keys']);
+  });
+});

package/src/components/ui/custom/__tests__/settings-dialog-shell-compile-graph.test.ts

@@ -0,0 +1,76 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+
+const settingsDialogShellPath = [
+  join(
+    process.cwd(),
+    'packages/ui/src/components/ui/custom/settings-dialog-shell.tsx'
+  ),
+  join(process.cwd(), 'src/components/ui/custom/settings-dialog-shell.tsx'),
+].find((path) => existsSync(path));
+
+if (!settingsDialogShellPath) {
+  throw new Error('Unable to locate settings-dialog-shell.tsx');
+}
+
+const settingsDialogShellSource = readFileSync(settingsDialogShellPath, {
+  encoding: 'utf8',
+});
+const settingsDialogSearchLoaderPath = [
+  join(
+    process.cwd(),
+    'packages/ui/src/components/ui/custom/settings-dialog-search-loader.js'
+  ),
+  join(
+    process.cwd(),
+    'src/components/ui/custom/settings-dialog-search-loader.js'
+  ),
+].find((path) => existsSync(path));
+
+if (!settingsDialogSearchLoaderPath) {
+  throw new Error('Unable to locate settings-dialog-search-loader.js');
+}
+
+const settingsDialogSearchLoaderSource = readFileSync(
+  settingsDialogSearchLoaderPath,
+  {
+    encoding: 'utf8',
+  }
+);
+const runtimeSource = settingsDialogShellSource.replace(
+  /^\s*import\s+type\b[\s\S]*?\sfrom\s+['"][^'"]+['"];?/gmu,
+  ''
+);
+
+function staticImportPattern(modulePath: string) {
+  const escapedModulePath = modulePath.replace(
+    /[.*+?^${}()|[\]\\]/gu,
+    String.raw`\$&`
+  );
+
+  return new RegExp(
+    String.raw`^\s*import\s+(?!type\b)[\s\S]*?\sfrom\s+['"]${escapedModulePath}['"];`,
+    'mu'
+  );
+}
+
+describe('settings dialog shell compile graph', () => {
+  it('keeps the settings search engine behind a dynamic import', () => {
+    expect(runtimeSource).not.toMatch(
+      staticImportPattern('./settings-dialog-search')
+    );
+    expect(runtimeSource).not.toMatch(
+      staticImportPattern('@tuturuuu/utils/text-helper')
+    );
+    expect(settingsDialogSearchLoaderSource).toMatch(
+      /import\(['"]\.\/settings-dialog-search['"]\)/u
+    );
+    expect(settingsDialogShellSource).not.toContain(
+      'settings-dialog-search.js'
+    );
+    expect(settingsDialogSearchLoaderSource).not.toContain(
+      'settings-dialog-search.js'
+    );
+  });
+});

package/src/components/ui/custom/__tests__/workspace-select-helpers.test.ts

@@ -2,7 +2,10 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import type { InternalApiWorkspaceSummary } from '@tuturuuu/types';
 import { describe, expect, it } from 'vitest';
-import { mergeWorkspaceSelectWorkspaces } from '../workspace-select-helpers';
+import {
+  mergeWorkspaceSelectWorkspaces,
+  normalizeWorkspaceSwitchPath,
+} from '../workspace-select-helpers';
 
 describe('mergeWorkspaceSelectWorkspaces', () => {
   it('uses the current workspace fallback when the workspace list is unavailable', () => {
@@ -56,3 +59,26 @@ describe('mergeWorkspaceSelectWorkspaces', () => {
     );
   });
 });
+
+describe('normalizeWorkspaceSwitchPath', () => {
+  it('lands on tasks when switching workspace from a task board detail route', () => {
+    expect(
+      normalizeWorkspaceSwitchPath('/personal/tasks/boards/board-1', 'personal')
+    ).toBe('/personal/tasks');
+  });
+
+  it('lands on tasks when switching workspace from the task boards index', () => {
+    expect(
+      normalizeWorkspaceSwitchPath('/personal/tasks/boards', 'personal')
+    ).toBe('/personal/tasks');
+  });
+
+  it('preserves existing UUID detail-route stripping for non-task-board routes', () => {
+    expect(
+      normalizeWorkspaceSwitchPath(
+        '/workspace-1/users/11111111-1111-4111-8111-111111111111',
+        'workspace-1'
+      )
+    ).toBe('/workspace-1/users');
+  });
+});

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

@@ -0,0 +1,165 @@
+import '@testing-library/jest-dom';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { fireEvent, render, screen } from '@testing-library/react';
+import type { ComponentProps } from 'react';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { NavLink } from './nav-link';
+
+const navigationState = vi.hoisted(() => ({
+  pathname: '/personal/tasks',
+}));
+
+vi.mock('next/navigation', () => ({
+  usePathname: () => navigationState.pathname,
+}));
+
+vi.mock('next-intl', () => ({
+  useTranslations: () => (key: string) => key,
+}));
+
+vi.mock('@tuturuuu/internal-api', () => ({
+  getWorkspaceConfigIdList: vi.fn(),
+}));
+
+function renderNavLink(
+  link: ComponentProps<typeof NavLink>['link'],
+  props: Partial<
+    Pick<ComponentProps<typeof NavLink>, 'onClick' | 'onSubMenuClick'>
+  > = {}
+) {
+  const queryClient = new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: false,
+      },
+    },
+  });
+
+  return render(
+    <QueryClientProvider client={queryClient}>
+      <NavLink
+        wsId="personal"
+        link={link}
+        isCollapsed={false}
+        onClick={props.onClick ?? vi.fn()}
+        onSubMenuClick={props.onSubMenuClick ?? vi.fn()}
+      />
+    </QueryClientProvider>
+  );
+}
+
+describe('NavLink', () => {
+  beforeEach(() => {
+    navigationState.pathname = '/personal/tasks';
+    vi.restoreAllMocks();
+  });
+
+  it('matches wildcard aliases even when the primary route is exact', () => {
+    navigationState.pathname = '/personal/tasks/boards/board-1';
+
+    renderNavLink({
+      aliases: ['/personal/tasks/boards/*'],
+      href: '/personal/tasks',
+      matchExact: true,
+      title: 'Tasks',
+    });
+
+    expect(screen.getByRole('link', { name: 'Tasks' })).toHaveClass(
+      'bg-accent',
+      'text-accent-foreground'
+    );
+  });
+
+  it('keeps exact primary routes from matching unrelated subroutes', () => {
+    navigationState.pathname = '/personal/tasks/progress';
+
+    renderNavLink({
+      aliases: ['/personal/tasks/boards/*'],
+      href: '/personal/tasks',
+      matchExact: true,
+      title: 'Tasks',
+    });
+
+    expect(screen.getByRole('link', { name: 'Tasks' })).not.toHaveClass(
+      'bg-accent'
+    );
+  });
+
+  it('does not mark cross-origin links active just because the path matches', () => {
+    navigationState.pathname = '/personal';
+
+    renderNavLink({
+      href: 'https://mail.tuturuuu.com/personal',
+      title: 'Mail',
+    });
+
+    expect(screen.getByRole('link', { name: 'Mail' })).not.toHaveClass(
+      'bg-accent'
+    );
+  });
+
+  it('navigates through the parent link instead of opening a single-child submenu', () => {
+    const onClick = vi.fn();
+    const onSubMenuClick = vi.fn();
+
+    renderNavLink(
+      {
+        children: [{ href: '/personal/tasks/boards', title: 'Boards' }],
+        href: '/personal/tasks',
+        title: 'Tasks',
+      },
+      { onClick, onSubMenuClick }
+    );
+
+    const link = screen.getByRole('link', { name: 'Tasks' });
+    link.addEventListener('click', (event) => event.preventDefault());
+    fireEvent.click(link);
+
+    expect(onClick).toHaveBeenCalledTimes(1);
+    expect(onSubMenuClick).not.toHaveBeenCalled();
+  });
+
+  it('dispatches the settings dialog open intent without navigating', () => {
+    const onClick = vi.fn();
+    const dispatchEvent = vi.spyOn(window, 'dispatchEvent');
+
+    renderNavLink(
+      {
+        openSettingsDialog: true,
+        title: 'Settings',
+      },
+      { onClick }
+    );
+
+    fireEvent.click(screen.getByText('Settings'));
+
+    expect(onClick).toHaveBeenCalledTimes(1);
+    expect(dispatchEvent).toHaveBeenCalledWith(
+      expect.objectContaining({
+        type: 'tuturuuu:settings-dialog-open-intent',
+      })
+    );
+  });
+
+  it('passes the requested tab when opening settings from navigation', () => {
+    const dispatchEvent = vi.spyOn(window, 'dispatchEvent');
+
+    renderNavLink({
+      openSettingsDialog: { tab: 'workspace_billing' },
+      title: 'Billing',
+    });
+
+    fireEvent.click(screen.getByText('Billing'));
+
+    const event = dispatchEvent.mock.calls.find(
+      ([candidate]) =>
+        candidate instanceof CustomEvent &&
+        candidate.type === 'tuturuuu:settings-dialog-open-intent'
+    )?.[0];
+
+    expect(event).toBeInstanceOf(CustomEvent);
+    expect((event as CustomEvent).detail).toEqual({
+      settingsTab: 'workspace_billing',
+    });
+  });
+});

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

@@ -38,20 +38,51 @@ function matchesPathPrefix(targetPath: string, pathPrefix: string) {
   return targetPath === pathPrefix || targetPath.startsWith(`${pathPrefix}/`);
 }
 
-function getComparablePath(target?: string) {
+function isAbsoluteHttpUrl(target: string) {
+  return /^https?:\/\//iu.test(target);
+}
+
+function getComparablePath(
+  target?: string,
+  options: { external?: boolean } = {}
+) {
   if (!target) return null;
+  if (options.external) return null;
 
   try {
     const base =
       typeof window === 'undefined'
         ? 'https://tuturuuu.local'
         : window.location.origin;
-    return new URL(target, base).pathname;
+    const url = isAbsoluteHttpUrl(target)
+      ? new URL(target)
+      : new URL(target, base);
+
+    if (isAbsoluteHttpUrl(target) && url.origin !== base) return null;
+
+    return url.pathname;
   } catch {
     return target.split(/[?#]/u)[0] || target;
   }
 }
 
+function matchesNavigationTarget(
+  pathname: string,
+  target: string,
+  matchExact = false
+) {
+  const isWildcard = target.endsWith('/*');
+  const normalizedTarget = isWildcard
+    ? target.slice(0, -2).replace(/\/+$/u, '') || '/'
+    : target;
+
+  if (isWildcard) return matchesPathPrefix(pathname, normalizedTarget);
+
+  return matchExact
+    ? pathname === normalizedTarget
+    : matchesPathPrefix(pathname, normalizedTarget);
+}
+
 interface NavLinkProps {
   wsId: string;
   link: NavLinkType;
@@ -60,6 +91,9 @@ interface NavLinkProps {
   onClick: () => void;
 }
 
+const SETTINGS_DIALOG_OPEN_INTENT_EVENT =
+  'tuturuuu:settings-dialog-open-intent';
+
 export function NavLink({
   wsId,
   link,
@@ -69,8 +103,19 @@ export function NavLink({
 }: NavLinkProps) {
   const t = useTranslations();
   const pathname = usePathname();
-  const { title, icon, href, children, newTab, onClick: onLinkClick } = link;
-  const hasChildren = children && children.length > 0;
+  const {
+    title,
+    icon,
+    href,
+    children,
+    newTab,
+    onClick: onLinkClick,
+    openSettingsDialog,
+  } = link;
+  const childLinks = children?.filter((child): child is NavLinkType =>
+    Boolean(child)
+  );
+  const hasSubMenu = (childLinks?.length ?? 0) > 1;
   const [showUpgradeDialog, setShowUpgradeDialog] = useState(false);
 
   // Recursive function to check if any nested child matches the pathname
@@ -78,10 +123,12 @@ export function NavLink({
     return (
       navLinks?.some((child) => {
         const childTargets = [child?.href, ...(child?.aliases ?? [])]
-          .map(getComparablePath)
+          .map((target) =>
+            getComparablePath(target, { external: child?.external })
+          )
           .filter((target): target is string => Boolean(target));
         const childMatches = childTargets.some((target) =>
-          child?.matchExact ? pathname === target : pathname.startsWith(target)
+          matchesNavigationTarget(pathname, target, child?.matchExact)
         );
 
         if (childMatches) return true;
@@ -96,11 +143,11 @@ export function NavLink({
   };
 
   const activeTargets = [href, ...(link.aliases ?? [])]
-    .map(getComparablePath)
+    .map((target) => getComparablePath(target, { external: link.external }))
     .filter((target): target is string => Boolean(target));
   const isActive =
     activeTargets.some((target) =>
-      link.matchExact ? pathname === target : pathname.startsWith(target)
+      matchesNavigationTarget(pathname, target, link.matchExact)
     ) ||
     (children && hasActiveChild(children));
 
@@ -190,7 +237,7 @@ export function NavLink({
             </Tooltip>
           )}
 
-          {(hasChildren || archivedItems.length > 0) &&
+          {(hasSubMenu || archivedItems.length > 0) &&
             !preferenceArchiveAction &&
             !preferenceQuickAction &&
             !isDisabled && (
@@ -316,9 +363,20 @@ export function NavLink({
       }
       if (onLinkClick) {
         onLinkClick();
-      } else if (hasChildren) {
+      } else if (openSettingsDialog) {
+        event.preventDefault();
+        const detail =
+          typeof openSettingsDialog === 'object'
+            ? { settingsTab: openSettingsDialog.tab }
+            : undefined;
+
+        window.dispatchEvent(
+          new CustomEvent(SETTINGS_DIALOG_OPEN_INTENT_EVENT, { detail })
+        );
+        onClick();
+      } else if (hasSubMenu) {
         event.preventDefault();
-        onSubMenuClick(children, title);
+        onSubMenuClick(children ?? [], title);
       } else if (href) {
         if (shouldResolveQueryParamsFromConfig && !effectiveHref) {
           event.preventDefault();

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

@@ -30,6 +30,7 @@ export interface NavLink {
   tempDisabled?: boolean;
   isBack?: boolean;
   onClick?: () => void;
+  openSettingsDialog?: boolean | { tab?: string };
   children?: (NavLink | null)[];
   aliases?: string[];
   requiredWorkspaceTier?: {