@astryxdesign/lab 0.0.0-bootstrap.0 → 0.1.2-canary.04e71b2

package/src/Schedule/types.ts

@@ -0,0 +1,86 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file types.ts
+ * @input Public Schedule API concepts
+ * @output Event, view, date, loader, and context types for Schedule
+ * @position Public type surface; consumed by Schedule implementation and exports
+ */
+
+import type {ReactNode} from 'react';
+import type {PlainDate} from '@astryxdesign/core/utils';
+import type {CalendarEvent} from './CalendarEvent';
+import type {ZonedDateTime, ZonedDateTimeRange} from './zonedDateTime';
+
+export type {PlainDate} from '@astryxdesign/core/utils';
+export type {
+  CalendarDayEvent,
+  CalendarEvent,
+  CalendarEventBase,
+  CalendarInstantEvent,
+  ScheduleCategory,
+  ScheduleEventColor,
+} from './CalendarEvent';
+export type {ZonedDateTime, ZonedDateTimeRange} from './zonedDateTime';
+
+/** Unix epoch milliseconds. */
+export type Instant = number;
+
+export type ScheduleEventSource =
+  | ReadonlyArray<CalendarEvent>
+  | ((start: Instant, end: Instant) => Promise<ReadonlyArray<CalendarEvent>>);
+
+export type ScheduleDate = Instant;
+
+export interface ScheduleRange {
+  startDate: PlainDate;
+  endDate: PlainDate;
+  start: Instant;
+  end: Instant;
+}
+
+export type ScheduleViewOptions = object;
+
+export interface ScheduleViewComponentProps<
+  Options extends ScheduleViewOptions = ScheduleViewOptions,
+> {
+  options: Options;
+}
+
+export interface ScheduleNavigationRange {
+  label: string;
+  range: ZonedDateTimeRange;
+}
+
+export type ScheduleViewComponent<
+  Options extends ScheduleViewOptions = ScheduleViewOptions,
+> = (props: ScheduleViewComponentProps<Options>) => ReactNode;
+
+export interface ScheduleViewBase {
+  getDateRange: (date: ZonedDateTime) => ZonedDateTimeRange;
+  getPreviousDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+  getNextDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+}
+
+export interface ScheduleView<
+  Options extends ScheduleViewOptions = ScheduleViewOptions,
+> extends ScheduleViewBase {
+  component: ScheduleViewComponent<Options>;
+  options: Options;
+}
+
+export interface ScheduleHeaderContent {
+  startContent: ReactNode;
+  centerContent: ReactNode;
+  endContent: ReactNode;
+}
+
+export type SchedulePluginPosition = 'start' | 'end';
+
+export interface SchedulePlugin {
+  renderHeader?: (
+    startContent: ReactNode,
+    centerContent: ReactNode,
+    endContent: ReactNode,
+  ) => ScheduleHeaderContent;
+}

package/src/Schedule/useCurrentTime.ts

@@ -0,0 +1,50 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useCurrentTime.ts
+ * @input Browser clock
+ * @output A shared ticking Instant value for schedule current-time affordances
+ * @position Internal hook consumed by schedule views
+ */
+
+import {useSyncExternalStore} from 'react';
+import type {Instant} from './types';
+
+const UPDATE_INTERVAL_MS = 60 * 1000;
+const listeners = new Set<() => void>();
+let interval: ReturnType<typeof setInterval> | null = null;
+let currentTime = Date.now() as Instant;
+
+function getSnapshot(): Instant {
+  return currentTime;
+}
+
+// SSR returns 0 because current time only drives client-side affordances
+// (now-indicator line, past-event dimming) that are acceptable to hydrate.
+function getServerSnapshot(): Instant {
+  return 0 as Instant;
+}
+
+function subscribe(listener: () => void): () => void {
+  listeners.add(listener);
+  if (interval == null) {
+    interval = setInterval(() => {
+      currentTime = Date.now() as Instant;
+      listeners.forEach(activeListener => activeListener());
+    }, UPDATE_INTERVAL_MS);
+  }
+
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0 && interval != null) {
+      clearInterval(interval);
+      interval = null;
+    }
+  };
+}
+
+export function useCurrentTime(): Instant {
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}

package/src/Schedule/zonedDateTime.ts

@@ -0,0 +1,71 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file zonedDateTime.ts
+ * @input Instant epoch milliseconds and IANA timezone IDs
+ * @output Lightweight ZonedDateTime helpers used by Schedule views
+ * @position Internal timezone-aware date bridge between schedule shell and views
+ */
+
+import {
+  plainDateAddDays,
+  plainDateFromInstant,
+  plainDateToInstant,
+  type PlainDate,
+} from '@astryxdesign/core/utils';
+import type {Instant, ScheduleRange, ScheduleDate} from './types';
+
+export interface ZonedDateTime {
+  instant: Instant;
+  timezoneID: string;
+  toPlainDate: () => PlainDate;
+  addDays: (days: number) => ZonedDateTime;
+  startOfDay: () => ZonedDateTime;
+}
+
+export type ZonedDateTimeRange = [ZonedDateTime, ZonedDateTime];
+
+export function createZonedDateTime(
+  date: ScheduleDate,
+  timezoneID: string,
+): ZonedDateTime {
+  return zonedDateTimeFromInstant(date as Instant, timezoneID);
+}
+
+export function zonedDateTimeFromInstant(
+  instant: Instant,
+  timezoneID: string,
+): ZonedDateTime {
+  return {
+    instant,
+    timezoneID,
+    toPlainDate: () => plainDateFromInstant(instant, timezoneID),
+    addDays: days => {
+      const date = plainDateAddDays(
+        plainDateFromInstant(instant, timezoneID),
+        days,
+      );
+      return zonedDateTimeFromInstant(
+        plainDateToInstant(date, timezoneID) as Instant,
+        timezoneID,
+      );
+    },
+    startOfDay: () => {
+      const date = plainDateFromInstant(instant, timezoneID);
+      return zonedDateTimeFromInstant(
+        plainDateToInstant(date, timezoneID) as Instant,
+        timezoneID,
+      );
+    },
+  };
+}
+
+export function scheduleRangeToZonedDateTimeRange(
+  range: ScheduleRange,
+  timezoneID: string,
+): ZonedDateTimeRange {
+  return [
+    zonedDateTimeFromInstant(range.start, timezoneID),
+    zonedDateTimeFromInstant(range.end, timezoneID),
+  ];
+}

package/src/Stepper/Step.doc.mjs

@@ -0,0 +1,17 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../core/src/docs-types').ComponentDoc} */
+
+export const docs = {
+  name: 'Step',
+  displayName: 'Step',
+  group: 'Stepper',
+  category: 'Navigation',
+  isHiddenFromOverview: true,
+
+  usage: {
+    description: '',
+  },
+
+  props: [],
+};