forty-cdk 0.0.1

package/internationalized-date/README.md

@@ -0,0 +1,23 @@
+# forty-cdk/internationalized-date
+
+Secondary entry point holding the [`@internationalized/date`](https://react-spectrum.adobe.com/internationalized/date/) implementations of the `DateAdapter` contract:
+
+- `InternationalizedDateAdapter` / `provideInternationalizedDateAdapter()` — day-granular `CalendarDate`.
+- `InternationalizedDateTimeAdapter` / `provideInternationalizedDateTimeAdapter()` — time-capable `CalendarDateTime`.
+
+It exists so the main `forty-cdk` bundle never references `@internationalized/date`: the package is an **optional peer dependency**, required only by consumers who import this entry point. The date/time primitives themselves (`Calendar`, `DateField`, `DatePicker`, `TimeField`) depend only on the abstract `DateAdapter` from the main entry point — `provideNativeDateAdapter()` works with zero extra installs.
+
+```bash
+npm install @internationalized/date
+```
+
+```ts
+import { bootstrapApplication } from '@angular/platform-browser';
+import { provideInternationalizedDateAdapter } from 'forty-cdk/internationalized-date';
+
+bootstrapApplication(App, {
+  providers: [provideInternationalizedDateAdapter()],
+});
+```
+
+See the [Calendar README](../src/lib/calendar/README.md) for the full adapter table and usage examples.

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "forty-cdk",
+  "version": "0.0.1",
+  "description": "Headless / styleless UI primitives for Angular with WAI-ARIA accessibility built in.",
+  "keywords": [
+    "angular",
+    "headless",
+    "unstyled",
+    "ui",
+    "components",
+    "primitives",
+    "accessibility",
+    "a11y",
+    "wai-aria",
+    "aria",
+    "signals",
+    "zoneless"
+  ],
+  "homepage": "https://github.com/tutkli/forty-cdk#readme",
+  "bugs": {
+    "url": "https://github.com/tutkli/forty-cdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tutkli/forty-cdk.git",
+    "directory": "projects/forty-cdk"
+  },
+  "license": "MIT",
+  "author": "tutkli (https://github.com/tutkli)",
+  "peerDependencies": {
+    "@angular/common": "^22.0.0",
+    "@angular/core": "^22.0.0",
+    "@angular/forms": "^22.0.0",
+    "@internationalized/date": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/forms": {
+      "optional": true
+    },
+    "@internationalized/date": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@floating-ui/dom": "^1.6.0",
+    "tslib": "^2.3.0"
+  },
+  "sideEffects": false,
+  "module": "fesm2022/forty-cdk.mjs",
+  "typings": "types/forty-cdk.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/forty-cdk.d.ts",
+      "default": "./fesm2022/forty-cdk.mjs"
+    },
+    "./internationalized-date": {
+      "types": "./types/forty-cdk-internationalized-date.d.ts",
+      "default": "./fesm2022/forty-cdk-internationalized-date.mjs"
+    }
+  },
+  "type": "module"
+}

package/types/forty-cdk-internationalized-date.d.ts

