@g9tm/lynxcontrols 0.0.0-stage → 1.4.0

package/dist/pickers/date-time.d.ts

@@ -0,0 +1,82 @@
+import { type G9CalendarSystem, type G9Culture, G9DateTimeDisplayFormat, G9DateTimePickerMode, type G9LocalDate, type G9LocalDateTime } from '@g9tm/lynxcontrols-foundation';
+/** One wheel row: the value it stands for and its text. */
+export interface G9WheelItem<V extends string | number = number> {
+    readonly value: V;
+    readonly text: string;
+}
+/** Year rows are a window of at most ±50 years around the selection (MAUI `YearWindowRadius`). */
+export declare const g9YearWindowRadius = 50;
+/** The calendar a picker shows: the explicit one, else Persian for a `fa` culture, else Gregorian (MAUI rule). */
+export declare function resolvePickerCalendar(culture: G9Culture, calendar?: G9CalendarSystem | null): G9CalendarSystem;
+/** A date-time with its time part (a plain date reads as midnight). */
+export declare function asDateTime(value: G9LocalDate): G9LocalDateTime;
+/**
+ * Min/max for a calendar: Persian bounds are pulled into the range the Persian calendar supports (from 0622-03-22),
+ * and an inverted pair is swapped.
+ */
+export declare function normalizePickerBounds(min: G9LocalDate | null | undefined, max: G9LocalDate | null | undefined, calendar: G9CalendarSystem): {
+    min: G9LocalDateTime | null;
+    max: G9LocalDateTime | null;
+};
+/** Orders two date-times (date first, then time). */
+export declare function compareDateTime(a: G9LocalDateTime, b: G9LocalDateTime): number;
+/** Clamps a value into `[min, max]` (either bound optional) and, for Persian, into the supported range. */
+export declare function clampPickerValue(value: G9LocalDateTime, bounds: {
+    min: G9LocalDateTime | null;
+    max: G9LocalDateTime | null;
+}, calendar: G9CalendarSystem): G9LocalDateTime;
+/** The value's parts in the picker calendar (what the day/month/year wheels show). */
+export declare function pickerParts(value: G9LocalDateTime, calendar: G9CalendarSystem): {
+    year: number;
+    month: number;
+    day: number;
+};
+/**
+ * Builds the value from wheel parts: the day is clamped to the month's length (31 Farvardin → 30 Mehr, 29 Feb → 28
+ * in a common year, Esfand 30 → 29), then the result is clamped to the bounds.
+ */
+export declare function composePickerValue(parts: {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+}, calendar: G9CalendarSystem, bounds: {
+    min: G9LocalDateTime | null;
+    max: G9LocalDateTime | null;
+}): G9LocalDateTime;
+/** Day rows 1…count (two digits, native numerals). */
+export declare function dayWheelItems(count: number, culture: G9Culture): G9WheelItem[];
+/** Month rows with the calendar's month names. */
+export declare function monthWheelItems(calendar: G9CalendarSystem, culture: G9Culture): G9WheelItem[];
+/**
+ * The year window (MAUI `BuildYears`): ±{@link g9YearWindowRadius} around `year`, inside the bounds' years (and the
+ * calendar's 1…9999 range).
+ */
+export declare function yearWindow(year: number, minYear: number | null, maxYear: number | null): {
+    from: number;
+    to: number;
+};
+/** Year rows `from…to` (four digits, native numerals). */
+export declare function yearWheelItems(from: number, to: number, culture: G9Culture): G9WheelItem[];
+/** Hour rows 0…23: `HH`, or `hh tt` in 12-hour display (MAUI `BuildHours`). */
+export declare function hourWheelItems(twentyFourHour: boolean, culture: G9Culture): G9WheelItem[];
+/** Minute rows 0…59. */
+export declare function minuteWheelItems(culture: G9Culture): G9WheelItem[];
+/** Options of {@link formatPickerValue}. */
+export interface G9PickerFormatOptions {
+    readonly mode?: G9DateTimePickerMode;
+    readonly displayFormat?: G9DateTimeDisplayFormat;
+    readonly twentyFourHour?: boolean;
+    readonly calendar?: G9CalendarSystem | null;
+    /** Text of the `'custom'` format (MAUI `FormattedDisplayText`); blank falls back to the short date. */
+    readonly customText?: string | null;
+}
+/**
+ * The trigger and preview text (MAUI `FormatValue`). Gregorian: short `d MMM yyyy`, long `MMMM d, yyyy`, time
+ * `HH:mm`/`hh:mm tt`, short date-time `d MMM yyyy, HH:mm`, long date-time `MMMM d, yyyy, hh:mm tt`. Persian:
+ * `dd MMMM yyyy` and `{date}، {time}` (a date the Persian calendar cannot hold is written Gregorian). The `'time'`
+ * mode always shows the time; `'custom'` shows `customText`.
+ */
+export declare function formatPickerValue(value: G9LocalDate, culture: G9Culture, options?: G9PickerFormatOptions): string;
+//# sourceMappingURL=date-time.d.ts.map

package/dist/pickers/date-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-time.d.ts","sourceRoot":"","sources":["../../src/pickers/date-time.ts"],"names":[],"mappings":"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"}

package/dist/pickers/date-time.jsx

