@bridge-ui/vue 0.0.8 → 0.0.10

package/docs/examples/date-luxon.ts

@@ -0,0 +1,332 @@
+/**
+ * Example Luxon date adapter for `@bridge-ui/vue`.
+ * Copy into your app or wire via `BridgeUIProvider` / `createBridgeUI` `global.dates`.
+ * Not published as an npm package.
+ *
+ * Requires `luxon`. Strong IANA time-zone support via `DateTime.setZone`.
+ */
+
+// ** External Imports
+import { clamp, isNil, isString, range } from "es-toolkit/compat";
+import { DateTime, Info } from "luxon";
+
+// ** Core Imports
+import type {
+  DateAdapter,
+  DateAdapterContext,
+  DateAdapterTimeOptions,
+} from "@bridge-ui/core";
+
+/**
+ * Options for {@link createLuxonDateAdapter}.
+ */
+export type LuxonDateAdapterOptions = {
+  /**
+   * Default locale when context omits `locale`.
+   *
+   * @default undefined
+   */
+  locale?: string;
+
+  /**
+   * Default IANA time zone when context omits `timeZone`.
+   *
+   * @default undefined (system local zone)
+   */
+  timeZone?: string;
+};
+
+/**
+ * Builds a Luxon-backed {@link DateAdapter} (`TDate = Date`) for Bridge calendars.
+ */
+export function createLuxonDateAdapter(
+  options: LuxonDateAdapterOptions = {},
+): DateAdapter<Date> {
+  const resolveLocale = (context?: DateAdapterContext) => {
+    return context?.locale ?? options.locale;
+  };
+
+  const resolveZone = (context?: DateAdapterContext) => {
+    return context?.timeZone ?? options.timeZone;
+  };
+
+  const toDateTime = (date: Date, context?: DateAdapterContext): DateTime => {
+    const locale = resolveLocale(context);
+    const zone = resolveZone(context);
+    let value = DateTime.fromJSDate(date);
+
+    if (!isNil(zone)) {
+      value = value.setZone(zone);
+    }
+
+    if (!isNil(locale)) {
+      value = value.setLocale(locale);
+    }
+
+    return value;
+  };
+
+  const fromDateTime = (value: DateTime): Date => {
+    return value.toJSDate();
+  };
+
+  const isValid = (date: Date) => {
+    return date instanceof Date && !Number.isNaN(date.getTime());
+  };
+
+  const adapter: DateAdapter<Date> = {
+    getDate: (date, context) => toDateTime(date, context).day,
+
+    getYear: (date, context) => toDateTime(date, context).year,
+
+    getHours: (date, context) => toDateTime(date, context).hour,
+
+    isAfter: (a, b, context) => adapter.isBefore(b, a, context),
+
+    getMinutes: (date, context) => toDateTime(date, context).minute,
+
+    getSeconds: (date, context) => toDateTime(date, context).second,
+
+    getMonth: (date, context) => toDateTime(date, context).month - 1,
+
+    getDay: (date, context) => toDateTime(date, context).weekday % 7,
+
+    startOfDay: (date, context) => {
+      return fromDateTime(toDateTime(date, context).startOf("day"));
+    },
+
+    setDate: (date, day, context) => {
+      return fromDateTime(toDateTime(date, context).set({ day }));
+    },
+
+    setYear: (date, year, context) => {
+      return fromDateTime(toDateTime(date, context).set({ year }));
+    },
+
+    startOfMonth: (date, context) => {
+      return fromDateTime(toDateTime(date, context).startOf("month"));
+    },
+
+    isSameDay: (a, b, context) => {
+      return toDateTime(a, context).hasSame(toDateTime(b, context), "day");
+    },
+
+    isSameYear: (a, b, context) => {
+      return toDateTime(a, context).hasSame(toDateTime(b, context), "year");
+    },
+
+    isSameMonth: (a, b, context) => {
+      return toDateTime(a, context).hasSame(toDateTime(b, context), "month");
+    },
+
+    addDays: (date, amount, context) => {
+      return fromDateTime(toDateTime(date, context).plus({ days: amount }));
+    },
+
+    addYears: (date, amount, context) => {
+      return fromDateTime(toDateTime(date, context).plus({ years: amount }));
+    },
+
+    setMonth: (date, month, context) => {
+      return fromDateTime(toDateTime(date, context).set({ month: month + 1 }));
+    },
+
+    addMonths: (date, amount, context) => {
+      return fromDateTime(toDateTime(date, context).plus({ months: amount }));
+    },
+
+    getMonthNames: (context) => {
+      const locale = resolveLocale(context) ?? "en-US";
+
+      return Info.months("long", { locale });
+    },
+
+    endOfMonth: (date, context) => {
+      return fromDateTime(
+        toDateTime(date, context).endOf("month").startOf("second"),
+      );
+    },
+
+    setHours: (date, hours, context) => {
+      return fromDateTime(
+        toDateTime(date, context).set({ hour: clamp(hours, 0, 23) }),
+      );
+    },
+
+    isBefore: (a, b, context) => {
+      return (
+        toDateTime(a, context).startOf("day") <
+        toDateTime(b, context).startOf("day")
+      );
+    },
+
+    setMinutes: (date, minutes, context) => {
+      return fromDateTime(
+        toDateTime(date, context).set({ minute: clamp(minutes, 0, 59) }),
+      );
+    },
+
+    setSeconds: (date, seconds, context) => {
+      return fromDateTime(
+        toDateTime(date, context).set({ second: clamp(seconds, 0, 59) }),
+      );
+    },
+
+    parseTime: (value, context, timeOptions) => {
+      return parseTimeWithLuxon({
+        value,
+        adapter,
+        context,
+        toDateTime,
+        timeOptions,
+        fromDateTime,
+      });
+    },
+
+    format: (date, context) => {
+      if (!isValid(date)) {
+        return "";
+      }
+
+      return toDateTime(date, context).toLocaleString({
+        day: "2-digit",
+        year: "numeric",
+        month: "2-digit",
+      });
+    },
+
+    isSameTime: (a, b, context) => {
+      const left = toDateTime(a, context);
+      const right = toDateTime(b, context);
+
+      return (
+        left.hour === right.hour &&
+        left.minute === right.minute &&
+        left.second === right.second
+      );
+    },
+
+    getWeekdayNames: (context) => {
+      const locale = resolveLocale(context) ?? "en-US";
+      // Luxon weekdays are Monday-first; Bridge expects Sunday → Saturday.
+      const names = Info.weekdays("short", { locale });
+
+      return [names[6]!, ...names.slice(0, 6)];
+    },
+
+    now: (context) => {
+      const zone = resolveZone(context);
+      const locale = resolveLocale(context);
+      let value: DateTime = DateTime.now();
+
+      if (!isNil(zone)) {
+        value = value.setZone(zone);
+      }
+
+      if (!isNil(locale)) {
+        value = value.setLocale(locale);
+      }
+
+      return fromDateTime(value);
+    },
+
+    formatTime: (date, context, timeOptions) => {
+      if (!isValid(date)) {
+        return "";
+      }
+
+      const ampm = timeOptions?.ampm === true;
+      const showSeconds = timeOptions?.showSeconds === true;
+
+      return toDateTime(date, context).toLocaleString({
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: ampm ? "h12" : "h23",
+        ...(showSeconds ? { second: "2-digit" as const } : {}),
+      });
+    },
+
+    getCalendarDays: (view, startOfWeek, context) => {
+      const monthStart = adapter.startOfMonth(view, context);
+      const weekday = adapter.getDay(monthStart, context);
+      const normalizedStart = ((startOfWeek % 7) + 7) % 7;
+      const leading = (weekday - normalizedStart + 7) % 7;
+      const gridStart = adapter.addDays(monthStart, -leading, context);
+
+      return range(42).map((index) => {
+        return adapter.addDays(gridStart, index, context);
+      });
+    },
+
+    parse: (value, context) => {
+      if (!isString(value) || value.trim() === "") {
+        return null;
+      }
+
+      const trimmed = value.trim();
+      const iso = DateTime.fromISO(trimmed, {
+        zone: resolveZone(context),
+        locale: resolveLocale(context),
+      });
+
+      if (iso.isValid) {
+        return fromDateTime(iso.startOf("day"));
+      }
+
+      const parsed = DateTime.fromJSDate(new Date(trimmed), {
+        zone: resolveZone(context),
+      });
+
+      if (!parsed.isValid) {
+        return null;
+      }
+
+      return fromDateTime(parsed.startOf("day"));
+    },
+  };
+
+  return adapter;
+}
+
+function parseTimeWithLuxon(input: {
+  adapter: DateAdapter<Date>;
+  context?: DateAdapterContext;
+  fromDateTime: (value: DateTime) => Date;
+  timeOptions?: DateAdapterTimeOptions;
+  toDateTime: (date: Date, context?: DateAdapterContext) => DateTime;
+  value: string;
+}): Date | null {
+  const { value, adapter, context, toDateTime, timeOptions, fromDateTime } =
+    input;
+
+  if (!isString(value) || value.trim() === "") {
+    return null;
+  }
+
+  const trimmed = value.trim();
+  const ampm = timeOptions?.ampm === true;
+  const showSeconds = timeOptions?.showSeconds === true;
+  const format = ampm
+    ? showSeconds
+      ? "h:mm:ss a"
+      : "h:mm a"
+    : showSeconds
+      ? "H:mm:ss"
+      : "H:mm";
+  const parsed = DateTime.fromFormat(trimmed, format, { locale: "en-US" });
+
+  if (!parsed.isValid) {
+    return null;
+  }
+
+  const base = toDateTime(adapter.now(context), context);
+
+  return fromDateTime(
+    base.set({
+      millisecond: 0,
+      hour: parsed.hour,
+      minute: parsed.minute,
+      second: showSeconds ? parsed.second : 0,
+    }),
+  );
+}

