picocrank 1.28.2 → 1.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "picocrank",
-  "version": "1.28.2",
+  "version": "1.30.0",
   "type": "module",
   "description": "A set of zero dependency Vue components built on the Femtocrank global CSS theme.",
   "main": "vite.config.js",

package/styles/picocrank-extensions.css

@@ -90,6 +90,8 @@
 	--danger-zone-summary-hover-bg: var(--karma-bad-tint);
 	--danger-zone-warning-fg: var(--muted-text-color);
 	--danger-zone-focus-outline: var(--karma-bad-border);
+
+	--picocrank-fixed-header-offset: 4em;
 }
 
 table thead th {
@@ -168,6 +170,27 @@ select.field-invalid:focus-visible {
 	outline: 2px solid var(--karma-bad-border);
 	outline-offset: 2px;
 }
+
+/*
+ * Fixed header layout: pin the app header and offset sidebar + main content.
+ * Apply .layout-fixed-header on a wrapper whose direct children are header and #layout.
+ */
+.layout-fixed-header > header {
+	position: fixed;
+	top: 0;
+	left: 0;
+	width: 100%;
+	z-index: 5;
+}
+
+.layout-fixed-header > #layout aside {
+	z-index: 3;
+	padding-top: var(--picocrank-fixed-header-offset);
+}
+
+.layout-fixed-header > #layout main {
+	padding-top: var(--picocrank-fixed-header-offset);
+}
 }
 
 /*

package/vue/components/Calendar.vue

@@ -1,5 +1,5 @@
 <script setup>
-import { ref, computed, watch, onUnmounted } from 'vue'
+import { ref, computed, watch, onUnmounted, nextTick } from 'vue'
 import { HugeiconsIcon } from '@hugeicons/vue'
 
 const props = defineProps({
@@ -62,6 +62,15 @@ const props = defineProps({
 		type: Number,
 		default: undefined,
 	},
+	viewMode: {
+		type: String,
+		default: 'month',
+		validator: (value) => ['month', 'week', 'day'].includes(value),
+	},
+	focusDate: {
+		type: [Date, String, Number],
+		default: null,
+	},
 })
 
 const emit = defineEmits([
@@ -73,6 +82,9 @@ const emit = defineEmits([
 	'event-move-request',
 	'event-moved',
 	'event-move-rejected',
+	'update:viewMode',
+	'update:focusDate',
+	'view-change',
 ])
 
 // Internal calendar state
@@ -87,20 +99,91 @@ const currentDate = computed(() => {
 const viewMonth = computed(() => currentDate.value.getMonth())
 const viewYear = computed(() => currentDate.value.getFullYear())
 
+// Monday-start week containing the given date
+function getWeekStart(date) {
+  const d = new Date(date)
+  const dayOfWeek = (d.getDay() + 6) % 7 // Monday=0
+  d.setDate(d.getDate() - dayOfWeek)
+  d.setHours(0, 0, 0, 0)
+  return d
+}
+
 // Compute the first visible day (Monday) for the current month view
 function getStartOfGrid(date) {
-  const firstOfMonth = new Date(date.getFullYear(), date.getMonth(), 1)
-  const dayOfWeek = (firstOfMonth.getDay() + 6) % 7 // Monday=0
-  const start = new Date(firstOfMonth)
-  start.setDate(firstOfMonth.getDate() - dayOfWeek)
-  start.setHours(0, 0, 0, 0)
-  return start
+  return getWeekStart(new Date(date.getFullYear(), date.getMonth(), 1))
 }
 
-// Anchor date for the 6x7 grid; we will shift this by weeks without re-rendering the grid structure
+function startOfDay(d) {
+  const x = new Date(d)
+  x.setHours(0, 0, 0, 0)
+  return x
+}
+
+function parseFocusDate(value) {
+  if (value == null) {
+    return startOfDay(new Date())
+  }
+
+  const parsed = value instanceof Date ? new Date(value) : new Date(value)
+  if (Number.isNaN(parsed.getTime())) {
+    return startOfDay(new Date())
+  }
+
+  return startOfDay(parsed)
+}
+
+function normalizeViewAnchor(mode, focusDateValue) {
+  const focus = parseFocusDate(focusDateValue)
+
+  if (mode === 'week') {
+    return getWeekStart(focus)
+  }
+  if (mode === 'day') {
+    return focus
+  }
+
+  return getStartOfGrid(currentDate.value)
+}
+
+// Anchor date for the grid; we will shift this by weeks without re-rendering the grid structure
 const gridStartDate = ref(getStartOfGrid(currentDate.value))
 // Track if we're actively scrolling to prevent watcher from resetting grid anchor
 const isScrolling = ref(false)
+const internalViewMode = ref(props.viewMode)
+const isCompactView = computed(() => internalViewMode.value !== 'month')
+
+const headerTitle = computed(() => {
+  if (internalViewMode.value === 'month') {
+    return `${props.monthNames[viewMonth.value]} ${viewYear.value}`
+  }
+
+  if (internalViewMode.value === 'day') {
+    const day = gridStartDate.value
+    return day.toLocaleDateString(undefined, {
+      weekday: 'long',
+      month: 'long',
+      day: 'numeric',
+      year: 'numeric',
+    })
+  }
+
+  const start = gridStartDate.value
+  const end = new Date(start)
+  end.setDate(start.getDate() + 6)
+
+  const startMonth = props.monthNames[start.getMonth()]
+  const endMonth = props.monthNames[end.getMonth()]
+  const startYear = start.getFullYear()
+  const endYear = end.getFullYear()
+
+  if (startYear === endYear && start.getMonth() === end.getMonth()) {
+    return `${startMonth} ${start.getDate()} – ${end.getDate()}, ${startYear}`
+  }
+  if (startYear === endYear) {
+    return `${startMonth} ${start.getDate()} – ${endMonth} ${end.getDate()}, ${startYear}`
+  }
+  return `${startMonth} ${start.getDate()}, ${startYear} – ${endMonth} ${end.getDate()}, ${endYear}`
+})
 
 // Helper function to check if a time is midnight (00:00)
 function isMidnight(dateValue) {
@@ -260,11 +343,33 @@ function getOrdinalSuffix(day) {
   return 'th'
 }
 
+function calendarDayCount(mode = internalViewMode.value) {
+  if (mode === 'week') return 7
+  if (mode === 'day') return 1
+  return 42
+}
+
+function sortedEventsForDay(day) {
+  return [...day.events].sort((a, b) => {
+    const aMultiDay = isMultiDayEvent(a)
+    const bMultiDay = isMultiDayEvent(b)
+    if (aMultiDay && !bMultiDay) return -1
+    if (!aMultiDay && bMultiDay) return 1
+    return 0
+  })
+}
+
+function visibleEventsForDay(day) {
+  const sorted = sortedEventsForDay(day)
+  return internalViewMode.value === 'day' ? sorted : sorted.slice(0, 3)
+}
+
 // Calendar generation from persistent grid start
 const calendarDays = computed(() => {
   const days = []
   const start = gridStartDate.value
-  for (let i = 0; i < 42; i++) {
+  const dayCount = calendarDayCount()
+  for (let i = 0; i < dayCount; i++) {
     const date = new Date(start)
     date.setDate(start.getDate() + i)
     days.push({
@@ -275,8 +380,68 @@ const calendarDays = computed(() => {
   return days
 })
 
+function commitViewChange(mode, focusDateValue, { emitUpdates = true } = {}) {
+  const gridStart = normalizeViewAnchor(mode, focusDateValue)
+  internalViewMode.value = mode
+  gridStartDate.value = gridStart
+
+  if (mode !== 'month') {
+    syncMonthFromGridStart()
+  }
+
+  if (emitUpdates) {
+    emit('update:viewMode', mode)
+    emit('update:focusDate', mode === 'month' ? null : gridStart)
+    emit('view-change', { mode, focusDate: mode === 'month' ? null : gridStart })
+  }
+}
+
+function applyExternalView(mode, focusDateValue) {
+  const gridStart = normalizeViewAnchor(mode, focusDateValue)
+  if (
+    mode === internalViewMode.value
+    && toDateKey(gridStartDate.value) === toDateKey(gridStart)
+  ) {
+    return
+  }
+
+  internalViewMode.value = mode
+  gridStartDate.value = gridStart
+  if (mode !== 'month') {
+    syncMonthFromGridStart()
+  }
+}
+
+watch(
+  () => [props.viewMode, props.focusDate],
+  ([mode, focusDateValue]) => {
+    applyExternalView(mode, focusDateValue)
+  },
+  { immediate: true },
+)
+
+function syncMonthFromGridStart() {
+  const { month, year } = getVisibleMonthYear(gridStartDate.value, internalViewMode.value)
+  if (props.currentMonth !== undefined && props.currentYear !== undefined) {
+    if (month !== viewMonth.value || year !== viewYear.value) {
+      emit('month-change', month, year)
+    }
+  } else {
+    internalCurrentDate.value = new Date(year, month, 1)
+  }
+}
+
 // Navigation functions
 function previousMonth() {
+  if (internalViewMode.value === 'week') {
+    adjustByWeeks(-1)
+    return
+  }
+  if (internalViewMode.value === 'day') {
+    adjustByDays(-1)
+    return
+  }
+
   if (props.currentMonth !== undefined && props.currentYear !== undefined) {
     const newMonth = viewMonth.value === 0 ? 11 : viewMonth.value - 1
     const newYear = viewMonth.value === 0 ? viewYear.value - 1 : viewYear.value
@@ -290,6 +455,15 @@ function previousMonth() {
 }
 
 function nextMonth() {
+  if (internalViewMode.value === 'week') {
+    adjustByWeeks(1)
+    return
+  }
+  if (internalViewMode.value === 'day') {
+    adjustByDays(1)
+    return
+  }
+
   if (props.currentMonth !== undefined && props.currentYear !== undefined) {
     const newMonth = viewMonth.value === 11 ? 0 : viewMonth.value + 1
     const newYear = viewMonth.value === 11 ? viewYear.value + 1 : viewYear.value
@@ -302,8 +476,17 @@ function nextMonth() {
 }
 
 function goToToday() {
+  const today = new Date()
+  if (internalViewMode.value === 'week') {
+    commitViewChange('week', today)
+    return
+  }
+  if (internalViewMode.value === 'day') {
+    commitViewChange('day', today)
+    return
+  }
+
   if (props.currentMonth !== undefined && props.currentYear !== undefined) {
-    const today = new Date()
     emit('month-change', today.getMonth(), today.getFullYear())
     gridStartDate.value = getStartOfGrid(today)
   } else {
@@ -315,33 +498,49 @@ function goToToday() {
 // Week navigation (mouse wheel)
 const lastWheelAt = ref(0)
 const wheelThrottleMs = 180
-function getVisibleMonthYear(start) {
+function getVisibleMonthYear(start, mode = internalViewMode.value) {
+  if (mode === 'day') {
+    return { month: start.getMonth(), year: start.getFullYear() }
+  }
+
   const mid = new Date(start)
-  mid.setDate(start.getDate() + 21) // middle of 6x7 grid
+  mid.setDate(start.getDate() + (mode === 'week' ? 3 : 21))
   return { month: mid.getMonth(), year: mid.getFullYear() }
 }
 
-function adjustByWeeks(weeks) {
-  const newStart = new Date(gridStartDate.value)
-  newStart.setDate(newStart.getDate() + weeks * 7)
-  gridStartDate.value = newStart
-
+function syncNavigationMonth(newStart) {
   if (props.currentMonth !== undefined && props.currentYear !== undefined) {
     const { month, year } = getVisibleMonthYear(newStart)
     if (month !== viewMonth.value || year !== viewYear.value) {
       emit('month-change', month, year)
-      // Set flag to prevent watcher from resetting our scroll position
       isScrolling.value = true
-      // Clear the flag after a short delay to allow future prop-driven updates
       setTimeout(() => { isScrolling.value = false }, 100)
     }
   } else {
-    // Keep internal anchor and current date roughly aligned (set to first of visible month)
     const { month, year } = getVisibleMonthYear(newStart)
     internalCurrentDate.value = new Date(year, month, 1)
   }
 }
 
+function adjustByWeeks(weeks) {
+  const newStart = new Date(gridStartDate.value)
+  newStart.setDate(newStart.getDate() + weeks * 7)
+
+  if (internalViewMode.value === 'month') {
+    gridStartDate.value = newStart
+    syncNavigationMonth(newStart)
+    return
+  }
+
+  commitViewChange(internalViewMode.value, newStart)
+}
+
+function adjustByDays(days) {
+  const newStart = new Date(gridStartDate.value)
+  newStart.setDate(newStart.getDate() + days)
+  commitViewChange('day', newStart)
+}
+
 function handleWheel(event) {
   // Prevent page scrolling while using calendar scroll
   event.preventDefault()
@@ -349,6 +548,10 @@ function handleWheel(event) {
   if (now - lastWheelAt.value < wheelThrottleMs) return
   lastWheelAt.value = now
   const direction = event.deltaY > 0 ? 1 : -1
+  if (internalViewMode.value === 'day') {
+    adjustByDays(direction)
+    return
+  }
   adjustByWeeks(direction)
 }
 
@@ -363,14 +566,133 @@ function handleContextMenu(event, mouseEvent) {
   emit('event-context-menu', event, mouseEvent)
 }
 
-// --- Date range selection (click / drag) ---
+// --- Day context menu ---
 
-function startOfDay(d) {
-  const x = new Date(d)
-  x.setHours(0, 0, 0, 0)
-  return x
+const DAY_CONTEXT_MENU_MARGIN_PX = 8
+const dayContextMenuOpen = ref(false)
+const dayContextMenuStyle = ref({ top: '0px', left: '0px' })
+const dayContextMenuDate = ref(null)
+const dayContextMenuRef = ref(null)
+
+function positionDayContextMenu(clientX, clientY) {
+  const menu = dayContextMenuRef.value
+  if (!menu) return
+
+  const rect = menu.getBoundingClientRect()
+  const margin = DAY_CONTEXT_MENU_MARGIN_PX
+  let top = clientY
+  let left = clientX
+
+  if (left + rect.width > window.innerWidth - margin) {
+    left = window.innerWidth - rect.width - margin
+  }
+  if (top + rect.height > window.innerHeight - margin) {
+    top = window.innerHeight - rect.height - margin
+  }
+  if (left < margin) left = margin
+  if (top < margin) top = margin
+
+  dayContextMenuStyle.value = {
+    top: `${top}px`,
+    left: `${left}px`,
+  }
+}
+
+function closeDayContextMenu() {
+  dayContextMenuOpen.value = false
+  dayContextMenuDate.value = null
+}
+
+function onDocumentPointerDownForDayMenu(event) {
+  if (!dayContextMenuOpen.value) return
+  if (dayContextMenuRef.value?.contains(event.target)) return
+  closeDayContextMenu()
 }
 
+function onDocumentKeyDownForDayMenu(event) {
+  if (!dayContextMenuOpen.value) return
+  if (event.key === 'Escape') {
+    closeDayContextMenu()
+  }
+}
+
+function attachDayContextMenuListeners() {
+  window.addEventListener('pointerdown', onDocumentPointerDownForDayMenu, true)
+  window.addEventListener('keydown', onDocumentKeyDownForDayMenu)
+}
+
+function detachDayContextMenuListeners() {
+  window.removeEventListener('pointerdown', onDocumentPointerDownForDayMenu, true)
+  window.removeEventListener('keydown', onDocumentKeyDownForDayMenu)
+}
+
+function onDayContextMenu(date, mouseEvent) {
+  if (isEventTarget(mouseEvent)) return
+
+  mouseEvent.preventDefault()
+  mouseEvent.stopPropagation()
+
+  dayContextMenuDate.value = startOfDay(date)
+  dayContextMenuOpen.value = true
+  dayContextMenuStyle.value = {
+    top: `${mouseEvent.clientY}px`,
+    left: `${mouseEvent.clientX}px`,
+  }
+
+  nextTick(() => {
+    positionDayContextMenu(mouseEvent.clientX, mouseEvent.clientY)
+    dayContextMenuRef.value?.querySelector('button')?.focus()
+  })
+}
+
+function showOnlyThisWeek() {
+  const date = dayContextMenuDate.value
+  if (!date) return
+
+  commitViewChange('week', date)
+  closeDayContextMenu()
+}
+
+function showOnlyThisDay() {
+  const date = dayContextMenuDate.value
+  if (!date) return
+
+  commitViewChange('day', date)
+  closeDayContextMenu()
+}
+
+function showFullMonth() {
+  commitViewChange('month', currentDate.value)
+  closeDayContextMenu()
+}
+
+function showWeekViewFromDay() {
+  commitViewChange('week', gridStartDate.value)
+}
+
+function setView({ mode, focusDate: nextFocusDate } = {}) {
+  const nextMode = mode ?? internalViewMode.value
+  const anchor = nextFocusDate ?? (nextMode === 'month' ? currentDate.value : gridStartDate.value)
+  commitViewChange(nextMode, anchor)
+}
+
+defineExpose({
+  setView,
+  showMonthView: () => commitViewChange('month', currentDate.value),
+  showWeekView: (date) => commitViewChange('week', date ?? gridStartDate.value),
+  showDayView: (date) => commitViewChange('day', date ?? gridStartDate.value),
+})
+
+watch(dayContextMenuOpen, (open) => {
+  if (open) {
+    attachDayContextMenuListeners()
+  } else {
+    detachDayContextMenuListeners()
+  }
+})
+
+// --- Date range selection (click / drag) ---
+
 function toDateKey(d) {
   return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`
 }
@@ -488,6 +810,7 @@ function onDayPointerEnter(date) {
 
 onUnmounted(() => {
   detachRangePointerListeners()
+  detachDayContextMenuListeners()
 })
 
 // --- Calendar event drag and drop (HTML5) ---
@@ -595,7 +918,7 @@ function onDayDrop(dayDate, ev) {
 
 // Sync grid start when controlled month/year props change (but not during scrolling)
 watch([viewMonth, viewYear], () => {
-  if (isScrolling.value) return
+  if (isScrolling.value || internalViewMode.value !== 'month') return
   const anchor = new Date(viewYear.value, viewMonth.value, 1)
   gridStartDate.value = getStartOfGrid(anchor)
 })
@@ -605,7 +928,7 @@ watch([viewMonth, viewYear], () => {
 <template>
   <div class="calendar-wrapper">
     <div v-if="showNavigation" class="calendar-header-nav">
-      <h2 class="calendar-title">{{ monthNames[viewMonth] }} {{ viewYear }}</h2>
+      <h2 class="calendar-title">{{ headerTitle }}</h2>
       <div class="calendar-nav-buttons">
         <slot name="nav-buttons">
           <button @click="previousMonth" class="button neutral">‹</button>
@@ -616,18 +939,40 @@ watch([viewMonth, viewYear], () => {
     </div>
 
     <div class="calendar-container">
+      <div v-if="isCompactView" class="calendar-compact-view-bar">
+        <button
+          v-if="internalViewMode === 'day'"
+          type="button"
+          class="button neutral"
+          @click="showWeekViewFromDay"
+        >
+          ‹ Week view
+        </button>
+        <button type="button" class="button neutral" @click="showFullMonth">
+          ‹ Month view
+        </button>
+      </div>
       <div v-if="error" class="calendar-error">{{ error }}</div>
       <div v-if="loading" class="calendar-loading-overlay">Loading…</div>
       <div
         class="calendar-grid"
         :class="{
           'is-dragging-range': isDraggingRange,
-          'is-dragging-event': draggingEventId !== null
+          'is-dragging-event': draggingEventId !== null,
+          'week-only': internalViewMode === 'week',
+          'day-only': internalViewMode === 'day'
         }"
         @wheel.prevent="handleWheel"
       >
         <!-- Day headers -->
-        <div v-for="day in dayNames" :key="day" class="day-header">{{ day }}</div>
+        <div
+          v-for="day in dayNames"
+          v-show="internalViewMode !== 'day'"
+          :key="day"
+          class="day-header"
+        >
+          {{ day }}
+        </div>
 
         <!-- Calendar days -->
         <div
@@ -637,6 +982,7 @@ watch([viewMonth, viewYear], () => {
           :data-calendar-date="toDateKey(day.date)"
           @mousedown="onDayPointerDown(day.date, $event)"
           @touchstart.passive="onDayPointerDown(day.date, $event)"
+          @contextmenu="onDayContextMenu(day.date, $event)"
           @mouseenter="onDayPointerEnter(day.date)"
           @dragover="onDayDragOver(day.date, $event)"
           @drop="onDayDrop(day.date, $event)"
@@ -667,13 +1013,7 @@ watch([viewMonth, viewYear], () => {
             </div>
             <div class="day-events">
               <div
-                v-for="event in day.events.sort((a, b) => {
-                  const aMultiDay = isMultiDayEvent(a);
-                  const bMultiDay = isMultiDayEvent(b);
-                  if (aMultiDay && !bMultiDay) return -1;
-                  if (!aMultiDay && bMultiDay) return 1;
-                  return 0;
-                }).slice(0, 3)"
+                v-for="event in visibleEventsForDay(day)"
                 :key="event.id"
                 class="calendar-event"
                 :class="{
@@ -714,7 +1054,10 @@ watch([viewMonth, viewYear], () => {
                   </div>
                 </slot>
               </div>
-              <div v-if="day.events.length > 3" class="more-events">
+              <div
+                v-if="internalViewMode !== 'day' && day.events.length > 3"
+                class="more-events"
+              >
                 +{{ day.events.length - 3 }} more
               </div>
             </div>
@@ -722,6 +1065,46 @@ watch([viewMonth, viewYear], () => {
         </div>
       </div>
     </div>
+
+    <Teleport to="body">
+      <div
+        v-if="dayContextMenuOpen"
+        ref="dayContextMenuRef"
+        class="calendar-day-context-menu"
+        role="menu"
+        :style="dayContextMenuStyle"
+        @click.stop
+        @contextmenu.prevent
+      >
+        <button
+          v-if="internalViewMode !== 'day'"
+          type="button"
+          role="menuitem"
+          class="calendar-day-context-menu-item"
+          @click="showOnlyThisDay"
+        >
+          Show only this day
+        </button>
+        <button
+          v-if="internalViewMode !== 'week'"
+          type="button"
+          role="menuitem"
+          class="calendar-day-context-menu-item"
+          @click="showOnlyThisWeek"
+        >
+          Show only this week
+        </button>
+        <button
+          v-if="internalViewMode !== 'month'"
+          type="button"
+          role="menuitem"
+          class="calendar-day-context-menu-item"
+          @click="showFullMonth"
+        >
+          Show full month
+        </button>
+      </div>
+    </Teleport>
   </div>
 </template>
 
@@ -781,12 +1164,42 @@ watch([viewMonth, viewYear], () => {
   position: relative;
 }
 
+.calendar-compact-view-bar {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.5rem 0.75rem;
+  border-bottom: 1px solid var(--calendar-border);
+  background: var(--calendar-chrome-bg);
+}
+
 .calendar-grid {
   display: grid;
   grid-template-columns: repeat(7, minmax(0, 1fr));
   min-height: 400px;
 }
 
+.calendar-grid.week-only {
+  min-height: min(72vh, 760px);
+  grid-template-rows: auto 1fr;
+}
+
+.calendar-grid.week-only .calendar-day {
+  height: auto;
+  min-height: min(68vh, 720px);
+}
+
+.calendar-grid.day-only {
+  grid-template-columns: minmax(0, 1fr);
+  min-height: min(72vh, 760px);
+}
+
+.calendar-grid.day-only .calendar-day {
+  height: auto;
+  min-height: min(68vh, 720px);
+  border-right: none;
+}
+
 .calendar-grid.is-dragging-range,
 .calendar-grid.is-dragging-event {
   user-select: none;
@@ -1068,6 +1481,12 @@ watch([viewMonth, viewYear], () => {
     height: 110px;
   }
 
+  .calendar-grid.week-only .calendar-day,
+  .calendar-grid.day-only .calendar-day {
+    height: auto;
+    min-height: min(52vh, 420px);
+  }
+
   .day-number {
     font-size: 1rem;
   }
@@ -1103,3 +1522,35 @@ watch([viewMonth, viewYear], () => {
   }
 }
 </style>
+
+<style>
+.calendar-day-context-menu {
+  position: fixed;
+  z-index: 1000;
+  min-width: 12rem;
+  padding: 0.35rem;
+  border: 1px solid var(--table-popover-border);
+  border-radius: 8px;
+  background: var(--table-popover-bg);
+  box-shadow: var(--table-popover-shadow);
+}
+
+.calendar-day-context-menu-item {
+  display: block;
+  width: 100%;
+  padding: 0.5rem 0.75rem;
+  border: none;
+  border-radius: 4px;
+  background: transparent;
+  color: var(--table-popover-fg);
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+}
+
+.calendar-day-context-menu-item:hover,
+.calendar-day-context-menu-item:focus-visible {
+  background: var(--table-popover-item-bg);
+  outline: none;
+}
+</style>

package/vue/components/Pagination.vue

@@ -108,12 +108,12 @@ const props = defineProps({
 const emit = defineEmits(['page-change', 'page-size-change', 'update:page', 'update:pageSize'])
 
 const localPageSize = ref(props.pageSize)
-const localCurrentPage = ref(props.currentPage)
 
-// Computed property to get the current page value (supports both v-model and regular props)
 const currentPageValue = computed(() => {
-  // When using v-model, the page prop will be reactive and change
-  // When using regular props, currentPage will be reactive
+  // `page` supports v-model; `currentPage` is the plain prop. Both default to 1.
+  if (props.currentPage !== 1) {
+    return props.currentPage
+  }
   return props.page
 })
 
@@ -124,28 +124,18 @@ const endItem = computed(() => Math.min(currentPageValue.value * localPageSize.v
 
 function goToPage(page) {
   if (page >= 1 && page <= totalPages.value && page !== currentPageValue.value) {
-    localCurrentPage.value = page
     emit('page-change', page)
     emit('update:page', page)
   }
 }
 
 function handlePageSizeChange() {
-  localCurrentPage.value = 1
   emit('page-size-change', localPageSize.value)
   emit('update:pageSize', localPageSize.value)
   emit('page-change', 1)
   emit('update:page', 1)
 }
 
-watch(() => props.currentPage, (newPage) => {
-  localCurrentPage.value = newPage
-})
-
-watch(() => props.page, (newPage) => {
-  localCurrentPage.value = newPage
-})
-
 watch(() => props.pageSize, (newSize) => {
   localPageSize.value = newSize
 })

package/vue/components/ReadOnlyTextArea.vue

@@ -1,19 +1,28 @@
 <template>
 	<div class="readonly-textarea">
-		<div v-if="label || showCopyButton" class="readonly-textarea-header">
+		<div v-if="showHeader" class="readonly-textarea-header">
 			<label v-if="label" :for="textareaId">{{ label }}</label>
-			<div v-else class="fg1" />
-			<button
-				v-if="showCopyButton"
-				type="button"
-				class="readonly-textarea-copy"
-				:title="copied ? 'Copied' : 'Copy to clipboard'"
-				:disabled="!modelValue"
-				@click="copy"
+			<div v-if="pushActionsEnd" class="fg1" />
+			<div
+				v-if="showActions"
+				class="readonly-textarea-actions"
+				:class="{ 'readonly-textarea-actions--leading': hasActions }"
 			>
-				<HugeiconsIcon :icon="copied ? CopyCheckIcon : Copy01Icon" width="1em" height="1em" />
-				<span>{{ copied ? copiedLabel : copyLabel }}</span>
-			</button>
+				<div v-if="hasActions" class="readonly-textarea-actions-slot">
+					<slot name="actions" />
+				</div>
+				<button
+					v-if="showCopyButton"
+					type="button"
+					class="readonly-textarea-copy"
+					:title="copied ? 'Copied' : 'Copy to clipboard'"
+					:disabled="!modelValue"
+					@click="copy"
+				>
+					<HugeiconsIcon :icon="copied ? CopyCheckIcon : Copy01Icon" width="1em" height="1em" />
+					<span>{{ copied ? copiedLabel : copyLabel }}</span>
+				</button>
+			</div>
 		</div>
 		<textarea
 			:id="textareaId"
@@ -28,7 +37,7 @@
 </template>
 
 <script setup>
-import { ref, computed, useId, watch } from 'vue'
+import { ref, computed, useId, useSlots, watch, Comment } from 'vue'
 import { HugeiconsIcon } from '@hugeicons/vue'
 import { Copy01Icon, CopyCheckIcon } from '@hugeicons/core-free-icons'
 
@@ -85,6 +94,26 @@ const props = defineProps({
 
 const emit = defineEmits(['copy', 'copy-error', 'update:modelValue'])
 
+const slots = useSlots()
+
+const hasActions = computed(() => {
+	const render = slots.actions
+	if (!render) {
+		return false
+	}
+	return render().some((vnode) => vnode.type !== Comment)
+})
+
+const showActions = computed(() => hasActions.value || props.showCopyButton)
+
+const showHeader = computed(
+	() => Boolean(props.label) || showActions.value,
+)
+
+const pushActionsEnd = computed(
+	() => showActions.value && !hasActions.value,
+)
+
 const generatedId = useId()
 const textareaId = props.id || `readonly-textarea-${generatedId}`
 const textareaRef = ref(null)
@@ -180,12 +209,13 @@ defineExpose({
 	flex-direction: column;
 	gap: 0.5rem;
 	width: 100%;
+	min-width: 0;
+	max-width: 100%;
 }
 
 .readonly-textarea-header {
 	display: flex;
 	align-items: center;
-	justify-content: space-between;
 	gap: 0.75rem;
 }
 
@@ -195,22 +225,46 @@ defineExpose({
 
 .fg1 {
 	flex: 1;
+	min-width: 0;
+}
+
+.readonly-textarea-actions {
+	display: inline-flex;
+	align-items: center;
+	gap: 0.75rem;
+	margin-left: auto;
+	flex-shrink: 0;
+}
+
+.readonly-textarea-actions--leading {
+	margin-left: 0;
+}
+
+.readonly-textarea-actions-slot {
+	display: inline-flex;
+	align-items: center;
+	gap: 0.75rem;
+	flex-wrap: wrap;
 }
 
 .readonly-textarea-copy {
 	display: inline-flex;
 	align-items: center;
 	gap: 0.35em;
+	flex-shrink: 0;
 }
 
 .readonly-textarea textarea {
 	width: 100%;
+	max-width: 100%;
+	box-sizing: border-box;
 	resize: vertical;
 	margin: 0;
 }
 
 .readonly-textarea textarea.monospace {
 	font-family: monospace;
-	white-space: pre;
+	white-space: pre-wrap;
+	overflow-wrap: anywhere;
 }
 </style>

package/vue/components/Sidebar.vue

@@ -107,7 +107,8 @@ import { HugeiconsIcon } from '@hugeicons/vue'
 import { Pin02Icon, PinIcon, ArrowDown01Icon, ArrowRight01Icon } from '@hugeicons/core-free-icons'
 import SidebarNavLink from './SidebarNavLink.vue'
 
-const STORAGE_KEY = 'picocrank-nav-sections-collapsed'
+const COLLAPSED_SECTIONS_STORAGE_KEY = 'picocrank-nav-sections-collapsed'
+const STUCK_STORAGE_KEY = 'picocrank-sidebar-stuck'
 const SIDEBAR_PANEL_ID = 'picocrank-sidebar'
 const TOGGLER_ID = 'sidebar-toggler-button'
 
@@ -118,8 +119,16 @@ const props = defineProps({
 	},
 })
 
+function loadStuckPreference() {
+	try {
+		return localStorage.getItem(STUCK_STORAGE_KEY) === 'true'
+	} catch {
+		return false
+	}
+}
+
 const isOpen = ref(false)
-const isStuck = ref(false)
+const isStuck = ref(loadStuckPreference())
 const sidebarRef = ref(null)
 const route = useRoute()
 const headingId = useId()
@@ -156,7 +165,7 @@ function isActive(link) {
 
 function loadCollapsedSections() {
 	try {
-		const raw = localStorage.getItem(STORAGE_KEY)
+		const raw = localStorage.getItem(COLLAPSED_SECTIONS_STORAGE_KEY)
 		if (!raw) return new Set()
 		const parsed = JSON.parse(raw)
 		return new Set(Array.isArray(parsed) ? parsed : [])
@@ -168,7 +177,7 @@ function loadCollapsedSections() {
 const collapsedSections = ref(loadCollapsedSections())
 
 function saveCollapsedSections() {
-	localStorage.setItem(STORAGE_KEY, JSON.stringify([...collapsedSections.value]))
+	localStorage.setItem(COLLAPSED_SECTIONS_STORAGE_KEY, JSON.stringify([...collapsedSections.value]))
 }
 
 function isSectionCollapsed(sectionId) {
@@ -244,6 +253,14 @@ watch(() => route.fullPath, () => {
 	expandSectionContainingActiveRoute()
 }, { immediate: true })
 
+watch(isStuck, (stuck) => {
+	try {
+		localStorage.setItem(STUCK_STORAGE_KEY, stuck ? 'true' : 'false')
+	} catch {
+		// ignore storage errors (private mode, quota, etc.)
+	}
+})
+
 function toggleStick() {
 	isStuck.value = !isStuck.value
 }

package/vue/examples/CalendarExample.vue

@@ -1,10 +1,16 @@
 <template>
-	<Section 
-		title="Example Calendar" 
-		padding
+	<Section
+		title="Example Calendar"
+		subtitle="Open with ?view=week&date=2026-09-08 or ?view=day&date=2026-09-13 to load a specific week or day."
+		:icon="Calendar01Icon"
+		:padding="sectionPadding"
 	>
         <template #toolbar>
-            <label class="short-month-suffix-toggle">
+            <label class="calendar-example-toggle">
+                <input type="checkbox" v-model="sectionPadding" />
+                Section padding
+            </label>
+            <label class="calendar-example-toggle">
                 <input type="checkbox" v-model="shortMonthSuffix" />
                 Short month suffix
             </label>
@@ -21,8 +27,7 @@
             </div>
             <button @click="nextMonth">›</button>
         </template>
-		<Calendar 
-            :section="true"
+		<Calendar
 			:events="events"
 			:loading="loading"
 			:error="error"
@@ -30,6 +35,8 @@
 			:short-month-suffix="shortMonthSuffix"
 			:current-month="currentMonthIndex"
 			:current-year="currentYear"
+			v-model:view-mode="calendarViewMode"
+			v-model:focus-date="calendarFocusDate"
 			@event-click="handleEventClick"
 			@date-click="handleDateClick"
 			@date-range-select="handleDateRangeSelect"
@@ -37,12 +44,14 @@
 			@event-moved="handleEventMoved"
 			@event-move-rejected="handleEventMoveRejected"
 			@month-change="handleMonthChange"
+			@view-change="handleViewChange"
 		/>
 	</Section>
 </template>
 
 <script setup>
 import { ref, onMounted } from 'vue'
+import { useRoute, useRouter } from 'vue-router'
 import Calendar from '../components/Calendar.vue'
 import Section from '../components/Section.vue'
 import {
@@ -67,10 +76,38 @@ const EVENT_COLORS = {
 	deadline: { color: '#fde8e8', foregroundColor: '#7f1d1d' },
 }
 
+const route = useRoute()
+const router = useRouter()
+
+const VALID_VIEW_MODES = new Set(['month', 'week', 'day'])
+
+function parseRouteViewMode() {
+	const view = route.query.view
+	return typeof view === 'string' && VALID_VIEW_MODES.has(view) ? view : 'month'
+}
+
+function parseRouteFocusDate() {
+	const date = route.query.date
+	if (typeof date !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+		return null
+	}
+
+	const parsed = new Date(`${date}T00:00:00`)
+	return Number.isNaN(parsed.getTime()) ? null : parsed
+}
+
+function formatFocusDateQuery(dateValue) {
+	const date = new Date(dateValue)
+	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`
+}
+
 const events = ref([])
 const loading = ref(false)
 const error = ref(null)
+const sectionPadding = ref(true)
 const shortMonthSuffix = ref(false)
+const calendarViewMode = ref(parseRouteViewMode())
+const calendarFocusDate = ref(parseRouteFocusDate())
 const currentMonth = ref('?')
 const currentMonthIndex = ref(new Date().getMonth())
 const currentYear = ref(new Date().getFullYear())
@@ -368,6 +405,22 @@ function goToSelectedDate() {
 	events.value = getEventsForSurroundingMonths(monthIndex, year)
 }
 
+function handleViewChange({ mode, focusDate }) {
+	const query = { ...route.query }
+
+	if (mode === 'month') {
+		delete query.view
+		delete query.date
+	} else {
+		query.view = mode
+		if (focusDate) {
+			query.date = formatFocusDateQuery(focusDate)
+		}
+	}
+
+	router.replace({ query })
+}
+
 function handleMonthChange(month, year) {
 	console.log('Month changed:', month, year)
 	// In a real app, you might fetch events for the new month
@@ -395,29 +448,24 @@ function handleMonthChange(month, year) {
 }
 
 onMounted(() => {
-	// Generate initial events for current, previous, and next months
-	const now = new Date()
-	const initMonth = now.getMonth()
-	const initYear = now.getFullYear()
+	const initialAnchor = calendarFocusDate.value ?? new Date()
+	const initMonth = initialAnchor.getMonth()
+	const initYear = initialAnchor.getFullYear()
+
 	events.value = getEventsForSurroundingMonths(initMonth, initYear)
-	
-	// Set initial month title using native JavaScript
-	currentMonthIndex.value = now.getMonth()
-	currentYear.value = now.getFullYear()
-	currentMonth.value = now.toLocaleDateString('en-US', { 
-		month: 'long', 
-		year: 'numeric' 
+	currentMonthIndex.value = initMonth
+	currentYear.value = initYear
+	currentMonth.value = initialAnchor.toLocaleDateString('en-US', {
+		month: 'long',
+		year: 'numeric',
 	})
-	
-	// Initialize the native date picker with current month/year
-	const year = now.getFullYear()
-	const month = String(now.getMonth() + 1).padStart(2, '0')
-	selectedDate.value = `${year}-${month}`
+
+	updateDatePicker(initMonth, initYear)
 })
 </script>
 
 <style scoped>
-.short-month-suffix-toggle {
+.calendar-example-toggle {
   display: inline-flex;
   align-items: center;
   gap: 0.35rem;

package/vue/examples/ReadOnlyTextAreaExample.vue

@@ -18,7 +18,11 @@
 				label="Application log"
 				:rows="10"
 				@copy="onCopy"
-			/>
+			>
+				<template #actions>
+					<button type="button" @click="refreshDiagnostics">Refresh log</button>
+				</template>
+			</ReadOnlyTextArea>
 
 			<ReadOnlyTextArea
 				v-model="environmentInfo"