@@ -0,0 +1,130 @@
+import { G9DateTimeDisplayFormat, G9DateTimePickerMode, clampToPersianRange, compareLocal, daysInMonth, formatLocalDateTime, fromCalendarDate, getMonthNames, isPersianLanguage, isSupportedByPersianCalendar, localDateTime, toCalendarDate, toNativeDigits } from "@g9tm/lynxcontrols-foundation";
+const g9YearWindowRadius = 50;
+function resolvePickerCalendar(culture, calendar) {
+    if (calendar) return calendar;
+    return isPersianLanguage(culture) ? 'persian' : 'gregorian';
+}
+function asDateTime(value) {
+    var _t_hour, _t_minute, _t_second, _t_millisecond;
+    const t = value;
+    return localDateTime(value.year, value.month, value.day, null != (_t_hour = t.hour) ? _t_hour : 0, null != (_t_minute = t.minute) ? _t_minute : 0, null != (_t_second = t.second) ? _t_second : 0, null != (_t_millisecond = t.millisecond) ? _t_millisecond : 0);
+}
+function normalizePickerBounds(min, max, calendar) {
+    let lo = min ? asDateTime(min) : null;
+    let hi = max ? asDateTime(max) : null;
+    if ('persian' === calendar) {
+        lo = lo ? clampToPersianRange(lo) : null;
+        hi = hi ? clampToPersianRange(hi) : null;
+    }
+    if (lo && hi && compareDateTime(lo, hi) > 0) [lo, hi] = [
+        hi,
+        lo
+    ];
+    return {
+        min: lo,
+        max: hi
+    };
+}
+function compareDateTime(a, b) {
+    const d = compareLocal(a, b);
+    if (0 !== d) return d;
+    return 3600000 * a.hour + 60000 * a.minute + 1000 * a.second + a.millisecond - (3600000 * b.hour + 60000 * b.minute + 1000 * b.second + b.millisecond);
+}
+function clampPickerValue(value, bounds, calendar) {
+    let v = 'persian' === calendar ? clampToPersianRange(value) : value;
+    if (bounds.min && compareDateTime(v, bounds.min) < 0) v = bounds.min;
+    if (bounds.max && compareDateTime(v, bounds.max) > 0) v = bounds.max;
+    return v;
+}
+function pickerParts(value, calendar) {
+    const c = toCalendarDate(value, calendar);
+    return {
+        year: c.year,
+        month: c.month,
+        day: c.day
+    };
+}
+function composePickerValue(parts, calendar, bounds) {
+    const day = Math.min(parts.day, daysInMonth(calendar, parts.year, parts.month));
+    const date = fromCalendarDate({
+        calendar,
+        year: parts.year,
+        month: parts.month,
+        day
+    });
+    return clampPickerValue(localDateTime(date.year, date.month, date.day, parts.hour, parts.minute), bounds, calendar);
+}
+const digits = (culture, n, width)=>toNativeDigits(String(n).padStart(width, '0'), culture.numberingSystem);
+function dayWheelItems(count, culture) {
+    return Array.from({
+        length: count
+    }, (_, i)=>({
+            value: i + 1,
+            text: digits(culture, i + 1, 2)
+        }));
+}
+function monthWheelItems(calendar, culture) {
+    return getMonthNames(calendar, culture).map((text, i)=>({
+            value: i + 1,
+            text
+        }));
+}
+function yearWindow(year, minYear, maxYear) {
+    const lo = Math.max(1, null != minYear ? minYear : 1);
+    const hi = Math.min(9999, null != maxYear ? maxYear : 9999);
+    return {
+        from: Math.max(lo, year - g9YearWindowRadius),
+        to: Math.min(hi, year + g9YearWindowRadius)
+    };
+}
+function yearWheelItems(from, to, culture) {
+    return Array.from({
+        length: Math.max(0, to - from + 1)
+    }, (_, i)=>({
+            value: from + i,
+            text: digits(culture, from + i, 4)
+        }));
+}
+function hourWheelItems(twentyFourHour, culture) {
+    return Array.from({
+        length: 24
+    }, (_, h)=>({
+            value: h,
+            text: formatLocalDateTime(localDateTime(2000, 1, 1, h), twentyFourHour ? 'HH' : 'hh tt', culture, {
+                calendar: 'gregorian'
+            })
+        }));
+}
+function minuteWheelItems(culture) {
+    return Array.from({
+        length: 60
+    }, (_, m)=>({
+            value: m,
+            text: digits(culture, m, 2)
+        }));
+}
+function formatPickerValue(value, culture, options = {}) {
+    var _options_displayFormat;
+    const format = null != (_options_displayFormat = options.displayFormat) ? _options_displayFormat : G9DateTimeDisplayFormat.ShortDate;
+    if (format === G9DateTimeDisplayFormat.Custom && options.customText && '' !== options.customText.trim()) return options.customText;
+    const v = asDateTime(value);
+    const time = options.twentyFourHour ? 'HH:mm' : 'hh:mm tt';
+    const calendar = resolvePickerCalendar(culture, options.calendar);
+    const effective = options.mode === G9DateTimePickerMode.Time ? G9DateTimeDisplayFormat.TimeOnly : format;
+    if ('persian' === calendar && isSupportedByPersianCalendar(v)) {
+        const fmt = (p)=>formatLocalDateTime(v, p, culture, {
+                calendar: 'persian'
+            });
+        const date = fmt('dd MMMM yyyy');
+        if (effective === G9DateTimeDisplayFormat.TimeOnly) return fmt(time);
+        if (effective === G9DateTimeDisplayFormat.ShortDateTime || effective === G9DateTimeDisplayFormat.LongDateTime) return `${date}، ${fmt(time)}`;
+        return date;
+    }
+    const pattern = effective === G9DateTimeDisplayFormat.LongDate ? 'MMMM d, yyyy' : effective === G9DateTimeDisplayFormat.TimeOnly ? time : effective === G9DateTimeDisplayFormat.ShortDateTime ? 'd MMM yyyy, HH:mm' : effective === G9DateTimeDisplayFormat.LongDateTime ? 'MMMM d, yyyy, hh:mm tt' : 'd MMM yyyy';
+    return formatLocalDateTime(v, pattern, culture, {
+        calendar: 'gregorian'
+    });
+}
+export { asDateTime, clampPickerValue, compareDateTime, composePickerValue, dayWheelItems, formatPickerValue, g9YearWindowRadius, hourWheelItems, minuteWheelItems, monthWheelItems, normalizePickerBounds, pickerParts, resolvePickerCalendar, yearWheelItems, yearWindow };
+
+//# sourceMappingURL=date-time.jsx.map

