bank20baht-ui 0.2.5 → 0.2.7

package/dist/components/primitives/baht-datepicker.d.ts

@@ -1,6 +1,38 @@
-import { TemplateResult } from 'lit';
+import { PropertyValues, TemplateResult } from 'lit';
 import { BahtFieldBase } from '../base.js';
-/** Value = ISO date string (yyyy-mm-dd). */
+/**
+ * Calendar field on top of flatpickr. The VALUE is always ISO `yyyy-mm-dd`
+ * regardless of `field.dateFormat` (display only):
+ *   - `dateMode: 'single'` (default) -> `string | null`
+ *   - `dateMode: 'range'`            -> `[start, end] | null` (inclusive)
+ *   - `dateMode: 'multiple'`         -> `string[]`
+ * `min` / `max` bound the calendar; `disabledDates` (ISO days or `a/b`
+ * intervals) and `disabledWeekdays` (0 = Sun … 6 = Sat) grey days out — and
+ * the engine re-checks them on validate, so the calendar is UX, not the gate.
+ *
+ * The calendar renders INSIDE the element (flatpickr `static`), so it lives in
+ * light DOM like every other node and picks up a theme set on any ancestor.
+ * Give a clipping ancestor (`overflow: hidden`) room, or it hides the popup.
+ */
 export declare class BahtDatepicker extends BahtFieldBase {
+    private fp;
+    /**
+     * What we last told the host. A controlled host re-feeds `value` after the
+     * event, but a slow (or absent) re-feed must not make onClose re-emit the
+     * pick onChange already sent — compare against this until `value` catches up.
+     */
+    private lastEmitted;
     protected renderControl(): TemplateResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: PropertyValues<this>): void;
+    private teardown;
+    /** Push the host-fed `value` into the calendar without echoing an event. */
+    private syncValue;
+    private options;
+    private emitIfChanged;
+    /** Host value (any mode) -> the Date list flatpickr works with. */
+    private datesOf;
+    /** flatpickr's selection -> the value shape of the field's mode. */
+    private toValue;
 }

package/dist/core/dates.d.ts

@@ -0,0 +1,29 @@
+import { DateMode, FieldDescriptor } from './types.js';
+/** ISO day -> local Date at midnight, or null when malformed / not a real day. */
+export declare function parseIsoDate(iso: unknown): Date | null;
+/** Local Date -> ISO day. */
+export declare function formatIsoDate(date: Date): string;
+export declare const dateModeOf: (field: FieldDescriptor) => DateMode;
+/**
+ * Every ISO day a date value holds, whatever the mode: a single string, a
+ * `[start, end]` range (both ends only — the interior is implied) or a list.
+ * Non-string entries are dropped; shape errors are the validator's job.
+ */
+export declare function isoDaysOf(value: unknown): string[];
+/**
+ * One `disabledDates` entry: an ISO day or an inclusive ISO interval
+ * `start/end`. Returns `[from, to]` (from === to for a single day) or null.
+ */
+export declare function parseDisabledEntry(entry: string): [Date, Date] | null;
+/**
+ * True when `iso` falls on a disabled weekday or inside a disabled date /
+ * interval of the descriptor. Malformed entries never disable anything.
+ */
+export declare function isDateDisabled(field: FieldDescriptor, iso: string): boolean;
+/**
+ * Days between a range's ends (inclusive) that a picker would step over —
+ * so a range can be rejected when a holiday sits INSIDE it. Capped so a
+ * hostile `["1900-01-01","2999-12-31"]` submission cannot spin the server;
+ * beyond the cap only the ends are checked.
+ */
+export declare function rangeInteriorDays(start: string, end: string, cap?: number): string[];

package/dist/core/i18n.d.ts