package/docs/examples/date-moment.ts

@@ -0,0 +1,334 @@
+/**
+ * Example Moment.js date adapter for `@bridge-ui/vue`.
+ * Copy into your app or wire via `BridgeUIProvider` / `createBridgeUI` `global.dates`.
+ * Not published as an npm package.
+ *
+ * Requires `moment` and `moment-timezone` (IANA zones via `moment.tz`).
+ */
+
+// ** External Imports
+import { clamp, isNil, isString, range } from "es-toolkit/compat";
+import moment, { type Moment } from "moment-timezone";
+
+// ** Core Imports
+import type {
+  DateAdapter,
+  DateAdapterContext,
+  DateAdapterTimeOptions,
+} from "@bridge-ui/core";
+
+/**
+ * Options for {@link createMomentDateAdapter}.
+ */
+export type MomentDateAdapterOptions = {
+  /**
+   * Default locale when context omits `locale`.
+   *
+   * @default undefined
+   */
+  locale?: string;
+
+  /**
+   * Default IANA time zone when context omits `timeZone`.
+   *
+   * @default undefined (system local zone)
+   */
+  timeZone?: string;
+};
+
+/**
+ * Builds a Moment-backed {@link DateAdapter} (`TDate = Date`) for Bridge calendars.
+ */
+export function createMomentDateAdapter(
+  options: MomentDateAdapterOptions = {},
+): DateAdapter<Date> {
+  const resolveLocale = (context?: DateAdapterContext) => {
+    return context?.locale ?? options.locale;
+  };
+
+  const resolveZone = (context?: DateAdapterContext) => {
+    return context?.timeZone ?? options.timeZone;
+  };
+
+  const toMoment = (date: Date, context?: DateAdapterContext): Moment => {
+    const locale = resolveLocale(context);
+    const zone = resolveZone(context);
+    let value = isNil(zone) ? moment(date) : moment.tz(date, zone);
+
+    if (!isNil(locale)) {
+      value = value.locale(locale);
+    }
+
+    return value;
+  };
+
+  const fromMoment = (value: Moment): Date => {
+    return value.toDate();
+  };
+
+  const isValid = (date: Date) => {
+    return date instanceof Date && !Number.isNaN(date.getTime());
+  };
+
+  const adapter: DateAdapter<Date> = {
+    getDay: (date, context) => toMoment(date, context).day(),
+
+    getDate: (date, context) => toMoment(date, context).date(),
+
+    getYear: (date, context) => toMoment(date, context).year(),
+
+    getHours: (date, context) => toMoment(date, context).hour(),
+
+    isAfter: (a, b, context) => adapter.isBefore(b, a, context),
+
+    getMonth: (date, context) => toMoment(date, context).month(),
+
+    getMinutes: (date, context) => toMoment(date, context).minute(),
+
+    getSeconds: (date, context) => toMoment(date, context).second(),
+
+    isSameDay: (a, b, context) => {
+      return toMoment(a, context).isSame(toMoment(b, context), "day");
+    },
+
+    setDate: (date, day, context) => {
+      return fromMoment(toMoment(date, context).clone().date(day));
+    },
+
+    isSameYear: (a, b, context) => {
+      return toMoment(a, context).isSame(toMoment(b, context), "year");
+    },
+
+    setYear: (date, year, context) => {
+      return fromMoment(toMoment(date, context).clone().year(year));
+    },
+
+    startOfDay: (date, context) => {
+      return fromMoment(toMoment(date, context).clone().startOf("day"));
+    },
+
+    endOfMonth: (date, context) => {
+      return fromMoment(toMoment(date, context).clone().endOf("month"));
+    },
+
+    isSameMonth: (a, b, context) => {
+      return toMoment(a, context).isSame(toMoment(b, context), "month");
+    },
+
+    setMonth: (date, month, context) => {
+      return fromMoment(toMoment(date, context).clone().month(month));
+    },
+
+    startOfMonth: (date, context) => {
+      return fromMoment(toMoment(date, context).clone().startOf("month"));
+    },
+
+    addDays: (date, amount, context) => {
+      return fromMoment(toMoment(date, context).clone().add(amount, "days"));
+    },
+
+    addYears: (date, amount, context) => {
+      return fromMoment(toMoment(date, context).clone().add(amount, "years"));
+    },
+
+    addMonths: (date, amount, context) => {
+      return fromMoment(toMoment(date, context).clone().add(amount, "months"));
+    },
+
+    setHours: (date, hours, context) => {
+      return fromMoment(
+        toMoment(date, context)
+          .clone()
+          .hour(clamp(hours, 0, 23)),
+      );
+    },
+
+    setMinutes: (date, minutes, context) => {
+      return fromMoment(
+        toMoment(date, context)
+          .clone()
+          .minute(clamp(minutes, 0, 59)),
+      );
+    },
+
+    setSeconds: (date, seconds, context) => {
+      return fromMoment(
+        toMoment(date, context)
+          .clone()
+          .second(clamp(seconds, 0, 59)),
+      );
+    },
+
+    isBefore: (a, b, context) => {
+      return toMoment(a, context)
+        .clone()
+        .startOf("day")
+        .isBefore(toMoment(b, context).clone().startOf("day"));
+    },
+
+    parseTime: (value, context, timeOptions) => {
+      return parseTimeWithMoment({
+        value,
+        adapter,
+        context,
+        toMoment,
+        fromMoment,
+        timeOptions,
+      });
+    },
+
+    getMonthNames: (context) => {
+      const locale = resolveLocale(context);
+
+      return range(12).map((month) => {
+        return new Intl.DateTimeFormat(locale, { month: "long" }).format(
+          new Date(2021, month, 1),
+        );
+      });
+    },
+
+    isSameTime: (a, b, context) => {
+      const left = toMoment(a, context);
+      const right = toMoment(b, context);
+
+      return (
+        left.hour() === right.hour() &&
+        left.minute() === right.minute() &&
+        left.second() === right.second()
+      );
+    },
+
+    now: (context) => {
+      const zone = resolveZone(context);
+      const locale = resolveLocale(context);
+      let value = isNil(zone) ? moment() : moment.tz(zone);
+
+      if (!isNil(locale)) {
+        value = value.locale(locale);
+      }
+
+      return fromMoment(value);
+    },
+
+    format: (date, context) => {
+      if (!isValid(date)) {
+        return "";
+      }
+
+      const locale = resolveLocale(context);
+      const timeZone = resolveZone(context);
+
+      return new Intl.DateTimeFormat(locale, {
+        timeZone,
+        day: "2-digit",
+        year: "numeric",
+        month: "2-digit",
+      }).format(date);
+    },
+
+    getWeekdayNames: (context) => {
+      const locale = resolveLocale(context);
+      const formatter = new Intl.DateTimeFormat(locale, { weekday: "short" });
+      const sunday = new Date(2021, 0, 3);
+
+      return range(7).map((index) => {
+        const day = new Date(sunday);
+
+        day.setDate(sunday.getDate() + index);
+
+        return formatter.format(day);
+      });
+    },
+
+    parse: (value, context) => {
+      if (!isString(value) || value.trim() === "") {
+        return null;
+      }
+
+      const trimmed = value.trim();
+      const zone = resolveZone(context);
+      const parsed = isNil(zone) ? moment(trimmed) : moment.tz(trimmed, zone);
+
+      if (!parsed.isValid()) {
+        return null;
+      }
+
+      return fromMoment(parsed.startOf("day"));
+    },
+
+    getCalendarDays: (view, startOfWeek, context) => {
+      const monthStart = adapter.startOfMonth(view, context);
+      const weekday = adapter.getDay(monthStart, context);
+      const normalizedStart = ((startOfWeek % 7) + 7) % 7;
+      const leading = (weekday - normalizedStart + 7) % 7;
+      const gridStart = adapter.addDays(monthStart, -leading, context);
+
+      return range(42).map((index) => {
+        return adapter.addDays(gridStart, index, context);
+      });
+    },
+
+    formatTime: (date, context, timeOptions) => {
+      if (!isValid(date)) {
+        return "";
+      }
+
+      const locale = resolveLocale(context);
+      const timeZone = resolveZone(context);
+      const ampm = timeOptions?.ampm === true;
+      const showSeconds = timeOptions?.showSeconds === true;
+
+      return new Intl.DateTimeFormat(locale, {
+        timeZone,
+        hour12: ampm,
+        hour: "2-digit",
+        minute: "2-digit",
+        ...(showSeconds ? { second: "2-digit" as const } : {}),
+      }).format(date);
+    },
+  };
+
+  return adapter;
+}
+
+function parseTimeWithMoment(input: {
+  adapter: DateAdapter<Date>;
+  context?: DateAdapterContext;
+  fromMoment: (value: Moment) => Date;
+  timeOptions?: DateAdapterTimeOptions;
+  toMoment: (date: Date, context?: DateAdapterContext) => Moment;
+  value: string;
+}): Date | null {
+  const { value, adapter, context, toMoment, fromMoment, timeOptions } = input;
+
+  if (!isString(value) || value.trim() === "") {
+    return null;
+  }
+
+  const trimmed = value.trim();
+  const ampm = timeOptions?.ampm === true;
+  const showSeconds = timeOptions?.showSeconds === true;
+  const format = ampm
+    ? showSeconds
+      ? "h:mm:ss A"
+      : "h:mm A"
+    : showSeconds
+      ? "H:mm:ss"
+      : "H:mm";
+  const parsed = moment(trimmed, format, true);
+
+  if (!parsed.isValid()) {
+    return null;
+  }
+
+  const base = toMoment(adapter.now(context), context);
+
+  return fromMoment(
+    base
+      .clone()
+      .hour(parsed.hour())
+      .minute(parsed.minute())
+      .second(showSeconds ? parsed.second() : 0)
+      .millisecond(0),
+  );
+}

package/docs/examples/icon-fontawesome.ts

@@ -11,13 +11,17 @@
 import type { IconDefinition } from "@fortawesome/fontawesome-svg-core";
 import {
   faBell,
+  faCalendarDays,
   faCheck,
   faChevronDown,
+  faChevronLeft,
+  faChevronRight,
   faChevronUp,
   faCircleCheck,
   faCircleExclamation,
   faCircleInfo,
   faCircleXmark,
+  faClock,
   faEye,
   faEyeSlash,
   faSpinner,
@@ -84,6 +88,7 @@ const icons = {
   user: faUser,
   clear: faXmark,
   check: faCheck,
+  clock: faClock,
   loader: faSpinner,
   info: faCircleInfo,
   eyeOff: faEyeSlash,
@@ -91,8 +96,11 @@ const icons = {
   success: faCircleCheck,
   chevronUp: faChevronUp,
   chevronUpDown: faUpDown,
+  calendar: faCalendarDays,
   alert: faCircleExclamation,
   chevronDown: faChevronDown,
+  chevronLeft: faChevronLeft,
+  chevronRight: faChevronRight,
   warning: faTriangleExclamation,
 } satisfies Record<SemanticIconName, unknown>;