package/dist/pickers/date-time.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickers/date-time.jsx","sources":["../../src/pickers/date-time.ts"],"sourcesContent":["import {\n  clampToPersianRange,\n  compareLocal,\n  daysInMonth,\n  formatLocalDateTime,\n  fromCalendarDate,\n  type G9CalendarSystem,\n  type G9Culture,\n  G9DateTimeDisplayFormat,\n  G9DateTimePickerMode,\n  type G9LocalDate,\n  type G9LocalDateTime,\n  getMonthNames,\n  isPersianLanguage,\n  isSupportedByPersianCalendar,\n  localDateTime,\n  toCalendarDate,\n  toNativeDigits,\n} from '@g9tm/lynxcontrols-foundation';\n\n// Date math and text of the date/time picker (MAUI `G9DateTimePicker` + `G9DateTimePickerSheet`), Intl-free: every\n// calendar step goes through the foundation calendar functions.\n\n/** One wheel row: the value it stands for and its text. */\nexport interface G9WheelItem<V extends string | number = number> {\n  readonly value: V;\n  readonly text: string;\n}\n\n/** Year rows are a window of at most ±50 years around the selection (MAUI `YearWindowRadius`). */\nexport const g9YearWindowRadius = 50;\n\n/** The calendar a picker shows: the explicit one, else Persian for a `fa` culture, else Gregorian (MAUI rule). */\nexport function resolvePickerCalendar(culture: G9Culture, calendar?: G9CalendarSystem | null): G9CalendarSystem {\n  if (calendar) return calendar;\n  return isPersianLanguage(culture) ? 'persian' : 'gregorian';\n}\n\n/** A date-time with its time part (a plain date reads as midnight). */\nexport function asDateTime(value: G9LocalDate): G9LocalDateTime {\n  const t = value as Partial<G9LocalDateTime>;\n  return localDateTime(\n    value.year,\n    value.month,\n    value.day,\n    t.hour ?? 0,\n    t.minute ?? 0,\n    t.second ?? 0,\n    t.millisecond ?? 0,\n  );\n}\n\n/**\n * Min/max for a calendar: Persian bounds are pulled into the range the Persian calendar supports (from 0622-03-22),\n * and an inverted pair is swapped.\n */\nexport function normalizePickerBounds(\n  min: G9LocalDate | null | undefined,\n  max: G9LocalDate | null | undefined,\n  calendar: G9CalendarSystem,\n): { min: G9LocalDateTime | null; max: G9LocalDateTime | null } {\n  let lo = min ? asDateTime(min) : null;\n  let hi = max ? asDateTime(max) : null;\n  if (calendar === 'persian') {\n    lo = lo ? clampToPersianRange(lo) : null;\n    hi = hi ? clampToPersianRange(hi) : null;\n  }\n  if (lo && hi && compareDateTime(lo, hi) > 0) [lo, hi] = [hi, lo];\n  return { min: lo, max: hi };\n}\n\n/** Orders two date-times (date first, then time). */\nexport function compareDateTime(a: G9LocalDateTime, b: G9LocalDateTime): number {\n  const d = compareLocal(a, b);\n  if (d !== 0) return d;\n  return (\n    a.hour * 3_600_000 +\n    a.minute * 60_000 +\n    a.second * 1000 +\n    a.millisecond -\n    (b.hour * 3_600_000 + b.minute * 60_000 + b.second * 1000 + b.millisecond)\n  );\n}\n\n/** Clamps a value into `[min, max]` (either bound optional) and, for Persian, into the supported range. */\nexport function clampPickerValue(\n  value: G9LocalDateTime,\n  bounds: { min: G9LocalDateTime | null; max: G9LocalDateTime | null },\n  calendar: G9CalendarSystem,\n): G9LocalDateTime {\n  let v = calendar === 'persian' ? clampToPersianRange(value) : value;\n  if (bounds.min && compareDateTime(v, bounds.min) < 0) v = bounds.min;\n  if (bounds.max && compareDateTime(v, bounds.max) > 0) v = bounds.max;\n  return v;\n}\n\n/** The value's parts in the picker calendar (what the day/month/year wheels show). */\nexport function pickerParts(\n  value: G9LocalDateTime,\n  calendar: G9CalendarSystem,\n): {\n  year: number;\n  month: number;\n  day: number;\n} {\n  const c = toCalendarDate(value, calendar);\n  return { year: c.year, month: c.month, day: c.day };\n}\n\n/**\n * Builds the value from wheel parts: the day is clamped to the month's length (31 Farvardin → 30 Mehr, 29 Feb → 28\n * in a common year, Esfand 30 → 29), then the result is clamped to the bounds.\n */\nexport function composePickerValue(\n  parts: { year: number; month: number; day: number; hour: number; minute: number },\n  calendar: G9CalendarSystem,\n  bounds: { min: G9LocalDateTime | null; max: G9LocalDateTime | null },\n): G9LocalDateTime {\n  const day = Math.min(parts.day, daysInMonth(calendar, parts.year, parts.month));\n  const date = fromCalendarDate({ calendar, year: parts.year, month: parts.month, day });\n  return clampPickerValue(localDateTime(date.year, date.month, date.day, parts.hour, parts.minute), bounds, calendar);\n}\n\nconst digits = (culture: G9Culture, n: number, width: number) =>\n  toNativeDigits(String(n).padStart(width, '0'), culture.numberingSystem);\n\n/** Day rows 1…count (two digits, native numerals). */\nexport function dayWheelItems(count: number, culture: G9Culture): G9WheelItem[] {\n  return Array.from({ length: count }, (_, i) => ({ value: i + 1, text: digits(culture, i + 1, 2) }));\n}\n\n/** Month rows with the calendar's month names. */\nexport function monthWheelItems(calendar: G9CalendarSystem, culture: G9Culture): G9WheelItem[] {\n  return getMonthNames(calendar, culture).map((text, i) => ({ value: i + 1, text }));\n}\n\n/**\n * The year window (MAUI `BuildYears`): ±{@link g9YearWindowRadius} around `year`, inside the bounds' years (and the\n * calendar's 1…9999 range).\n */\nexport function yearWindow(year: number, minYear: number | null, maxYear: number | null): { from: number; to: number } {\n  const lo = Math.max(1, minYear ?? 1);\n  const hi = Math.min(9999, maxYear ?? 9999);\n  return { from: Math.max(lo, year - g9YearWindowRadius), to: Math.min(hi, year + g9YearWindowRadius) };\n}\n\n/** Year rows `from…to` (four digits, native numerals). */\nexport function yearWheelItems(from: number, to: number, culture: G9Culture): G9WheelItem[] {\n  return Array.from({ length: Math.max(0, to - from + 1) }, (_, i) => ({\n    value: from + i,\n    text: digits(culture, from + i, 4),\n  }));\n}\n\n/** Hour rows 0…23: `HH`, or `hh tt` in 12-hour display (MAUI `BuildHours`). */\nexport function hourWheelItems(twentyFourHour: boolean, culture: G9Culture): G9WheelItem[] {\n  return Array.from({ length: 24 }, (_, h) => ({\n    value: h,\n    text: formatLocalDateTime(localDateTime(2000, 1, 1, h), twentyFourHour ? 'HH' : 'hh tt', culture, {\n      calendar: 'gregorian',\n    }),\n  }));\n}\n\n/** Minute rows 0…59. */\nexport function minuteWheelItems(culture: G9Culture): G9WheelItem[] {\n  return Array.from({ length: 60 }, (_, m) => ({ value: m, text: digits(culture, m, 2) }));\n}\n\n/** Options of {@link formatPickerValue}. */\nexport interface G9PickerFormatOptions {\n  readonly mode?: G9DateTimePickerMode;\n  readonly displayFormat?: G9DateTimeDisplayFormat;\n  readonly twentyFourHour?: boolean;\n  readonly calendar?: G9CalendarSystem | null;\n  /** Text of the `'custom'` format (MAUI `FormattedDisplayText`); blank falls back to the short date. */\n  readonly customText?: string | null;\n}\n\n/**\n * The trigger and preview text (MAUI `FormatValue`). Gregorian: short `d MMM yyyy`, long `MMMM d, yyyy`, time\n * `HH:mm`/`hh:mm tt`, short date-time `d MMM yyyy, HH:mm`, long date-time `MMMM d, yyyy, hh:mm tt`. Persian:\n * `dd MMMM yyyy` and `{date}، {time}` (a date the Persian calendar cannot hold is written Gregorian). The `'time'`\n * mode always shows the time; `'custom'` shows `customText`.\n */\nexport function formatPickerValue(value: G9LocalDate, culture: G9Culture, options: G9PickerFormatOptions = {}): string {\n  const format = options.displayFormat ?? G9DateTimeDisplayFormat.ShortDate;\n  if (format === G9DateTimeDisplayFormat.Custom && options.customText && options.customText.trim() !== '') {\n    return options.customText;\n  }\n  const v = asDateTime(value);\n  const time = options.twentyFourHour ? 'HH:mm' : 'hh:mm tt';\n  const calendar = resolvePickerCalendar(culture, options.calendar);\n  const effective = options.mode === G9DateTimePickerMode.Time ? G9DateTimeDisplayFormat.TimeOnly : format;\n  if (calendar === 'persian' && isSupportedByPersianCalendar(v)) {\n    const fmt = (p: string) => formatLocalDateTime(v, p, culture, { calendar: 'persian' });\n    const date = fmt('dd MMMM yyyy');\n    if (effective === G9DateTimeDisplayFormat.TimeOnly) return fmt(time);\n    if (effective === G9DateTimeDisplayFormat.ShortDateTime || effective === G9DateTimeDisplayFormat.LongDateTime) {\n      return `${date}، ${fmt(time)}`;\n    }\n    return date;\n  }\n  const pattern =\n    effective === G9DateTimeDisplayFormat.LongDate\n      ? 'MMMM d, yyyy'\n      : effective === G9DateTimeDisplayFormat.TimeOnly\n        ? time\n        : effective === G9DateTimeDisplayFormat.ShortDateTime\n          ? 'd MMM yyyy, HH:mm'\n          : effective === G9DateTimeDisplayFormat.LongDateTime\n            ? 'MMMM d, yyyy, hh:mm tt'\n            : 'd MMM yyyy';\n  return formatLocalDateTime(v, pattern, culture, { calendar: 'gregorian' });\n}\n"],"names":["g9YearWindowRadius","resolvePickerCalendar","culture","calendar","isPersianLanguage","asDateTime","value","_t_hour","_t_minute","_t_second","_t_millisecond","t","localDateTime","normalizePickerBounds","min","max","lo","hi","clampToPersianRange","compareDateTime","a","b","d","compareLocal","clampPickerValue","bounds","v","pickerParts","c","toCalendarDate","composePickerValue","parts","day","Math","daysInMonth","date","fromCalendarDate","digits","n","width","toNativeDigits","String","dayWheelItems","count","Array","_","i","monthWheelItems","getMonthNames","text","yearWindow","year","minYear","maxYear","yearWheelItems","from","to","hourWheelItems","twentyFourHour","h","formatLocalDateTime","minuteWheelItems","m","formatPickerValue","options","_options_displayFormat","format","G9DateTimeDisplayFormat","time","effective","G9DateTimePickerMode","isSupportedByPersianCalendar","fmt","p","pattern"],"mappings":"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"}