@@ -6,6 +6,7 @@ export interface MessageCatalog {
     max: string;
     pattern: string;
     email: string;
+    dateDisabled: string;
     compareEq: string;
     compareNe: string;
     compareGt: string;

package/dist/core/index.d.ts

@@ -11,3 +11,4 @@ export { resolveNext, walkPath } from './engine/graph.js';
 export { evalCondition, readRef } from './engine/conditions.js';
 export { evalValueExpr } from './engine/expressions.js';
 export { displayValue, type DisplayValue } from './display.js';
+export { formatIsoDate, isDateDisabled, parseDisabledEntry, parseIsoDate } from './dates.js';

package/dist/core/types.d.ts

@@ -1,6 +1,8 @@
 /** Control types supported by v1 (spec 01 §2). */
 export type FieldType = 'text' | 'textarea' | 'number' | 'email' | 'password' | 'dropdown' | 'multiselect' | 'checkbox' | 'radio' | 'toggle' | 'date' | 'file' | 'label' | 'section' | 'repeater';
 export type FieldWidth = '1/4' | '1/2' | '3/4' | 'full';
+/** `date` field selection mode (spec 01 §2). */
+export type DateMode = 'single' | 'range' | 'multiple';
 export interface FieldOption {
     key: string;
     label: string;
@@ -48,6 +50,25 @@ export interface FieldDescriptor {
     minLength?: number;
     min?: number | string;
     max?: number | string;
+    /**
+     * date: selection mode. 'single' (default) -> value is one ISO string;
+     * 'range' -> value is `[start, end]` (both ISO, inclusive); 'multiple' ->
+     * value is an ISO string[] in pick order.
+     */
+    dateMode?: DateMode;
+    /**
+     * date: DISPLAY format of the typed/rendered text (flatpickr tokens, e.g.
+     * 'd/m/Y', 'j M Y'). The VALUE stays ISO yyyy-mm-dd regardless.
+     */
+    dateFormat?: string;
+    /**
+     * date: days that cannot be picked — each entry an ISO date ('2026-04-13')
+     * or an inclusive ISO interval ('2026-04-13/2026-04-15'). Enforced by the
+     * engine too, so a hand-crafted submission cannot bypass the calendar.
+     */
+    disabledDates?: string[];
+    /** date: weekdays that cannot be picked, 0 = Sunday … 6 = Saturday. */
+    disabledWeekdays?: number[];
     step?: number;
     rows?: number;
     accept?: string;

package/dist/custom-elements.json

@@ -2515,9 +2515,27 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Value = ISO date string (yyyy-mm-dd).",
+          "description": "Calendar field on top of flatpickr. The VALUE is always ISO `yyyy-mm-dd`\nregardless of `field.dateFormat` (display only):\n  - `dateMode: 'single'` (default) -> `string | null`\n  - `dateMode: 'range'`            -> `[start, end] | null` (inclusive)\n  - `dateMode: 'multiple'`         -> `string[]`\n`min` / `max` bound the calendar; `disabledDates` (ISO days or `a/b`\nintervals) and `disabledWeekdays` (0 = Sun … 6 = Sat) grey days out — and\nthe engine re-checks them on validate, so the calendar is UX, not the gate.\n\nThe calendar renders INSIDE the element (flatpickr `static`), so it lives in\nlight DOM like every other node and picks up a theme set on any ancestor.\nGive a clipping ancestor (`overflow: hidden`) room, or it hides the popup.",
           "name": "BahtDatepicker",
           "members": [
+            {
+              "kind": "field",
+              "name": "fp",
+              "type": {
+                "text": "FlatpickrInstance | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "lastEmitted",
+              "type": {
+                "text": "Date[] | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "What we last told the host. A controlled host re-feeds `value` after the\nevent, but a slow (or absent) re-feed must not make onClose re-emit the\npick onChange already sent — compare against this until `value` catches up."
+            },
             {
               "kind": "method",
               "name": "renderControl",
@@ -2532,6 +2550,93 @@
                 "module": "src/components/base.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "teardown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "syncValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Push the host-fed `value` into the calendar without echoing an event."
+            },
+            {
+              "kind": "method",
+              "name": "options",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "FlatpickrOptions"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emitIfChanged",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "dates",
+                  "type": {
+                    "text": "Date[]"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "datesOf",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date[]"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "unknown"
+                  }
+                }
+              ],
+              "description": "Host value (any mode) -> the Date list flatpickr works with."
+            },
+            {
+              "kind": "method",
+              "name": "toValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "unknown"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "dates",
+                  "type": {
+                    "text": "Date[]"
+                  }
+                }
+              ],
+              "description": "flatpickr's selection -> the value shape of the field's mode."
+            },
             {
               "kind": "field",
               "name": "uid",