@timebraid/vue 1.4.0 → 1.6.0

package/README.md

@@ -13,7 +13,7 @@ import { TBtn, TPill, TIcon } from '@timebraid/vue'
 
 <template>
   <TBtn size="xl" icon="download">Download for macOS</TBtn>
-  <TPill :running="[{ id: '1', task: 'Logo exploration', project: 'Acme rebrand', color: 'var(--chart-1)', since: '9:12', seconds: 8047 }]" />
+  <TPill :running="[{ id: '1', task: 'Logo exploration', project: 'Acme rebrand', projectId: 'acme', color: 'var(--chart-1)', since: '9:12', seconds: 8047 }]" />
   <TIcon name="play" :size="16" />
 </template>
 ```
@@ -34,21 +34,26 @@ Import `@timebraid/tokens/styles.css` once in `main.ts` (or `@timebraid/vue/styl
 | `TSelect` | Trailing-value select with `chevrons-up-down`, used inside `TRow`; name the control with `label` (rendered visually hidden) or `ariaLabel` |
 | `TBadge` | Status pill: neutral, running, green, red, soon |
 | `TBar` | Animated value bar |
-| `TAvatar` | Initials avatar |
-| `TLargeTitle` | Large collapsing page title |
-| `TSheet` | Centred sheet on desktop, bottom sheet on phones |
+| `TAvatar` | Initials avatar; pass `src` for a photo instead |
+| `TAvatarStack` | Overlapping `TAvatar`s with a `+N` overflow count |
+| `TLargeTitle` | Large collapsing page title; `sticky` pins it above its scrolling content |
+| `TSheet` | Centred sheet on desktop, bottom sheet on phones; on phones drag the grabber, the header or, at the top of its scroll, the content to dismiss - it follows the finger and closes or springs back by release direction |
 | `TDot` | Status dot with a pulsing ring when running |
 | `TDur` | Duration readout, mono and tabular |
-| `TWaterfall` | Parallel-time waterfall timeline for reports |
-| `TPill` | The floating always-visible timer pill; the `popover` slot (scoped with `running`) replaces the popover body, and `open` is consumer-owned through `update:open` |
-| `TWorkspaceSwitcher` | Workspace picker popover |
-| `TTimerBar` | Phone bottom timer bar |
+| `TWaterfall` | Parallel-time waterfall timeline for reports, one lane per task grouped under its project; `showWs` adds a workspace tag per project |
+| `TPill` | The floating always-visible timer pill: count first, the longest timer leads; the `popover` slot (scoped with `running`) replaces the popover body, grouped by workspace then project, and `open` is consumer-owned through `update:open` |
+| `TWsIcon` | Workspace glyph: a coloured initial square, or the app mark when `all` |
+| `TWsTag` | Small workspace label, the square plus its name; appears only in the All-workspaces scope |
+| `TWorkspaceSwitcher` | Scope selector: All workspaces or one |
+| `TWorkspaceMenu` | The workspace list shared by the switcher's popover and the drawer; `embedded` drops its shadow for inline use |
+| `TWorkspaceDrawer` | Full-height phone workspace list; drag the panel to dismiss |
+| `TTimerBar` | Phone bottom timer bar: takes the full `timers` array, count first with the longest leading |
 | `TStrokes` | Oversized faded tally strokes behind sign-in and empty states |
-| `TIOSNav` | iOS large-title nav bar that collapses on scroll |
+| `TIOSNav` | iOS nav bar under the status-bar inset (`--inset-top`); the `leading` control, the large title and the `right` actions share one line and the title collapses in place on scroll |
 | `TIOSTabBar` | iOS tab bar |
-| `TAndroidTop` | Android top app bar |
+| `TAndroidTop` | Android top app bar under the status-bar inset (`--inset-top`); `sub` for a subtitle, `scrolled` for its elevated state, `title` slot to replace the text |
 | `TAndroidNavBar` | Android bottom navigation bar |
-| `TIcon` | Lucide glyph via CSS mask, follows `currentColor` |
+| `TIcon` | Bundled inline Lucide glyph, follows `currentColor` |
 | `TLogo` | The stopwatch mark, correct artwork per size; `mono` paints it in currentColor |
 | `TCodeInput` | 6-digit code entry |
 | `TAuthCard` | Sign-in layout card |