package/dist/pickers/index.d.ts

@@ -0,0 +1,10 @@
+export { G9ComboBox, type G9ComboBoxProps, g9ComboMaxChips, sameSelectionKeys } from './combo-box.js';
+export { asDateTime, clampPickerValue, compareDateTime, composePickerValue, dayWheelItems, formatPickerValue, type G9PickerFormatOptions, type G9WheelItem, g9YearWindowRadius, hourWheelItems, minuteWheelItems, monthWheelItems, normalizePickerBounds, pickerParts, resolvePickerCalendar, yearWheelItems, yearWindow, } from './date-time.js';
+export { DateTimeSheetBody, G9DateTimePicker, type G9DateTimePickerProps, g9YearWindowStep } from './date-time-picker.js';
+export { G9Picker, type G9PickerProps } from './picker.js';
+export { type G9PickerSheetBodyProps, PickerSheetHeader, showPickerSheet } from './picker-sheet.js';
+export { composeTimeSpan, formatTimeSpan, type G9TimeSpanParts, G9TimeSpanPickerMode, g9TimeSpanDefaultMaxDays, g9TimeSpanMaxYears, timeSpanDepth, timeSpanParts, } from './timespan.js';
+export { G9TimeSpanPicker, type G9TimeSpanPickerProps, TimeSpanSheetBody } from './timespan-picker.js';
+export { type G9PickerFieldProps, PickerField, SelectionValueIcon, usePickerOpen, valueDirectionClass, } from './trigger.js';
+export { G9WheelColumn, type G9WheelColumnProps, g9WheelRowHeight, g9WheelVisibleRows, wheelIndexAt, } from './wheel-column.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pickers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pickers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvH,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,eAAe,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/pickers/index.jsx

@@ -0,0 +1,9 @@
+export { G9ComboBox, g9ComboMaxChips, sameSelectionKeys } from "./combo-box.jsx";
+export { asDateTime, clampPickerValue, compareDateTime, composePickerValue, dayWheelItems, formatPickerValue, g9YearWindowRadius, hourWheelItems, minuteWheelItems, monthWheelItems, normalizePickerBounds, pickerParts, resolvePickerCalendar, yearWheelItems, yearWindow } from "./date-time.jsx";
+export { DateTimeSheetBody, G9DateTimePicker, g9YearWindowStep } from "./date-time-picker.jsx";
+export { G9Picker } from "./picker.jsx";
+export { PickerSheetHeader, showPickerSheet } from "./picker-sheet.jsx";
+export { G9TimeSpanPickerMode, composeTimeSpan, formatTimeSpan, g9TimeSpanDefaultMaxDays, g9TimeSpanMaxYears, timeSpanDepth, timeSpanParts } from "./timespan.jsx";
+export { G9TimeSpanPicker, TimeSpanSheetBody } from "./timespan-picker.jsx";
+export { PickerField, SelectionValueIcon, usePickerOpen, valueDirectionClass } from "./trigger.jsx";
+export { G9WheelColumn, g9WheelRowHeight, g9WheelVisibleRows, wheelIndexAt } from "./wheel-column.jsx";

package/dist/pickers/picker-sheet.d.ts

