@bridge-ui/vue 0.0.7 → 0.0.9

package/docs/components/useModalAction.md

@@ -0,0 +1,75 @@
+# useModalAction
+
+Imperative API to mount custom components inside `Modal`. Requires `BridgeModalHost`.
+
+## Import
+
+```ts
+import { useModalAction } from "@bridge-ui/vue/Actions";
+```
+
+## Prerequisites
+
+Mount `BridgeUIHosts` with the matching host (`BridgeDialogHost`, `BridgeModalHost`, or `BridgeSnackbarHost`) inside `BridgeUIProvider`.
+
+## Examples
+
+### Usage
+
+```ts
+const modal = useModalAction();
+
+const id = modal.open({
+  component: SettingsForm,
+  modal: { size: "lg", title: "Settings" },
+});
+```
+
+### open
+
+```vue
+<Button v-on:click="openBasic">Open basic</Button>
+
+<Button variant="outline" v-on:click="openWithOptions">
+  Open with modal options
+</Button>
+```
+
+### close / closeTop
+
+```vue
+<Button
+  variant="outline"
+  :disabled="!lastId"
+  v-on:click="lastId && modal.close(lastId)"
+>
+  close(lastId)
+</Button>
+
+<Button variant="outline" v-on:click="modal.closeTop()">
+  closeTop()
+</Button>
+```
+
+### Nested stack
+
+```vue
+<Button v-on:click="openNested">Open nested example</Button>
+```
+
+## API
+
+| Method              | Description                   |
+| ------------------- | ----------------------------- |
+| `open(options)`     | Push a modal onto the stack   |
+| `close(id)`         | Close a specific modal        |
+| `closeTop()`        | Close the topmost modal       |
+| `isOpen(id)`        | Whether an id is open         |
+| `update(id, patch)` | Update props or modal options |
+| `stackSize`         | Current stack depth           |
+
+**open() options:** `component`, `props`, `modal` (`size`, `transition`, `persistent`, `align`), `onClose`, `onClosed`
+
+## Related components
+
+Modal, useDialogAction, BridgeUIProvider

package/docs/components/useSnackbarAction.md

@@ -0,0 +1,85 @@
+# useSnackbarAction
+
+Imperative API for toast notifications. Requires `BridgeSnackbarHost`.
+
+## Import
+
+```ts
+import { useSnackbarAction } from "@bridge-ui/vue/Actions";
+```
+
+## Prerequisites
+
+Mount `BridgeUIHosts` with the matching host (`BridgeDialogHost`, `BridgeModalHost`, or `BridgeSnackbarHost`) inside `BridgeUIProvider`.
+
+## Examples
+
+### Usage
+
+```ts
+const snackbar = useSnackbarAction();
+
+snackbar.open({
+  title: "Saved",
+  color: "success",
+  description: "Your changes were saved successfully.",
+});
+```
+
+### open
+
+```vue
+<Button v-on:click="openBasic">Open basic</Button>
+
+<Button variant="outline" v-on:click="openWithOptions">
+  Open with options
+</Button>
+```
+
+### close / closeAll
+
+```vue
+<Button variant="outline" v-on:click="snackbar.closeTop()">
+  closeTop()
+</Button>
+
+<Button variant="outline" v-on:click="snackbar.closeAll()">
+  closeAll()
+</Button>
+```
+
+### update
+
+```vue
+<Button v-on:click="openUpdateDemo">Open update demo</Button>
+
+<Button
+  variant="outline"
+  :disabled="!updateDemoId"
+  v-on:click="
+    snackbar.update(updateDemoId, {
+      props: { title: 'Updated title' },
+    })
+  "
+>
+  update props
+</Button>
+```
+
+## API
+
+| Method              | Description                    |
+| ------------------- | ------------------------------ |
+| `open(options)`     | Push a snackbar onto the stack |
+| `close(id)`         | Close a specific snackbar      |
+| `closeTop()`        | Close the topmost snackbar     |
+| `closeAll()`        | Close all snackbars            |
+| `isOpen(id)`        | Whether an id is open          |
+| `update(id, patch)` | Update snackbar props          |
+| `stackSize`         | Current stack depth            |
+
+**open() options:** `title`, `description`, `color`, `duration`, `position`, `onClose`, `onClosed`
+
+## Related components
+
+Snackbar, Alert, BridgeUIProvider

package/docs/examples/date-date-fns.ts