@@ -57,14 +62,7 @@ Import `@timebraid/tokens/styles.css` once in `main.ts` (or `@timebraid/vue/styl
 
 Also exported: `formatDuration(seconds, 'clock' | 'short' | 'compact')`, `PROJECT_COLORS`, `TIMEBRAID_ICON_BASE`, `DEFAULT_ICON_BASE`, `resolveTheme`, `applyTheme`, `watchTheme`, `THEME_PREFERENCES`.
 
-`TIcon` masks its glyph from `https://unpkg.com/lucide-static@latest/icons/`. Self-host the glyphs and point every icon at them in one line. An iOS WebView under `tauri://localhost` needs this, because it cannot paint a cross-origin mask:
-
-```ts
-import { TIMEBRAID_ICON_BASE } from '@timebraid/vue'
-app.provide(TIMEBRAID_ICON_BASE, '/icons/')
-```
-
-A `base` prop on a single `TIcon` still wins over the provided value.
+`TIcon` ships its glyphs: `scripts/glyphs.mjs` writes the Lucide paths for every name the products use into `packages/vue/src/icons/glyphs.ts`, and the component renders them inline in `currentColor`. Nothing is fetched at runtime. To add a glyph, add its name to `NAMES` in the script and run `pnpm glyphs`. `ICON_NAMES` and `hasIcon()` are exported so an app can assert every name it uses is bundled. A name missing from the table still masks from `TIMEBRAID_ICON_BASE` (or the `base` prop) with a dev warning, so nothing breaks while the table catches up.
 
 ## Rules
 

package/dist/index.d.ts

@@ -9,11 +9,11 @@ flat: boolean;
 plainTitle: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLElement>;
 
-declare const __VLS_component_10: DefineComponent<__VLS_Props_27, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_27> & Readonly<{}>, {
+declare const __VLS_component_10: DefineComponent<__VLS_Props_32, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_32> & Readonly<{}>, {
 width: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_11: DefineComponent<__VLS_Props_29, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_29> & Readonly<{}>, {
+declare const __VLS_component_11: DefineComponent<__VLS_Props_34, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_34> & Readonly<{}>, {
 side: "top" | "bottom" | "left" | "right";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
 
@@ -46,28 +46,31 @@ declare const __VLS_component_4: DefineComponent<__VLS_Props_8, {}, {}, {}, {},
 tone: keyof typeof TONES_2;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
 
-declare const __VLS_component_5: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const __VLS_component_5: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {
+sticky: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_6: DefineComponent<__VLS_Props_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_component_6: DefineComponent<__VLS_Props_15, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 close: () => any;
-}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_15> & Readonly<{
 onClose?: (() => any) | undefined;
 }>, {
 inline: boolean;
 width: number;
 mobile: boolean;
 teleport: boolean;
+cancelLabel: string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
 dialog: HTMLDivElement;
 }, any>;
 
-declare const __VLS_component_7: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_component_7: DefineComponent<__VLS_Props_19, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 stop: (id: string) => any;
 start: () => any;
 "update:open": (v: boolean) => any;
 stopAll: () => any;
 openApp: () => any;
-}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_19> & Readonly<{
 onStop?: ((id: string) => any) | undefined;
 onStart?: (() => any) | undefined;
 "onUpdate:open"?: ((v: boolean) => any) | undefined;
@@ -79,9 +82,11 @@ paused: boolean;
 compact: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_8: DefineComponent<__VLS_Props_20, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_20> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const __VLS_component_8: DefineComponent<__VLS_Props_25, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_25> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_9: DefineComponent<__VLS_Props_22, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_22> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const __VLS_component_9: DefineComponent<__VLS_Props_27, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_27> & Readonly<{}>, {
+scrolled: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
 declare type __VLS_Props = {
     title?: string;
@@ -94,29 +99,50 @@ declare type __VLS_Props_10 = {
     name: string;
     size?: number;
     color?: string;
+    src?: string;
 };
 
 declare type __VLS_Props_11 = {
+    people: Person[];
+    size?: number;
+    max?: number;
+};
+
+declare type __VLS_Props_12 = {
+    name: string;
+    color: string;
+};
+
+declare type __VLS_Props_13 = {
+    name?: string;
+    color?: string;
+    all?: boolean;
+    size?: number;
+};
+
+declare type __VLS_Props_14 = {
     title: string;
     sub?: string;
+    sticky?: boolean;
 };
 
-declare type __VLS_Props_12 = {
+declare type __VLS_Props_15 = {
     open: boolean;
     title: string;
     mobile?: boolean;
     width?: number;
     inline?: boolean;
     teleport?: boolean;
+    cancelLabel?: string;
 };
 
-declare type __VLS_Props_13 = {
+declare type __VLS_Props_16 = {
     color: string;
     size?: number;
     running?: boolean;
 };
 
-declare type __VLS_Props_14 = {
+declare type __VLS_Props_17 = {
     seconds: number;
     mode?: DurationFormat;
     size?: number;
@@ -124,41 +150,23 @@ declare type __VLS_Props_14 = {
     tone?: keyof typeof TONES_3;
 };
 
-declare type __VLS_Props_15 = {
-    rows: WaterfallRow[];
+declare type __VLS_Props_18 = {
+    rows: WaterfallProject[];
     start?: number;
     end?: number;
     labelW?: number;
     rowH?: number;
     compact?: boolean;
+    showWs?: boolean;
 };
 
-declare type __VLS_Props_16 = {
+declare type __VLS_Props_19 = {
     running: PillTimer[];
     compact?: boolean;
     paused?: boolean;
     open?: boolean;
 };
 
-declare type __VLS_Props_17 = {
-    workspaces: WorkspaceOption[];
-    modelValue: string;
-};
-
-declare type __VLS_Props_18 = {
-    task: string;
-    project: string;
-    color?: string;
-    seconds: number;
-    more?: number;
-    android?: boolean;
-    bottom?: number;
-};
-
-declare type __VLS_Props_19 = {
-    opacity?: number;
-};
-
 declare type __VLS_Props_2 = {
     icon?: string;
     iconBg?: string;
@@ -173,62 +181,104 @@ declare type __VLS_Props_2 = {
 };
 
 declare type __VLS_Props_20 = {
+    workspaces: WorkspaceOption[];
+    modelValue: string;
+    showAll?: boolean;
+};
+
+declare type __VLS_Props_21 = {
+    workspaces: WorkspaceOption[];
+    modelValue: string;
+    showAll?: boolean;
+    embedded?: boolean;
+};
+
+declare type __VLS_Props_22 = {
+    open: boolean;
+    workspaces: WorkspaceOption[];
+    modelValue: string;
+    showAll?: boolean;
+    teleport?: boolean;
+};
+
+declare type __VLS_Props_23 = {
+    timers: PillTimer[];
+    android?: boolean;
+    bottom?: number;
+};
+
+declare type __VLS_Props_24 = {
+    opacity?: number;
+};
+
+declare type __VLS_Props_25 = {
     title: string;
     sub?: string;
     scrolled: boolean;
 };
 
-declare type __VLS_Props_21 = {
+declare type __VLS_Props_26 = {
     items: TabItem[];
     modelValue: string;
     indicator?: boolean;
 };
 
-declare type __VLS_Props_22 = {
+declare type __VLS_Props_27 = {
     title: string;
+    sub?: string;
+    scrolled?: boolean;
 };
 
-declare type __VLS_Props_23 = {
+declare type __VLS_Props_28 = {
     items: TabItem[];
     modelValue: string;
     indicator?: boolean;
 };
 
 /**
- * Lucide glyph painted with a CSS mask so it follows currentColor.
+ * Lucide glyph rendered inline from the bundled table, so it follows currentColor and fetches nothing.
  * SUBSTITUTION: Timebraid has no icon set of its own yet; Lucide is the closest match to the mark.
  */
-declare type __VLS_Props_24 = {
-    /** Lucide kebab-case name: play, pause, square, layers, file-text… */
+declare type __VLS_Props_29 = {
+    /** Lucide kebab-case name from the bundled table: play, square, plus, folder-kanban... */
     name: string;
     /** 16 in the app, 20 in the site header, 24 in marketing rows. */
     size?: number;
     color?: string;
-    /** Where this one glyph is masked from. Wins over the `TIMEBRAID_ICON_BASE` injection key, which every app can set once with `app.provide(TIMEBRAID_ICON_BASE, '/icons/')` and which itself falls back to `https://unpkg.com/lucide-static@latest/icons/`. Self-host and provide the key in an iOS WebView, which cannot paint a cross-origin mask. */
+    /** Only for a name that is not bundled: where that one glyph is masked from. Wins over the `TIMEBRAID_ICON_BASE` injection key. Bundled names never fetch. */
     base?: string;
 };
 
+declare type __VLS_Props_3 = {
+    modelValue: string;
+    options: {
+        value: string;
+        label: string;
+    }[];
+    size?: 'sm' | 'md';
+};
+
 /** The Timebraid stopwatch from shipped artwork: the detailed PNG plate at 64px and up, the flat small mark below, the 16px PNG under 24px. `mono` paints the one-colour mark in currentColor. */
-declare type __VLS_Props_25 = {
+declare type __VLS_Props_30 = {
     size?: number;
     wordmark?: boolean;
     mono?: boolean;
 };
 
-declare type __VLS_Props_26 = {
+declare type __VLS_Props_31 = {
     modelValue?: string;
     length?: number;
     error?: string;
     autofocus?: boolean;
 };
 
-declare type __VLS_Props_27 = {
+declare type __VLS_Props_32 = {
     title: string;
     description?: string;
     width?: number;
 };
 
-declare type __VLS_Props_28 = {
+declare type __VLS_Props_33 = {
     modelValue?: boolean;
     label: string;
     description?: string;
@@ -236,22 +286,13 @@ declare type __VLS_Props_28 = {
     disabled?: boolean;
 };
 
-declare type __VLS_Props_29 = {
+declare type __VLS_Props_34 = {
     content: string;
     /** e.g. ⌘N - mono, muted, at the end. */
     shortcut?: string;
     side?: 'top' | 'bottom' | 'left' | 'right';
 };
 
-declare type __VLS_Props_3 = {
-    modelValue: string;
-    options: {
-        value: string;
-        label: string;
-    }[];
-    size?: 'sm' | 'md';
-};
-
 declare type __VLS_Props_4 = {
     kind?: keyof typeof KINDS;
     size?: keyof typeof SIZES;
@@ -396,6 +437,7 @@ declare function __VLS_template_7(): {
 declare function __VLS_template_8(): {
     attrs: Partial<{}>;
     slots: {
+        leading?(_: {}): any;
         right?(_: {}): any;
     };
     refs: {};
@@ -405,6 +447,7 @@ declare function __VLS_template_8(): {
 declare function __VLS_template_9(): {
     attrs: Partial<{}>;
     slots: {
+        title?(_: {}): any;
         right?(_: {}): any;
     };
     refs: {};
@@ -499,16 +542,26 @@ declare type __VLS_WithTemplateSlots_9<T, S> = T & {
     };
 };
 
+export declare const ALL_WORKSPACES = "all";
+
 export declare function applyTheme(root: HTMLElement, theme: ResolvedTheme): void;
 
 /** Where TIcon masks from when nothing overrides it. */
-export declare const DEFAULT_ICON_BASE = "https://unpkg.com/lucide-static@latest/icons/";
+export declare const DEFAULT_ICON_BASE = "https://unpkg.com/lucide-static@0.545.0/icons/";
 
 export declare type DurationFormat = 'clock' | 'short' | 'compact';
 
+export declare const FILLED_NAMES: ReadonlySet<string>;
+
 /** 8047 → "2:14:07" (clock) · "2:14" (short) · "2h 14m" (compact) */
 export declare function formatDuration(seconds: number, format?: DurationFormat): string;
 
+export declare function groupTimers(timers: PillTimer[]): TimerGroup[];
+
+export declare const hasIcon: (name: string) => boolean;
+
+export declare const ICON_NAMES: readonly string[];
+
 declare const KINDS: {
     readonly primary: {
         readonly background: "var(--accent)";
@@ -537,13 +590,27 @@ declare const KINDS: {
     };
 };
 
+export declare function longestTimer(timers: PillTimer[]): PillTimer | null;
+
+export declare interface Person {
+    name: string;
+    src?: string;
+    color?: string;
+}
+
 export declare interface PillTimer {
     id: string;
     task: string;
     project: string;
+    projectId: string;
     color: string;
     since: string;
     seconds: number;
+    workspace?: {
+        id: string;
+        name: string;
+        color: string;
+    };
 }
 
 /** Okabe-Ito, the only palette permitted for projects and charts. */
@@ -591,9 +658,9 @@ export declare interface TabItem {
     icon: string;
 }
 
-export declare const TAndroidNavBar: DefineComponent<__VLS_Props_23, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const TAndroidNavBar: DefineComponent<__VLS_Props_28, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (id: string) => any;
-}, string, PublicProps, Readonly<__VLS_Props_23> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_28> & Readonly<{
 "onUpdate:modelValue"?: ((id: string) => any) | undefined;
 }>, {
 indicator: boolean;
@@ -605,6 +672,11 @@ export declare const TAuthCard: __VLS_WithTemplateSlots_10<typeof __VLS_componen
 
 export declare const TAvatar: DefineComponent<__VLS_Props_10, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_10> & Readonly<{}>, {
 size: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare const TAvatarStack: DefineComponent<__VLS_Props_11, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_11> & Readonly<{}>, {
+size: number;
+max: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
 
 export declare const TBadge: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
@@ -616,9 +688,9 @@ h: number;
 
 export declare const TBtn: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
 
-export declare const TCheckbox: DefineComponent<__VLS_Props_28, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const TCheckbox: DefineComponent<__VLS_Props_33, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (v: boolean) => any;
-}, string, PublicProps, Readonly<__VLS_Props_28> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_33> & Readonly<{
 "onUpdate:modelValue"?: ((v: boolean) => any) | undefined;
 }>, {
 modelValue: boolean;
@@ -626,9 +698,9 @@ disabled: boolean;
 indeterminate: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLLabelElement>;
 
-export declare const TCodeInput: DefineComponent<__VLS_Props_26, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const TCodeInput: DefineComponent<__VLS_Props_31, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (v: string) => any;
-}, string, PublicProps, Readonly<__VLS_Props_26> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_31> & Readonly<{
 "onUpdate:modelValue"?: ((v: string) => any) | undefined;
 }>, {
 length: number;
@@ -636,12 +708,12 @@ modelValue: string;
 autofocus: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-export declare const TDot: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {
+export declare const TDot: DefineComponent<__VLS_Props_16, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_16> & Readonly<{}>, {
 size: number;
 running: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
 
-export declare const TDur: DefineComponent<__VLS_Props_14, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_14> & Readonly<{}>, {
+export declare const TDur: DefineComponent<__VLS_Props_17, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_17> & Readonly<{}>, {
 size: number;
 tone: keyof typeof TONES_3;
 mode: DurationFormat;
@@ -668,10 +740,10 @@ export declare const THEME_PREFERENCES: ThemePreference[];
 
 export declare type ThemePreference = 'system' | 'light' | 'dark';
 
-export declare const TIcon: DefineComponent<__VLS_Props_24, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_24> & Readonly<{}>, {
+export declare const TIcon: DefineComponent<__VLS_Props_29, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_29> & Readonly<{}>, {
 color: string;
 size: number;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 export declare const TIconBtn: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 click: (e: MouseEvent) => any;
@@ -686,11 +758,29 @@ tone: keyof typeof TONES;
 /** App-wide base URL every TIcon masks from: `app.provide(TIMEBRAID_ICON_BASE, '/icons/')`. */
 export declare const TIMEBRAID_ICON_BASE: InjectionKey<string>;
 
+export declare interface TimerGroup {
+    workspace: TimerWorkspace | null;
+    projects: TimerProjectGroup[];
+}
+
+export declare interface TimerProjectGroup {
+    id: string;
+    name: string;
+    color: string;
+    timers: PillTimer[];
+}
+
+export declare interface TimerWorkspace {
+    id: string;
+    name: string;
+    color: string;
+}
+
 export declare const TIOSNav: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
 
-export declare const TIOSTabBar: DefineComponent<__VLS_Props_21, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const TIOSTabBar: DefineComponent<__VLS_Props_26, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (id: string) => any;
-}, string, PublicProps, Readonly<__VLS_Props_21> & Readonly<{
+}, string, PublicProps, Readonly<__VLS_Props_26> & Readonly<{
 "onUpdate:modelValue"?: ((id: string) => any) | undefined;
 }>, {
 indicator: boolean;
@@ -698,7 +788,7 @@ indicator: boolean;
 
 export declare const TLargeTitle: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
 
-export declare const TLogo: DefineComponent<__VLS_Props_25, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_25> & Readonly<{}>, {
+export declare const TLogo: DefineComponent<__VLS_Props_30, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_30> & Readonly<{}>, {
 size: number;
 mono: boolean;
 wordmark: boolean;
@@ -768,22 +858,22 @@ disabled: boolean;
 
 export declare const TSheet: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
 
-export declare const TStrokes: DefineComponent<__VLS_Props_19, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_19> & Readonly<{}>, {
+export declare const TStrokes: DefineComponent<__VLS_Props_24, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_24> & Readonly<{}>, {
 opacity: number;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-export declare const TTimerBar: DefineComponent<__VLS_Props_18, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-stop: () => any;
+export declare const TTimerBar: DefineComponent<__VLS_Props_23, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+stop: (id: string) => any;
 open: () => any;
-}, string, PublicProps, Readonly<__VLS_Props_18> & Readonly<{
-onStop?: (() => any) | undefined;
+stopAll: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_23> & Readonly<{
+onStop?: ((id: string) => any) | undefined;
 onOpen?: (() => any) | undefined;
+onStopAll?: (() => any) | undefined;
 }>, {
-color: string;
 bottom: number;
-more: number;
 android: boolean;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
 export declare const TToggle: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:modelValue": (v: boolean) => any;
@@ -795,32 +885,83 @@ disabled: boolean;
 
 export declare const TTooltip: __VLS_WithTemplateSlots_11<typeof __VLS_component_11, __VLS_TemplateResult_11["slots"]>;
 
-export declare const TWaterfall: DefineComponent<__VLS_Props_15, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_15> & Readonly<{}>, {
+export declare const TWaterfall: DefineComponent<__VLS_Props_18, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_18> & Readonly<{}>, {
 end: number;
 start: number;
 compact: boolean;
 labelW: number;
 rowH: number;
+showWs: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-export declare const TWorkspaceSwitcher: DefineComponent<__VLS_Props_17, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+export declare const TWorkspaceDrawer: DefineComponent<__VLS_Props_22, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+help: () => any;
 "update:modelValue": (id: string) => any;
+close: () => any;
 create: () => any;
-}, string, PublicProps, Readonly<__VLS_Props_17> & Readonly<{
+preferences: () => any;
+actions: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_22> & Readonly<{
+onHelp?: (() => any) | undefined;
 "onUpdate:modelValue"?: ((id: string) => any) | undefined;
+onClose?: (() => any) | undefined;
 onCreate?: (() => any) | undefined;
-}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
+onPreferences?: (() => any) | undefined;
+onActions?: (() => any) | undefined;
+}>, {
+teleport: boolean;
+showAll: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare const TWorkspaceMenu: DefineComponent<__VLS_Props_21, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:modelValue": (id: string) => any;
+create: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_21> & Readonly<{
+"onUpdate:modelValue"?: ((id: string) => any) | undefined;
+onCreate?: (() => any) | undefined;
+}>, {
+showAll: boolean;
+embedded: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+
+export declare const TWorkspaceSwitcher: DefineComponent<__VLS_Props_20, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:modelValue": (id: string) => any;
+create: () => any;
+}, string, PublicProps, Readonly<__VLS_Props_20> & Readonly<{
+"onUpdate:modelValue"?: ((id: string) => any) | undefined;
+onCreate?: (() => any) | undefined;
+}>, {
+showAll: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
 root: HTMLDivElement;
 }, HTMLDivElement>;
 
+export declare const TWsIcon: DefineComponent<__VLS_Props_13, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_13> & Readonly<{}>, {
+color: string;
+name: string;
+size: number;
+all: boolean;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+export declare const TWsTag: DefineComponent<__VLS_Props_12, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_12> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLSpanElement>;
+
 export declare function watchTheme(pref: () => ThemePreference, root: HTMLElement, media?: MediaQueryList | null): {
     refresh(): void;
     stop(): void;
 };
 
+export declare interface WaterfallProject {
+    project: string;
+    color: string;
+    ws?: {
+        name: string;
+        color: string;
+    };
+    tasks: WaterfallRow[];
+}
+
 export declare interface WaterfallRow {
     label: string;
-    color: string;
     segments: WaterfallSegment[];
 }
 
@@ -835,6 +976,7 @@ export declare interface WorkspaceOption {
     name: string;
     color: string;
     memberCount: number;
+    projectCount?: number;
     isDefault: boolean;
     personal: boolean;
 }