@@ -0,0 +1,139 @@
+import * as i0 from '@angular/core';
+import { Provider } from '@angular/core';
+import { CalendarDate, CalendarDateTime } from '@internationalized/date';
+import { DateAdapter } from 'forty-cdk';
+
+/**
+ * {@link DateAdapter} over `@internationalized/date`'s immutable `CalendarDate`.
+ * This is the recommended adapter: it is the same date primitive React Aria and
+ * Ark UI build on, it works in every browser today with no polyfill, and its
+ * reference-equality-on-mutation makes it signal-friendly.
+ *
+ * **Gregorian only.** `createDate` always builds a Gregorian `CalendarDate`, so
+ * the calendar grid is Gregorian regardless of the runtime locale. True
+ * non-Gregorian calendar systems are deferred to the planned Temporal adapter
+ * track (#354).
+ *
+ * Ships in the `forty-cdk/internationalized-date` secondary entry point so the
+ * main `forty-cdk` bundle never references `@internationalized/date` — the
+ * package is an **optional peer dependency**, required only by consumers who
+ * import this entry point. A consumer relying solely on
+ * `provideNativeDateAdapter()` never resolves it at all.
+ */
+declare class InternationalizedDateAdapter implements DateAdapter<CalendarDate> {
+    /**
+     * Today as a `CalendarDate` in the runtime time zone (`getLocalTimeZone()`).
+     * Subject to the SSR/hydration caveat on {@link DateAdapter.today}.
+     */
+    today(): CalendarDate;
+    createDate(year: number, month: number, day: number): CalendarDate;
+    getYear(date: CalendarDate): number;
+    getMonth(date: CalendarDate): number;
+    getDate(date: CalendarDate): number;
+    getDayOfWeek(date: CalendarDate): number;
+    getDaysInMonth(date: CalendarDate): number;
+    getFirstDayOfWeek(): number;
+    addDays(date: CalendarDate, n: number): CalendarDate;
+    addMonths(date: CalendarDate, n: number): CalendarDate;
+    addYears(date: CalendarDate, n: number): CalendarDate;
+    compare(a: CalendarDate, b: CalendarDate): number;
+    isSameDay(a: CalendarDate, b: CalendarDate): boolean;
+    isValid(date: CalendarDate): boolean;
+    /**
+     * Formats through the runtime's default locale and time zone. Subject to the
+     * SSR/hydration caveat on {@link DateAdapter.format}.
+     */
+    format(date: CalendarDate, options: Intl.DateTimeFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InternationalizedDateAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InternationalizedDateAdapter>;
+}
+/**
+ * Provides the {@link InternationalizedDateAdapter} as the active
+ * {@link DateAdapter}, making `ForCalendar` operate on `CalendarDate` values
+ * from `@internationalized/date`.
+ *
+ * Requires `@internationalized/date` to be installed (optional peer
+ * dependency).
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideInternationalizedDateAdapter()],
+ * });
+ * ```
+ */
+declare function provideInternationalizedDateAdapter(): Provider[];
+
+/**
+ * Time-capable {@link DateAdapter} over `@internationalized/date`'s immutable
+ * `CalendarDateTime`. It mirrors {@link InternationalizedDateAdapter} for all
+ * day operations but adds a wall-clock time component (hour / minute / second),
+ * so it backs `ForTimeField` and the time granularity of the date primitives.
+ * Use it when you want the `@internationalized/date` types *and* a time.
+ *
+ * **Gregorian only.** Like {@link InternationalizedDateAdapter}, `createDate`
+ * builds a Gregorian `CalendarDateTime`; non-Gregorian calendar systems are
+ * deferred to the planned Temporal adapter track (#354).
+ *
+ * Ships in the `forty-cdk/internationalized-date` secondary entry point so the
+ * main `forty-cdk` bundle never references `@internationalized/date` — the
+ * package is an **optional peer dependency**, required only by consumers who
+ * import this entry point. A consumer relying solely on
+ * `provideNativeDateAdapter()` never resolves it at all.
+ *
+ * `compare` orders by the full date-time (day *and* time); `compareDate`
+ * ignores the time and orders by calendar day, so the calendar grid stays
+ * day-granular even when `min`/`max` carry a time.
+ */
+declare class InternationalizedDateTimeAdapter implements DateAdapter<CalendarDateTime> {
+    /**
+     * Today as a `CalendarDateTime` in the runtime time zone
+     * (`getLocalTimeZone()`). Subject to the SSR/hydration caveat on
+     * {@link DateAdapter.today}.
+     */
+    today(): CalendarDateTime;
+    createDate(year: number, month: number, day: number): CalendarDateTime;
+    getYear(date: CalendarDateTime): number;
+    getMonth(date: CalendarDateTime): number;
+    getDate(date: CalendarDateTime): number;
+    getDayOfWeek(date: CalendarDateTime): number;
+    getDaysInMonth(date: CalendarDateTime): number;
+    getFirstDayOfWeek(): number;
+    addDays(date: CalendarDateTime, n: number): CalendarDateTime;
+    addMonths(date: CalendarDateTime, n: number): CalendarDateTime;
+    addYears(date: CalendarDateTime, n: number): CalendarDateTime;
+    compare(a: CalendarDateTime, b: CalendarDateTime): number;
+    compareDate(a: CalendarDateTime, b: CalendarDateTime): number;
+    isSameDay(a: CalendarDateTime, b: CalendarDateTime): boolean;
+    isValid(date: CalendarDateTime): boolean;
+    /**
+     * Formats through the runtime's default locale and time zone. Subject to the
+     * SSR/hydration caveat on {@link DateAdapter.format}.
+     */
+    format(date: CalendarDateTime, options: Intl.DateTimeFormatOptions): string;
+    supportsTime(): boolean;
+    getHours(date: CalendarDateTime): number;
+    getMinutes(date: CalendarDateTime): number;
+    getSeconds(date: CalendarDateTime): number;
+    setTime(date: CalendarDateTime, hours: number, minutes: number, seconds: number): CalendarDateTime;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InternationalizedDateTimeAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<InternationalizedDateTimeAdapter>;
+}
+/**
+ * Provides the {@link InternationalizedDateTimeAdapter} as the active
+ * {@link DateAdapter}, making the time / date-time primitives operate on
+ * `CalendarDateTime` values from `@internationalized/date`.
+ *
+ * Requires `@internationalized/date` to be installed (optional peer
+ * dependency).
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [provideInternationalizedDateTimeAdapter()],
+ * });
+ * ```
+ */
+declare function provideInternationalizedDateTimeAdapter(): Provider[];
+
+export { InternationalizedDateAdapter, InternationalizedDateTimeAdapter, provideInternationalizedDateAdapter, provideInternationalizedDateTimeAdapter };