@@ -0,0 +1,286 @@
+/**
+ * Example date-fns date adapter for `@bridge-ui/vue`.
+ * Copy into your app or wire via `BridgeUIProvider` / `createBridgeUI` `global.dates`.
+ * Not published as an npm package.
+ *
+ * Requires `date-fns`. Values stay as native `Date` (date-fns default).
+ * For IANA zones, prefer the Luxon or Day.js samples.
+ */
+
+// ** External Imports
+import {
+  addDays,
+  addMonths,
+  addYears,
+  endOfMonth,
+  format as formatDate,
+  getDate,
+  getDay,
+  getHours,
+  getMinutes,
+  getMonth,
+  getSeconds,
+  getYear,
+  isAfter,
+  isBefore,
+  isSameDay,
+  isSameMonth,
+  isSameYear,
+  isValid,
+  parse,
+  parseISO,
+  setDate,
+  setHours,
+  setMinutes,
+  setMonth,
+  setSeconds,
+  setYear,
+  startOfDay,
+  startOfMonth,
+} from "date-fns";
+import { clamp, isNil, isString, range } from "es-toolkit/compat";
+
+// ** Core Imports
+import type {
+  DateAdapter,
+  DateAdapterContext,
+  DateAdapterTimeOptions,
+} from "@bridge-ui/core";
+
+/**
+ * Options for {@link createDateFnsDateAdapter}.
+ */
+export type DateFnsDateAdapterOptions = {
+  /**
+   * Default locale when context omits `locale`.
+   *
+   * @default undefined
+   */
+  locale?: string;
+
+  /**
+   * Default IANA time zone when context omits `timeZone`.
+   * Used for `format` / `formatTime` via `Intl` (date-fns itself is local).
+   *
+   * @default undefined
+   */
+  timeZone?: string;
+};
+
+/**
+ * Builds a date-fns-backed {@link DateAdapter} (`TDate = Date`) for Bridge calendars.
+ */
+export function createDateFnsDateAdapter(
+  options: DateFnsDateAdapterOptions = {},
+): DateAdapter<Date> {
+  const resolveLocale = (context?: DateAdapterContext) => {
+    return context?.locale ?? options.locale;
+  };
+
+  const resolveTimeZone = (context?: DateAdapterContext) => {
+    return context?.timeZone ?? options.timeZone;
+  };
+
+  const isValidDate = (date: Date) => {
+    return date instanceof Date && isValid(date);
+  };
+
+  const adapter: DateAdapter<Date> = {
+    now: () => new Date(),
+
+    getDay: (date) => getDay(date),
+
+    getDate: (date) => getDate(date),
+
+    getYear: (date) => getYear(date),
+
+    getMonth: (date) => getMonth(date),
+
+    getHours: (date) => getHours(date),
+
+    isSameDay: (a, b) => isSameDay(a, b),
+
+    getMinutes: (date) => getMinutes(date),
+
+    getSeconds: (date) => getSeconds(date),
+
+    isSameYear: (a, b) => isSameYear(a, b),
+
+    startOfDay: (date) => startOfDay(date),
+
+    endOfMonth: (date) => endOfMonth(date),
+
+    isSameMonth: (a, b) => isSameMonth(a, b),
+
+    startOfMonth: (date) => startOfMonth(date),
+
+    setDate: (date, day) => setDate(date, day),
+
+    setYear: (date, year) => setYear(date, year),
+
+    setMonth: (date, month) => setMonth(date, month),
+
+    addDays: (date, amount) => addDays(date, amount),
+
+    addYears: (date, amount) => addYears(date, amount),
+
+    addMonths: (date, amount) => addMonths(date, amount),
+
+    isAfter: (a, b) => isAfter(startOfDay(a), startOfDay(b)),
+
+    isBefore: (a, b) => isBefore(startOfDay(a), startOfDay(b)),
+
+    setHours: (date, hours) => setHours(date, clamp(hours, 0, 23)),
+
+    setMinutes: (date, minutes) => setMinutes(date, clamp(minutes, 0, 59)),
+
+    setSeconds: (date, seconds) => setSeconds(date, clamp(seconds, 0, 59)),
+
+    parseTime: (value, context, timeOptions) => {
+      return parseTimeWithDateFns({
+        value,
+        adapter,
+        context,
+        timeOptions,
+      });
+    },
+
+    isSameTime: (a, b) => {
+      return (
+        getHours(a) === getHours(b) &&
+        getMinutes(a) === getMinutes(b) &&
+        getSeconds(a) === getSeconds(b)
+      );
+    },
+
+    getMonthNames: (context) => {
+      const locale = resolveLocale(context);
+
+      return range(12).map((month) => {
+        return new Intl.DateTimeFormat(locale, { month: "long" }).format(
+          new Date(2021, month, 1),
+        );
+      });
+    },
+
+    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) => {
+      if (!isString(value) || value.trim() === "") {
+        return null;
+      }
+
+      const trimmed = value.trim();
+      const iso = parseISO(trimmed);
+
+      if (isValid(iso) && /^\d{4}-\d{2}-\d{2}/.test(trimmed)) {
+        return startOfDay(iso);
+      }
+
+      const parsed = new Date(trimmed);
+
+      return isValidDate(parsed) ? startOfDay(parsed) : null;
+    },
+
+    format: (date, context) => {
+      if (!isValidDate(date)) {
+        return "";
+      }
+
+      const locale = resolveLocale(context);
+      const timeZone = resolveTimeZone(context);
+
+      if (!isNil(timeZone) || !isNil(locale)) {
+        return new Intl.DateTimeFormat(locale, {
+          timeZone,
+          day: "2-digit",
+          year: "numeric",
+          month: "2-digit",
+        }).format(date);
+      }
+
+      return formatDate(date, "P");
+    },
+
+    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 (!isValidDate(date)) {
+        return "";
+      }
+
+      const locale = resolveLocale(context);
+      const timeZone = resolveTimeZone(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 parseTimeWithDateFns(input: {
+  adapter: DateAdapter<Date>;
+  context?: DateAdapterContext;
+  timeOptions?: DateAdapterTimeOptions;
+  value: string;
+}): Date | null {
+  const { value, adapter, context, timeOptions } = input;
+
+  if (!isString(value) || value.trim() === "") {
+    return null;
+  }
+
+  const trimmed = value.trim();
+  const ampm = timeOptions?.ampm === true;
+  const showSeconds = timeOptions?.showSeconds === true;
+  const pattern = ampm
+    ? showSeconds
+      ? "h:mm:ss a"
+      : "h:mm a"
+    : showSeconds
+      ? "H:mm:ss"
+      : "H:mm";
+  const parsed = parse(trimmed, pattern, adapter.now(context));
+
+  if (!isValid(parsed)) {
+    return null;
+  }
+
+  const base = adapter.now(context);
+
+  return setSeconds(
+    setMinutes(setHours(base, getHours(parsed)), getMinutes(parsed)),
+    showSeconds ? getSeconds(parsed) : 0,
+  );
+}