@@ -0,0 +1,21 @@
+import './pickers.css';
+import type { ReactNode } from '@lynx-js/react';
+import type { G9SheetService } from '../sheet/service.js';
+/** Props a drum sheet body receives: finish with a value (Done) or without (Cancel). */
+export interface G9PickerSheetBodyProps<T> {
+    readonly done: (value: T) => void;
+    readonly cancel: () => void;
+}
+/**
+ * Opens a fit-to-content drum sheet (MAUI `G9DateTimePickerSheet.ShowAsync` / `G9TimeSpanPickerSheet.ShowAsync`) and
+ * resolves the value Done returned, or `null` for Cancel, any dismissal, or a throttled open. The body is built after
+ * the open motion and revealed as one settled unit (`fadeDeferredContentIn`, MAUI's crossfade).
+ */
+export declare function showPickerSheet<T>(sheets: G9SheetService, body: (props: G9PickerSheetBodyProps<T>) => ReactNode): Promise<T | null>;
+/** The drum sheet header (MAUI): Cancel, the title, Done. */
+export declare function PickerSheetHeader(props: {
+    readonly title: string;
+    readonly onCancel: () => void;
+    readonly onDone: () => void;
+}): ReactNode;
+//# sourceMappingURL=picker-sheet.d.ts.map

package/dist/pickers/picker-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker-sheet.d.ts","sourceRoot":"","sources":["../../src/pickers/picker-sheet.tsx"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wFAAwF;AACxF,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,SAAS,GACpD,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqBnB;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B,GAAG,SAAS,CA8BZ"}

package/dist/pickers/picker-sheet.jsx

@@ -0,0 +1,61 @@
+import "./pickers.css";
+import { G9StringKey } from "@g9tm/lynxcontrols-foundation";
+import { g9RowStyle } from "../base/control.jsx";
+import { useG9Press } from "../base/press.jsx";
+import { useG9Direction, useG9Strings } from "../provider/hooks.jsx";
+import { useG9SheetContext } from "../sheet/frame.jsx";
+import { fitToContentSheetOptions } from "../sheet/options.jsx";
+async function showPickerSheet(sheets, body) {
+    let result = null;
+    let finished = false;
+    const Body = ()=>{
+        var _useG9SheetContext;
+        const handle = null == (_useG9SheetContext = useG9SheetContext()) ? void 0 : _useG9SheetContext.handle;
+        const finish = (value)=>{
+            if (finished) return;
+            finished = true;
+            result = value;
+            null == handle || handle.close();
+        };
+        return body({
+            done: (v)=>finish(v),
+            cancel: ()=>finish(null)
+        });
+    };
+    const handle = sheets.show(()=><Body/>, {
+        ...fitToContentSheetOptions(),
+        fadeDeferredContentIn: true,
+        loadingSkeleton: 'none'
+    });
+    if (!handle) return null;
+    await handle.result;
+    return result;
+}
+function PickerSheetHeader(props) {
+    const strings = useG9Strings();
+    const direction = useG9Direction();
+    const cancel = useG9Press(props.onCancel, {
+        source: 'G9PickerSheet',
+        guardMs: 0
+    });
+    const done = useG9Press(props.onDone, {
+        source: 'G9PickerSheet',
+        guardMs: 0
+    });
+    return <view className="g9-picker-sheet__header" style={g9RowStyle(direction)}>
+      <view className="g9-picker-sheet__action g9-picker-sheet__cancel" accessibility-element={true} accessibility-traits="button" bindtap={cancel}>
+        <text className="g9-picker-sheet__action-text">{strings.get(G9StringKey.Cancel)}</text>
+      </view>
+      <text className="g9-picker-sheet__title" text-maxline="1">
+        {props.title}
+      </text>
+      <view className="g9-picker-sheet__action g9-picker-sheet__done" accessibility-element={true} accessibility-traits="button" bindtap={done}>
+        <text className="g9-picker-sheet__action-text g9-picker-sheet__action-text--done">
+          {strings.get(G9StringKey.Done)}
+        </text>
+      </view>
+    </view>;
+}
+export { PickerSheetHeader, showPickerSheet };
+
+//# sourceMappingURL=picker-sheet.jsx.map

