super-time-tracker-ui 0.1.2

package/lib/use_week_starts_on.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { week_starts_on_preference } from '@/lib/preferences/week_starts_on_preference'
+import { type WeekStartsOn } from '@/lib/types/ui_preferences'
+
+/**
+ * Subscribes to the week-starts-on preference.
+ */
+export function use_week_starts_on(): WeekStartsOn {
+  return useSyncExternalStore(
+    week_starts_on_preference.subscribe,
+    week_starts_on_preference.get_snapshot,
+    week_starts_on_preference.get_server_snapshot,
+  )
+}

package/lib/validate_entry_times.ts

@@ -0,0 +1,12 @@
+/**
+ * Ensures a completed entry has a start time strictly before its end time.
+ */
+export function validate_entry_times(start: Date, end: Date | null): void {
+  if (end === null) {
+    return;
+  }
+
+  if (+start >= +end) {
+    throw new Error("Start must be before end");
+  }
+}

package/lib/week_starts_on_to_index.ts

@@ -0,0 +1,8 @@
+import { type WeekStartsOn } from '@/lib/types/ui_preferences'
+
+/**
+ * Maps the week-starts-on preference to a date-fns week start index.
+ */
+export function week_starts_on_to_index(value: WeekStartsOn): 0 | 1 {
+  return value === 'sunday' ? 0 : 1
+}

package/lib/write_active_sheet_preference.ts

@@ -0,0 +1,28 @@
+import {
+  ACTIVE_SHEET_COOKIE_NAME,
+  ACTIVE_SHEET_STORAGE_KEY,
+} from '@/lib/types/ui_settings'
+
+/**
+ * Persists the last opened sheet in localStorage and a cookie for SSR reloads.
+ */
+export function write_active_sheet_preference(sheet_name: string): void {
+  const trimmed = sheet_name.trim()
+
+  if (trimmed.length === 0) {
+    return
+  }
+
+  try {
+    window.localStorage.setItem(ACTIVE_SHEET_STORAGE_KEY, trimmed)
+  } catch {
+    // Ignore storage failures in private browsing.
+  }
+
+  try {
+    const encoded = encodeURIComponent(trimmed)
+    document.cookie = `${ACTIVE_SHEET_COOKIE_NAME}=${encoded}; Path=/; Max-Age=31536000; SameSite=Lax`
+  } catch {
+    // Ignore cookie failures.
+  }
+}

package/lib/write_db.ts

@@ -0,0 +1,20 @@
+import { promises as fs } from "node:fs";
+
+import { DB_PATH } from "@/lib/config";
+import { type TimeTrackerDB } from "@/lib/types";
+
+/**
+ * Persists the in-memory database to disk as JSON.
+ */
+export async function write_db(
+  db: TimeTrackerDB,
+  db_path: string = DB_PATH,
+): Promise<void> {
+  const db_json = JSON.stringify(db);
+
+  try {
+    await fs.writeFile(db_path, db_json);
+  } catch (err: unknown) {
+    throw new Error(`Failed to save DB: ${String(err)}`, { cause: err });
+  }
+}

package/lib/write_sheet_tag_filter.ts

@@ -0,0 +1,20 @@
+import { read_stored_sheet_tag_filters } from '@/lib/read_stored_sheet_tag_filters'
+import { write_stored_sheet_tag_filters } from '@/lib/write_stored_sheet_tag_filters'
+
+/**
+ * Updates one sheet's tag filter list in localStorage.
+ */
+export function write_sheet_tag_filter(
+  sheet_name: string,
+  filter_tags: string[],
+): void {
+  const filters = read_stored_sheet_tag_filters()
+
+  if (filter_tags.length === 0) {
+    delete filters[sheet_name]
+  } else {
+    filters[sheet_name] = filter_tags
+  }
+
+  write_stored_sheet_tag_filters(filters)
+}

package/lib/write_stored_compact_lists.ts

@@ -0,0 +1,15 @@
+import { COMPACT_LISTS_STORAGE_KEY } from "@/lib/types/ui_settings";
+
+/**
+ * Persists the compact lists setting to localStorage.
+ */
+export function write_stored_compact_lists(enabled: boolean): void {
+  try {
+    window.localStorage.setItem(
+      COMPACT_LISTS_STORAGE_KEY,
+      enabled ? "true" : "false",
+    );
+  } catch {
+    // Ignore storage failures in private browsing.
+  }
+}

package/lib/write_stored_default_sheet_fixed_name.ts

@@ -0,0 +1,28 @@
+import {
+  DEFAULT_SHEET_FIXED_NAME_COOKIE_NAME,
+  DEFAULT_SHEET_FIXED_NAME_STORAGE_KEY,
+} from '@/lib/types/ui_settings'
+
+/**
+ * Persists the fixed default sheet name in localStorage and a cookie.
+ */
+export function write_stored_default_sheet_fixed_name(sheet_name: string): void {
+  const trimmed = sheet_name.trim()
+
+  if (trimmed.length === 0) {
+    return
+  }
+
+  try {
+    window.localStorage.setItem(DEFAULT_SHEET_FIXED_NAME_STORAGE_KEY, trimmed)
+  } catch {
+    // Ignore storage failures in private browsing.
+  }
+
+  try {
+    const encoded = encodeURIComponent(trimmed)
+    document.cookie = `${DEFAULT_SHEET_FIXED_NAME_COOKIE_NAME}=${encoded}; Path=/; Max-Age=31536000; SameSite=Lax`
+  } catch {
+    // Ignore cookie failures.
+  }
+}

package/lib/write_stored_default_sheet_session_mode.ts

