rei-kit 0.1.0

package/dist/utils/date.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Local calendar-day helpers.
+ *
+ * Every function is pure and works on `YYYY-MM-DD` keys, the same shape as the
+ * `date` columns in Postgres. Nothing here calls `toISOString`: that converts to
+ * UTC, so in a UTC+9 timezone every entry made between midnight and 09:00 would
+ * be written to the previous day.
+ */
+/**
+ * Formats a `Date` as a local `YYYY-MM-DD` key.
+ *
+ * @param date - Any `Date`; only its local year, month and day are read.
+ * @returns The calendar day in the runtime's own timezone.
+ *
+ * @example
+ * ```ts
+ * // 2026-08-23 01:30 in Tokyo
+ * toDateKey(new Date())        // '2026-08-23'
+ * new Date().toISOString()     // '2026-08-22T16:30…'  ← the bug
+ * ```
+ */
+export declare function toDateKey(date: Date): string;
+/** Today's key in the user's own timezone. */
+export declare function todayKey(): string;
+/**
+ * Parses a `YYYY-MM-DD` key into a `Date` at local midnight.
+ *
+ * @param key - A key produced by {@link toDateKey}.
+ * @returns Local midnight of that calendar day.
+ * @throws If the key is not three numeric parts.
+ *
+ * @example
+ * ```ts
+ * fromDateKey('2026-08-23')      // local midnight, correct
+ * new Date('2026-08-23')         // UTC midnight — shifts a day in some zones
+ * ```
+ */
+export declare function fromDateKey(key: string): Date;
+/**
+ * Shifts a date key by whole calendar days.
+ *
+ * Uses `setDate`, which is calendar-aware: it rolls over month and year ends,
+ * and stays correct across daylight-saving transitions. Adding
+ * `days * 86_400_000` milliseconds would not — a DST day is 23 or 25 hours long.
+ *
+ * @param key - Starting `YYYY-MM-DD` key.
+ * @param days - Days to add; negative goes back.
+ * @returns The resulting key.
+ *
+ * @example
+ * ```ts
+ * addDays('2026-01-31', 1)   // '2026-02-01'
+ * addDays('2026-01-01', -1)  // '2025-12-31'
+ * addDays('2028-02-28', 1)   // '2028-02-29'  — leap year
+ * ```
+ */
+export declare function addDays(key: string, days: number): string;
+/**
+ * The last `count` days ending today, oldest first.
+ *
+ * `today` is a parameter so the function stays pure and testable; call sites
+ * normally omit it.
+ *
+ * @param count - How many days to return, including `today`.
+ * @param today - End of the range. Defaults to the real today.
+ * @returns Keys in ascending order.
+ *
+ * @example
+ * ```ts
+ * lastNDays(3, '2026-08-23')  // ['2026-08-21', '2026-08-22', '2026-08-23']
+ * ```
+ */
+export declare function lastNDays(count: number, today?: string): string[];
+/** 0 = week starts on Sunday, 1 = on Monday. Mirrors `profiles.week_starts_on`. */
+export type WeekStart = 0 | 1;
+/**
+ * The first day of the week containing `key`.
+ *
+ * The user's preference is a parameter, not a module-level setting: changing it
+ * in Profile has to re-render the week grid and the year heatmap immediately,
+ * and a global would make that a hidden dependency.
+ *
+ * @param key - Any day in the week.
+ * @param weekStartsOn - 0 for Sunday, 1 for Monday.
+ * @returns Key of that week's first day.
+ *
+ * @example
+ * ```ts
+ * // 2026-08-23 is a Sunday
+ * startOfWeek('2026-08-23', 1)  // '2026-08-17'  — previous Monday
+ * startOfWeek('2026-08-23', 0)  // '2026-08-23'  — already Sunday
+ * ```
+ */
+export declare function startOfWeek(key: string, weekStartsOn: WeekStart): string;
+/**
+ * Every day of a calendar year, in order.
+ *
+ * Leap years fall out of the loop for free: it walks day by day until the year
+ * rolls over, so February 29 is included when it exists.
+ *
+ * @param year - Four-digit year.
+ * @returns 365 or 366 keys, oldest first.
+ */
+export declare function eachDayOfYear(year: number): string[];
+/**
+ * Empty cells before a block's first day in a seven-row column grid.
+ *
+ * The grid fills column by column, so the first column is only partly used
+ * unless the block starts exactly on the week's first day. An off-by-one here
+ * shifts the whole block by a row, so this is unit tested.
+ *
+ * @param firstDayKey - First day of the block, e.g. `'2026-02-01'`.
+ * @param weekStartsOn - 0 for Sunday, 1 for Monday.
+ * @returns 0-6 blank cells.
+ *
+ * @example
+ * ```ts
+ * leadingBlanks('2026-01-01', 1)  // 3 — a Thursday, Mon-Wed are blank
+ * leadingBlanks('2024-01-01', 1)  // 0 — a Monday
+ * ```
+ */
+export declare function leadingBlanks(firstDayKey: string, weekStartsOn: WeekStart): number;