package/dist/pickers/picker-sheet.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickers/picker-sheet.jsx","sources":["../../src/pickers/picker-sheet.tsx"],"sourcesContent":["import './pickers.css';\nimport { G9StringKey } from '@g9tm/lynxcontrols-foundation';\nimport type { ReactNode } from '@lynx-js/react';\nimport { g9RowStyle } from '../base/control';\nimport { useG9Press } from '../base/press';\nimport { useG9Direction, useG9Strings } from '../provider/hooks';\nimport { useG9SheetContext } from '../sheet/frame';\nimport { fitToContentSheetOptions } from '../sheet/options';\nimport type { G9SheetService } from '../sheet/service';\n\n/** Props a drum sheet body receives: finish with a value (Done) or without (Cancel). */\nexport interface G9PickerSheetBodyProps<T> {\n  readonly done: (value: T) => void;\n  readonly cancel: () => void;\n}\n\n/**\n * Opens a fit-to-content drum sheet (MAUI `G9DateTimePickerSheet.ShowAsync` / `G9TimeSpanPickerSheet.ShowAsync`) and\n * resolves the value Done returned, or `null` for Cancel, any dismissal, or a throttled open. The body is built after\n * the open motion and revealed as one settled unit (`fadeDeferredContentIn`, MAUI's crossfade).\n */\nexport async function showPickerSheet<T>(\n  sheets: G9SheetService,\n  body: (props: G9PickerSheetBodyProps<T>) => ReactNode,\n): Promise<T | null> {\n  let result: T | null = null;\n  let finished = false;\n  const Body = () => {\n    const handle = useG9SheetContext()?.handle;\n    const finish = (value: T | null) => {\n      if (finished) return;\n      finished = true;\n      result = value;\n      handle?.close();\n    };\n    return body({ done: (v) => finish(v), cancel: () => finish(null) });\n  };\n  const handle = sheets.show(() => <Body />, {\n    ...fitToContentSheetOptions(),\n    fadeDeferredContentIn: true,\n    loadingSkeleton: 'none',\n  });\n  if (!handle) return null;\n  await handle.result;\n  return result;\n}\n\n/** The drum sheet header (MAUI): Cancel, the title, Done. */\nexport function PickerSheetHeader(props: {\n  readonly title: string;\n  readonly onCancel: () => void;\n  readonly onDone: () => void;\n}): ReactNode {\n  const strings = useG9Strings();\n  const direction = useG9Direction();\n  const cancel = useG9Press(props.onCancel, { source: 'G9PickerSheet', guardMs: 0 });\n  const done = useG9Press(props.onDone, { source: 'G9PickerSheet', guardMs: 0 });\n  return (\n    <view className=\"g9-picker-sheet__header\" style={g9RowStyle(direction)}>\n      <view\n        className=\"g9-picker-sheet__action g9-picker-sheet__cancel\"\n        accessibility-element={true}\n        accessibility-traits=\"button\"\n        bindtap={cancel}\n      >\n        <text className=\"g9-picker-sheet__action-text\">{strings.get(G9StringKey.Cancel)}</text>\n      </view>\n      <text className=\"g9-picker-sheet__title\" text-maxline=\"1\">\n        {props.title}\n      </text>\n      <view\n        className=\"g9-picker-sheet__action g9-picker-sheet__done\"\n        accessibility-element={true}\n        accessibility-traits=\"button\"\n        bindtap={done}\n      >\n        <text className=\"g9-picker-sheet__action-text g9-picker-sheet__action-text--done\">\n          {strings.get(G9StringKey.Done)}\n        </text>\n      </view>\n    </view>\n  );\n}\n"],"names":["showPickerSheet","sheets","body","result","finished","Body","_useG9SheetContext","handle","finish","value","v","fitToContentSheetOptions","PickerSheetHeader","props","strings","useG9Strings","direction","useG9Direction","cancel","useG9Press","done","view","g9RowStyle","text","G9StringKey"],"mappings":";;;;;;;AAqBO,eAAeA,gBACpBC,MAAsB,EACtBC,IAAqD;IAErD,IAAIC,SAAmB;IACvB,IAAIC,WAAW;IACf,MAAMC,OAAO;YACIC;QAAf,MAAMC,SAAS,QAAAD,CAAAA,qBAAAA,mBAAkB,IAAlBA,KAAAA,IAAAA,mBAAqB,MAAM;QAC1C,MAAME,SAAS,CAACC;YACd,IAAIL,UAAU;YACdA,WAAW;YACXD,SAASM;YACTF,QAAAA,UAAAA,OAAQ,KAAK;QACf;QACA,OAAOL,KAAK;YAAE,MAAM,CAACQ,IAAMF,OAAOE;YAAI,QAAQ,IAAMF,OAAO;QAAM;IACnE;IACA,MAAMD,SAASN,OAAO,IAAI,CAAC,KAAOI,QAAS;QACzC,GAAGM,0BAA0B;QAC7B,uBAAuB;QACvB,iBAAiB;IACnB;IACA,IAAI,CAACJ,QAAQ,OAAO;IACpB,MAAMA,OAAO,MAAM;IACnB,OAAOJ;AACT;AAGO,SAASS,kBAAkBC,KAIjC;IACC,MAAMC,UAAUC;IAChB,MAAMC,YAAYC;IAClB,MAAMC,SAASC,WAAWN,MAAM,QAAQ,EAAE;QAAE,QAAQ;QAAiB,SAAS;IAAE;IAChF,MAAMO,OAAOD,WAAWN,MAAM,MAAM,EAAE;QAAE,QAAQ;QAAiB,SAAS;IAAE;IAC5E,QACGQ,KAAK,UAAU,0BAA0B,OAAOC,WAAWN,YAAY;MACtE,CAACK,KACC,UAAU,kDACV,uBAAuB,MACvB,qBAAqB,SACrB,SAASH,QACV;QACC,CAACK,KAAK,UAAU,gCAAgCT,QAAQ,GAAG,CAACU,YAAY,MAAM,IAAID,KAAK;MACzF,EAAEF,KAAK;MACP,CAACE,KAAK,UAAU,yBAAyB,aAAa,IAAI;QACxD,CAACV,MAAM,KAAK,CAAC;MACf,EAAEU,KAAK;MACP,CAACF,KACC,UAAU,gDACV,uBAAuB,MACvB,qBAAqB,SACrB,SAASD,MACV;QACC,CAACG,KAAK,UAAU,kEAAkE;UAChF,CAACT,QAAQ,GAAG,CAACU,YAAY,IAAI,EAAE;QACjC,EAAED,KAAK;MACT,EAAEF,KAAK;IACT,EAAEA;AAEN"}

package/dist/pickers/picker.d.ts

@@ -0,0 +1,32 @@
+import './pickers.css';
+import { type ReactNode } from '@lynx-js/react';
+import { type G9SelectionItem } from '../base/selection-item.js';
+import { type G9PickerFieldProps } from './trigger.js';
+/** Props of {@link G9Picker}. */
+export interface G9PickerProps<T extends G9SelectionItem = G9SelectionItem> extends G9PickerFieldProps {
+    /** The rows of the sheet (MAUI `ItemsSource`). Disabled items are left out except the selected one. */
+    readonly items: ReadonlyArray<T>;
+    /** Selected item key (`selectionKey`: key, else text); `null` = none. Controlled with `onValueChange`. */
+    readonly value?: string | null;
+    readonly defaultValue?: string | null;
+    /** The selection changed: by a pick, or by `restoreOnCancel` putting back the opening value. */
+    readonly onValueChange?: (key: string | null, item: T | null) => void;
+    /** Sheet title; default the label, else the placeholder (MAUI `SheetTitle`). */
+    readonly sheetTitle?: string | null;
+    /**
+     * Default true (MAUI `RestoreOnCancel`): a dismissed sheet puts back the value the picker had when it opened (if it
+     * changed meanwhile) and reports `onSelectionCancelled`. False leaves the current value and reports nothing.
+     */
+    readonly restoreOnCancel?: boolean;
+    /** A row was picked (MAUI `ItemSelected` + `SelectionAcceptedCommand`); only for a pick, never for a dismissal. */
+    readonly onItemSelected?: (item: T) => void;
+    /** The sheet was dismissed without a pick (MAUI `SelectionCancelled` + `SelectionCancelledCommand`). */
+    readonly onSelectionCancelled?: () => void;
+}
+/**
+ * Single selection from a list in an outlined box (MAUI `G9Picker`): a tap opens the selection sheet (no search; a
+ * pick closes it), the box shows the item's icon or swatch and text, the trailing chevron hints at the sheet. Must
+ * be inside a `G9Host` (the sheet).
+ */
+export declare function G9Picker<T extends G9SelectionItem = G9SelectionItem>(props: G9PickerProps<T>): ReactNode;
+//# sourceMappingURL=picker.d.ts.map

package/dist/pickers/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../src/pickers/picker.tsx"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,eAAe,EAAgB,MAAM,wBAAwB,CAAC;AAK5E,OAAO,EAAE,KAAK,kBAAkB,EAAkD,MAAM,WAAW,CAAC;AAEpG,iCAAiC;AACjC,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,CAAE,SAAQ,kBAAkB;IACpG,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,0GAA0G;IAC1G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,gGAAgG;IAChG,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IACtE,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,mHAAmH;IACnH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5C,wGAAwG;IACxG,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAiDxG"}

