picocrank 1.6.3 → 1.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "picocrank",
-  "version": "1.6.3",
+  "version": "1.7.0",
   "description": "A set of zero dependency Vue components built on the Femtocrank global CSS theme.",
   "main": "vite.config.js",
   "scripts": {
@@ -21,7 +21,7 @@
     "@hugeicons/core-free-icons": "^1.0.16",
     "@hugeicons/vue": "^1.0.3",
     "@vitejs/plugin-vue": "^6.0.1",
-    "femtocrank": "^2.4.3",
+    "femtocrank": "^2.4.4",
     "unplugin-vue-components": "^29.0.0",
     "vite": "^7.1.3",
     "vue": "^3.5.19",

package/styles.css

@@ -0,0 +1,3 @@
+/* Import femtocrank styles */
+@import 'femtocrank/style.css';
+@import 'femtocrank/dark.css';

package/vue/components/Calendar.vue

@@ -57,6 +57,21 @@ const currentDate = computed(() => {
 const currentMonth = computed(() => currentDate.value.getMonth())
 const currentYear = computed(() => currentDate.value.getFullYear())
 
+// Compute the first visible day (Monday) for the current month view
+function getStartOfGrid(date: Date): 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
+}
+
+// Anchor date for the 6x7 grid; we will shift this by weeks without re-rendering the grid structure
+const gridStartDate = ref<Date>(getStartOfGrid(currentDate.value))
+// Track if we're actively scrolling to prevent watcher from resetting grid anchor
+const isScrolling = ref(false)
+
 // Helper function to check if a time is midnight (00:00)
 function isMidnight(dateValue: any): boolean {
   if (!dateValue) return false
@@ -72,6 +87,15 @@ function formatTimeOrNoTime(dateValue: any): string {
   return date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
 }
 
+// Determine if a date is in the past (before today)
+function isPastDay(date: Date): boolean {
+  const day = new Date(date)
+  day.setHours(0, 0, 0, 0)
+  const today = new Date()
+  today.setHours(0, 0, 0, 0)
+  return day.getTime() < today.getTime()
+}
+
 // Get event date range
 function getEventDateRange(event: CalendarEvent): { start: Date | null; end: Date | null } {
   if (props.getEventDateRange) {
@@ -179,55 +203,18 @@ function formatEventTimeDefault(event: CalendarEvent, date: Date): string {
   return 'All day'
 }
 
-// Calendar generation
+// Calendar generation from persistent grid start
 const calendarDays = computed(() => {
-  const year = currentYear.value
-  const month = currentMonth.value
-
-  const firstDay = new Date(year, month, 1)
-  const lastDay = new Date(year, month + 1, 0)
-  const daysInMonth = lastDay.getDate()
-
-  // Get starting day of week (Monday as first day)
-  const startDay = (firstDay.getDay() + 6) % 7
-
-  const days = []
-
-  // Add days from previous month to fill the first row
-  const prevMonth = month === 0 ? 11 : month - 1
-  const prevYear = month === 0 ? year - 1 : year
-  const prevMonthLastDay = new Date(prevYear, prevMonth + 1, 0).getDate()
-
-  for (let i = 0; i < startDay; i++) {
-    const day = prevMonthLastDay - startDay + i + 1
-    const date = new Date(prevYear, prevMonth, day)
-    days.push({
-      date,
-      events: getEventsForDate(date)
-    })
-  }
-
-  // Add days of the month
-  for (let day = 1; day <= daysInMonth; day++) {
-    const date = new Date(year, month, day)
-    days.push({
-      date,
-      events: getEventsForDate(date)
-    })
-  }
-
-  // Add days from next month to complete the last row
-  const totalCells = 42
-  const remainingCells = totalCells - days.length
-
-  for (let day = 1; day <= remainingCells; day++) {
-    const date = new Date(year, month + 1, day)
+  const days = [] as { date: Date; events: CalendarEvent[] }[]
+  const start = gridStartDate.value
+  for (let i = 0; i < 42; i++) {
+    const date = new Date(start)
+    date.setDate(start.getDate() + i)
     days.push({
       date,
       events: getEventsForDate(date)
     })
   }
-
   return days
 })
 
@@ -237,8 +224,11 @@ function previousMonth() {
     const newMonth = currentMonth.value === 0 ? 11 : currentMonth.value - 1
     const newYear = currentMonth.value === 0 ? currentYear.value - 1 : currentYear.value
     emit('month-change', newMonth, newYear)
+    // Optimistically update grid anchor for smooth transition
+    gridStartDate.value = getStartOfGrid(new Date(newYear, newMonth, 1))
   } else {
     internalCurrentDate.value = new Date(currentYear.value, currentMonth.value - 1, 1)
+    gridStartDate.value = getStartOfGrid(internalCurrentDate.value)
   }
 }
 
@@ -247,8 +237,10 @@ function nextMonth() {
     const newMonth = currentMonth.value === 11 ? 0 : currentMonth.value + 1
     const newYear = currentMonth.value === 11 ? currentYear.value + 1 : currentYear.value
     emit('month-change', newMonth, newYear)
+    gridStartDate.value = getStartOfGrid(new Date(newYear, newMonth, 1))
   } else {
     internalCurrentDate.value = new Date(currentYear.value, currentMonth.value + 1, 1)
+    gridStartDate.value = getStartOfGrid(internalCurrentDate.value)
   }
 }
 
@@ -256,11 +248,53 @@ function goToToday() {
   if (props.currentMonth !== undefined && props.currentYear !== undefined) {
     const today = new Date()
     emit('month-change', today.getMonth(), today.getFullYear())
+    gridStartDate.value = getStartOfGrid(today)
   } else {
     internalCurrentDate.value = new Date()
+    gridStartDate.value = getStartOfGrid(internalCurrentDate.value)
+  }
+}
+
+// Week navigation (mouse wheel)
+const lastWheelAt = ref(0)
+const wheelThrottleMs = 180
+function getVisibleMonthYear(start: Date): { month: number; year: number } {
+  const mid = new Date(start)
+  mid.setDate(start.getDate() + 21) // middle of 6x7 grid
+  return { month: mid.getMonth(), year: mid.getFullYear() }
+}
+
+function adjustByWeeks(weeks: number): void {
+  const newStart = new Date(gridStartDate.value)
+  newStart.setDate(newStart.getDate() + weeks * 7)
+  gridStartDate.value = newStart
+
+  if (props.currentMonth !== undefined && props.currentYear !== undefined) {
+    const { month, year } = getVisibleMonthYear(newStart)
+    if (month !== currentMonth.value || year !== currentYear.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 handleWheel(event: WheelEvent): void {
+  // Prevent page scrolling while using calendar scroll
+  event.preventDefault()
+  const now = (typeof performance !== 'undefined' && performance.now) ? performance.now() : Date.now()
+  if (now - lastWheelAt.value < wheelThrottleMs) return
+  lastWheelAt.value = now
+  const direction = event.deltaY > 0 ? 1 : -1
+  adjustByWeeks(direction)
+}
+
 // Event handlers
 function handleEventClick(event: CalendarEvent) {
   emit('event-click', event)
@@ -275,6 +309,15 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
   mouseEvent.stopPropagation()
   emit('event-context-menu', event, mouseEvent)
 }
+import { watch } from 'vue'
+
+// Sync grid start when controlled month/year props change (but not during scrolling)
+watch([currentMonth, currentYear], () => {
+  if (isScrolling.value) return
+  const anchor = new Date(currentYear.value, currentMonth.value, 1)
+  gridStartDate.value = getStartOfGrid(anchor)
+})
+
 </script>
 
 <template>
@@ -290,10 +333,10 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
       </div>
     </div>
 
-    <div v-if="error" class="calendar-error">{{ error }}</div>
-    <div v-else-if="loading" class="calendar-loading">Loading…</div>
-    <div v-else class="calendar-container">
-      <div class="calendar-grid">
+    <div class="calendar-container">
+      <div v-if="error" class="calendar-error">{{ error }}</div>
+      <div v-if="loading" class="calendar-loading-overlay">Loading…</div>
+      <div class="calendar-grid" @wheel.prevent="handleWheel">
         <!-- Day headers -->
         <div v-for="day in dayNames" :key="day" class="day-header">{{ day }}</div>
 
@@ -306,7 +349,8 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
             'today': day && day.date.toDateString() === new Date().toDateString(),
             'weekend': day && (day.date.getDay() === 0 || day.date.getDay() === 6),
             'prev-month': day && day.date.getMonth() !== currentMonth && day.date.getMonth() !== (currentMonth + 1) % 12,
-            'next-month': day && day.date.getMonth() !== currentMonth && day.date.getMonth() === (currentMonth + 1) % 12
+            'next-month': day && day.date.getMonth() !== currentMonth && day.date.getMonth() === (currentMonth + 1) % 12,
+            'past': day && isPastDay(day.date)
           }"
         >
           <div v-if="day" class="day-content" @click="handleDateClick(day.date)">
@@ -397,11 +441,23 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
   text-align: center;
 }
 
+.calendar-loading-overlay {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: rgba(255, 255, 255, 0.6);
+  z-index: 1;
+  font-weight: 600;
+}
+
 .calendar-container {
   background: white;
   border: 1px solid #e0e0e0;
   overflow: hidden;
   border-radius: 8px;
+  position: relative;
 }
 
 .calendar-grid {
@@ -427,10 +483,11 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
 .calendar-day {
   border-right: 1px solid #e0e0e0;
   border-bottom: 1px solid #e0e0e0;
-  min-height: 120px;
+  height: 160px;
   position: relative;
   transition: background-color 0.2s ease;
   cursor: pointer;
+  overflow: hidden;
 }
 
 .calendar-day:hover {
@@ -452,12 +509,18 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
 .calendar-day.next-month,
 .calendar-day.prev-month {
   background: #f8f9fa;
-  opacity: 0.6;
 }
 
 .calendar-day.next-month:hover,
 .calendar-day.prev-month:hover {
   background: #e9ecef;
+}
+
+.calendar-day.past {
+  opacity: 0.6;
+}
+
+.calendar-day.past:hover {
   opacity: 0.8;
 }
 
@@ -503,7 +566,7 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
 
 .day-events {
   flex: 1;
-  overflow: hidden;
+  overflow: auto;
 }
 
 .calendar-event {
@@ -587,7 +650,7 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
   }
 
   .calendar-day {
-    min-height: 80px;
+    height: 80px;
   }
 
   .day-number {
@@ -609,7 +672,7 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
   }
 
   .calendar-day {
-    min-height: 60px;
+    height: 60px;
   }
 
   .day-header {
@@ -692,5 +755,13 @@ function handleContextMenu(event: CalendarEvent, mouseEvent: MouseEvent) {
   .calendar-day.weekend:hover {
     background: #374151;
   }
+
+  .calendar-day.past {
+    opacity: 0.6;
+  }
+
+  .calendar-day.past:hover {
+    opacity: 0.8;
+  }
 }
 </style>

package/vue/views/App.vue

@@ -19,7 +19,7 @@
 			</main>
 
 			<footer>
-				<span>PicoCrank</span>
+				<span><a href = "https://github.com/jamesread/picocrank">PicoCrank</a></span>
 			</footer>
 		</div>
 	</div>
@@ -31,7 +31,7 @@
 	import { Pin02Icon } from '@hugeicons/core-free-icons'
 
 	import QuickSearch from './../components/QuickSearch.vue'
-	import '../../src/styles.css'
+	import '../../styles.css'
 	import logoUrl from '/logo.png';
 
 	const quickSearchRef = ref(null)

package/vue/views/CalendarExample.vue

@@ -44,37 +44,48 @@ const currentMonth = ref('?')
 const currentMonthIndex = ref(new Date().getMonth())
 const currentYear = ref(new Date().getFullYear())
 
+// Cache events by month/year key (e.g., "2024-10")
+const eventsCache = new Map()
+
 // Date picker state - using native HTML5 month input
 const selectedDate = ref('')
 
-// Generate dummy events for the current month
-function generateDummyEvents() {
-	const now = new Date()
-	const currentMonth = now.getMonth()
-	const currentYear = now.getFullYear()
-	
-	// Get the number of days in the current month
-	const daysInMonth = new Date(currentYear, currentMonth + 1, 0).getDate()
+// Simple seeded random number generator for consistent event generation
+function seededRandom(seed) {
+	let value = seed
+	return function() {
+		value = (value * 9301 + 49297) % 233280
+		return value / 233280
+	}
+}
+
+// Generate dummy events for a specific month
+function generateDummyEventsForMonth(monthIndex, year) {
+	// Get the number of days in the month
+	const daysInMonth = new Date(year, monthIndex + 1, 0).getDate()
 	
 	const dummyEvents = []
 	
+	// Create a seeded random generator for consistent events per month
+	const random = seededRandom(year * 12 + monthIndex)
+	
 	// Add some recurring events
 	for (let day = 1; day <= daysInMonth; day++) {
-		const date = new Date(currentYear, currentMonth, day)
+		const date = new Date(year, monthIndex, day)
 		const dayOfWeek = date.getDay()
 		
 		// Add weekend events (Saturday and Sunday)
 		if (dayOfWeek === 0 || dayOfWeek === 6) {
 			dummyEvents.push({
-				id: `weekend-${day}`,
+				id: `weekend-${year}-${monthIndex}-${day}`,
 				title: 'Weekend Activity',
-				date: new Date(currentYear, currentMonth, day, 10, 0),
+				date: new Date(year, monthIndex, day, 10, 0),
 				description: 'Relaxing weekend activity'
 			})
 		}
 		
 		// Add some random events
-		if (Math.random() > 0.7) {
+		if (random() > 0.7) {
 			const eventTypes = [
 				{ title: 'Team Meeting', time: [9, 0], duration: 1 },
 				{ title: 'Client Call', time: [14, 30], duration: 0.5 },
@@ -83,13 +94,13 @@ function generateDummyEvents() {
 				{ title: 'Code Review', time: [10, 0], duration: 1.5 }
 			]
 			
-			const eventType = eventTypes[Math.floor(Math.random() * eventTypes.length)]
+			const eventType = eventTypes[Math.floor(random() * eventTypes.length)]
 			const [hours, minutes] = eventType.time
 			
 			dummyEvents.push({
-				id: `event-${day}-${Math.random().toString(36).substr(2, 9)}`,
+				id: `event-${year}-${monthIndex}-${day}-${Math.random().toString(36).substr(2, 9)}`,
 				title: eventType.title,
-				date: new Date(currentYear, currentMonth, day, hours, minutes),
+				date: new Date(year, monthIndex, day, hours, minutes),
 				description: `Scheduled ${eventType.title.toLowerCase()}`
 			})
 		}
@@ -97,34 +108,34 @@ function generateDummyEvents() {
 	
 	// Add some multi-day events
 	dummyEvents.push({
-		id: 'conference-1',
+		id: `conference-${year}-${monthIndex}`,
 		title: 'Tech Conference',
-		startDate: new Date(currentYear, currentMonth, 5, 9, 0),
-		endDate: new Date(currentYear, currentMonth, 7, 17, 0),
+		startDate: new Date(year, monthIndex, 5, 9, 0),
+		endDate: new Date(year, monthIndex, 7, 17, 0),
 		description: 'Annual technology conference'
 	})
 	
 	dummyEvents.push({
-		id: 'vacation-1',
+		id: `vacation-${year}-${monthIndex}`,
 		title: 'Vacation',
-		startDate: new Date(currentYear, currentMonth, 15, 0, 0),
-		endDate: new Date(currentYear, currentMonth, 18, 23, 59),
+		startDate: new Date(year, monthIndex, 15, 0, 0),
+		endDate: new Date(year, monthIndex, 18, 23, 59),
 		description: 'Family vacation time'
 	})
 	
 	// Add some all-day events
 	dummyEvents.push({
-		id: 'holiday-1',
+		id: `holiday-${year}-${monthIndex}`,
 		title: 'Public Holiday',
-		date: new Date(currentYear, currentMonth, 1, 0, 0),
+		date: new Date(year, monthIndex, 1, 0, 0),
 		description: 'National holiday - office closed'
 	})
 	
 	if (daysInMonth >= 25) {
 		dummyEvents.push({
-			id: 'deadline-1',
+			id: `deadline-${year}-${monthIndex}`,
 			title: 'Project Deadline',
-			date: new Date(currentYear, currentMonth, 25, 0, 0),
+			date: new Date(year, monthIndex, 25, 0, 0),
 			description: 'Important project deadline'
 		})
 	}
@@ -132,9 +143,47 @@ function generateDummyEvents() {
 	return dummyEvents
 }
 
+// Get or generate events for a specific month/year
+function getEventsForMonth(monthIndex, year) {
+	const cacheKey = `${year}-${monthIndex}`
+	
+	// Return cached events if available
+	if (eventsCache.has(cacheKey)) {
+		return eventsCache.get(cacheKey)
+	}
+	
+	// Generate new events for this month
+	const dummyEvents = generateDummyEventsForMonth(monthIndex, year)
+	
+	// Cache the events
+	eventsCache.set(cacheKey, dummyEvents)
+	
+	return dummyEvents
+}
+
+// Merge events for previous, current, and next months so overflow days show events
+function getEventsForSurroundingMonths(monthIndex, year) {
+	const prevMonthIndex = monthIndex === 0 ? 11 : monthIndex - 1
+	const prevYear = monthIndex === 0 ? year - 1 : year
+	const nextMonthIndex = monthIndex === 11 ? 0 : monthIndex + 1
+	const nextYear = monthIndex === 11 ? year + 1 : year
+
+	return [
+		...getEventsForMonth(prevMonthIndex, prevYear),
+		...getEventsForMonth(monthIndex, year),
+		...getEventsForMonth(nextMonthIndex, nextYear)
+	]
+}
+
+// Generate dummy events for the current month (backward compatibility wrapper)
+function generateDummyEvents() {
+    const now = new Date()
+    return getEventsForMonth(now.getMonth(), now.getFullYear())
+}
+
 function handleEventClick(event) {
-	console.log('Event clicked:', event)
-	alert(`Event: ${event.title}\nDescription: ${event.description || 'No description'}`)
+    console.log('Event clicked:', event)
+    alert(`Event: ${event.title}\nDescription: ${event.description || 'No description'}`)
 }
 
 function handleDateClick(date) {
@@ -166,6 +215,9 @@ function previousMonth() {
 	
 	// Update date picker
 	updateDatePicker(newMonth, newYear)
+
+	// Update events for surrounding months
+	events.value = getEventsForSurroundingMonths(newMonth, newYear)
 }
 
 function nextMonth() {
@@ -185,6 +237,9 @@ function nextMonth() {
 	
 	// Update date picker
 	updateDatePicker(newMonth, newYear)
+
+	// Update events for surrounding months
+	events.value = getEventsForSurroundingMonths(newMonth, newYear)
 }
 
 function goToToday() {
@@ -204,6 +259,9 @@ function goToToday() {
 	
 	// Update date picker
 	updateDatePicker(newMonth, newYear)
+
+	// Update events for surrounding months
+	events.value = getEventsForSurroundingMonths(newMonth, newYear)
 }
 
 function goToSelectedDate() {
@@ -223,6 +281,9 @@ function goToSelectedDate() {
 		month: 'long', 
 		year: 'numeric' 
 	})
+
+	// Update events for surrounding months
+	events.value = getEventsForSurroundingMonths(monthIndex, year)
 }
 
 function handleMonthChange(month, year) {
@@ -245,18 +306,20 @@ function handleMonthChange(month, year) {
 	updateDatePicker(month, year)
 	
 	setTimeout(() => {
-		// Simulate loading delay
-		events.value = generateDummyEvents()
+		// Load events for surrounding months (will use cache if available)
+		events.value = getEventsForSurroundingMonths(month, year)
 		loading.value = false
 	}, 500)
 }
 
 onMounted(() => {
-	// Generate initial events for current month
-	events.value = generateDummyEvents()
+	// Generate initial events for current, previous, and next months
+	const now = new Date()
+	const initMonth = now.getMonth()
+	const initYear = now.getFullYear()
+	events.value = getEventsForSurroundingMonths(initMonth, initYear)
 	
 	// Set initial month title using native JavaScript
-	const now = new Date()
 	currentMonthIndex.value = now.getMonth()
 	currentYear.value = now.getFullYear()
 	currentMonth.value = now.toLocaleDateString('en-US', {