package/dist/utils/day-label.d.ts

@@ -0,0 +1,27 @@
+/** The two days worth naming rather than numbering. */
+export interface DayLabels {
+    today: string;
+    yesterday: string;
+}
+/**
+ * A short name for a day, relative to today.
+ *
+ * "Today" and "Yesterday" are worth spelling out — they are the two a user
+ * actually reaches for. Anything older gets its weekday, which inside a
+ * five-day window is unambiguous and stays two or three characters in every
+ * language.
+ *
+ * The two words are arguments rather than translated here: a library that calls
+ * `t()` forces every consumer onto one i18n setup.
+ *
+ * @param dateKey - The day to label (`YYYY-MM-DD`).
+ * @param today - Today's key, passed in so the caller controls the clock.
+ * @param labels - What to call today and yesterday.
+ *
+ * @example
+ * ```ts
+ * relativeDayLabel('2026-08-28', '2026-08-31', { today: 'Today', yesterday: 'Yesterday' })
+ * // 'Fri'
+ * ```
+ */
+export declare function relativeDayLabel(dateKey: string, today: string, labels: DayLabels): string;

package/dist/utils/download.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hands the user a file without a server round trip.
+ *
+ * @param data - Anything `JSON.stringify` can serialise.
+ * @param filename - Suggested name, e.g. `hibi-export-2026-08-24.json`.
+ */
+export declare function downloadJson(data: unknown, filename: string): void;

package/dist/utils/format.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Points every formatter at a new locale.
+ *
+ * @example
+ * ```ts
+ * setFormatLocale('tr-TR')
+ * ```
+ */
+export declare function setFormatLocale(next: string): void;
+/**
+ * Formats a date in the active locale.
+ *
+ * Reading the locale ref here is deliberate: called from a `computed`, the
+ * result re-evaluates when the language changes.
+ *
+ * @param date - Date to format.
+ * @param options - Passed straight to `Intl.DateTimeFormat`.
+ *
+ * @example
+ * ```ts
+ * formatDate(new Date(), { weekday: 'narrow' }) // 'T'
+ * ```
+ */
+export declare function formatDate(date: Date, options: Intl.DateTimeFormatOptions): string;

package/dist/utils/haptics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A short vibration for a confirmed tap.
+ *
+ * Optional chaining is not decoration: iOS Safari has no `vibrate` at all, and
+ * calling it unguarded would throw on every marked day.
+ *
+ * @param duration - Milliseconds. Keep it under ~15ms; longer reads as an alert.
+ */
+export declare function tapFeedback(duration?: number): void;

package/dist/utils/platform.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Whether the app is running from the Home Screen rather than a browser tab.
+ *
+ * Two checks because iOS predates the standard one: `display-mode: standalone`
+ * is the modern signal, `navigator.standalone` is Safari's own.
+ */
+export declare function isInstalled(): boolean;
+/** iPhone and iPad, including iPadOS reporting itself as a Mac. */
+export declare function isApplePortable(): boolean;
+/**
+ * Whether this device can only receive notifications once the app is installed.
+ *
+ * Safari on iOS grants notification permission to an installed web app and to
+ * nothing else — in a normal tab the request does not even prompt. Telling the
+ * user to allow notifications there is asking for something the browser will
+ * not offer, so the UI has to say "add to Home Screen" instead.
+ *
+ * @example
+ * ```ts
+ * if (needsIosInstall()) // show the Home Screen instruction, not the button
+ * ```
+ */
+export declare function needsIosInstall(): boolean;

package/dist/utils/redirect.d.ts