package/dist/pickers/picker.jsx

@@ -0,0 +1,72 @@
+import "./pickers.css";
+import { useRef } from "@lynx-js/react";
+import { selectionKey } from "../base/selection-item.jsx";
+import { useControllableState } from "../base/use-controllable-state.jsx";
+import { useG9Settings } from "../provider/hooks.jsx";
+import { showSelectionSheet } from "../selection/selection-sheet.jsx";
+import { useG9Sheets } from "../sheet/service.jsx";
+import { PickerField, SelectionValueIcon, usePickerOpen } from "./trigger.jsx";
+function G9Picker(props) {
+    var _props_defaultValue, _props_placeholder;
+    const sheets = useG9Sheets();
+    const glyphs = useG9Settings().glyphs;
+    const open = usePickerOpen();
+    const [key, setKey] = useControllableState({
+        value: props.value,
+        defaultValue: null != (_props_defaultValue = props.defaultValue) ? _props_defaultValue : null,
+        onChange: props.onValueChange,
+        name: 'G9Picker.value'
+    });
+    const latest = useRef({
+        props,
+        key
+    });
+    latest.current = {
+        props,
+        key
+    };
+    const selected = null === key ? void 0 : props.items.find((i)=>selectionKey(i) === key);
+    const onOpen = ()=>open(async (isCurrent)=>{
+            var _ref, _p_label;
+            var _p_sheetTitle;
+            const p = latest.current.props;
+            const previousKey = latest.current.key;
+            const previous = null === previousKey ? void 0 : p.items.find((i)=>selectionKey(i) === previousKey);
+            const items = p.items.filter((i)=>false !== i.isEnabled || i === previous);
+            if (0 === items.length) return;
+            const result = await showSelectionSheet(sheets, {
+                title: (null == (_p_sheetTitle = p.sheetTitle) ? void 0 : _p_sheetTitle.trim()) ? p.sheetTitle : null != (_ref = null != (_p_label = p.label) ? _p_label : p.placeholder) ? _ref : '',
+                items,
+                selectedItems: previous ? [
+                    previous
+                ] : [],
+                allowMultiple: false,
+                closeOnSingleSelection: true,
+                showSearch: false
+            });
+            if (!isCurrent()) return;
+            const next = result.wasAccepted ? result.items[0] : void 0;
+            const now = latest.current.props;
+            if (next) {
+                var _now_onItemSelected;
+                setKey(selectionKey(next), next);
+                null == (_now_onItemSelected = now.onItemSelected) || _now_onItemSelected.call(now, next);
+            } else if (false !== now.restoreOnCancel) {
+                var _now_onSelectionCancelled;
+                if (latest.current.key !== previousKey) setKey(previousKey, null != previous ? previous : null);
+                null == (_now_onSelectionCancelled = now.onSelectionCancelled) || _now_onSelectionCancelled.call(now);
+            }
+        });
+    return <PickerField field={{
+        trailingIcon: glyphs.chevron,
+        ...props
+    }} hasValue={void 0 !== selected} onOpen={onOpen}>
+      {selected ? <SelectionValueIcon item={selected}/> : null}
+      <text className={`g9-picker__text${selected ? '' : ' g9-picker__text--placeholder'}`} text-maxline="1">
+        {selected ? selected.text : props.label ? '' : null != (_props_placeholder = props.placeholder) ? _props_placeholder : ''}
+      </text>
+    </PickerField>;
+}
+export { G9Picker };
+
+//# sourceMappingURL=picker.jsx.map

