dsh-offwork 1.0.0 → 1.1.0

package/clock.js

@@ -5,37 +5,48 @@ export function calculate(settings, timestamp = Date.now()) {
   if (!Number.isFinite(now)) throw new RangeError('Invalid timestamp');
   const DAY = 86400000;
   const formatter = new Intl.DateTimeFormat('en-CA', {
-    timeZone: settings.timezone, year: 'numeric', month: '2-digit', day: '2-digit',
-    hour: '2-digit', minute: '2-digit', second: '2-digit', hourCycle: 'h23',
+    timeZone: settings.timezone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
   });
-  const civil = time => {
-    const p = Object.fromEntries(formatter.formatToParts(time).map(p => [p.type, p.value]));
+  const civil = (time) => {
+    const p = Object.fromEntries(formatter.formatToParts(time).map((p) => [p.type, p.value]));
     return Date.UTC(+p.year, +p.month - 1, +p.day, +p.hour, +p.minute, +p.second);
   };
   // Convert a timezone-local civil time to an absolute instant. At DST overlaps use
   // the earlier occurrence; at gaps move forward by the gap (Temporal-compatible).
-  const instant = local => {
-    const offsets = [...new Set([-DAY, 0, DAY].map(delta => civil(local + delta) - (local + delta)))];
-    const candidates = offsets.map(offset => local - offset);
-    const exact = candidates.filter(time => civil(time) === local);
+  const instant = (local) => {
+    const offsets = [
+      ...new Set([-DAY, 0, DAY].map((delta) => civil(local + delta) - (local + delta))),
+    ];
+    const candidates = offsets.map((offset) => local - offset);
+    const exact = candidates.filter((time) => civil(time) === local);
     if (exact.length) return Math.min(...exact);
-    const after = candidates.filter(time => civil(time) >= local);
+    const after = candidates.filter((time) => civil(time) >= local);
     return Math.min(...(after.length ? after : candidates));
   };
-  const minute = text => {
+  const minute = (text) => {
     if (typeof text !== 'string' || !/^(?:[01]\d|2[0-3]):[0-5]\d$/.test(text)) {
       throw new RangeError('Shift times must be HH:mm');
     }
     const [h, m] = text.split(':').map(Number);
     return h * 60 + m;
   };
-  const start = minute(settings.start), end = minute(settings.end);
+  const start = minute(settings.start),
+    end = minute(settings.end);
   if (start === end) throw new RangeError('Shift must not be empty');
   const overnight = end < start;
   const duration = (end - start + 1440) % 1440;
-  let breakOffset = 0, breakDuration = 0;
+  let breakOffset = 0,
+    breakDuration = 0;
   if (settings.breakStart != null || settings.breakEnd != null) {
-    const bs = minute(settings.breakStart), be = minute(settings.breakEnd);
+    const bs = minute(settings.breakStart),
+      be = minute(settings.breakEnd);
     if (bs !== be) {
       breakOffset = (bs - start + 1440) % 1440;
       breakDuration = (be - bs + 1440) % 1440;
@@ -47,7 +58,7 @@ export function calculate(settings, timestamp = Date.now()) {
   const localNow = civil(now);
   const today = Math.floor(localNow / DAY) * DAY;
   const minuteNow = (localNow - today) / 60000;
-  const workday = day => settings.weekdays.includes(new Date(day).getUTCDay());
+  const workday = (day) => settings.weekdays.includes(new Date(day).getUTCDay());
   let shiftDay = today;
   if (overnight && minuteNow < start) {
     // Retain yesterday's finished work shift until the next shift starts. If
@@ -58,46 +69,82 @@ export function calculate(settings, timestamp = Date.now()) {
   const shiftStart = instant(shiftDay + start * 60000);
   const shiftEnd = instant(shiftDay + (start + duration) * 60000);
   const breakStart = breakDuration ? instant(shiftDay + (start + breakOffset) * 60000) : null;
-  const breakEnd = breakDuration ? instant(shiftDay + (start + breakOffset + breakDuration) * 60000) : null;
+  const breakEnd = breakDuration
+    ? instant(shiftDay + (start + breakOffset + breakDuration) * 60000)
+    : null;
   const breakMs = breakDuration ? breakEnd - breakStart : 0;
   const totalMs = shiftEnd - shiftStart - breakMs;
   if (totalMs <= 0 || breakMs < 0) throw new RangeError('Shift has no paid duration');
   const clampedNow = Math.max(shiftStart, Math.min(now, shiftEnd));
-  const elapsedMs = isWorkday ? Math.max(0, Math.min(totalMs,
-    clampedNow - shiftStart - (breakDuration ? Math.max(0, Math.min(clampedNow, breakEnd) - breakStart) : 0))) : 0;
-  const status = !isWorkday ? 'rest' : now < shiftStart ? 'before' : now >= shiftEnd ? 'done'
-    : breakDuration && now >= breakStart && now < breakEnd ? 'lunch' : 'working';
+  const elapsedMs = isWorkday
+    ? Math.max(
+        0,
+        Math.min(
+          totalMs,
+          clampedNow -
+            shiftStart -
+            (breakDuration ? Math.max(0, Math.min(clampedNow, breakEnd) - breakStart) : 0),
+        ),
+      )
+    : 0;
+  const status = !isWorkday
+    ? 'rest'
+    : now < shiftStart
+      ? 'before'
+      : now >= shiftEnd
+        ? 'done'
+        : breakDuration && now >= breakStart && now < breakEnd
+          ? 'lunch'
+          : 'working';
   // Decimal inputs become exact rational numbers before truncation. Never use
   // floor((salary / days * progress) * 100): binary rounding loses whole cents.
-  const rational = number => {
-    if (typeof number !== 'number' || !Number.isFinite(number) || number < 0) throw new RangeError('Invalid salary');
+  const rational = (number) => {
+    if (typeof number !== 'number' || !Number.isFinite(number) || number < 0)
+      throw new RangeError('Invalid salary');
     const [mantissa, exponent = '0'] = String(number).toLowerCase().split('e');
     const [integer, fraction = ''] = mantissa.split('.');
     const scale = fraction.length - Number(exponent);
-    return scale >= 0 ? [BigInt(integer + fraction), 10n ** BigInt(scale)]
+    return scale >= 0
+      ? [BigInt(integer + fraction), 10n ** BigInt(scale)]
       : [BigInt(integer + fraction) * 10n ** BigInt(-scale), 1n];
   };
   const payMode = settings.payMode === 'daily' ? 'daily' : 'monthly';
-  let [numerator, denominator] = rational(payMode === 'daily' ? settings.dailySalary : settings.monthlySalary);
+  let [numerator, denominator] = rational(
+    payMode === 'daily' ? settings.dailySalary : settings.monthlySalary,
+  );
   if (payMode === 'monthly') {
     const [daysN, daysD] = rational(settings.workdaysPerMonth);
     if (daysN === 0n) throw new RangeError('Workdays per month must be positive');
     numerator *= daysD;
     denominator *= daysN;
   }
-  const dailyCents = Number(numerator * 100n / denominator);
-  const earnedCents = Math.min(dailyCents, Number(numerator * 100n * BigInt(Math.floor(elapsedMs)) /
-    (denominator * BigInt(totalMs))));
-  const hourlyCents = Number(numerator * 100n * 3600000n / (denominator * BigInt(totalMs)));
-  const dateString = day => new Date(day).toISOString().slice(0, 10);
+  const dailyCents = Number((numerator * 100n) / denominator);
+  const earnedCents = Math.min(
+    dailyCents,
+    Number((numerator * 100n * BigInt(Math.floor(elapsedMs))) / (denominator * BigInt(totalMs))),
+  );
+  const hourlyCents = Number((numerator * 100n * 3600000n) / (denominator * BigInt(totalMs)));
+  const dateString = (day) => new Date(day).toISOString().slice(0, 10);
   return {
-    status, remaining: isWorkday ? Math.max(0, Math.ceil((shiftEnd - now) / 1000)) : 0,
+    status,
+    remaining: isWorkday ? Math.max(0, Math.ceil((shiftEnd - now) / 1000)) : 0,
     startRemaining: status === 'before' ? Math.max(0, Math.ceil((shiftStart - now) / 1000)) : 0,
     progress: elapsedMs / totalMs,
-    earned: earnedCents / 100, daily: dailyCents / 100, hourly: hourlyCents / 100,
-    date: dateString(today), shiftDate: dateString(shiftDay),
-    earnedCents, dailyCents, payMode, isWorkday, overnight,
-    shiftStart, shiftEnd, breakStart, breakEnd,
-    elapsed: elapsedMs / 1000, total: totalMs / 1000,
+    earned: earnedCents / 100,
+    daily: dailyCents / 100,
+    hourly: hourlyCents / 100,
+    date: dateString(today),
+    shiftDate: dateString(shiftDay),
+    earnedCents,
+    dailyCents,
+    payMode,
+    isWorkday,
+    overnight,
+    shiftStart,
+    shiftEnd,
+    breakStart,
+    breakEnd,
+    elapsed: elapsedMs / 1000,
+    total: totalMs / 1000,
   };
 }

package/companion.js

@@ -0,0 +1,185 @@
+// Presentation only: no clocks, storage, salary data or reminder side effects.
+export function companionPresentation({
+  workStatus,
+  phase,
+  ownsPrompt = false,
+  ready = true,
+  failed = false,
+  feedback = null,
+  visible = true,
+  motion = true,
+  pageVisible = true,
+}) {
+  if (!visible)
+    return { visible: false, pose: 'calm', message: null, announce: false, animate: false };
+  let pose = 'calm';
+  let message = 'companionWorking';
+  const quiet =
+    ['quiet', 'paused'].includes(phase) && !['before', 'done', 'rest'].includes(workStatus);
+  const resting = ['lunch', 'rest', 'done', 'before'].includes(workStatus);
+  if (!ready) {
+    pose = 'rest';
+    message = 'companionLoading';
+  } else if (failed) {
+    pose = 'offline';
+    message = 'companionUnavailable';
+  } else if (quiet) {
+    pose = 'quiet';
+    message = phase === 'quiet' ? 'companionQuiet' : 'companionPaused';
+  } else if (workStatus === 'lunch') {
+    pose = 'rest';
+    message = 'companionBreak';
+  } else if (workStatus === 'rest') {
+    pose = 'rest';
+    message = 'companionDayOff';
+  } else if (workStatus === 'done') {
+    pose = 'happy';
+    message = 'companionDone';
+  } else if (workStatus === 'before') {
+    pose = 'rest';
+    message = 'companionBefore';
+  } else if (phase === 'due' && ownsPrompt) {
+    // The existing leased reminder is the only source of the due message.
+    pose = 'drink';
+    message = null;
+  }
+  let announce = false;
+  let animate = false;
+  if (ready && !failed && !(phase === 'due' && ownsPrompt) && feedback) {
+    message = feedback.key;
+    announce = true;
+    if (feedback.kind === 'drink' && !quiet && !resting) {
+      pose = 'happy';
+      animate = motion && pageVisible;
+    }
+  }
+  return { visible: true, pose, message, announce, animate };
+}
+
+// Original vector character. Its art is decorative; controls and status text
+// provide the accessible names. Stable keys prevent the 1-second clock tick
+// from replaying the reaction animation.
+export function companionArtwork(h, presentation, size = 40, reaction = '') {
+  const { pose, animate } = presentation;
+  const asleep = ['rest', 'quiet'].includes(pose);
+  const path = (d, props = {}) => h('path', { d, ...props });
+  return h(
+    'svg',
+    {
+      key: pose + ':' + reaction,
+      className: 'owc-companion-art',
+      viewBox: '0 0 64 64',
+      width: size,
+      height: size,
+      'aria-hidden': 'true',
+      focusable: 'false',
+      'data-pose': pose,
+      'data-animate': animate,
+    },
+    h('ellipse', { cx: 32, cy: 58, rx: 19, ry: 3, className: 'owc-companion-shadow' }),
+    h(
+      'g',
+      { className: 'owc-companion-body' },
+      path('M32 7C28 18 12 28 12 42C12 54 21 58 32 58S52 54 52 42C52 28 36 18 32 7Z', {
+        className: 'owc-companion-skin',
+      }),
+      path('M25 21C21 25 18 29 17 34', { className: 'owc-companion-shine' }),
+      h(
+        'g',
+        { className: 'owc-companion-face' },
+        asleep
+          ? path('M21 38Q24 41 27 38M37 38Q40 41 43 38')
+          : h(
+              'g',
+              null,
+              h('circle', { cx: 24, cy: 38, r: 1.7, fill: 'currentColor', stroke: 'none' }),
+              h('circle', { cx: 40, cy: 38, r: 1.7, fill: 'currentColor', stroke: 'none' }),
+            ),
+        path(
+          pose === 'happy'
+            ? 'M27 44Q32 51 37 44Z'
+            : pose === 'offline'
+              ? 'M29 46H35'
+              : 'M28 45Q32 49 36 45',
+        ),
+      ),
+      h(
+        'g',
+        { className: 'owc-companion-cheeks' },
+        h('ellipse', { cx: 20, cy: 44, rx: 3, ry: 1.6 }),
+        h('ellipse', { cx: 44, cy: 44, rx: 3, ry: 1.6 }),
+      ),
+      pose === 'happy' && path('M12 44L7 38M52 44L57 38', { className: 'owc-companion-limbs' }),
+      pose === 'drink' &&
+        h(
+          'g',
+          { className: 'owc-companion-cup' },
+          path('M43 41H55L53 54H45Z'),
+          path('M55 43H58Q62 47 55 49', { fill: 'none' }),
+        ),
+      pose === 'quiet' && path('M45 16H51L45 22H51', { className: 'owc-companion-limbs' }),
+    ),
+  );
+}
+
+export const COMPANION_MESSAGES = {
+  zh: {
+    companionName: '小歇',
+    companionLabel: '下班搭子',
+    companionOpen: '打开小歇的快捷操作',
+    companionShow: '显示陪伴角色',
+    companionMotion: '角色动作反馈',
+    companionPreferences: '立即生效，保存在本浏览器。隐藏角色后仍可使用计时和喝水操作。',
+    companionWorking: '你忙你的，我陪你记着时间。',
+    companionQuiet: '好，先安静陪着你。',
+    companionPaused: '本班先不提醒，需要时再叫我。',
+    companionBreak: '休息一下，回来再继续。',
+    companionBefore: '还没开工，先慢慢准备。',
+    companionDone: '这一班结束啦，辛苦了。',
+    companionDayOff: '今天歇一歇，按自己的节奏来。',
+    companionLoading: '稍等，我看看现在的状态。',
+    companionUnavailable: '暂时读不到提醒状态，可以重试读取。',
+  },
+  en: {
+    companionName: 'Xiaoxie',
+    companionLabel: 'Your workday companion',
+    companionOpen: 'Open companion quick actions',
+    companionShow: 'Show companion',
+    companionMotion: 'Character reactions',
+    companionPreferences:
+      'Applies immediately in this browser. Timers and water actions work with the character hidden.',
+    companionWorking: 'Carry on. I’ll keep an eye on the time.',
+    companionQuiet: 'I’ll keep you company quietly.',
+    companionPaused: 'Reminders are paused. Resume whenever you like.',
+    companionBreak: 'Take a break. We can carry on afterward.',
+    companionBefore: 'No rush. Your shift hasn’t started yet.',
+    companionDone: 'That’s your shift done. Take a breather.',
+    companionDayOff: 'A day off. Enjoy your own pace.',
+    companionLoading: 'One moment while I check the status.',
+    companionUnavailable: 'I can’t read reminder status. You can retry loading.',
+  },
+};
+
+export const COMPANION_STYLE = `
+.owc-sr-only{position:absolute!important;width:1px;height:1px;padding:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap}
+.owc-mini-feedback{margin:0;padding:0 14px 9px;max-width:260px;font-size:11px;line-height:1.6;overflow-wrap:anywhere}
+.owc-companion{display:flex;align-items:center;gap:10px;padding:12px 17px 8px;cursor:default}
+.owc-companion-copy{min-width:0;flex:1}
+.owc-companion-name{display:flex;align-items:center;gap:6px;font-size:11px;color:var(--dsw-alias-label-secondary);font-weight:600}
+.owc-companion-name span{font-size:10px;font-weight:400}
+.owc-companion p{margin:5px 0 0;font-size:12px;line-height:1.65;overflow-wrap:anywhere}
+.owc-water .owc-companion{padding:4px 0 8px;border-bottom:1px solid color-mix(in srgb,var(--owc-accent) 10%,transparent);margin-bottom:8px}
+.owc-v2 button.owc-companion-trigger{padding:0;flex:none;min-width:36px;min-height:36px;border-radius:12px}
+.owc-companion-art{flex:none;overflow:visible;color:var(--owc-accent);pointer-events:none}
+.owc-companion-shadow{fill:currentColor;opacity:.12}
+.owc-companion-skin{fill:color-mix(in srgb,var(--owc-accent) 22%,var(--dsw-alias-bg-overlay));stroke:currentColor;stroke-width:1.6;stroke-linejoin:round}
+.owc-companion-shine{fill:none;stroke:white;stroke-width:2.5;stroke-linecap:round;opacity:.75}
+.owc-companion-face{color:var(--dsw-alias-label-primary);fill:none;stroke:currentColor;stroke-width:1.6;stroke-linecap:round;stroke-linejoin:round}
+.owc-companion-cheeks{fill:#ef8d96;opacity:.5}
+.owc-companion-limbs{fill:none;stroke:currentColor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}
+.owc-companion-cup{fill:var(--dsw-alias-bg-overlay);stroke:currentColor;stroke-width:1.6;stroke-linejoin:round}
+.owc-companion-art[data-pose=offline]{opacity:.65}
+.owc-companion-art[data-animate=true] .owc-companion-body{transform-origin:32px 52px;animation:owc-companion-thanks .65s ease-in-out 2}
+@keyframes owc-companion-thanks{0%,100%{transform:translateY(0) rotate(0)}40%{transform:translateY(-2px) rotate(-3deg)}70%{transform:translateY(0) rotate(2deg)}}
+@media(prefers-reduced-motion:reduce){.owc-companion-art *{animation:none!important;transition:none!important}}
+`;

package/hydration-store.js

@@ -0,0 +1,101 @@
+import { defaultHydration, validateHydration } from './hydration.js';
+
+// A single IndexedDB read/write transaction is the cross-tab mutex. Neither
+// notification delivery nor localStorage read-back is used as an atomic lock.
+export function createHydrationStore(indexedDB, name = 'dsh.offwork-clock.hydration.v1') {
+  let database = null;
+  let opening = null;
+  let closed = false;
+  const open = () => {
+    if (closed) return Promise.reject(new Error('Hydration store closed'));
+    if (database) return Promise.resolve(database);
+    if (opening) return opening;
+    opening = new Promise((resolve, reject) => {
+      let abandoned = false;
+      const fail = (error) => {
+        abandoned = true;
+        reject(error);
+      };
+      if (!indexedDB) {
+        reject(new Error('Hydration storage unavailable'));
+        return;
+      }
+      const request = indexedDB.open(name, 1);
+      request.onupgradeneeded = () => request.result.createObjectStore('state');
+      request.onerror = () => fail(request.error ?? new Error('Hydration storage unavailable'));
+      request.onblocked = () => fail(new Error('Hydration storage blocked'));
+      request.onsuccess = () => {
+        if (closed || abandoned) {
+          request.result.close();
+          reject(new Error('Hydration store closed'));
+          return;
+        }
+        database = request.result;
+        database.onversionchange = () => {
+          database.close();
+          database = null;
+          opening = null;
+        };
+        database.onclose = () => {
+          database = null;
+          opening = null;
+        };
+        resolve(database);
+      };
+    }).catch((error) => {
+      opening = null;
+      throw error;
+    });
+    return opening;
+  };
+  return {
+    async update(reducer, { reset = false } = {}) {
+      const db = await open();
+      if (closed) throw new Error('Hydration store closed');
+      return new Promise((resolve, reject) => {
+        const transaction = db.transaction('state', 'readwrite');
+        const store = transaction.objectStore('state');
+        const request = store.get('current');
+        let output;
+        let failure;
+        request.onsuccess = () => {
+          try {
+            const current =
+              reset || request.result === undefined
+                ? defaultHydration()
+                : validateHydration(request.result);
+            const next = validateHydration(reducer(structuredClone(current)));
+            const changed = JSON.stringify(next) !== JSON.stringify(current);
+            const migrated =
+              request.result !== undefined && request.result.schema !== current.schema;
+            if (reset || changed || migrated) {
+              const previousRevision =
+                Number.isSafeInteger(request.result?.revision) && request.result.revision >= 0
+                  ? request.result.revision
+                  : current.revision;
+              next.revision = previousRevision + 1;
+              if (!Number.isSafeInteger(next.revision))
+                throw new Error('Hydration revision exhausted');
+              store.put(next, 'current');
+            }
+            output = next;
+          } catch (error) {
+            failure = error;
+            transaction.abort();
+          }
+        };
+        transaction.oncomplete = () => resolve(output);
+        transaction.onabort = () =>
+          reject(failure ?? transaction.error ?? new Error('Hydration transaction aborted'));
+        transaction.onerror = () => {
+          /* onabort reports the failure once. */
+        };
+      });
+    },
+    close() {
+      closed = true;
+      database?.close();
+      database = null;
+    },
+  };
+}