@@ -0,0 +1,41 @@
+/**
+ * What a router hands back for one query key.
+ *
+ * Inlined rather than imported from vue-router: the shape is `string | null`
+ * either way, and a helper this small should not drag a router into the
+ * package's dependencies.
+ */
+export type QueryValue = string | null;
+/**
+ * Resolves a `?redirect=` query value into a safe in-app path.
+ *
+ * Only same-origin paths are accepted. Anything else falls back to `/`,
+ * so a crafted link cannot bounce a user from the real login page to a
+ * phishing clone.
+ *
+ * Pure: takes the query value instead of reading the router, so it also
+ * works inside navigation guards and can be unit tested.
+ *
+ * @param target - Raw `route.query.redirect` value. May be a string, an
+ *   array (repeated query key), `null`, or `undefined`.
+ * @returns A path starting with a single `/`. Defaults to `/`.
+ *
+ * @example
+ * ```ts
+ * // in a view
+ * await router.push(safeRedirect(route.query.redirect))
+ *
+ * // in a guard
+ * return safeRedirect(to.query.redirect)
+ * ```
+ *
+ * @example
+ * ```ts
+ * safeRedirect('/week')              // '/week'
+ * safeRedirect('https://evil.com')   // '/'
+ * safeRedirect('//evil.com')         // '/'  (protocol-relative URL)
+ * safeRedirect(['/a', '/b'])         // '/'
+ * safeRedirect(undefined)            // '/'
+ * ```
+ */
+export declare function safeRedirect(target: QueryValue | QueryValue[] | undefined): string;

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "rei-kit",
+  "version": "0.1.0",
+  "description": "Vue 3 and Tailwind 4 design system and shared runtime. Extracted from Hibi.",
+  "license": "MIT",
+  "author": "Ramazan Doğan",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ramazandogna/rei-kit.git"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./tokens.css": "./dist/tokens.css",
+    "./styles.css": "./dist/styles.css",
+    "./supabase": {
+      "types": "./dist/supabase/index.d.ts",
+      "import": "./dist/supabase.js"
+    }
+  },
+  "engines": {
+    "node": "^22.18.0 || >=24.12.0"
+  },
+  "packageManager": "pnpm@10.34.5",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "run-s type-check build-only",
+    "build-only": "vite build",
+    "type-check": "vue-tsc --build",
+    "test:unit": "vitest",
+    "test:ci": "vitest run",
+    "lint": "run-s \"lint:*\"",
+    "lint:oxlint": "oxlint . --fix",
+    "lint:eslint": "eslint . --fix --cache",
+    "check": "run-s check:format check:lint type-check test:ci build-only",
+    "check:format": "prettier --check src/",
+    "check:lint": "run-s check:lint:*",
+    "check:lint:oxlint": "oxlint .",
+    "check:lint:eslint": "eslint .",
+    "format": "prettier --write src/",
+    "prepublishOnly": "pnpm run build"
+  },
+  "peerDependencies": {
+    "lucide-vue-next": "^1.0.0",
+    "tailwindcss": "^4.0.0",
+    "vue": "^3.5.0",
+    "vue-i18n": "^11.0.0",
+    "@supabase/supabase-js": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue-i18n": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@supabase/supabase-js": "^2.112.4",
+    "@tailwindcss/vite": "^4.3.3",
+    "@tsconfig/node24": "^24.0.5",
+    "@types/node": "^24.13.3",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "@vitest/eslint-plugin": "^1.6.27",
+    "@vue/eslint-config-typescript": "^14.9.0",
+    "@vue/test-utils": "^2.5.0",
+    "@vue/tsconfig": "^0.9.1",
+    "eslint": "^10.7.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-oxlint": "^1.80.0",
+    "eslint-plugin-vue": "^10.10.0",
+    "jiti": "^2.7.0",
+    "jsdom": "^29.1.1",
+    "lucide-vue-next": "^1.0.0",
+    "npm-run-all2": "^9.0.3",
+    "oxlint": "^1.74.0",
+    "prettier": "^3.9.5",
+    "prettier-plugin-tailwindcss": "^0.8.1",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^6.0.3",
+    "vite": "^8.1.5",
+    "vite-plugin-dts": "^5.0.3",
+    "vitest": "^4.1.10",
+    "vue": "^3.5.40",
+    "vue-eslint-parser": "^10.4.1",
+    "vue-i18n": "^11.4.10",
+    "vue-tsc": "^3.3.7"
+  }
+}