@reachweb/alpine-calendar 0.1.1 → 0.2.0

package/dist/core/metadata.d.ts

@@ -0,0 +1,25 @@
+import type { CalendarDate } from './calendar-date';
+/** Metadata that can be attached to individual dates. */
+export interface DateMeta {
+    /** Text below the day number (e.g., "$150"). */
+    label?: string;
+    /** Visual availability state. 'unavailable' disables selection + shows strikethrough. */
+    availability?: 'available' | 'unavailable';
+    /** CSS color applied as --color-calendar-day-meta on the cell (for dot/label). */
+    color?: string;
+    /** Custom class(es) added to the day cell. */
+    cssClass?: string;
+}
+/**
+ * Provider for per-date metadata.
+ * Either a static object map keyed by ISO date strings, or a callback.
+ */
+export type DateMetaProvider = ((date: CalendarDate) => DateMeta | undefined) | Record<string, DateMeta>;
+/**
+ * Normalize a DateMetaProvider into a consistent callback form.
+ *
+ * - `undefined`/`null` → returns a no-op that always returns `undefined`
+ * - function → pass through
+ * - object map → wrap in `(date) => map[date.toISO()]`
+ */
+export declare function normalizeDateMeta(provider: DateMetaProvider | undefined | null): (date: CalendarDate) => DateMeta | undefined;

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export type { Selection } from './core/selection';
 export { createDateConstraint, createRangeValidator, createDisabledReasons, isDateDisabled, } from './core/constraints';
 export type { DateConstraintOptions, DateConstraintProperties, DateConstraintRule, ConstraintMessages, } from './core/constraints';
 export type { CalendarConfigRule, RangePreset } from './plugin/calendar-component';
+export { normalizeDateMeta } from './core/metadata';
+export type { DateMeta, DateMetaProvider } from './core/metadata';
 export { presetToday, presetYesterday, presetLastNDays, presetThisWeek, presetLastWeek, presetThisMonth, presetLastMonth, presetThisYear, presetLastYear, } from './core/presets';
 export { parseDate, parseDateRange, parseDateMultiple } from './input/parser';
 export { formatDate, formatRange, formatMultiple } from './input/formatter';

package/dist/plugin/calendar-component.d.ts

@@ -3,6 +3,7 @@ import type { ConstraintMessages } from '../core/constraints';
 import type { DayCell, MonthGrid, MonthCell, YearCell } from '../core/grid';
 import type { Selection } from '../core/selection';
 import type { RangePreset } from '../core/presets';
+import type { DateMeta, DateMetaProvider } from '../core/metadata';
 /** Period-specific constraint rule (string-based for Alpine/HTML config). */
 export interface CalendarConfigRule {
     /** Start of the period (ISO string). Required unless `months` is set. */
@@ -128,6 +129,8 @@ export interface CalendarConfig {
         /** Whether this click would select or deselect the date. */
         action: 'select' | 'deselect';
     }) => boolean | undefined;
+    /** Per-date metadata (labels, availability, colors). Static map or callback. */
+    dateMetadata?: DateMetaProvider;
     /** Custom messages for disabled-date tooltips. Overrides default English strings. */
     constraintMessages?: ConstraintMessages;
     /** Auto-render template when no `.rc-calendar` exists in the container. Default: true. Set false to require manual template. */
@@ -199,6 +202,10 @@ export declare function createCalendarData(config?: CalendarConfig, Alpine?: {
      * re-evaluates class bindings without needing a full grid rebuild.
      */
     _selectionRev: number;
+    _getDateMeta: (date: CalendarDate) => DateMeta | undefined;
+    _metadataRev: number;
+    /** Check if a date is effectively disabled (constraint OR metadata unavailability). */
+    _isEffectivelyDisabled(d: CalendarDate): boolean;
     _statusMessage: string;
     readonly selectedDates: CalendarDate[];
     readonly formattedValue: string;
@@ -299,6 +306,20 @@ export declare function createCalendarData(config?: CalendarConfig, Alpine?: {
         date: CalendarDate;
         isDisabled: boolean;
     }): string;
+    /**
+     * Get metadata for a day cell. Returns `DateMeta | undefined`.
+     * Reads `_metadataRev` for Alpine reactivity.
+     */
+    dayMeta(cell: {
+        date: CalendarDate;
+    }): DateMeta | undefined;
+    /**
+     * Get inline style string for a day cell.
+     * Sets `--color-calendar-day-meta` when the metadata has a custom color.
+     */
+    dayStyle(cell: {
+        date: CalendarDate;
+    }): string;
     /**
      * Bind an input element to the calendar.
      *
@@ -452,6 +473,20 @@ export declare function createCalendarData(config?: CalendarConfig, Alpine?: {
      * ```
      */
     updateConstraints(updates: Partial<CalendarConfig>): void;
+    /**
+     * Update the date metadata provider at runtime.
+     *
+     * Normalizes the provider, bumps the reactive counter, and rebuilds
+     * the day grid (since unavailability affects disabled state).
+     *
+     * Usage:
+     * ```js
+     * $data.updateDateMetadata({
+     *   '2026-03-15': { label: '$150', availability: 'available' },
+     * })
+     * ```
+     */
+    updateDateMetadata(provider: DateMetaProvider | undefined | null): void;
     setView(newView: "days" | "months" | "years"): void;
     selectMonth(targetMonth: number): void;
     selectYear(targetYear: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reachweb/alpine-calendar",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "description": "A lightweight, AlpineJS-native calendar component with inline/popup display, input binding with masking, and TailwindCSS 4 theming.",
   "main": "dist/alpine-calendar.umd.js",
@@ -21,21 +21,6 @@
   "sideEffects": [
     "*.css"
   ],
-  "scripts": {
-    "dev": "vite",
-    "build": "pnpm build:lib && pnpm build:cdn && tsc --emitDeclarationOnly",
-    "build:lib": "vite build --config vite.config.lib.ts",
-    "build:cdn": "vite build --config vite.config.cdn.ts",
-    "preview": "vite preview",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "format": "prettier --write 'src/**/*.{ts,css}'",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm run build"
-  },
   "peerDependencies": {
     "alpinejs": "^3.0.0"
   },
@@ -82,5 +67,20 @@
     "*.css": [
       "prettier --write"
     ]
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "pnpm build:lib && pnpm build:cdn && tsc --emitDeclarationOnly",
+    "build:lib": "vite build --config vite.config.lib.ts",
+    "build:cdn": "vite build --config vite.config.cdn.ts",
+    "build:demo": "vite build --config vite.config.demo.ts",
+    "preview": "vite preview",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write 'src/**/*.{ts,css}'",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
   }
-}
+}