package/dist/pickers/picker.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickers/picker.jsx","sources":["../../src/pickers/picker.tsx"],"sourcesContent":["import './pickers.css';\nimport { type ReactNode, useRef } from '@lynx-js/react';\nimport { type G9SelectionItem, selectionKey } from '../base/selection-item';\nimport { useControllableState } from '../base/use-controllable-state';\nimport { useG9Settings } from '../provider/hooks';\nimport { showSelectionSheet } from '../selection/selection-sheet';\nimport { useG9Sheets } from '../sheet/service';\nimport { type G9PickerFieldProps, PickerField, SelectionValueIcon, usePickerOpen } from './trigger';\n\n/** Props of {@link G9Picker}. */\nexport interface G9PickerProps<T extends G9SelectionItem = G9SelectionItem> extends G9PickerFieldProps {\n  /** The rows of the sheet (MAUI `ItemsSource`). Disabled items are left out except the selected one. */\n  readonly items: ReadonlyArray<T>;\n  /** Selected item key (`selectionKey`: key, else text); `null` = none. Controlled with `onValueChange`. */\n  readonly value?: string | null;\n  readonly defaultValue?: string | null;\n  /** The selection changed: by a pick, or by `restoreOnCancel` putting back the opening value. */\n  readonly onValueChange?: (key: string | null, item: T | null) => void;\n  /** Sheet title; default the label, else the placeholder (MAUI `SheetTitle`). */\n  readonly sheetTitle?: string | null;\n  /**\n   * Default true (MAUI `RestoreOnCancel`): a dismissed sheet puts back the value the picker had when it opened (if it\n   * changed meanwhile) and reports `onSelectionCancelled`. False leaves the current value and reports nothing.\n   */\n  readonly restoreOnCancel?: boolean;\n  /** A row was picked (MAUI `ItemSelected` + `SelectionAcceptedCommand`); only for a pick, never for a dismissal. */\n  readonly onItemSelected?: (item: T) => void;\n  /** The sheet was dismissed without a pick (MAUI `SelectionCancelled` + `SelectionCancelledCommand`). */\n  readonly onSelectionCancelled?: () => void;\n}\n\n/**\n * Single selection from a list in an outlined box (MAUI `G9Picker`): a tap opens the selection sheet (no search; a\n * pick closes it), the box shows the item's icon or swatch and text, the trailing chevron hints at the sheet. Must\n * be inside a `G9Host` (the sheet).\n */\nexport function G9Picker<T extends G9SelectionItem = G9SelectionItem>(props: G9PickerProps<T>): ReactNode {\n  const sheets = useG9Sheets();\n  const glyphs = useG9Settings().glyphs;\n  const open = usePickerOpen();\n  const [key, setKey] = useControllableState<string | null, [T | null]>({\n    value: props.value,\n    defaultValue: props.defaultValue ?? null,\n    onChange: props.onValueChange,\n    name: 'G9Picker.value',\n  });\n  const latest = useRef({ props, key });\n  latest.current = { props, key };\n  const selected = key === null ? undefined : props.items.find((i) => selectionKey(i) === key);\n\n  const onOpen = () =>\n    open(async (isCurrent) => {\n      const p = latest.current.props;\n      const previousKey = latest.current.key;\n      const previous = previousKey === null ? undefined : p.items.find((i) => selectionKey(i) === previousKey);\n      const items = p.items.filter((i) => i.isEnabled !== false || i === previous);\n      if (items.length === 0) return;\n      const result = await showSelectionSheet(sheets, {\n        title: p.sheetTitle?.trim() ? p.sheetTitle : (p.label ?? p.placeholder ?? ''),\n        items,\n        selectedItems: previous ? [previous] : [],\n        allowMultiple: false,\n        closeOnSingleSelection: true,\n        showSearch: false,\n      });\n      if (!isCurrent()) return;\n      const next = result.wasAccepted ? result.items[0] : undefined;\n      const now = latest.current.props;\n      if (next) {\n        setKey(selectionKey(next), next);\n        now.onItemSelected?.(next);\n      } else if (now.restoreOnCancel !== false) {\n        if (latest.current.key !== previousKey) setKey(previousKey, previous ?? null);\n        now.onSelectionCancelled?.();\n      }\n    });\n\n  return (\n    <PickerField field={{ trailingIcon: glyphs.chevron, ...props }} hasValue={selected !== undefined} onOpen={onOpen}>\n      {selected ? <SelectionValueIcon item={selected} /> : null}\n      <text className={`g9-picker__text${selected ? '' : ' g9-picker__text--placeholder'}`} text-maxline=\"1\">\n        {selected ? selected.text : props.label ? '' : (props.placeholder ?? '')}\n      </text>\n    </PickerField>\n  );\n}\n"],"names":["G9Picker","props","_props_defaultValue","_props_placeholder","sheets","useG9Sheets","glyphs","useG9Settings","open","usePickerOpen","key","setKey","useControllableState","latest","useRef","selected","undefined","i","selectionKey","onOpen","isCurrent","_ref","_p_sheetTitle","p","previousKey","previous","items","result","showSelectionSheet","next","now","PickerField","SelectionValueIcon","text"],"mappings":";;;;;;;;AAoCO,SAASA,SAAsDC,KAAuB;QAM3EC,qBAuCsCC;IA5CtD,MAAMC,SAASC;IACf,MAAMC,SAASC,gBAAgB,MAAM;IACrC,MAAMC,OAAOC;IACb,MAAM,CAACC,KAAKC,OAAO,GAAGC,qBAAgD;QACpE,OAAOX,MAAM,KAAK;QAClB,cAAc,QAAAC,CAAAA,sBAAAA,MAAM,YAAY,AAAD,IAAjBA,sBAAsB;QACpC,UAAUD,MAAM,aAAa;QAC7B,MAAM;IACR;IACA,MAAMY,SAASC,OAAO;QAAEb;QAAOS;IAAI;IACnCG,OAAO,OAAO,GAAG;QAAEZ;QAAOS;IAAI;IAC9B,MAAMK,WAAWL,AAAQ,SAARA,MAAeM,SAAYf,MAAM,KAAK,CAAC,IAAI,CAAC,CAACgB,IAAMC,aAAaD,OAAOP;IAExF,MAAMS,SAAS,IACbX,KAAK,OAAOY;gBAOsCC,MAAAA;gBAAvCC;YANT,MAAMC,IAAIV,OAAO,OAAO,CAAC,KAAK;YAC9B,MAAMW,cAAcX,OAAO,OAAO,CAAC,GAAG;YACtC,MAAMY,WAAWD,AAAgB,SAAhBA,cAAuBR,SAAYO,EAAE,KAAK,CAAC,IAAI,CAAC,CAACN,IAAMC,aAAaD,OAAOO;YAC5F,MAAME,QAAQH,EAAE,KAAK,CAAC,MAAM,CAAC,CAACN,IAAMA,AAAgB,UAAhBA,EAAE,SAAS,IAAcA,MAAMQ;YACnE,IAAIC,AAAiB,MAAjBA,MAAM,MAAM,EAAQ;YACxB,MAAMC,SAAS,MAAMC,mBAAmBxB,QAAQ;gBAC9C,OAAOkB,AAAAA,SAAAA,CAAAA,gBAAAA,EAAE,UAAU,AAAD,IAAXA,KAAAA,IAAAA,cAAc,IAAI,EAAC,IAAIC,EAAE,UAAU,GAAG,QAACF,CAAAA,OAAAA,QAAAA,CAAAA,WAAAA,EAAE,KAAK,AAAD,IAANA,WAAWE,EAAE,WAAW,AAAD,IAAvBF,OAA4B;gBAC1EK;gBACA,eAAeD,WAAW;oBAACA;iBAAS,GAAG,EAAE;gBACzC,eAAe;gBACf,wBAAwB;gBACxB,YAAY;YACd;YACA,IAAI,CAACL,aAAa;YAClB,MAAMS,OAAOF,OAAO,WAAW,GAAGA,OAAO,KAAK,CAAC,EAAE,GAAGX;YACpD,MAAMc,MAAMjB,OAAO,OAAO,CAAC,KAAK;YAChC,IAAIgB,MAAM;oBAERC;gBADAnB,OAAOO,aAAaW,OAAOA;wBAC3BC,CAAAA,sBAAAA,IAAI,cAAc,AAAD,KAAjBA,oBAAAA,IAAAA,CAAAA,KAAqBD;YACvB,OAAO,IAAIC,AAAwB,UAAxBA,IAAI,eAAe,EAAY;oBAExCA;gBADA,IAAIjB,OAAO,OAAO,CAAC,GAAG,KAAKW,aAAab,OAAOa,aAAaC,QAAAA,WAAAA,WAAY;wBACxEK,CAAAA,4BAAAA,IAAI,oBAAoB,AAAD,KAAvBA,0BAAAA,IAAAA,CAAAA;YACF;QACF;IAEF,QACGC,YAAY,OAAO;QAAE,cAAczB,OAAO,OAAO;QAAE,GAAGL,KAAK;IAAC,GAAG,UAAUc,AAAaC,WAAbD,UAAwB,QAAQI,QAAQ;MAChH,CAACJ,YAAYiB,mBAAmB,MAAMjB,cAAe,KAAK;MAC1D,CAACkB,KAAK,WAAW,CAAC,eAAe,EAAElB,WAAW,KAAK,iCAAiC,EAAE,aAAa,IAAI;QACrG,CAACA,WAAWA,SAAS,IAAI,GAAGd,MAAM,KAAK,GAAG,KAAK,QAACE,CAAAA,qBAAAA,MAAM,WAAW,AAAD,IAAhBA,qBAAqB,GAAI;MAC3E,EAAE8B,KAAK;IACT,EAAEF;AAEN"}