@@ -0,0 +1,24 @@
+import { type DefaultSheetSessionMode } from '@/lib/types/ui_settings'
+import {
+  DEFAULT_SHEET_SESSION_MODE_COOKIE_NAME,
+  DEFAULT_SHEET_SESSION_MODE_STORAGE_KEY,
+} from '@/lib/types/ui_settings'
+
+/**
+ * Persists the default sheet session mode in localStorage and a cookie.
+ */
+export function write_stored_default_sheet_session_mode(
+  mode: DefaultSheetSessionMode,
+): void {
+  try {
+    window.localStorage.setItem(DEFAULT_SHEET_SESSION_MODE_STORAGE_KEY, mode)
+  } catch {
+    // Ignore storage failures in private browsing.
+  }
+
+  try {
+    document.cookie = `${DEFAULT_SHEET_SESSION_MODE_COOKIE_NAME}=${mode}; Path=/; Max-Age=31536000; SameSite=Lax`
+  } catch {
+    // Ignore cookie failures.
+  }
+}

package/lib/write_stored_sheet_tag_filters.ts

@@ -0,0 +1,18 @@
+import { read_stored_sheet_tag_filters } from '@/lib/read_stored_sheet_tag_filters'
+import { SHEET_TAG_FILTERS_STORAGE_KEY } from '@/lib/types/ui_settings'
+
+/**
+ * Persists per-sheet tag filter selections to localStorage.
+ */
+export function write_stored_sheet_tag_filters(
+  filters: Record<string, string[]>,
+): void {
+  try {
+    window.localStorage.setItem(
+      SHEET_TAG_FILTERS_STORAGE_KEY,
+      JSON.stringify(filters),
+    )
+  } catch {
+    // Ignore storage failures in private browsing.
+  }
+}

package/lib/write_stored_theme.ts

@@ -0,0 +1,12 @@
+import { THEME_STORAGE_KEY, type Theme } from "@/lib/types/theme";
+
+/**
+ * Persists the active theme to localStorage.
+ */
+export function write_stored_theme(theme: Theme): void {
+  try {
+    window.localStorage.setItem(THEME_STORAGE_KEY, theme);
+  } catch {
+    // Storage may be unavailable in private browsing or restricted contexts.
+  }
+}

package/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  output: 'standalone',
+}
+
+export default nextConfig;

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "super-time-tracker-ui",
+  "version": "0.1.2",
+  "description": "Web UI for the super-time-tracker CLI time sheets",
+  "keywords": [
+    "nextjs",
+    "react",
+    "time-tracking",
+    "timesheet",
+    "super-time-tracker",
+    "ui"
+  ],
+  "homepage": "https://github.com/f3rnox/super-time-tracker-ui",
+  "bugs": {
+    "url": "https://github.com/f3rnox/super-time-tracker-ui/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/f3rnox/super-time-tracker-ui.git"
+  },
+  "license": "MIT",
+  "author": "Cris Mihalache <f3rnox42@gmail.com>",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "stt-ui": "./bin/stt-ui.js"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "stt-ui": "node bin/stt-ui.js",
+    "format": "pnpm format:prettier",
+    "format:check": "pnpm format:prettier:check",
+    "format:prettier": "prettier --write .",
+    "format:prettier:check": "prettier --check .",
+    "lint": "pnpm lint:markdownlint && pnpm lint:eslint",
+    "lint:eslint": "eslint package.json src/**/*",
+    "lint:eslint:fix": "eslint package.json src/**/*",
+    "lint:fix": "pnpm lint:markdownlint:fix && pnpm lint:eslint:fix",
+    "lint:markdownlint": "markdownlint README.md",
+    "lint:markdownlint:fix": "markdownlint --fix README.md",
+    "prepare": "husky",
+    "prepare-release": "pnpm build && git add docs",
+    "prepublish": "pnpm build",
+    "release": "pnpm prepare-release && pnpm update-version && git push --follow-tags origin main",
+    "serve:coverage": "http-server ./coverage",
+    "serve:docs": "http-server ./docs",
+    "test": "NODE_PATH=./src NODE_ENV=test vitest run",
+    "update-deps": "updates -u -g -c",
+    "update-version": "standard-version -a"
+  },
+  "dependencies": {
+    "date-fns": "^4.2.1",
+    "humanize-duration": "^3.33.2",
+    "next": "16.2.6",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "time-speak": "^1.9.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/humanize-duration": "^3.27.4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.6",
+    "tailwindcss": "^4",
+    "typescript": "^5",
+    "@commitlint/cli": "^20.5.0",
+    "@commitlint/config-conventional": "^20.5.0",
+    "@commitlint/format": "^20.5.0",
+    "@commitlint/types": "^20.5.0",
+    "@eslint/js": "^10.0.1",
+    "@istanbuljs/nyc-config-typescript": "^1.0.2",
+    "globals": "^17.4.0",
+    "http-server": "^14.1.1",
+    "husky": "^9.1.7",
+    "jiti": "^2.6.1",
+    "lint-staged": "^16.4.0",
+    "markdownlint-cli": "^0.48.0",
+    "nyc": "^18.0.0",
+    "prettier": "^3.8.1",
+    "remark": "^15.0.1",
+    "standard-version": "^9.5.0",
+    "ts-node": "^10.9.2",
+    "tslib": "^2.8.1",
+    "tsx": "^4.21.0",
+    "typedoc": "^0.28.18",
+    "typescript-eslint": "^8.58.0",
+    "updates": "^17.13.5",
+    "vitest": "^4.1.2"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,7 @@
+allowBuilds:
+  esbuild: false
+  sharp: false
+  unrs-resolver: false
+ignoredBuiltDependencies:
+  - sharp
+  - unrs-resolver

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}